Обзор

Метод	Эндпоинт	Быстрая ссылка
`POST`	`/public/agent/{uuid}`	Запустить агента исходящим звонком через узел API Trigger
`POST`	`/public/agent/workflow/{workflow_uuid}`	Запустить агента исходящим звонком по Agent UUID
`GET`	`/workflow/{workflow_id}/runs/{run_id}`	Получить сведения о запуске агента
`GET`	`/public/download/workflow/{token}/{artifact_type}`	Скачать записи и транскрипты
`POST`	`/telephony/inbound/{workflow_id}`	Вебхук входящего запуска

Как выбрать нужный публичный маршрут запуска

Агентика предоставляет два семейства публичных маршрутов для запуска агента исходящим звонком. Они не взаимозаменяемы, даже если оба параметра пути выглядят как UUID.

Используйте, когда	Продакшн-маршрут	Тестовый маршрут	Идентификатор, который нужно передать
Вы добавили в воркфлоу узел API Trigger и хотите выполнить именно этот триггер	`/public/agent/{uuid}`	`/public/agent/test/{uuid}`	UUID триггера (`trigger_path`) из узла API Trigger
Вы хотите выполнить воркфлоу по его стабильному Agent UUID, а не через узел-триггер	`/public/agent/workflow/{workflow_uuid}`	`/public/agent/test/workflow/{workflow_uuid}`	UUID воркфлоу из поля агента Agent UUID

Не передавайте UUID воркфлоу в /public/agent/{uuid} и не передавайте UUID триггера в /public/agent/workflow/{workflow_uuid}. Агентика рассматривает их как разные типы идентификаторов, и при их смешении запрос завершится ошибкой.

После того как Агентика определит целевого агента, оба семейства маршрутов ведут себя одинаково:

Они принимают одинаковое тело запроса
Они возвращают ответ одинаковой формы
Они проверяют одну и ту же границу организации по X-API-Key
Они используют одни и те же правила выбора конфигурации телефонии

Если вам нужен именно маршрут API Trigger, см. Запустить агента исходящим звонком через узел API Trigger. Чтобы выполнить запуск по Agent UUID, см. Запустить агента исходящим звонком по Agent UUID.

Использование initial context

initial_context передаёт данные времени выполнения в агента во время запуска. Значения доступны как переменные шаблона в промпте вашего агента через синтаксис двойных фигурных скобок.

{
  "initial_context": {
    "customer_name": "Jane",
    "appointment_date": "March 15"
  }
}

Затем в промпте агента можно ссылаться на {{customer_name}} и {{appointment_date}} — они будут подставлены при старте запуска.

Значения статуса запуска

Статус	Описание
`pending`	Запуск поставлен в очередь, но ещё не подключён
`in_progress`	Запуск выполняется в реальном времени
`completed`	Запуск завершился штатно
`failed`	Запуск завершился ошибкой до или во время выполнения

Ресурсы

Аутентификация и ошибки

Как выбрать нужный публичный маршрут запуска

Использование initial context

Значения статуса запуска

​Как выбрать нужный публичный маршрут запуска

​Использование initial context

​Значения статуса запуска

Как выбрать нужный публичный маршрут запуска

Использование initial context

Значения статуса запуска