Протестируйте и проверьте подключаемый модуль для Microsoft 365 Copilot

Проверьте точный артефакт версии, созданный Create the plugin package. В тесте пакета & подключите свидетельство компонента к этому ZIP-файлу, установите его поддерживаемым способом и проверьте доставленную версию, доступ и реальное поведение во время выполнения в каждом заявленном интерфейсе Майкрософт.

Закончите следующим доказательством: «Я протестировал эти компоненты, упаковал эти точные ссылки, установил эту точную версию, запустил эти сценарии и сохранил эти результаты». Успешная проверка схемы, команда подготовки или правдоподобный ответ не создают эту цепочку.

Подготовка

Имеют:

  • Выполненные испытания компонентов и интеграции, включая известные тестовые данные и ожидаемые результаты.
  • ZIP-файл-кандидат, идентификатор и версия пакета, а также версии компонентов, конечные точки и ссылки на подключения, которые он содержит.
  • Клиент разработки, непроизводственные данные, поддерживаемый маршрут установки для компонентов пакета и разрешение на его использование.
  • тестовые удостоверения для разрешенных и ограниченных пользователей; уполномоченный администратор по тестам доступности и блокировке.
  • Обязательные лицензии, вход, согласие, подключения и внешние службы для каждой целевой среды.
  • Тестовая запись для каждого сценария и удостоверения.

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

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

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

Откройте ZIP-архив кандидата, не изменяя его. Чтение корня manifest.json, записи idversion, и manifestVersion. Подтвердите следующее.

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

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

wiqd plugin validate --mode source --env "<test-environment>"

Проверьте: Регистрируются подходящие проверки источника (pass), а также пропущенные или незакрытые возможности.

В режиме источника проверяется сохраненная диагностика декларативного агента и базовые средства защиты проекта. Он не проверяет полностью схему приложения, содержимое навыка, корень agentConnectors[]или содержимое ссылок API или OpenAPI. В проектах, предназначенных только для навыков или соединителей, не может применяться проверка агентов. Используйте source явно: режим по умолчанию - это проверка пакета, а не автономная проверка.

Проверка точного пакета

Выберите один ZIP-файл явно, а не полагайтесь на каталог сборки с несколькими кандидатами. В PowerShell замените путь примера артефактом:

$packageFile = (Resolve-Path '.\appPackage\build\<candidate>.zip').Path
Get-FileHash -LiteralPath $packageFile -Algorithm SHA256

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

  1. Перед проверкой подлинности войдите с нужным удостоверением Microsoft 365:

    wiqd auth login --interactive
    wiqd doctor
    

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

  2. Получив разрешение на отправку этого ZIP-файла в службу проверки платформы, выполните следующую команду:

    wiqd plugin validate --mode package --package-file "$packageFile"
    

    Проверьте: Результаты для этого конкретного ZIP-файла удовлетворяют необходимым проверкам; сохранить возвращаемые неизменяемые отчеты JSON и HTML.

  3. Если для вашего пути публикации требуются дополнительные проверки политики Marketplace и доказательств, выполните следующие команды:

    wiqd plugin validate --mode marketplace --package-file "$packageFile"
    

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

В обоих packagemarketplace случаях используется встроенный ZIP-файл, можно отправить его и потребовать ввода в систему. Они не создают его и не входят в систему автоматически. Они также принимают ZIP-файл без исходного проекта. Режим Marketplace добавляет проверки политики и доказательств. Ее отчет не является официальным одобрением магазина или Центра партнеров. Следуйте текущему контракту проверки WIQD, а не устаревшим deepименам staticmanifest или именам режима.

Читайте выводы, покрытие, пропущенные проверки и необходимые доказательства, а не только результат выхода команды. Для маршрута пакета поддерживаемого набора средств агентов используйте проверку пакета приложения с помощью правил проверки или atk validate --app-package-file-path <path> согласно документации в статье "Проверка приложения".

Если в ZIP-файле что-то изменится, создайте нового кандидата и повторите проверку. Изменения удаленной службы требуют соответствующего повторного тестирования во время выполнения, даже если ZIP-файл не изменился.

Установка или загрузка пакета без публикации

Используйте маршрут, который принимает ваш собственный пакет приложений Microsoft 365 и поддерживает его компоненты. Ссылка для подготовки и тестирования WIQD идентифицирует развертывание; при его открытии не устанавливается установка окончательного проверенного ZIP-файла.

Персональная установка exact-ZIP

Следуйте персональной процедуре загрузки неопубликованных приложений Cowork для установки CLI, проверки подлинности и установки пакета, если этот пакет и целевой интерфейс поддерживаются. Передайте точный файл, выбранный в Проверка точного пакета, используя $packageFile в качестве значения --file-path и Personal области.

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

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

Отправка пакета Cowork

Чтобы получить поддерживаемый пакет Cowork, см. раздел "Загрузить пакет подключаемого модуля" и рекомендации по его предоставлению общего доступа. Выберите точный проверенный собственный ZIP-файл Microsoft 365 и ограничьте доступ к тестовому удостоверению или явно авторизованной тестовой аудитории. Подписаться: используйте плагины с Cowork, чтобы включить плагин и установить необходимые подключения в новой беседе.

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

Иностранные отправки могут конвертироваться автоматически. Такое преобразование не является доказательством того, что исходный Microsoft 365 ZIP был протестирован без изменений. Восстановите артефакт и доказательства проверки, если маршрут преобразует его.

Проверка доставленной версии

Сохранение записи установки, которая связывает выбранный ZIP-файл и его манифест id , а также version успешную установку, предполагаемую учетную запись и возвращенные идентификаторы установки. Для задокументированного персонального маршрута загрузки неопубликованных приложений сохраните команду с разрешенным путем к файлу, метаданными манифеста кандидата и выходными данными установщика, содержащими TitleId и AppId. Для поддерживаемой собственной отправки Cowork сохраните выбранный файл и запись об успешной загрузке / установке с отображаемым идентификатором плагина и тестовой учетной записью.

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

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

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

Проверка упакованного подключаемого модуля

Повторите полные сценарии интеграции с установленным кандидатом, а не с более ранним развертыванием разработки:

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

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

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

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

  3. Проверка выходных файлов и цитат. Повторите подходящие случаи отказа и границы.

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

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

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

Проверка подлинности и доступа

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

Проверка Настройка и действия Ожидаемый результат
Разрешенный пользователь Включите тестовое удостоверение в утвержденную аудиторию. Войдите в качестве этого пользователя и заполните необходимые согласия и соединения. Поддерживаемый сценарий успешно выполняется в пределах разрешений исходного кода этого пользователя; Свидетельство вызова определяет ожидаемую возможность.
Пользователь с ограниченным доступом Ограничьте доступность для утвержденной аудитории, а затем протестируйте с учетной записью за пределами этой аудитории. Пользователь не может использовать плагин. В канале Copilot листинг может оставаться доступным для обнаружения как заблокированный; Подходящие пользователи могут запросить доступ. Видимость сама по себе не является недостатком.
Отказано в согласии Используйте тестовое удостоверение/подключение без существующего гранта. Отклоните требуемое согласие операции и повторите попытку защищенного поиска. Операция не получает запрошенный защищенный доступ. Запишите ошибку входа или согласия и убедитесь, что защищенный результат не представлен как успешный. Несвязанные разрешенные возможности по-прежнему будут работать.
Блокировка и разблокировка Попросите администратора следовать Заблокируйте плагин или навык для кандидата. Повторите запрос с ранее разрешенным пользователем, затем администратор должен выбрать "Разблокировать " для подключаемого модуля и повторите запрос снова. Пока плагин и зависимые агенты заблокированы, их нельзя использовать. Связанные серверы/соединители MCP остаются доступными для других подключаемых модулей. После разблокировки ранее разрешенный пользователь может снова использовать плагин при условии исходной доступности, разрешения и требований к подключению.

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

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

Тестирование поддерживаемых возможностей

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

Запись результатов, качественных для агента

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

Повтор регрессионных тестов для кандидата

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

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

Определение готовности к выпуску

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

Назначение одного результата:

  • Ready — точный кандидат прошел все необходимые проверки с полными доказательствами и без нерешенного блокировщика релиза.
  • Заблокировано — обязательная проверка не пройдена или остается непроверенной, включая привязку артефакта, доставленную версию, доступ или вызов.
  • Готов с ограничениями - Необходимые проверки пройдены; Остальные ограничения, не связанные с блокировкой, задокументированы, приняты и подходят для раскрытия.

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

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

После завершения необходимых доказательств продолжайте публиковать & распространять: