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

Запуск агента

Пути указаны относительно /api/workspaces/{workspaceId}.

Метод Путь Что делает
POST /agents/{agentId}/run Отправить сообщение и получить ответ
GET /agents/{agentId}/thread Id вашего диалога с этим агентом
GET /conversations/ Ваши диалоги со всеми агентами, сначала новые
GET /conversations/{conversationId} Один диалог с сообщениями
Окно терминала
curl -X POST https://<host>/api/workspaces/{workspaceId}/agents/{agentId}/run \
-H "Authorization: Bearer $KATA_API_TOKEN" \
-H "Content-Type: application/json" \
-d '{ "message": "Кратко перескажи вчерашние обращения в поддержку", "stream": false }'

С "stream": false вызов ждёт полного ответа и возвращает JSON:

{ "conversationId": "3f1c…", "text": "Вчера было 14 обращений…" }

Без него ответ — поток server-sent events с ходом выполнения (текст, вызовы инструментов, подтверждения) в формате AG-UI, который читает useChat из TanStack AI. Id диалога — в заголовке ответа x-conversation-id.

Поле Примечания
message Текст сообщения
conversationId Продолжить существующий диалог; без него начнётся новый
stream false — один JSON-ответ

Из запроса берётся только новое сообщение. История всегда берётся из копии диалога, которую хранит Kata, — в ней могут быть запуски регулярных задач и заметки других ботов.

Все эти эндпоинты возвращают только ваши диалоги — вошедшего участника или участника, создавшего токен. Чужой диалог — это 404. У запроса, за которым не стоит человек (токен, создатель которого покинул пространство), диалогов нет, а GET /agents/{agentId}/thread возвращает 403.