Агенты
Агент — это бот. Пути указаны относительно /api/workspaces/{workspaceId}.
| Метод | Путь | Что делает |
|---|---|---|
GET |
/agents/ |
Список агентов, сначала недавно активные |
POST |
/agents/ |
Создать агента |
GET |
/agents/{agentId} |
Прочитать одного агента |
PATCH |
/agents/{agentId} |
Изменить переданные поля |
DELETE |
/agents/{agentId} |
Удалить агента вместе с его диалогами |
POST |
/agents/{agentId}/takeover |
Забрать личного бота ушедшего участника |
Создать агента
Заголовок раздела «Создать агента»curl -X POST https://<host>/api/workspaces/{workspaceId}/agents/ \ -H "Authorization: Bearer $KATA_API_TOKEN" \ -H "Content-Type: application/json" \ -d '{ "name": "Пульс блога", "title": "Каждый день просматривает сайт", "instructions": "Ты — ежедневный обозреватель нашего блога...", "skillAuthoring": "own" }'| Поле | Обязательное | Примечания |
|---|---|---|
name |
да | |
title |
нет | Описание в одну строку под именем |
instructions |
нет | Системный промпт бота |
model |
нет | По умолчанию auto; см. ниже |
skillAuthoring |
нет | workspace (по умолчанию), own или off — см. Навыки |
avatar |
нет | Лицо в виде shape/color, например squircle/#0a84ff; если не указано, подбирается автоматически |
visibility |
нет | workspace или private; см. ниже |
Возвращает 201 с созданным агентом, включая его id.
Изменить агента
Заголовок раздела «Изменить агента»PATCH принимает любые поля из таблицы выше, а также:
pinned: true | false— закрепить вверху списка (закрепление возвращает из архива).archived: true | false— отправить в архив или вернуть (архивация снимает закрепление).avatar: ""— сбросить выбранное лицо.
При удалении агента навыки и инструменты пространства остаются на месте: у агента были только ссылки на них.
model — это auto или одно из значений:
openai/gpt-6-luna,openai/gpt-6-sol,openai/gpt-5.6-luna,openai/gpt-5.4-nano,openai/gpt-5.4-mini,openai/gpt-5.2,openai/gpt-5.1,openai/gpt-5anthropic/claude-opus-4-8,anthropic/claude-opus-4-7,anthropic/claude-sonnet-4-6,anthropic/claude-haiku-4-5
Неизвестное значение возвращает 400 со списком допустимых.
Кто видит бота
Заголовок раздела «Кто видит бота»visibility — workspace (бота видят и с ним говорят все участники) или
private (только создатель; больше никто, включая владельца и администраторов).
Чтобы открыть бота всему пространству, нужно разрешение bot: publish; новый бот
получает workspace, если оно у вызывающего есть, и private, если нет. Чужой
личный бот везде отвечает 404.
Когда создатель личного бота покидает пространство, роль с bot: edit видит
бота в списке с "orphaned": true и может вызвать
POST /agents/{agentId}/takeover. Бот становится её, по-прежнему личным.
Разговоры и память ушедшего участника с ним остаются закрытыми.