Перейти к основному содержимому

Схема данных настройки

Прямого REST для настройки снаружи нет

Настройка проекта — агенты, воркфлоу, функции — работает через внутренние пути бэкенда. Они одинаково отклоняют и токен проекта, и токен профиля.

Для настройки извне работает только MCP-сервер. Раздел ниже — справочник по полям объектов: те же, что принимают и возвращают инструменты MCP, но здесь — без обращения через MCP.

Проекты​

Соответствует MCP-инструментам list_projects / get_project.

Форма ответа list_projects:

{
"projects": [
{
"id": "proj_abc123",
"organization_id": "org_def456",
"name": "Моя компания",
"description": "",
"timezone": "Europe/Moscow",
"settings": { "chat_enabled": false },
"retry_config": null,
"created_at": "2026-05-26T08:19:22Z",
"updated_at": "2026-10-19T12:27:53Z"
}
]
}

Токен проекта видит только один проект — тот, на который выдан. Токен профиля — все, доступные аккаунту.

Агенты​

Соответствует MCP-инструментам list_agents / get_agent / create_agent / update_agent / delete_agent / duplicate_agent.

Форма объекта:

{
"id": "agt_abc123",
"name": "Поддержка клиентов",
"description": "Отвечает на вопросы о заказе",
"organization_id": "org_def456",
"project_id": "proj_xyz789",
"agent_type": "text",
"role": "standalone",
"is_active": true,
"version": 1,
"created_at": "2026-10-15T10:22:33Z",
"updated_at": "2026-10-15T10:22:33Z",
"configuration": {
"text_config": {
"llm": { "model": "openai/gpt-4o-mini", "temperature": 0.3 }
}
},
"prompts": [
{ "name": "default", "content": "Ты — агент поддержки. Отвечай по базе знаний.", "is_active": true, "version": 1 }
],
"function_ids": [],
"workflow_ids": null,
"mcp_server_ids": null,
"sub_agent_ids": null
}

Поля для создания (create_agent): project_id, organization_id, name, instructions — обязательны. organization_id берётся из list_projects. Далее опционально model, description, agent_type (text/voice), role (standalone/orchestrator/specialist), temperature, function_ids, workflow_ids, mcp_server_ids, sub_agent_ids, configuration. Все id в списках инструментов обязаны принадлежать этому же проекту.

Правка (update_agent): те же поля, все опциональные, плюс is_active, плюс обязательный version — текущая версия агента из get_agent. Устаревшая version отклоняется, нужно заново получить агента. Списки инструментов при передаче — полная замена, [] отвязывает все.

Удаление (delete_agent) — агент пропадает из списков, но запись не стирается физически (мягкое удаление), с очисткой правил телефонии агента. Дублирование (duplicate_agent) — копия с конфигурацией и привязками в рамках того же проекта. ensure_agent_workflow — получить или создать обёрточный воркфлоу агента, возвращает {"workflow_id": "wf_abc123"}.

Воркфлоу​

Соответствует MCP-инструментам list_workflows / get_workflow / create_workflow / update_workflow / delete_workflow.

Создание (create_workflow): project_id, name обязательны, nodes, edges, description опциональны. nodes/edges — формат нод и связей, описанный в skill для сборки воркфлоу; без них создаётся пустой граф.

Правка (update_workflow): workflow_id, обязательный version (текущая версия из get_workflow), остальные поля опциональны. Переданные nodes/edges полностью заменяют хранившийся граф, а не дополняют его.

Черновик не виден в продакшне

Создание и правка воркфлоу через MCP меняют черновик. Чтобы изменения стали видны в продакшне, проект нужно отдельно опубликовать.

Функции​

Соответствует MCP-инструментам list_functions / get_function / create_function / update_function / delete_function.

Форма объекта:

{
"id": "fn_abc123",
"project_id": "proj_xyz789",
"organization_id": "org_def456",
"name": "calculate_discount",
"description": "",
"code": "const { amount } = context.input;\nreturn { discount: Math.round(amount * 0.1) };",
"parameters": "{}",
"timeout": 10,
"is_active": true,
"is_template": false,
"category": null,
"created_at": "2026-06-16T12:12:34Z",
"updated_at": "2026-10-15T12:17:50Z"
}

code — тело функции, без обёртки async function execute(){...}: платформа хранит только тело, а обёртку добавляет песочница при выполнении. parameters — JSON Schema входных параметров функции, передаётся строкой. timeout — от 1 до 60 секунд, по умолчанию 10. У функций, в отличие от агентов и воркфлоу, нет version — при правке не защищены от гонки одновременных изменений.

Запуски и трейсы (только чтение)​

Соответствует MCP-инструментам list_executions / get_execution / get_execution_trace / get_step_detail.

Форма элемента списка запусков:

{
"id": "exec_abc123",
"workflow_id": "wf_def456",
"workflow_name": "Обработка заявки",
"status": "completed",
"queued_at": "2026-10-27T09:00:00Z",
"started_at": "2026-10-27T09:00:02Z",
"completed_at": "2026-10-27T09:00:03Z",
"error": null,
"thread_id": "thread_abc",
"steps_total": 3,
"steps_completed": 3,
"steps_failed": 0,
"pending_approvals": 0
}

status: queued / running / completed / failed / cancelled. Один запуск (get_execution) дополняет эти поля входом, выходом, ошибкой и результатами по каждой ноде. Трейс сессии (get_execution_trace) — пошаговая лента по thread_id, результат ограничен проектом ключа даже если такой же thread_id встречается в чужом проекте. Детали шага (get_step_detail) — вход, выход, ошибка и состояние одного шага, плюс данные его родительского запуска.

Разбор ошибки запуска: get_execution(id) — увидеть error → get_execution_trace(thread_id) — найти упавший шаг → get_step_detail(step_id) — увидеть детали.

Организации и голосовые сессии​

Соответствует MCP-инструментам list_organizations (параметры — в разделе «Проект») и list_voice_sessions / get_voice_session / get_voice_session_events / get_voice_session_transcript (параметры — в разделе «Голосовые сессии»). Форма ответа list_organizations — список {id, name} плюс total, limit, offset.