Запуск агента
Пути указаны относительно /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.