Выбор средств разработки для подключаемого модуля

Во время подготовки преобразуйте выбранные возможности в план сборки. Начните с Work IQ Dev Tools для профессиональной разработки, выберите документированную среду и добавляйте набор средств агентов Microsoft 365 или пакет SDK только тогда, когда это требуется сценарию. У вас есть инструмент, расположение источника, владелец и необходимые условия для каждого компонента.

Чтобы внедрить возможности Copilot в собственное приложение, следуйте инструкциям в разделе "Создание приложений на платформе Copilot ".

Начало работы со средствами разработчика Work IQ

Work IQ Dev Tools — это путь по умолчанию для профессиональных разработчиков, поддерживаемых сценариев подключаемых модулей. Используйте его пошаговый рабочий процесс для создания и составления плагина, а затем его проверки, подготовки, упаковки и предоставления общего доступа. Используйте команды прямого интерфейса командной строки, когда требуется повторяемое выполнение или создание сценариев.

Выберите панель команд, которой принадлежит источник:

Источник и задача Начните отсюда Максимальное
Новый подключаемый модуль, содержащий поддерживаемые навыки, подключаемые соединители для удаленных серверов MCP или необязательный декларативный агент Создание подключаемого модуля с помощью WIQD wiqd plugin add agent подкладывает компонент агента; Существующий проект агента не импортируется.
Существующий исходный проект декларативного агента Жизненный цикл компонента агента Используйте документированный wiqd agent рабочий процесс для этого проекта.
Поддерживаемый источник подключаемого модуля Open, Claude plugin или Cursor Импорт и экспорт WIQD Преобразование формата не создает эквивалентное поведение среды выполнения или поддержку узла.
Протестированное общее развертывание для выбранных пользователей Создание подключаемого модуля с помощью WIQD Совместное использование предоставляет доступ; Это не отправка каталога организации.
Протестированный подключаемый модуль для каталога организации Публикация и существующие проекты wiqd plugin publish подается на утверждение администратора, а не на сертификацию общедоступного Marketplace.

Используйте явную проверку источника для автономных проверок. Режим проверки по умолчанию — проверка пакета в соответствии с существующим ZIP-архивом; Он может отправить пакет и потребовать проверку подлинности. Ни один из режимов не заменяет тестирование реальных возможностей в предполагаемом интерфейсе.

Выбор среды

В следующей таблице перечислены задокументированные маршруты WIQD. Это не исчерпывающая матрица совместимости:

Среда Используйте его для Настройка и ограничения
Интерфейс командной строки GitHub Copilot Управляемое создание плагинов с помощью плагина WIQD coding-помощник Установите узел и его подключаемый модуль WIQD Marketplace, затем начните новый сеанс. Подключаемый модуль Marketplace не устанавливает интерфейс командной строки WIQD.
Код Claude Управляемая разработка с помощью подключаемого модуля WIQD для этого узла Следуйте инструкциям по конкретному узлу магазина при установке WIQD.
Прямая командная строка Проверка и повторяющиеся команды жизненного цикла подключаемого модуля или агента Установите отдельный интерфейс командной строки. Путь сценария установки требует Node.js 24.15 или более поздней версии и npm; Для Windows требуется PowerShell 7 или более поздней версии.
Visual Studio Code Редактирование проекта и диагностика манифеста с помощью необязательного расширения WIQD Следите за установкой WIQD для интеграции с текущим редактором. Диагностика Редактора не заменяет проверку окончательного пакета.
Доверенные конвейеры CI/CD Операции подготовки, публикации и общего доступа с поддержкой ядра с учетом ограничений проверки подлинности выбранного выпуска Следуйте инструкциям плагина CI/CD и аутентификации конвейера. Примеры конвейера "агент-проект" не являются генератором конвейеров с поддержкой подключаемых модулей.

Для операций с локальным клиентом выполните интерактивный вход перед подготовкой. Для автоматизации используйте опубликованный контракт доверенного конвейера и секретное хранилище. Не запускайте интерактивный wiqd auth login режим в CI и не предоставляйте учетные данные недоверенным заданиям запроса на вытягивание. Проверка подлинности жизненного цикла ядра не проверяет подлинность запросов, оценок и других расширений Work IQ. Не применяйте текст команды "агент-проект" без изменений к проекту подключаемого модуля.

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

При необходимости добавляйте средства для конкретных компонентов

Используйте эти маршруты продуктов, если выбранный компонент нуждается в специальных элементах управления разработкой или проектом. Следуйте собственной процедуре, а не рассматривайте инструменты как взаимозаменяемые форматы пакетов.

Требования Передача инструмента или продукта
Низкоуровневое управление поддерживаемым проектом декларативного агента, манифестами и интеграциями Набор средств для агентов Microsoft 365 с использованием JSON или TypeSpec
Управляемый интерфейс разработки с декларативным агентом Агент Билдер; Использование собственной процедуры навыка для поддерживаемых навыков
Управляемые рабочие процессы, соединители Power Platform, среды и логика агента с минимумом программирования Copilot Studio; При необходимости используйте канал публикации Microsoft 365
Агент, основанный на выбранных сайтах или библиотеках документов SharePoint Рекомендации для агента SharePoint и руководство по обновлению для выбранного формата
Соединители навыков или плагинов для Copilot Cowork Создавайте плагины для Copilot Cowork с учетом требований к файлам, среде выполнения и тестированию для конкретного продукта
Соединитель Copilot (синхронизированный), который принимает внешнее содержимое в Microsoft Graph Создайте свой первый настраиваемый соединитель Copilot
Удаленное действие MCP в декларативном агенте Создание подключаемого модуля на основе сервера MCP

Agent Builder в Copilot Studio в настоящее время не поддерживает добавление навыков. Не делайте выводы о его наборе возможностей из отдельного интерфейса Agent Builder в Microsoft 365 Copilot. Автономные агенты Copilot Studio отображаются в реестре агентов, а не в подключаемых модулях.

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

Используйте пакет SDK в пути к приложению , если вам нужны собственные оркестровки, модели, размещение или среда выполнения. Не переносите разработку приложений пользовательского движка в рабочий процесс подключаемого модуля только потому, что он также использует службы Microsoft 365.

Запись плана сборки

Для каждого компонента запишите:

  • Задача, предполагаемый интерфейс и задокументированный формат компонента.
  • Независимо от того, создаете ли вы новый компонент, настраиваете существующий исходный код или используете рабочий процесс повторного использования для конкретного продукта.
  • Инструмент разработки, репозиторий исходного кода или управляемая среда, а также ответственный владелец.
  • Обязательные учетные записи, подписки, разрешения, службы и тестовые пользователи.
  • Инструмент, создающий артефакт, и метод распространения, который его принимает.
  • Тесты среды выполнения и доказательства, необходимые перед тестом пакета, &.

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

Следующий этап

Введите Build или повторно используйте с помощью Build или возможности повторного использования для вашего плагина. Чтобы создать новый плагин, следуйте Создайте плагин с помощью WIQD. Если у вас уже есть исходный код декларативного агента, следуйте инструкциям Упаковка существующего декларативного агента в качестве плагина.