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

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

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

​
Типы узлов

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

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

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

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

​
Создание workflows

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