Протестируйте компоненты подключаемого модуля вместе

Проверьте, что содержит или ссылается ваш пакет подключаемого модуля: навыки, удаленные соединители MCP и декларативный агент, если он включен. Эта задача тестирования пакетов & устанавливает поведение и интеграцию компонента перед созданием артефакта выпуска. Затем следуют окончательные проверки пакета, установки и опыта выпуска в разделе Проверьте и подтвердите подключаемый модуль. Выберите тесты для компонентов, заведите запись тестов и завершите их выполнение Перед упаковкой.

Выбор тестов

Проверка компонентов в интегрированном сценарии

В подключаемом модуле Протестируйте с помощью Часть
Навыки уровня подключаемого модуля с агентом или без него Сеанс разработки Cowork; поддерживаемый выбор навыка Chat Проверка навыков
Соединители плагинов, указывающие на удаленные серверы MCP Инспектор, то та же задача через плагин в Cowork Тестирование удаленных разъемов MCP
Декларативный агент, если он включен Средства разработчика Work IQ Запрос команды и DevUI Проверка включенного декларативного агента
Зависимости, используемые решением Диагностика разъема, затем повторите интегрированную задачу Проверка зависимостей

Узнайте, какой соединитель вы проверяете

  • Соединитель плагина: Запись манифеста agentConnectors[] приложения. В этой статье тестируется удаленный тип MCP: пакет ссылается на сервер; Он не содержит запущенную службу.
  • Соединитель Copilot (синхронизировано): Принимает знания в Microsoft Graph. Проверьте его прием и последующее извлечение в качестве зависимостей.
  • Соединитель Copilot (федеративный): Извлекает данные в режиме реального времени с помощью подключенного удостоверения. Протестируйте динамический доступ отдельно от приема.
  • Соединитель Power Platform: Инструмент Copilot Studio. При его тестировании не было установлено, что его агент является подключаемым модулем реестра.

В справочнике по разработке плагинов также задокументирован явный маршрут для существующих ссылок на настраиваемые соединители OpenAPI. Используйте требования этого маршрута, если это применимо; процедура MCP, описанная в этой статье, не проверяет этот тип разъема.

Как судить результат

Проверьте каждый компонент независимо, а затем запустите задачу, использующую эти компоненты вместе. Успешный прямой вызов службы устанавливает поведение сервера. Интегрированная задача устанавливает выбор, ввод, проверку подлинности и использование возвращаемых данных.

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

Компонент или утверждение Доказательства, которые нужно хранить
Выбор навыков и поведение Хранение свидетельств, идентифицирующих выбранный или загруженный навык, а также необходимые выходные данные и файлы. На боковой панели CoworkSkills определяет загруженные навыки. Явный выбор не устанавливает автоматический вызов.
Удаленный вызов MCP Журналы служб, прошедших проверку подлинности, коррелировали с запросом узла, определяя операцию, входные данные и результат. Прямой вызов инспектора не устанавливает вызов через плагин.
Включенный агент Развернутый идентификатор агента, запрос и ответ, а также доступные возможности: выбор, извлечение и диагностика цитирования. Одна только диагностика агента не устанавливает вызов каждого включенного навыка или сценария.
Выполнение сценария навыка Диагностика выполнения при воздействии. Обязательные выходные файлы устанавливают результат вывода, а не доказательство того, что конкретный сценарий был запущен. Если выполнение этого сценария является требованием к выпуску, получите доказательства, подтверждающие это.
  • Оценивайте правильность ответа отдельно от доказательств призыва. Агент может создавать правдоподобные заметки о выпуске, не загружая ваш навык.
  • Отсутствуют доказательства для необходимой проверки Не проверено и блокирует готовность. Не ослабляйте требуемую проверку, так как диагностика недоступна.
  • Если узел не предоставляет дополнительные сведения диагностики, запишите это ограничение, не утверждая, что данные были проверены. Недоступная диагностика не является отдельным блокировщиком, если доказательства уже удовлетворяют требуемым проверкам.
  • Относитесь к молчаливому откату или неполному результату как к неудаче.
  • Сохраняйте очищенные доказательства в утвержденном хранилище, никогда учетные данные. Моментальные снимки агентов могут содержать конфиденциальное содержимое.

Предварительные требования и известные данные испытаний

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

Для следующих команд установите средства разработчика Work IQ: Для интерфейса командной строки требуются Node.js 24.15+ и npm, а также PowerShell 7+ в Windows.

Подготовка:

  • Известные записи: Проблема 123 в тестовом репозитории, с точным названием, состоянием и URL-адресом, записанными из источника.
  • Ввод навыка:Added CSV export; Fixed duplicate rows; Updated help text. Для навыка заметок о выпуске ожидайте компоненты, исправления и другое соответственно, а также любой обещанный файл или содержимое, созданное скриптом.

Замените имена, идентификаторы и заполнители примеров. Вход и проверка готовности перед командами клиента:

wiqd auth login --interactive
wiqd doctor

Проверьте: Вход и проверки готовности для предполагаемого клиента проходят успешно.

Чтобы получить необязательные запросы помощника, установите интерфейс командной строки GitHub Copilot. Если его плагин WIQD guide еще не установлен, выполните следующие команды, а затем начните новую сессию в существующем проекте плагина:

copilot plugin install wiqd@awesome-copilot
copilot plugin list --json
copilot

Проверьте: Инвентаризация показывает установленное и включенное руководство WIQD. Существующие установки должны следовать руководству по установке, а не добавлять дубликаты. Этот подключаемый модуль гида не устанавливает интерфейс командной строки WIQD. Вставка подсказок помощника в сеанс помощника по написанию кода; вместо этого в запросах развернутого агента -q используйте параметр из статьи Проверка включенного декларативного агента.

Проверка навыков

Компонент плагина: Навыки уровня плагина, зарегистрированные через app-manifest agentSkills.

Что это доказывает: Предполагаемый навык загружается и создает ожидаемый результат в развертывании разработки.

Еще предстоит доказать после упаковки: Точный артефакт проверяется, устанавливается по вашему маршруту распространения и запускается в каждом заявленном опыте.

Доказательства, которые необходимо сохранить: Развертывание/версия, загруженные навыки, файлы ввода, вывода и доступные журналы удаленных вызовов.

Используйте Copilot Cowork для развертывания разработки. Повторно используйте распечатанную ссылку для установки/тестирования, если она доступна.

  1. Если требуется подготовка, сначала проверьте m365agents.yml выбранный файл среды в соответствии с его настройками environmentFolderPath . Подтвердите клиента и эффективный AGENT_SCOPE; стандартные леса используются local для личных область и dev для общих область, но имена сами по себе не являются доказательством. Утвердите предложенные изменения, а затем выполните следующие действия:

    wiqd plugin provision --env "<test-environment>"
    

    Проверьте: Подготовка завершается успешно и возвращается ссылка развертывания на установку или тестирование.

  2. Откройте возвращенную ссылку и завершите установку и необходимые подключения с помощью тестового удостоверения. Запустите сеанс Cowork и запросите заметки о выпуске, используя известные входные данные.

    Проверьте: Ваш навык отображается в разделе "Навыки" на боковой панели сеанса.

  3. Проверьте отклик и любой файл в папке>вывода "Просмотр" или " Загрузка".

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

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

    Проверьте: Поведение обнаружения, выбора и сбоя соответствует требованиям навыка для этого взаимодействия.

Лично загруженный навык проверяет регистрацию, отличную от регистрации плагина; вместо этого навыки, agentSkillsприкрепленные агентом, используются agent_skills в манифесте декларативного агента. Доказательства загруженных навыков не устанавливают выполнение сценария.

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

Предпочитаете использовать интерфейс командной строки GitHub Copilot?

Help test <skill-name> in this plugin's existing Cowork development deployment.
Reuse its printed install link. Ask before provisioning; inspect the actual
environment scope first. Don't publish or share. Request release notes for
"Added CSV export; Fixed duplicate rows; Updated help text." Compare categories
and promised files; test missing input. Guide explicit/automatic Chat selection
if supported. Let me operate inaccessible UI and handle sign-in/consent.
Show actual evidence and ask before installs, exposure, or external changes.

Тестирование удаленных разъемов MCP

Компонент плагина:agentConnectors[] Записи, указывающие на удаленные службы MCP.

Что это доказывает: Поведение сервера независимо, а затем аутентифицировано использование с помощью плагина разработки.

Еще предстоит доказать после упаковки: Объявление соединителя, настройка подключения и вызовы среды выполнения работают из точного установленного артефакта.

Доказательства, которые необходимо сохранить: Конечная точка или версия, схема инструмента, входные данные и результаты, удостоверение и связанные записи узла или сервера.

Используйте MCP Inspector с Node.js 22.19.0+, доверенной потоковой конечной точкой HTTP, ее данными проверки подлинности и безопасной операцией только для чтения.

  1. Инспектор запуска, заменив пример URL:

    $serverUrl = 'https://your-server.example/mcp'
    npx @modelcontextprotocol/inspector --server-url "$serverUrl" --transport http
    

    Проверьте: Проверка подлинности завершается, и появляется ожидаемое удостоверение и возможности сервера.

  2. Перечислите средства, выберите операцию подстановки, введите поля схемы, определенные для известной записи, и выполните ее.

    Проверьте: Схема и возвращаемые заголовок, состояние и URL-адрес соответствуют ожиданиям.

  3. Повтор с несуществующей записью и ограниченным удостоверением.

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

  4. Откройте ссылку для установки и тестирования Cowork подключаемого модуля разработки, при необходимости используя шаг подготовки в разделе "Проверка навыков". Проекты, связанные только с соединителями, не требуют навыков. Завершите настройку подключения и запросите ту же запись. Если навык должен использовать соединитель, вызовите его с помощью этого запроса.

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

  5. Все утвержденные операции записи проверяйте только на одноразовых записях, включая отмену.

    Проверьте: Утвержденные изменения соответствуют запросу, а отмена оставляет исходные данные без изменений.

Сравните ссылку на конечную точку и проверку подлинности в конфигурации компонента с тем, что фактически выполнялось. Следуйте требованиям к разъемам, включая применимые требования к описанию инструмента; Успех сервера сам по себе не определяет готовность подключения к узлу.

Для локальной службы запустите ее с помощью команды проекта. После утверждения возможности доступа выполните следующие действия: Создайте постоянный туннель разработки. Для этого соединителя подключаемого модуля установите remoteMcpServer.mcpServerUrl общедоступную конечную точку HTTPS с фактическим путем MCP; обновите развертывание разработки в рабочем процессе проекта и повторите тестирование. Сохраните проверку подлинности приложения и остановите туннель по завершении тестирования.

Проверьте: Журналы службы показывают запрос аутентифицированного узла в предполагаемой конечной точке.

Предпочитаете использовать интерфейс командной строки GitHub Copilot?

Help test this plugin's remote MCP connector at <endpoint>. Show the Inspector
command and ask before downloads or launch. Let me authenticate and call
<read-only-tool/input>; compare with <expected-record>. Then guide the same
task in the existing Cowork deployment and correlate sanitized server logs.
Ask before exposure, deployment, or writes; report diagnostics you can't see.

Проверка включенного декларативного агента

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

Что это доказывает: Ответы агента и доступные выбранные функции — диагностика подключаемого модуля, извлечения и цитирования.

Еще предстоит доказать после упаковки: Упакованный агент ссылается на запросы и завершает сценарий установки подключаемого модуля в заявленных взаимодействиях.

Доказательства, которые необходимо сохранить: Агент или версия, идентификатор запроса или беседы, выбранная возможность, ввод и фактический результат.

Следуйте анатомии поддерживаемого проекта плагина. Используйте средства разработчика Work IQ иDevUI против уже развернутого агента, соответствующего этому компоненту.

  1. Перечислите агентов и выполните поиск:

    wiqd agent list
    wiqd plugin ask --component agent --agent-id "<agent-id>" -q "Find issue 123 in my test repository. Return its title, status, and source URL."
    

    Проверьте: Выбранный агент и возвращаемые значения соответствуют записи компонента и источника.

  2. Включите задокументированный флажок предварительного просмотра DevUI и повторите:

    wiqd config flags set devui true
    wiqd devui start --agent "<agent-name>"
    wiqd devui ask --agent "<agent-name>" -q "Find issue 123 in my test repository. Return its title, status, and source URL."
    

    Проверка выбранных плагинов, извлечение, цитаты и необработанные результаты.

    Проверьте: Доступные средства диагностики определяют предполагаемую возможность и ожидаемые возвращаемые данные.

  3. Если у агента есть прикрепленный навык, проверьте его вывод:

    wiqd devui ask --agent "<agent-name>" -q "Draft release notes from these changes: Added CSV export; Fixed duplicate rows; Updated help text."
    

    Проверьте: Изменения и обещанные файлы удовлетворяют требованиям навыка.

  4. Остановите сервер диагностики:

    wiqd devui stop
    

    Проверьте: Команда сообщает, что остановлена или не запущена.

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

Предпочитаете использовать интерфейс командной строки GitHub Copilot?

Use WIQD to list agents; let me choose the component's deployed <agent-id>.
Ask it for issue 123 in <repository>, comparing with <expected-title/status/URL>.
Open DevUI and repeat; help inspect selected plugins, retrieval, citations,
raw results, and request IDs. If <skill-name> is attached, request release
notes for "Added CSV export; Fixed duplicate rows; Updated help text."
Compare outputs separately from invocation evidence. Show commands/results
and stop DevUI. Ask before configuration, deployment, sharing, or external
writes. Let me handle sign-in and inaccessible UI; don't publish anything.

Ознакомьтесь с задокументированным процессом агента DevUI.

Проверка зависимостей

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

Синхронизированный соединитель Copilot

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

Что это доказывает: Прием, свежесть, разрешения и последующее извлечение.

Еще предстоит доказать после упаковки: Установленный подключаемый модуль использует предполагаемое подключение и записи.

Доказательства, которые необходимо сохранить: Идентификатор подключения, результаты обхода, индексированное количество, цитаты и исходные значения.

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

  1. Убедитесь, что ИД подключения, настроенный для включенного агента, соответствует проверяемому подключению, а известная запись индексирована.

    Проверьте: Диагностика подключения: определите предполагаемый источник и ожидаемые индексированные элементы.

  2. Отправьте запрос агенту, настроенному с этим подключением, затем обновите устраняемую проблему, повторно запустите соединитель и запросите снова. Протестируйте удаление с помощью пути сверки и ограничения доступа там, где применяются разрешения на элементы.

    Проверьте: Требования, к которым необходимо соответствовать значениям, ссылкам, обновлениям, обработке удалений и доступу.

Федеративный соединитель Copilot

Зависимость: Доступное федеративное подключение , используемое в поддерживаемом сценарии.

Что это доказывает: Динамическое извлечение с помощью подключенного удостоверения.

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

Доказательства, которые необходимо сохранить: Идентификатор, запись источника, ответы/цитаты и доступные журналы служб.

  1. В чате Copilot выберите ...>Параметры>"Источники", найдите источник, выберите "Подключиться" и пройдите проверку подлинности.

    Проверьте: Подключение для нужного удостоверения установлено успешно.

  2. Запросите известную запись по имени или идентификатору источника. Обновите одноразовую запись и повторите операцию. Кроме того, протестируйте ограниченное удостоверение.

    Проверьте: Динамические изменения отображаются, а разрешения источника сохраняются.

Тестирование полных пользовательских сценариев

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

  1. Начните новую беседу с предполагаемым тестовым идентификатором и введенными данными.

    Проверьте: Ожидаемый навык или агент обрабатывает запрос.

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

    Проверьте: Выбирается нужный компонент. Там, где инструмент необходим, он получает правильные входные данные и идентификаторы, и используется его фактический выход.

  3. Сравните отклик и файлы с ожидаемым результатом.

    Проверьте: Контент, цитаты и обещанные результаты соответствуют требованиям.

Сбои и границы тестов

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

Запись результатов интеграции

Используйте одну запись для каждого сценария и удостоверения. Доведите его до тестирования упаковки; Заполнение полей пакета после упаковки.

Поле Сохранить
Компоненты Версии, файлы, конечные точки, ссылки на подключения и версия источника
Пакет Удостоверение, версия, путь ZIP и необязательный хэш SHA256. Ожидание перед упаковкой
Контекст Среда, состояние опыта или выпуска, флаги функций, роль тестового удостоверения и дата
Сценарий Обязательные проверки, приемлемые доказательства, повторяемый ввод и ожидаемый результат в сравнении с фактическим
Доказательства Очищенные журналы вызовов, идентификаторы запросов, выходные данные и расположения отчетов
Решение. Пройдено, не пройдено или не проверено; Пробелы в требуемых доказательствах, диагностические ограничения, владелец и дальнейшие действия

Перед упаковкой

  • Призыв: Подтвердите выбор предполагаемой возможности и ожидаемые входные и выходные данные.
  • Доступ: Выполнение проверок разрешенного и ограниченного доступа, согласия и подтверждения.
  • Результаты и неудачи: Выполните применимые тесты на отказ.
  • Предполагаемые возможности: Записывайте результаты разработки отдельно для каждого поддерживаемого выпуска; Запланируйте окончательные проверки установленных артефактов.
  • Запись передачи: Сохраните записи тестов и устраните препятствия реализации перед упаковкой.
  • Ссылки на пакеты: Убедитесь, что версии компонентов, файлы, идентификаторы, ссылки подключений и конечные точки указаны в пакете.

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

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