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

Навыки

Навыки принадлежат пространству. Навыки создаются в /skills, а подключаются к агенту в /agents/{agentId}/skills. Пути указаны относительно /api/workspaces/{workspaceId}.

Метод Путь Что делает
GET /skills/ Список навыков
POST /skills/ Создать навык
GET /skills/{skillId} Прочитать один
PATCH /skills/{skillId} Изменить
DELETE /skills/{skillId} Удалить
GET /skills/{skillId}/references/ Список материалов
POST /skills/{skillId}/references/ Добавить материал
PATCH /skills/{skillId}/references/{referenceId} Изменить материал
DELETE /skills/{skillId}/references/{referenceId} Удалить материал
Окно терминала
curl -X POST https://<host>/api/workspaces/{workspaceId}/skills/ \
-H "Authorization: Bearer $KATA_API_TOKEN" \
-H "Content-Type: application/json" \
-d '{
"name": "monthly-close",
"description": "Как готовить закрытие месяца. Применяй, когда просят закрыть месяц.",
"content": "1. Выгрузи журнал...\n2. Сверь...\n3. Отчитайся..."
}'
  • name: строчные латинские буквы, цифры и одиночные дефисы, не больше 64 символов, уникальное в пространстве.
  • description: обязательно, не больше 1024 символов, без XML-тегов.
  • content: обязательно, Markdown.

Материал принимает name, content и необязательный description. Агент читает его как references/<name>.md, когда навык на него ссылается.

Метод Путь Что делает
GET /agents/{agentId}/skills/ Навыки этого агента
POST /agents/{agentId}/skills/ Подключить: { "skillId": "…" }
DELETE /agents/{agentId}/skills/{skillId} Отключить

Подключение и отключение возвращают 204. Отключение не удаляет навык.