Добавление навыков

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

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

Когда это следует использовать

Добавить навыки вашему агенту, когда:

  • У вас есть кластер связанных знаний — инструкции, справочные документы и скрипты, которые логически относятся вместе (например, "отчеты о расходах" или "рекомендации по проверке кода").
  • Для нескольких агентов требуется один и тот же опыт в области домена, и требуется один источник истины, а не повторяющиеся инструкции.
  • Вы хотите совместно использовать и распространять возможности агента между командами, проектами или организациями в виде автономных пакетов.
  • Вам нужно эффективно управлять контекстом — навыки используют прогрессивное раскрытие информации, чтобы агенты загружали только необходимые сведения, когда они нуждаются.

Рекомендации

Consideration Сведения
Повторное использование Навык — это автономный пакет. После создания любой агент может взять его — без копирования и вставки, и без расхождений между копиями.
Эффективность контекста Навыки используют прогрессивное раскрытие: агент видит краткое описание (~100 токенов) и загружает полные инструкции только в том случае, если это необходимо. Это позволяет сократить окно контекста, когда навык не требуется.
Стоимость абстракции Навыки добавляют слой абстракции над инструментами. Для одного автономного инструмента функции добавление оболочки навыка является ненужной тратой ресурсов.
Усилия по проектированию Вам нужно подумать о границах навыка заранее: что принадлежит внутри навыка и что остается вне. Неопределенные границы приводят к навыкам, которые слишком широки (теряется контекст) или слишком узкие (потеря преимущества объединения).

Как навыки отличаются от инструментов

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

Средство — это одно вызываемое действие — одна функция с именем, описанием и схемой параметров. Когда модель решит, что требуется инструмент, он создает структурированный вызов, Агент Framework выполняет его, и результат возвращается к модели. Инструменты — это атомы поведения агента.

Навык — это пакет знаний в области. Он может включать в себя:

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

Ключевое различие является одной из областей: средство дает агенту возможность выполнять одно действие; навык дает агенту знания и ресурсы для обработки всего домена.

инструмент Skill
Что он предоставляет Одно вызываемое действие Инструкции и справочные материалы + необязательные скрипты
Как агент использует его Вызывает функцию, когда нужно выполнить действие Загружает его при возникновении соответствующей задачи, считывает инструкции и может вызывать скрипты или обращаться к ресурсам
Контекстные затраты Схема инструментов всегда находится в запросе В запросе находятся только имя и описание навыка (~100 маркеров); полное содержимое загружается по запросу
Портативность Привязанный к агенту, который регистрирует его Автономный пакет, который может обнаружить любой совместимый агент
лучше всего подходит для Отдельные действия (запрос базы данных, отправка сообщения электронной почты) Опыт в области (политики расходов, рекомендации по проверке кода, процедуры подключения)

Tip

Думайте о средствах как глаголы (поиск, книга, проверка) и навыки как опыт (знания о резервировании путешествий, знания о политике расходов). Агент использует средства для действий и навыков, чтобы узнать, как действовать.

Как работают навыки: прогрессивное раскрытие информации

Навыки предназначены для эффективного использования в контексте. Вместо того, чтобы внедрить все в запрос заранее, навыки используют трехэтапный шаблон:

┌──────────────────────────────────────────────────────────────────┐
│  Stage 1: Advertise                                              │
│  Agent sees skill names and descriptions (~100 tokens each)      │
│  in its system prompt at the start of every run.                 │
└──────────────┬───────────────────────────────────────────────────┘
               ▼ (task matches a skill's domain)
┌──────────────────────────────────────────────────────────────────┐
│  Stage 2: Load                                                   │
│  Agent calls load_skill to get the full instructions             │
│  (< 5000 tokens recommended).                                   │
└──────────────┬───────────────────────────────────────────────────┘
               ▼ (agent needs more detail)
┌──────────────────────────────────────────────────────────────────┐
│  Stage 3: Read resources                                         │
│  Agent calls read_skill_resource to fetch supplementary files    │
│  (FAQs, templates, reference docs) only when needed.            │
└──────────────────────────────────────────────────────────────────┘

Этот паттерн означает, что агент с 10 зарегистрированными навыками платит примерно 1000 токенов контекстных накладных расходов, а не 50 000. Агент только углубляет свои знания, когда текущая задача требует ее.

Кроме того, умения строятся на основе инфраструктуры инструментов. Agent Framework объявляет доступные навыки в системном запросе агента, а затем предоставляет load_skill и read_skill_resource в качестве вызовов средства, которые агент вызывает для постепенной загрузки содержимого.

Tip

Полные сведения о структуре навыка, настройке и примерах кода см. в справочнике по навыкам агента .

Когда использовать навыки и когда — другие шаблоны

По мере того как ваш агент становится более способным, у вас есть несколько способов упорядочить его поведение. Вот как навыки сравниваются с инструментами:

Рисунок лучше всего подходит для Example
Отдельные инструменты Одноуровневые действия, которые не нуждаются в общем контексте get_weather Инструмент для функций
Навыки Экспертные знания в области с инструкциями, ссылками и опциональными скриптами Навык "отчёт о расходах" с документами политики, скриптами валидации и пошаговыми инструкциями по отправке

Распространенные ловушки

Ловушка Рекомендации
Чрезмерно широкие навыки Навык под названием "все о финансах", который пытается охватить учет, налоги, отчеты о расходах и заработную плату, будет иметь слишком длинные и нефокусированные инструкции. Сохраняйте навыки, ориентированные на один домен.
Пропуск проверки безопасности Инструкции по навыку внедряются в контекст агента и скрипты выполняют код. Относитесь к навыкам как к сторонним зависимостям — их следует просмотреть перед развертыванием. Ознакомьтесь с рекомендациями по обеспечению безопасности в справочнике по навыкам.
Игнорировать прогрессивное раскрытие информации Если ваш SKILL.md составляет 2000 строк, агент сталкивается с значительными контекстными затратами при загрузке навыка. Следуйте кратким инструкциям и переместите подробные справочные материалы в отдельные файлы ресурсов, чтобы воспользоваться полными преимуществами прогрессивного раскрытия информации.

Дальнейшие действия

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

Добавление промежуточного программного обеспечения

Вернитесь глубже:

  • Last updated on