В Агентике простая модель данных для передачи информации через звонок. Понять ее важно, чтобы создавать агентов, которые говорят персонализированно, и извлекать полезные результаты после звонка.

Три объекта контекста

initial_context

Данные, доступные агенту до начала звонка: имя контакта, сведения об аккаунте, информация о встрече и любые данные, которые агент должен знать заранее. Их можно задать несколькими способами:
  • Триггер через API — передайте их в теле запроса при вызове POST /public/agent/{uuid} или POST /telephony/initiate-call
  • CSV кампании — столбцы кроме phone_number автоматически становятся полями initial_context для звонка каждому контакту
  • Загрузка данных перед звонком — обогатите контекст данными из CRM или ERP через HTTP-вызов при старте звонка, до того как агент заговорит
  • Настройки агента — задайте контекстные переменные шаблона на агенте для тестирования; они включаются в тестовые звонки из редактора воркфлоу и игнорируются в боевых звонках

Переменные шаблона

Значения из initial_context доступны в промпте агента через синтаксис {{double_brace}}.
Когда звонок начинается, Агентика подставляет значения перед отправкой промпта в LLM, поэтому агент говорит естественно, будто уже знает контакт.

Резервные значения

Если переменная может отсутствовать или быть пустой, используйте вертикальную черту (|), чтобы задать значение по умолчанию:
Если customer_name не задан, агент скажет «Здравствуйте, друг», а не оставит пустое место. Синтаксис:
Если переменная присутствует и не пуста, резервное значение игнорируется и используется фактическое значение.

Переменные по умолчанию

Встроенные переменные текущего времени и дня недели доступны в любом промпте без настройки initial_context. Замените <TIMEZONE> на имя часового пояса IANA, например Asia/Kolkata, America/New_York или Europe/London.
Если вы используете суффикс часового пояса у любой из переменных current_time или current_weekday, другая переменная без суффикса автоматически использует тот же часовой пояс вместо UTC. Например, если промпт содержит {{current_time_Asia/Kolkata}} и {{current_weekday}}, день недели тоже будет вычислен в Asia/Kolkata.

Переменные телефонии

Для телефонных звонков, входящих и исходящих, Агентика автоматически добавляет эти переменные в initial_context: Для входящих звонков caller_number — номер клиента, а called_number — ваш номер Агентики. Для исходящих звонков наоборот: caller_number — ваш номер Агентики, а called_number — номер клиента.

gathered_context

Данные, которые агент собирает во время звонка. Вы настраиваете, что извлекать, в настройках извлечения узла агента: у каждой переменной есть имя, тип и промпт, который говорит LLM, что искать. gathered_context возвращается в записи запуска после завершения звонка и доступен в payload вебхуков для последующей обработки. Он не доступен как переменная шаблона в промптах агента: промпты могут ссылаться только на поля initial_context.

Пример потока данных

Где доступны переменные