Навыки агентов

Навыки агентов — это переиспользуемые пакеты инструкций, которые дают вашим ИИ-агентам специализированные возможности. Основанные на открытом формате Agent Skills, навыки позволяют захватывать предметную экспертизу, рабочие процессы и лучшие практики, которые агенты могут загружать по требованию.

Как работают навыки

Навыки используют прогрессивное раскрытие, чтобы сохранять контекст агента компактным:

1. Обнаружение — В системный промпт агента включаются только названия и описания навыков (~50-100 токенов каждый)
2. Активация — Когда агент решает, что навык релевантен, он вызывает инструмент load_skill для загрузки полных инструкций в контекст
3. Выполнение — Агент следует загруженным инструкциям для выполнения задачи

Это означает, что вы можете прикрепить много навыков к агенту без раздувания его контекстного окна. Агент загружает только то, что ему нужно.

Создание навыков

Перейдите в Настройки и выберите Навыки в разделе Инструменты.

Нажмите Добавить, чтобы создать новый навык с тремя полями:

Написание хорошего содержания навыка

Содержание навыка следует тем же соглашениям, что и файлы SKILL.md:

# SQL Expert

## When to use this skill
Use when the user asks you to write, optimize, or debug SQL queries.

## Instructions
1. Always ask which database engine (PostgreSQL, MySQL, SQLite)
2. Use CTEs over subqueries for readability
3. Add index recommendations when relevant
4. Explain query plans for optimization requests

## Common Patterns
...

Рекомендуемая структура:

• Когда использовать — Конкретные триггеры и сценарии
• Инструкции — Пошаговое руководство с нумерованными списками
• Примеры — Примеры ввода/вывода, показывающие ожидаемое поведение
• Общие шаблоны — Переиспользуемые подходы для частых задач
• Крайние случаи — Подводные камни и особые соображения

Держите навыки сфокусированными и менее 500 строк. Если навык становится слишком большим, разделите его на несколько специализированных навыков.

Добавление навыков к агенту

Откройте любой блок Агент и найдите выпадающий список Навыки ниже раздела инструментов. Выберите навыки, к которым вы хотите предоставить доступ агенту.

Выбранные навыки отображаются в виде карточек, которые можно нажать для редактирования или удаления.

Что происходит во время выполнения

Когда рабочий процесс запускается:

1. Системный промпт агента включает раздел <available_skills> со списком названий и описаний каждого навыка
2. Инструмент load_skill автоматически добавляется к доступным инструментам агента
3. Когда агент определяет, что навык релевантен текущей задаче, он вызывает load_skill с названием навыка
4. Полное содержание навыка возвращается как ответ инструмента, давая агенту подробные инструкции

Это работает со всеми поддерживаемыми провайдерами LLM — инструмент load_skill использует стандартный вызов инструментов, поэтому не требуется никакой специфичной для провайдера конфигурации.

Общие случаи использования

Навыки наиболее ценны, когда агентам нужны специализированные знания или многошаговые рабочие процессы:

Предметная экспертиза

• api-integration-expert — Лучшие практики для вызова конкретных API (аутентификация, ограничение частоты запросов, обработка ошибок)
• data-transformation — Шаблоны ETL, очистка данных и правила валидации
• code-reviewer — Руководства по ревью кода, специфичные для стандартов вашей команды

Шаблоны рабочих процессов

• bug-investigation — Пошаговая методология отладки (воспроизвести → изолировать → протестировать → исправить)
• feature-implementation — Рабочий процесс разработки от требований до развертывания
• document-generator — Шаблоны и правила форматирования для технической документации

Специфичные для компании знания

• our-architecture — Диаграммы архитектуры системы, зависимости сервисов и процессы развертывания
• style-guide — Руководства по бренду, тон письма, шаблоны UI/UX
• customer-onboarding — Стандартные процедуры и общие вопросы клиентов

Когда использовать навыки vs. инструкции агента:

• Используйте навыки для знаний, которые применяются в нескольких рабочих процессах или часто меняются
• Используйте инструкции агента для контекста, специфичного для задачи, который уникален для одного агента

Лучшие практики

Написание эффективных описаний

• Будьте конкретны и используйте ключевые слова — Вместо "Помогает с SQL" напишите "Пишите оптимизированные SQL-запросы для PostgreSQL, MySQL и SQLite, включая рекомендации по индексам и анализ планов запросов"
• Включайте триггеры активации — Упоминайте конкретные слова или фразы, которые должны запускать навык (например, "Используйте, когда пользователь упоминает PDF, формы или извлечение документов")
• Держите до 200 слов — Агенты быстро сканируют описания; пусть каждое слово имеет значение

Область действия и организация навыков

• Один навык на домен — Сфокусированный навык sql-expert работает лучше, чем широкий навык database-everything
• Ограничьте 5-10 навыками на агента — Больше навыков = больше накладных расходов на принятие решений; начните с малого и добавляйте по мере необходимости
• Разделяйте большие навыки — Если навык превышает 500 строк, разбейте его на сфокусированные под-навыки

Структура содержания

• Используйте форматирование markdown — Заголовки, списки и блоки кода помогают агентам анализировать и следовать инструкциям
• Предоставляйте примеры — Показывайте пары ввода/вывода, чтобы агенты понимали ожидаемое поведение
• Будьте явны в отношении крайних случаев — Не предполагайте, что агенты будут выводить специальную обработку

Тестирование и итерация

• Тестируйте активацию — Запустите ваш рабочий процесс и проверьте, что агент загружает навык, когда ожидается
• Проверяйте ложные срабатывания — Убедитесь, что навыки не активируются, когда не должны
• Уточняйте описания — Если навык не загружается, когда нужен, добавьте больше ключевых слов в описание

Узнать больше

• Спецификация Agent Skills — Открытый формат для портативных навыков агентов
• Примеры навыков — Просмотрите примеры навыков сообщества
• Лучшие практики — Написание эффективных навыков