Примечание.
Для доступа к этой странице требуется авторизация. Вы можете попробовать войти или изменить каталоги.
Для доступа к этой странице требуется авторизация. Вы можете попробовать изменить каталоги.
В этой статье рассматриваются навыки, связанные с декларативным агентом. Сведения о создании навыка для использования непосредственно в 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 на уровне клиента. |