Навыки
Навыки принадлежат пространству. Навыки создаются в /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. Отключение не удаляет навык.