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

Три объекта context

initial_context

Данные, доступные агенту до начала звонка: имя контакта, сведения об аккаунте, информация о встрече и любые данные, которые агент должен знать заранее. Их можно задать несколькими способами:
  • API trigger — передайте их в body запроса при вызове POST /public/agent/{uuid} или POST /telephony/initiate-call
  • Campaign CSV — столбцы кроме phone_number автоматически становятся полями initial_context для звонка каждому контакту
  • Pre-call data fetch — обогатите context данными из CRM или ERP через HTTP-вызов при старте звонка, до того как агент заговорит
  • Agent Settings — задайте template context variables на агенте для тестирования; они включаются в тестовые звонки из workflow editor и игнорируются в production-звонках

Template variables

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

Fallback values

Если переменная может отсутствовать или быть пустой, используйте pipe (|), чтобы задать значение по умолчанию:
Если customer_name не задан, агент скажет “Hello there”, а не оставит пустое место. Синтаксис:
Если переменная присутствует и не пуста, fallback игнорируется и используется фактическое значение.

Default variables

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

Telephony variables

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

gathered_context

Данные, которые агент собирает во время звонка. Вы настраиваете, что извлекать, в extraction settings узла агента: у каждой переменной есть имя, тип и prompt, который говорит LLM, что искать. Извлеченные переменные gathered_context возвращается в записи run после завершения звонка и доступен в webhook payloads для последующей обработки. Он не доступен как template variable в prompts агента: prompts могут ссылаться только на поля initial_context.

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

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