Навыки в OpenAI API

О чём урок

Загружайте, управляйте и прикрепляйте многократно используемые навыки к размещенным средам. Навыки агента позволяют загружать и повторно использовать версионированные пакеты файлов как в размещенных, так и в локальных shell-средах. Полную справочную информацию см. в документации по навыкам. Навык — это многократно используемый пакет файлов (инструкции + скрипты + ресурсы), упакованный в папку и закрепленный обязательным манифестом SKILL.md. OpenAI копирует этот пакет в среду выполнения, чтобы модель могла читать инструкции и выполнять код по мере необходимости. В размещенном shell-окружении происходит следующее, когда вы прикрепляете навыки к среде инструмента shell (environment.type="container_auto"): Сервис загружает и распаковывает навыки в среду выполнения Сервис считывает метаданные SKILL.md (имя/описание), затем добавляет name, description и path каждого навыка в скрытый контекст системного prompt, что позволяет модели узнать о существовании навыка Если модель решает вызвать навык, она использует path для чтения SKILL.md, затем исследует файлы и выполняет скрипты с помощью инструмента shell Навыки предназначены для процедур: повторяющихся рабочих процессов, где важен способ выполнения (шаги, логика ветвления, правила форматирования, скрипты). Навыки полезны, когда вы хотите, чтобы ваша процедура: Повторно использовалась в различных prompt'ах/агентах Версионировалась и поставлялась независимо Вызывалась только при необходимости (а не была встроена в каждый системный prompt) Навыки особенно уместны и эффективны, когда… Вы хотите иметь многократно используемый, независимо версионируемый набор поведений. Примеры: «Процедура форматирования PowerPoint», «генератор отчетов для конкретной компании», «стандартный конвейер очистки данных». Ваш рабочий процесс сильно зависит от условий или ветвится, как сложная блок-схема. Пример: Если X → сделать это; иначе если Y → сделать то; плюс валидация + повторные попытки. Ваш рабочий процесс требует выполнения кода и локальных артефактов. Все, что выигрывает от скриптов, шаблонов, тестовых приспособлений или справочных ресурсов, которые должны находиться рядом с инструкциями. Навыки разработаны как zip-архив этих ресурсов. Вы хотите, чтобы системные prompt'ы оставались лаконичными. Помещайте стабильные процедуры в навыки; используйте системные prompt'ы для глобального поведения.

План урока

1. Что такое навык?
2. Когда использовать навыки
3. Навыки против инструментов против системных prompt'ов
4. Упаковка навыков: SKILL.md и структура папок
5. Структура папок
6. Метаданные SKILL.md
7. Создание навыков через API
8. Загрузка каталога или загрузка zip-архива