Примечание.
Для доступа к этой странице требуется авторизация. Вы можете попробовать войти или изменить каталоги.
Для доступа к этой странице требуется авторизация. Вы можете попробовать изменить каталоги.
Проверьте, что содержит или ссылается ваш пакет подключаемого модуля: навыки, удаленные соединители 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 для развертывания разработки. Повторно используйте распечатанную ссылку для установки/тестирования, если она доступна.
Если требуется подготовка, сначала проверьте
m365agents.ymlвыбранный файл среды в соответствии с его настройкамиenvironmentFolderPath. Подтвердите клиента и эффективныйAGENT_SCOPE; стандартные леса используютсяlocalдля личных область иdevдля общих область, но имена сами по себе не являются доказательством. Утвердите предложенные изменения, а затем выполните следующие действия:wiqd plugin provision --env "<test-environment>"Проверьте: Подготовка завершается успешно и возвращается ссылка развертывания на установку или тестирование.
Откройте возвращенную ссылку и завершите установку и необходимые подключения с помощью тестового удостоверения. Запустите сеанс Cowork и запросите заметки о выпуске, используя известные входные данные.
Проверьте: Ваш навык отображается в разделе "Навыки" на боковой панели сеанса.
Проверьте отклик и любой файл в папке>вывода "Просмотр" или " Загрузка".
Проверьте: Все изменения отображаются в предназначенных категориях, а обещанные файлы соответствуют требованиям.
Выполните тесты обнаружения и вызова в каждом поддерживаемом интерфейсе, используя это развертывание и известные входные данные.
Проверьте: Поведение обнаружения, выбора и сбоя соответствует требованиям навыка для этого взаимодействия.
Лично загруженный навык проверяет регистрацию, отличную от регистрации плагина; вместо этого навыки, 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, ее данными проверки подлинности и безопасной операцией только для чтения.
Инспектор запуска, заменив пример URL:
$serverUrl = 'https://your-server.example/mcp' npx @modelcontextprotocol/inspector --server-url "$serverUrl" --transport httpПроверьте: Проверка подлинности завершается, и появляется ожидаемое удостоверение и возможности сервера.
Перечислите средства, выберите операцию подстановки, введите поля схемы, определенные для известной записи, и выполните ее.
Проверьте: Схема и возвращаемые заголовок, состояние и URL-адрес соответствуют ожиданиям.
Повтор с несуществующей записью и ограниченным удостоверением.
Проверьте: Поведение при отсутствии записи влечет за собой действие, а несанкционированное содержимое остается недоступным.
Откройте ссылку для установки и тестирования Cowork подключаемого модуля разработки, при необходимости используя шаг подготовки в разделе "Проверка навыков". Проекты, связанные только с соединителями, не требуют навыков. Завершите настройку подключения и запросите ту же запись. Если навык должен использовать соединитель, вызовите его с помощью этого запроса.
Проверьте: В журналах служб, прошедших проверку подлинности, отображаются ожидаемые операции и входные данные, а возвращаемые значения соответствуют результату сеанса.
Все утвержденные операции записи проверяйте только на одноразовых записях, включая отмену.
Проверьте: Утвержденные изменения соответствуют запросу, а отмена оставляет исходные данные без изменений.
Сравните ссылку на конечную точку и проверку подлинности в конфигурации компонента с тем, что фактически выполнялось. Следуйте требованиям к разъемам, включая применимые требования к описанию инструмента; Успех сервера сам по себе не определяет готовность подключения к узлу.
Для локальной службы запустите ее с помощью команды проекта. После утверждения возможности доступа выполните следующие действия: Создайте постоянный туннель разработки. Для этого соединителя подключаемого модуля установите 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 против уже развернутого агента, соответствующего этому компоненту.
Перечислите агентов и выполните поиск:
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."Проверьте: Выбранный агент и возвращаемые значения соответствуют записи компонента и источника.
Включите задокументированный флажок предварительного просмотра 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."Проверка выбранных плагинов, извлечение, цитаты и необработанные результаты.
Проверьте: Доступные средства диагностики определяют предполагаемую возможность и ожидаемые возвращаемые данные.
Если у агента есть прикрепленный навык, проверьте его вывод:
wiqd devui ask --agent "<agent-name>" -q "Draft release notes from these changes: Added CSV export; Fixed duplicate rows; Updated help text."Проверьте: Изменения и обещанные файлы удовлетворяют требованиям навыка.
Остановите сервер диагностики:
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" следуйте инструкциям в статье "Создайте свой первый синхронизированный соединитель " для выполнения предварительных требований, настройки репозитория, получения согласия, обхода и индексирования. Для других реализаций используйте задокументированные процедуры обхода и диагностики.
Убедитесь, что ИД подключения, настроенный для включенного агента, соответствует проверяемому подключению, а известная запись индексирована.
Проверьте: Диагностика подключения: определите предполагаемый источник и ожидаемые индексированные элементы.
Отправьте запрос агенту, настроенному с этим подключением, затем обновите устраняемую проблему, повторно запустите соединитель и запросите снова. Протестируйте удаление с помощью пути сверки и ограничения доступа там, где применяются разрешения на элементы.
Проверьте: Требования, к которым необходимо соответствовать значениям, ссылкам, обновлениям, обработке удалений и доступу.
Федеративный соединитель Copilot
Зависимость: Доступное федеративное подключение , используемое в поддерживаемом сценарии.
Что это доказывает: Динамическое извлечение с помощью подключенного удостоверения.
Еще предстоит доказать после упаковки: Весь сценарий установки подключаемого модуля использует предусмотренный путь доступа к данным.
Доказательства, которые необходимо сохранить: Идентификатор, запись источника, ответы/цитаты и доступные журналы служб.
В чате Copilot выберите ...>Параметры>"Источники", найдите источник, выберите "Подключиться" и пройдите проверку подлинности.
Проверьте: Подключение для нужного удостоверения установлено успешно.
Запросите известную запись по имени или идентификатору источника. Обновите одноразовую запись и повторите операцию. Кроме того, протестируйте ограниченное удостоверение.
Проверьте: Динамические изменения отображаются, а разрешения источника сохраняются.
Тестирование полных пользовательских сценариев
Выполните ту же известную задачу в предполагаемом интерфейсе с включенными всеми необходимыми компонентами. Например, попросите навык извлечь известную проблему и создать заметки о выпуске, только если этот объединенный рабочий процесс является частью вашего решения.
Начните новую беседу с предполагаемым тестовым идентификатором и введенными данными.
Проверьте: Ожидаемый навык или агент обрабатывает запрос.
Соберите доказательства, относящиеся к компоненту. Для удаленных звонков сопоставьте доступную диагностику узла с журналами служб, прошедших проверку подлинности.
Проверьте: Выбирается нужный компонент. Там, где инструмент необходим, он получает правильные входные данные и идентификаторы, и используется его фактический выход.
Сравните отклик и файлы с ожидаемым результатом.
Проверьте: Контент, цитаты и обещанные результаты соответствуют требованиям.
Сбои и границы тестов
Повтор с отсутствующими или неоднозначными входными данными, просроченной проверкой подлинности, отказом в согласии, ограничением доступа, недоступными зависимостями, пустыми или неправильно сформированными результатами, сбоями сценариев, тайм-аутами, регулированием и повторными попытками. Подтвердите безопасное, действенное поведение при сбоях и необходимые подтверждения. Запишите каждый ожидаемый результат перед выполнением теста.
Запись результатов интеграции
Используйте одну запись для каждого сценария и удостоверения. Доведите его до тестирования упаковки; Заполнение полей пакета после упаковки.
| Поле | Сохранить |
|---|---|
| Компоненты | Версии, файлы, конечные точки, ссылки на подключения и версия источника |
| Пакет | Удостоверение, версия, путь ZIP и необязательный хэш SHA256. Ожидание перед упаковкой |
| Контекст | Среда, состояние опыта или выпуска, флаги функций, роль тестового удостоверения и дата |
| Сценарий | Обязательные проверки, приемлемые доказательства, повторяемый ввод и ожидаемый результат в сравнении с фактическим |
| Доказательства | Очищенные журналы вызовов, идентификаторы запросов, выходные данные и расположения отчетов |
| Решение. | Пройдено, не пройдено или не проверено; Пробелы в требуемых доказательствах, диагностические ограничения, владелец и дальнейшие действия |
Перед упаковкой
- Призыв: Подтвердите выбор предполагаемой возможности и ожидаемые входные и выходные данные.
- Доступ: Выполнение проверок разрешенного и ограниченного доступа, согласия и подтверждения.
- Результаты и неудачи: Выполните применимые тесты на отказ.
- Предполагаемые возможности: Записывайте результаты разработки отдельно для каждого поддерживаемого выпуска; Запланируйте окончательные проверки установленных артефактов.
- Запись передачи: Сохраните записи тестов и устраните препятствия реализации перед упаковкой.
- Ссылки на пакеты: Убедитесь, что версии компонентов, файлы, идентификаторы, ссылки подключений и конечные точки указаны в пакете.
См. также:
- Copilot Studio тестирование и диагностика карты активности для агентов, использующих соединители Power Platform или инструменты MCP.
- Тестирование Agent Builder и тесты прикрепленных навыков. Эти тесты разработки не устанавливают поддерживаемый путь упаковки реестра.
Следующий этап
Продолжите тест пакета &: создайте пакет подключаемого модуля, затем проверьте и протестируйте пакет, используя ту же запись свидетельства и точные упакованные ссылки.