Навыки: расширяем возможности агентов
Что такое навык в AgentHere, как устроен формат SKILL.md и чем навыки отличаются от системного промпта.
Навык (skill) — это Markdown-инструкция, которая добавляется к агенту и учит его конкретной задаче. Навыки — основной способ расширять возможности за пределы базового системного промпта.
Навык против системного промпта
Системный промпт задаёт общую роль агента. Навыки — это модульные «умения», которые можно включать и выключать. Представьте агента как сотрудника: промпт — его должность, а навыки — освоенные им процедуры.
| Системный промпт | Навык | |
|---|---|---|
| Назначение | Роль и тон | Конкретная задача |
| Количество | Один на агента | Несколько |
| Источник | Пишете вы | Свои или из маркетплейса |
| Управление | В конфигураторе | Включается/выключается отдельно |
Формат SKILL.md
Навык — это файл SKILL.md с YAML-заголовком и телом-инструкцией:
---
name: meeting-summary
description: Конспектирует встречи в структурированные итоги
---
# Итоги встречи
1. Собери ключевые решения и договорённости.
2. Выдели ответственных и сроки.
3. Верни результат таблицей: пункт · ответственный · срок.Поле name обязано соответствовать шаблону ^[a-z0-9][a-z0-9\-]*[a-z0-9]$ — строчные буквы,
цифры и дефисы. Тело — пошаговая инструкция, которой следует агент.
Ресурсы и переменные
Навык может включать дополнительные файлы (ресурсы) и переменные окружения:
- Ресурсы — справочники, шаблоны, базы знаний (например, таблица продуктов для навыка планирования меню).
- Переменные — секреты и настройки (например, API-ключи), которые заполняются при установке.
Два уровня навыков
- Навыки агента — добавляются конкретному агенту и редактируются прямо у него.
- Навыки маркетплейса — публикуются отдельно, устанавливаются в любого агента, имеют версии, оценки и комментарии.
Как устанавливать готовые навыки — в «Установка и использование навыков». Как создавать свои — в «Создание и публикация навыка».