Навыки работы с декларативными агентами

В этой статье рассматриваются навыки, связанные с декларативным агентом. Сведения о создании навыка для использования непосредственно в Microsoft 365 Copilot Chat без создания агента см. в статье "Развитие навыков для Copilot Chat". Таблица поддержки в этой статье относится к навыкам уровня агента, а не ко всем навыкам или пакетам плагинов.

Важно

В клиентах, использующих информационные барьеры Microsoft Purview (IB), администраторы могут развертывать декларативные агенты с навыками, но конечные пользователи не могут добавлять навыки к создаваемым ими декларативным агентам.

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

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

Вы можете добавить навыки в декларативный агент с помощью построителя агентов. Для поддерживаемых сценариев с использованием программного обеспечения рекомендуется Work IQ Dev Tools . Для его wiqd agent add skill маршрута agent-skills требуется флаг функции, который по умолчанию отключен; см. Выберите путь реализации навыка. Пошаговое руководство на основе Toolkit остается доступным для существующих проектов Toolkit.

Что такое навык

Навык — это каталог со следующим содержимым:

  • Обязательный SKILL.md файл, который содержит:
    • Название и описание навыка в передней части YAML.
    • инструкции по обучению, длина которых не должна превышать 20 000 символов;
  • Необязательные файлы ресурсов, такие как шаблоны, справочные данные или определения.
  • Необязательные сценарии и вспомогательные папки.

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

Зачем использовать навыки в декларативных агентах

С помощью навыков вы можете создавать более надежные и повторяющиеся рабочие процессы агентов:

  • Оптимизировано использование контекста и повышена точность. Навыки используют прогрессивное раскрытие информации: модель загружает инструкции и содержание навыка в контекст только тогда, когда этого требует задача. Контекст агента остается сфокусированным, даже когда его библиотека навыков растет. Предоставление сценариев, а не использование кода, сгенерированного моделью, также обеспечивает большую повторяемость рабочих процессов.
  • Масштабирование инструкций без потери качества. Сложные инструкции можно разложить на модульные, многократно используемые навыки. Этот подход позволяет предоставлять более длинные и конкретные руководства, не ухудшая качество выполнения инструкций и не ограничиваясь 8000 символов в инструкциях декларативного агента.
  • Упаковка повторно используемых ресурсов. Вы можете упаковать инструкции, ресурсы и сценарии вместе в навык и интегрировать эту возможность в декларативный агент.
  • Корпоративная готовность. Сценарии выполняются в безопасной песочнице, метки конфиденциальности в файлах навыков сохраняются и учитываются, а администраторы могут управлять ими.

Матрица поддержки

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

В следующей таблице описаны эти два пути разработки, а не ограничения WIQD или охват функций. Для рекомендуемого пути pro-code подтвердите текущие требования в документации WIQD.

Элемент Построитель агентов Набор средств для агентов
Максимальное количество навыков на одного оператора 8 8
Пакет навыков Сжатый .zip, максимум 50 МБ Каталог навыков; .zip не поддерживается
Максимальный размер файла 25 МБ на файл Нет ограничений по уровню навыков; размер полного пакета приложения ограничен 10 МБ
Максимальное количество файлов в пакете 350 файлов для всех навыков 350 файлов для всех навыков
Формирование навыка на основе отдельных отправленных файлов Не поддерживается; Отправить все .zip Добавление или импорт полного каталога навыков
Иерархия каталогов Максимальная глубина каталога — 3 Максимальная глубина каталога — 3
Повторное использование между агентами Не поддерживается Не поддерживается

Поддерживаемые типы файлов и сценариев

Навык может включать следующие типы файлов:

Категория Типы файлов
Файлы инструкций и ресурсов .json, .xml, .yaml, .yml, .ini, .config, .utf8, .docx, .doc, .docm, .pdf, .txt, .rtf, .md, .ppt, .pptx, .ppsm, .xlsx, .xls, .xlsm, .csv, .tsv, .html, .htm, .png, .jpg, .jpeg, .gif, .bmp, .log
Сценарии и двоичные файлы .py, .js, .mjs, .cjs, .ts, .mts, .sh, .bash

Песочница выполнения скриптов

Скрипты навыков выполняются в безопасной песочнице со следующими ограничениями:

Возможность Поддержка
Доступ к Интернету или сети из скриптов Песочница не имеет доступа к сети во время выполнения, кроме как во время использования браузера.
Установка пакета Не поддерживаются. Навык не может устанавливать пакеты во время выполнения.
Аутентифицированные сетевые вызовы из сценариев Не поддерживаются.
Предустановленные пакеты и средства Навык может использовать только пакеты и инструменты, уже присутствующие в песочнице. См. раздел "Доступные пакеты и средства".
Соединители, подключаемые модули API и серверы MCP Агент может использовать включенные возможности через оркестратор. Сценарии не могут вызвать их через песочницу.

Доступные пакеты и средства

Те же песочницы и инвентаризация пакетов применяются к навыкам, прикрепленным к декларативным агентам, и навыкам, используемым непосредственно в Copilot Chat. Обновления служб могут изменять доступность и версии пакетов.

Категория Пакеты и инструменты
Документы и электронные таблицы python-docx, , python-pptx, openpyxl, docxxlsxwriter, ; pptxgenjs LibreOffice, Pandoc
Обработка PDF-файлов pypdf, , pymupdf, pdfplumber, pdf-libreportlab, ; pdfjs-dist Poppler (pdftotext, pdfinfo, ), pdftoppmGhostscript
Анализ данных numpy, pandas, scipy, scikit-learn
Построение диаграмм matplotlib, plotly, seaborn
Обработка изображений и векторов pillow, sharp; ImageMagick, Inkscape
Распознавание текста pytesseract, ocrmypdf; Тессеракт
Обработка звука и видео FFmpeg
Генерация документов LaTeX TeX Live (pdflatex, latexmk)
Обработка JSON jq
Инструменты разработчика TypeScript, ts-node, компоненты Jupyter, Playwright

Чувствительность и память

Элемент Поддержка
Метки конфиденциальности В песочнице сохраняются метки конфиденциальности и соблюдаются политики меток. Она не поддерживает определяемые пользователем разрешения или шифрование с двойным ключом.
Хранилище Система хранит загруженные файлы навыков в контейнерах SharePoint Embedded на уровне клиента.