Навыки агента¶
Навык — это каталог с файлом SKILL.md, который содержит инструкции для модели по конкретному типу задач.
Koda Desktop автоматически обнаруживает навыки при старте сессии и передаёт агенту их имена и описания.
Когда запрос подходит под описание навыка, модель загружает его инструкции и следует им.
Общее устройство навыков описано в разделе Навыки
Там же приведены примеры и лучшие практики.
Расположение навыков¶
Koda Desktop сканирует несколько каталогов:
| Источник | Пути |
|---|---|
| Глобальные | ~/.kodacli/skills |
~/.agents/skills |
|
| Локальные (в проекте) | .kodacli/skills |
.koda/skills |
|
.agents/skills |
Глобальные навыки доступны во всех проектах, локальные — только в том проекте, где лежат. Если навыки с одинаковым именем есть в нескольких источниках, приоритет у локального.
Управлять навыками можно и через Koda CLI — например, установить навык из Git-репозитория командой koda skills install.
Подробности — в разделе Навыки агента документации CLI.
Включение навыков проекта¶
Локальными навыками проекта можно управлять прямо из чата. Если в проекте есть хотя бы один такой навык, над полем запроса появляется чип Навыки с количеством включённых навыков.
По клику на чип открывается список локальных навыков проекта с переключателями:
- включённый навык агент может активировать автоматически;
- выключенный навык не попадает в контекст агента.
Изменения сохраняются в файле .kodacli/settings.json в проекте:
Во время ответа агента переключение недоступно
Включать и выключать навыки можно после завершения ответа агента. Пока агент работает, чип остаётся неактивным.
Ограничение в режимах¶
В пользовательских режимах агента можно ограничить, какие навыки доступны агенту:
- Все навыки — агент использует любые доступные навыки;
- Выбрать вручную — можно включить только нужные навыки;
- Пользовательский навык — можно добавить навык, который не был обнаружен автоматически.
Подробности в разделе Пользовательские режимы — Навыки.
Ограничение в задачах по расписанию¶
Для задач по расписанию набор навыков ограничивается так же, как и в режимах: по умолчанию разрешены все, при необходимости только выбранные.
Это полезно для фоновых задач: например, задаче по проверке релизных заметок достаточно одного навыка, и лишние навыки не будут ей доступны.
Подробности в разделе Задачи по расписанию.