В Агентике то, что в панели управления называется агент, в API называется воркфлоу. Это одно и то же: воркфлоу — базовое определение, агент — продуктовое название.
Когда API говорит workflow, думайте «агент». Когда API говорит workflow_definition, думайте «логика разговора внутри вашего агента».

​
Модель графа

Воркфлоу — это направленный граф: набор узлов, соединенных ребрами. Узлы — шаги разговора. У каждого узла есть промпт, который сообщает LLM, что говорить и делать на этом этапе. Ребра — переходы между узлами. У каждого ребра есть условие: описание на естественном языке, когда нужно перейти дальше. LLM оценивает, выполнено ли условие, по текущему разговору.

​
Типы узлов

​
Ребра и переходы

Ребро соединяет два узла и срабатывает, когда его условие выполнено: transition_speech необязателен. Если он задан, агент произносит его перед переходом к следующему узлу. О том, как агент реально решает сработать по ребру во время живого звонка и почему условия формулируются именно так, см. Как работают переходы.

​
Версионирование

Каждый раз, когда вы обновляете workflow_definition, Агентика сохраняет новую версию и оставляет историю. Текущая версия всегда используется для запусков. Старые версии хранятся для аудита.

​
Создание воркфлоу

Через API воркфлоу можно создать двумя способами:
  • Из определения — вы сами передаете полный граф узлов и ребер. Лучше всего для программной генерации.
  • Из шаблона — вы описываете сценарий на естественном языке, а Агентика генерирует начальный граф с помощью LLM. Лучше всего для быстрого старта.
Полный справочник полей см. в схеме определения воркфлоу.