Создать сценарного агента

POST
/api/bot/flows/{flowId}/agents

Создаёт только сценарного агента — служебные агенты уже существуют виртуально (см. id: 0 выше) и создаются своим первым PATCH.

Сохранённое имя агента получает вид scenario_<name>. description читается логикой маршрутизации агента по умолчанию, чтобы решить, когда передавать диалог этому сценарию, и клиенту не показывается.

Сам по себе новый сценарий ничего не делает: агент по умолчанию узнаёт о его существовании только тогда, когда его prompt упоминает этот сценарий, — поэтому создание сценария стоит сопровождать PATCH промпта агента по умолчанию. При успехе записывается событие бота scenario_create.

Authorization

ApiKeyAuth
Authorization<token>

API-ключ интеграции со страницы бота Settings → API Keys, передаётся как есть, без префикса Bearer.

In: header

Path Parameters

flowId*integer

Id агента из GET /api/bot/flows.

Request Body

application/json

TypeScript Definitions

Use the request body type in TypeScript.

Response Body

application/json

application/json

application/json

application/json

application/json

application/json

curl -X POST "https://example.com/api/bot/flows/0/agents" \  -H "Content-Type: application/json" \  -d '{    "name": "string",    "description": "string",    "prompt": "string"  }'
{  "applied": true,  "scenario": {    "id": 0,    "name": "scenario_refunds",    "type": "default",    "enabled": true,    "prompt": "string",    "options": {}  }}