Развитие и повторное использование навыков

Если у вас есть повторяющаяся задача и целевой опыт Майкрософт, воспользуйтесь этой статьей, чтобы решить, следует ли создать навык или адаптировать существующее содержимое навыка. Затем выберите шаги разработки продукта. Вы находитесь в разделе "Сборка или повторное использование". Результатом является реализация навыка с его зависимостями и тестовыми доказательствами, готовая к интеграции до тестирования пакета &.

Повторное использование или расширение навыка

Для декларативных агентов Agent Builder и Agents Toolkit не поддерживают повторное использование между агентами. Следуйте матрице поддержки в разделе Навыки в декларативных агентах; Не думайте, что навык, прикрепленный к одному агенту, можно использовать совместно с другим.

Перед созданием навыка:

  1. Просмотрите утвержденные навыки, которые уже выполняют необходимую работу.
  2. Убедитесь, что целевой агент или интерфейс Майкрософт поддерживает формат и возможности навыка.
  3. Просмотрите инструкции, ресурсы, сценарии, инструменты и доступ к данным.
  4. Проверяйте задокументированные ограничения на повторное использование целевого интерфейса, прежде чем адаптировать существующий контент навыка.
  5. Подтвердите право владения, управление версиями, общий доступ, поддержку и обновите ожидания.
  6. Протестируйте навык с помощью репрезентативных входных данных и ожидаемых результатов.

Создавайте новый навык, если существующий утвержденный навык не соответствует требуемому требованию или целевой опыт не поддерживает повторное использование.

Выбор пути реализации

Начните с Work IQ Dev Tools для профессионального развития. Выберите маршрут для вашего целевого опыта и тип проекта; Общий SKILL.md формат не устанавливает право на повторное использование или публикацию между агентами.

Подход к разработке Артефакт навыка и области действия Начать с
Средства разработчика Work IQ Папка навыка верхнего уровня в автономном плагине или навык, добавленный в существующий проект декларативного агента. Это отдельные пути разработки. Создайте плагин с помощью средств разработчика Work IQ и сведений о маршруте ниже
Навык создания Copilot Chat и распространение плагинов Следуйте указаниям по разработке и распространению для конкретного продукта. Развитие навыков для Copilot Chat
Построитель агентов ZIP-файл полного навыка, загруженный в декларативный агент, или навык, созданный из описания в Agent Builder. Добавление навыков с помощью Agent Builder
Набор средств для агентов Microsoft 365 Каталог навыков, добавленный в существующий проект декларативного агента, а не отдельный ZIP-архив навыка. Добавление навыков с помощью набора средств агентов
Copilot Cowork Папки навыков, зарегистрированные в пакете приложения Microsoft 365. Используйте требования и ограничения для пакета Cowork. Создание плагинов для Copilot Cowork

Сопоставление артефакта с маршрутом публикации

Следуйте инструкциям по публикации артефакта.

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

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

Средства разработчика Work IQ

WIQD предлагает два разных пути создания навыков.

  • wiqd plugin add skill Добавляет навык высшего уровня в отдельный проект плагина. Подключаемый модуль может быть только навыком или комбинировать навык с поддерживаемыми агентами или удаленными соединителями MCP. Отдельно уточните поддержку целевого продукта.
  • wiqd agent add skill Добавляет навык в существующий проект декларативного агента. В этом маршруте agent-skills используется флаг функции, который по умолчанию отключен.

Оба пути создают SKILL.mdвозможность на основе -, но они работают с разными типами проектов. В формате плагина WIQD имя навыка должно совпадать с именем его папки, а его описание должно включать фразы, которые его активируют. См. раздел Что такое плагин? и справочник по разработке плагина.

Проверка источника WIQD (wiqd plugin validate --mode source) не проверяет содержимое навыка. После упаковки запустите wiqd plugin validate --mode package --package-file "<path-to-existing-zip>" по фактическому пути ZIP. При проверке пакета в службу проверки Microsoft 365 загружается захваченная копия этого ZIP-файла, может потребоваться пройти проверку подлинности. Ознакомиться с полученными результатами; Проход не устанавливает поведение среды выполнения. См. Проверка и MVL.

Реализация навыка

Выполните соответствующую работу:

  1. Определите задание, входные данные, ожидаемые результаты, границы и критерии успеха.
  2. Создайте или импортируйте инструкции по навыку.
  3. Добавьте необходимые вспомогательные ресурсы и сценарии.
  4. Настройте любой необходимый инструмент, удаленный сервер MCP, API, удостоверение, разрешение или зависимость данных.
  5. Проверьте поддерживаемые типы файлов, типы сценариев, поведение песочницы, хранилище и требования к конфиденциальности.
  6. Тестируйте ожидаемые, неоднозначные, неподдерживаемые сценарии и сценарии сбоя.
  7. Запишите версию навыка, владельца, зависимости, известные ограничения и процесс поддержки.

Сведения о навыках, используемых непосредственно в Copilot Chat, см. в статье "Развитие навыков для Copilot Chat". Сведения о текущих ограничениях поддержки и времени выполнения в декларативных агентах см. в статье Навыки декларативных агентов. Сведения о Copilot Cowork см. в разделе "Ограничения на вспомогательные файлы". Применяйте требования каждого целевого узла, когда вы распространяете навык на несколько опытов.

Убедитесь, что навык работает

Навык готов к интеграции в следующих случаях:

  • Целевой агент или процесс могут загружаться и использовать его.
  • Его инструкции последовательно выполняют заданную задачу.
  • Необходимые ресурсы, скрипты, инструменты и данные доступны.
  • Разрешения и внешние зависимости работают в среде разработки или тестирования.
  • Неподдерживаемые или неудачные операции приводят к понятному поведению.
  • Записываются сведения о владении, управлении версиями, ограничениях и доказательствах тестирования.

Продолжите работу с любыми другими компонентами плана. Когда они будут готовы, интегрируйте и протестируйте свои компоненты, а затем перейдите в Package & test , чтобы создать пакет плагина.