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

Агенты

Агент — это бот. Пути указаны относительно /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-5
  • anthropic/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. Бот становится её, по-прежнему личным. Разговоры и память ушедшего участника с ним остаются закрытыми.