Примечание.
Для доступа к этой странице требуется авторизация. Вы можете попробовать войти или изменить каталоги.
Для доступа к этой странице требуется авторизация. Вы можете попробовать изменить каталоги.
Используйте средства разработчика Work IQ с локальным исходным кодом существующего декларативного агента для проверки, подготовки, упаковки и предоставления общего доступа в виде подключаемого модуля. Это краткое руководство начинается с существующего исходного проекта, а не с нового агента.
В этом пошаговом руководстве не создается новый агент и не восстанавливается исходный код из установленного агента. Если вместо этого вы запускаете новый плагин, следуйте инструкциям в Build a plugin with Work IQ Dev Tools.
Совет
Посмотрите, как средства разработчика Work IQ создают подключаемый модуль Copilot на основе запроса и публикуют его в магазине агентов в интерактивной демонстрации.
Необходимые условия
- Интерфейс командной строки GitHub Copilot с активной подпиской Copilot
- Плагин WIQD coding-помощник для GitHub Copilot CLI (см. команды установки в этом разделе)
- Node.js 24.15 или более поздней версии и npm, доступно на вашем
PATH, для интерфейса командной строки WIQD и скрипта установки - PowerShell 7 или более поздней версии (только для Windows)
- Учетная запись Microsoft 365 с доступом к Copilot
- Отправка пользовательского приложения включена в клиенте
- Поддерживаемый исходный проект декларативного агента
После установки GitHub Copilot интерфейса командной строки установите подключаемый модуль WIQD coding-помощник:
copilot plugin install wiqd@awesome-copilot
В качестве альтернативы добавьте маркетплейс WIQD и установите плагин оттуда:
copilot plugin marketplace add microsoft/wiqd
copilot plugin install wiqd@wiqd
Установите интерфейс командной строки WIQD с помощью сценария установки.
Запустите новый сеанс интерфейса командной строки GitHub Copilot после установки.
Подключаемый модуль code-помощник предоставляет руководство по разработке; он не устанавливает интерфейс командной строкиwiqd. Установите интерфейс командной строки отдельно перед выполнением команд проверки и управления жизненным циклом. Подтвердите установку wiqd --version CLI и проверьте, как проверить ее необходимые условия с помощью wiqd doctor.
Убедитесь, что у вас есть поддерживаемый начальный проект
Начните с корневой папки локального исходного проекта декларативного агента. Папка должна содержать как минимум:
contoso-support-agent/
|-- appPackage/
| |-- manifest.json
| |-- declarativeAgent.json
| `-- <the instruction and action files referenced by the manifests>
`-- <a supported lifecycle file>
Файл жизненного цикла может иметь вид m365agents.yml, m365agents.local.ymlteamsapp.yml, или teamsapp.local.yml. Проект может содержать другие папки и файлы среды.
Это краткое руководство не применяется, если:
- У вас есть только опубликованный агент или установленный пакет и нет локального исходного проекта. Средства разработчика Work IQ не поддерживают восстановление исходного проекта из развернутой игры. Восстановите исходный репозиторий исходного кода или используйте средство создания оригинала.
- Агент существует только в управляемом интерфейсе разработки, например Agent Builder или Copilot Studio. Используйте процедуру публикации и предоставления общего доступа к этому средству.
- У вас есть агент пользовательского движка. Этот маршрут средств разработки Work IQ поддерживает декларативные агенты.
- У вас есть только пакет
.zipагента. Для команд жизненного цикла требуется исходный проект и его файл жизненного цикла.
Если у вас нет существующего проекта, начните с краткого руководства по WIQD , чтобы создать подключаемый модуль и добавить декларативный агент. WIQD является рекомендуемой отправной точкой для разработки кода для поддерживаемых сценариев.
Примечание
wiqd plugin importимпортирует поддерживаемые форматы подключаемого модуля "Открыть", "Подключаемый модуль Claude" или "Курсор". Существующий проект или пакет декларативного агента Microsoft 365 не импортируется. Дополнительные сведения см. в статье "Импорт и экспорт (взаимодействие)".
Создайте свой плагин
Если вы еще этого не сделали, установите средства разработчика Work IQ.
Откройте интерфейс командной строки в каталоге, в котором вы хотите создать плагин, и выполните вход с помощью следующей команды:
wiqd auth login --interactiveВ интерфейсе командной строки запустите GitHub Copilot с помощью
copilotкоманды.Попросите GitHub Copilot создать подключаемый модуль с существующим декларативным агентом, навыком или сервером MCP. Например:
Create a plugin named My Plugin by using the agent in "..\My Agent"
Проверка проекта подключаемого модуля
Перед подготовкой или упаковкой подключаемого модуля явным образом выберите автономную проверку источника. В интерфейсе командной строки GitHub Copilot попросите следующее:
Validate the plugin source offline in the dev environment
Подготовка подключаемого модуля
Важно
В этом примере используется стандартная общая dev среда. Проверьте действующую конфигурацию жизненного цикла и выбранный файл среды в разделе environmentFolderPath (по умолчанию env) перед AGENT_SCOPE=shared подготовкой к совместному использованию. Среда, названная dev отдельно, не устанавливает общую область. Используйте одинаковую среду для подготовки, упаковки, проверки и общего доступа.
Попросите GitHub Copilot подготовить подключаемый модуль.
Provision the plugin using the dev environment
Дождитесь завершения подготовки. Подготовка не означает, что в Copilot Chat доступны все возможности подключаемого модуля; поддержка зависит от компонента и целевого интерфейса Microsoft 365.
Упаковка подключаемого модуля
Попросите GitHub Copilot упаковать подключаемый модуль.
Package the plugin using the dev environment
Важно
Перед упаковкой подключаемого модуля необходимо подготовить его. Если вы упакуете пакет до подготовки, результирующий пакет будет недопустимым.
Проверка пакета
После упаковки найдите созданный ZIP-файл и убедитесь, что он существует. В интерфейсе командной строки GitHub Copilot укажите его фактический путь и спросите:
Validate this existing plugin ZIP in package mode using the dev environment
Для проверки пакета используется --mode package и существующий ZIP-архив, предоставляемый через --package-file, а не автоматическая сборка. Просмотрите возвращенный вердикт и выводы. Код 0 выхода означает, что выбранные проверки пройдены; предупреждения по-прежнему могут выводиться. Блокировка результатов или неполные результаты не являются допустимыми, а проверка пакета не доказывает поведение во время выполнения.
Текущие режимы проверки: source, package, и marketplace.
sourceявляется явной автономной проверкой. Для использования по умолчанию packageтребуется существующий ZIP-архив, отправка захваченной копии в службу проверки Microsoft 365 и, возможно, проверка подлинности.
marketplace добавляет проверку политики и доказательств; Это не официальное одобрение магазина. Проверка не создает ZIP-архив автоматически, не выполняет вход в систему и не подготавливает подключаемый модуль автоматически. Дополнительные сведения см. в разделе Проверка и MVL.
Предоставление общего доступа к подключаемому модулю
Теперь вы можете попросить GitHub Copilot поделиться развертыванием вашего подключаемого модуля с определенными пользователями в организации или со всей организацией. Подтвердите в выбранной среде перед предоставлением общего AGENT_SCOPE=shared доступа. Аудитория общего доступа (--scope users--scope tenantили ) не меняет области развертывания.
Share the plugin with AmberR@contoso.com using the dev environment
Или:
Share the plugin with my organization using the dev environment
Важно
Предоставление общего доступа к настраиваемым подключаемым модулям зависит от параметров организации по предоставлению или запрету общего доступа к подключаемым модулям. Если на этом этапе у вас возникнут ошибки, проверьте, проверка у администраторов. Дополнительные сведения см. в статье "Параметры общего доступа к агенту и публикации".
Публикация подключаемого модуля в реестре подключаемых модулей организации
Вместо того чтобы предоставлять общий доступ к подключаемому модулю, вы можете запросить его публикацию в реестре подключаемых модулей вашей организации. Администраторы вашей организации могут просмотреть ваш подключаемый модуль и утвердить или отклонить запрос.
Submit my plugin to the organization catalog for admin approval using the dev environment
Совместное использование предоставляет прямой доступ; Отправка каталога — это отдельная операция, которая не утверждается администратором и не завершается установкой пользователем.
Удалите пакет (необязательно)
Если этот подключаемый модуль является просто тестовым, попросите GitHub Copilot удалить его. Это действие удаляет все подготовленные облачные ресурсы.
Delete the plugin using the dev environment