Примечание.
Для доступа к этой странице требуется авторизация. Вы можете попробовать войти или изменить каталоги.
Для доступа к этой странице требуется авторизация. Вы можете попробовать изменить каталоги.
Используйте мониторинг, отзывы и подтверждающие данные, чтобы решить, следует ли исправлять, обновлять, передавать или удалять плагин или агент. Протестируйте изменения перед выпуском и проверьте результат с предполагаемыми пользователями.
Строители поддерживают и тестируют решение. Администраторы Microsoft 365 выполняют развертывание организации и получают доступ к действиям при необходимости. Владельцы служб поддерживают соединители, удаленные MCP-серверы, удостоверения и внешние службы, которые они используют. Эти обязанности не переносятся вместе автоматически.
Выберите задачу
Используйте этот раздел для необходимой работы. Для мониторинга, поддержки, передачи и снятия с учета не требуется следовать рабочему процессу обновления.
| Необходимые действия | Начать с |
|---|---|
| Проверка внедрения, отзыва или результатов задач | Мониторинг использования и результатов выполнения задач |
| Изучение проблемы пользователя | Поддержка пользователей и изучение проблем |
| Измените и отпустите решение | Обновите подключаемый модуль или агент |
| Передача обязанностей по техническому обслуживанию | Передача владения и поддержки |
| Окончание распространения или доступа | Снятие подключаемого модуля или агента с учета |
Подготовка
Определите:
- Текущее удостоверение и версия подключаемого модуля или агента.
- Затронутые пользователи и возможности Microsoft 365.
- Владелец, ответственный за задачу и все задействованные подключения и службы.
Для автономного агента используйте процедуры мониторинга и выпуска, поддерживаемые его продуктом-разработчиком. Не думайте, что к нему применяется процедура пакета плагинов.
Мониторинг использования и результатов выполнения задач
Выберите период отчета, версию, аудиторию и репрезентативные задачи. Используйте возможности мониторинга для продукта, которому принадлежит действие.
| Что вы отслеживаете | С чего начать | Рамки, которые следует помнить |
|---|---|---|
| Агент, встроенный в построитель агентов | Мониторинг агентов в построителе агентов | Вкладка " Монитор " агента охватывает его использование и отзывы. Для видимости отзывов есть отдельные предварительные требования. |
| Агент Copilot Studio с использованием стандартной жгутовой системы | Мониторинг производительности агента в Copilot Studio | использовать аналитику, поддерживаемую для этого агента; Не думайте, что такие отчеты существуют в конструкторе агентов или других путях сборки. |
| Доступ подключаемого модуля, задачи пользователя и сбои | Мониторинг подключаемого модуля | Проверяйте доступность пакетов, репрезентативные результаты задач, отзывы пользователей и обращения в службу поддержки. |
| Использование Microsoft 365 и аудит действий | Выбор объектов для проверки | Используйте каждый отчет для охватываемой в нем деятельности. Событие аудита не позволяет подтвердить успешное выполнение задачи или правильность отклика. |
| Соединитель или удаленная служба MCP | Исследование сбоев и руководство по мониторингу службы | Совместно с владельцем службы проверяйте состояние подключения, разрешения источника, работоспособность конечной точки, журналы и ошибки. Доступность пакета не доказывает работоспособность процесса выполнения. |
Не предполагайте, что телеметрия или охват отчетов совместно используются в путях сборки подключаемого модуля и агента. Включенный отчет агента охватывает этого агента, а не обязательно все возможности в подключаемом модуле.
Записывайте изменения в принятии решений, выполнении задач, качестве отклика, сбоях входа или средств, а также объем поддержки в тех случаях, когда имеющиеся данные подтверждают эти выводы. Сравнивайте показательные задачи и отзывы пользователей, а также количество использований.
Поддержка пользователей и изучение проблем
Для каждой проблемы зафиксируйте затронутую версию, продукт, аудиторию, ожидаемый результат, наблюдаемый результат и соответствующие сведения об ошибке. Назначьте владельца и назначьте следующее действие.
- Попросите администратора изучить доступность, установку, политику или ожидающие запросы на доступ.
- Попросите владельца сборщика или агента изучить инструкции, знания, выбор инструмента или регрессию.
- Попросите владельца удостоверения, подключения или службы изучить сбои проверки подлинности, предоставления согласия, доступа к источнику и сбоев во время выполнения.
При сбоях входа в действие API или MCP используйте Устранение неполадок аутентификации подключаемого модуля. Для проверок задач и зависимостей используйте исследование сбоев.
Подтвердите исправление у затронутого пользователя и запишите результат. Исправленная конфигурация или успешный вызов средства сами по себе не означает, что теперь полная задача пользователя теперь работает.
Обновите подключаемый модуль или агент
Выполните этот процесс, если вам нужно изменить решение. Используйте шаги пакета для созданного подключаемого модуля. Используйте процедуру выпуска продукта разработки для автономного агента.
Перед обновлением
Имеют:
- Мониторинг доказательств, отзывов пользователей, обращений в службу поддержки или запланированного улучшения.
- Репрезентативные задачи и критерии приемки.
- Доступ к исходным и затронутым возможностям.
- Запись публикации, включая текущую версию, аудиторию и маршрут распространения.
- Владельцы всех изменений подключения, удостоверения или службы.
Создание базового плана
- Опишите проблему или улучшение, которое нужно устранить.
- Определите затронутые версии пакета или агента, пользователей, возможности, возможности и зависимости.
- Определите репрезентативные задачи и измеримые критерии приемки.
- Выполните задания для текущей версии и запишите результаты.
- Если ваша организация администрирует подключаемый модуль, запишите его текущее состояние, доступность для пользователей и состояние установки вподключаемых модуляхагентов> исредств>. Для применимых элементов управления агента используйтереестрвсех агентов>>.
- Сохраните доказательства, необходимые для сравнения текущего и обновленного поведения.
Для подключаемого модуля, содержащего агент, используйте обзор оценки агента , чтобы разработать оценку, когда частью изменения является качество отклика, инструкции, знания или использование инструмента. Оценка может предоставить данные до выпуска и помочь выявить проблемы качества после развертывания, в том числе вызванные сигналами использования, отзывами пользователей, изменениями агентов и зависимостей.
Оценка агента не требуется для каждого подключаемого модуля. Она не заменяет тестирование возможностей, проверку пакетов или тестирование всего пользовательского интерфейса.
Для развернутых декларативных агентов используйте пошаговый wiqd agent eval рабочий процесс. Сведения о непосредственном управлении командной строкой или конвейером см. в разделе Обзор командной строки Microsoft 365 Copilot Evaluations.
Применение и проверка изменения
Вернитесь к сборке или используйте повторно , если вам нужно изменить возможность, интеграцию или источник. Вернитесь к пакету & тестировать, если вам нужно подготовить и проверить релиз-кандидат. Сохранение затронутых зависимостей и поддерживаемых возможностей в областях.
- Обновите источник или затронутую возможность.
- Обновите отдельно управляемые службы или конфигурацию, если этого требует изменение.
- Протестируйте каждую измененную возможность и затронутую зависимость.
- Снова запустите базовые задачи и оценки.
- Сравните результаты с критериями приемки.
- Изучите регрессии, прежде чем создавать пакет выпуска.
Если изменение затрагивает соединитель, удаленный сервер MCP, удостоверение, разрешение или внешнюю службу, вовлекайте владельца этой зависимости. Не думайте, что при изменении пакета обновляется отдельная служба.
Создание и проверка пакета
Для автономного агента следуйте инструкциям по управлению версиями, тестированию и публикации его продукта. Следующие шаги пакета применяются к составленным плагинам.
- Назначьте новую версию пакета и проведите проверку требований к удостоверениям для метода публикации.
- Создайте пакет подключаемого модуля.
- Проверьте и протестируйте именно тот пакет, который вы планируете выпустить.
- Протестируйте необходимый вход, согласие, подключения и внешние службы.
- Протестируйте пакет во всех интерфейсах Microsoft 365, которые предполагается поддерживать.
- Запишите известные ограничения, требуемую конфигурацию и любой задокументированный параметр восстановления.
Не публикуйте пакет, который отличается от пакета, который вы проверили.
Публикация и развертывание обновления
Выберите процедуру обновления для вашего продукта и способ распространения. Пути публикации различают общий доступ, отправку организации и публикацию на Marketplace.
| Маршрут распространения | Документированные рекомендации или ограничения | Кто действует |
|---|---|---|
| Подключаемый модуль, общий доступ через Cowork | Выполните задокументированную процедуру отправки и повторного совместного использования для более новой версии уже опубликованного подключаемого модуля. Эта процедура относится к общему доступу Cowork, а не к общей замене реестра. | Владелец подключаемого модуля |
| Отправка каталога приложений организации с помощью средств разработчика Work IQ | Следовать Отправить утвержденное обновление в каталог приложений организации. Сохраните существующее удостоверение и состояние среды целевого выпуска, протестируйте обновленный выпуск, отправьте с wiqd plugin publishпомощью и получите утверждение администратора. |
Владелец и администратор подключаемого модуля |
| Загрузка реестра вручную или другой метод прямого доступа | Перед выпуском подтвердите процедуру обновления существующего элемента для конкретного продукта. В этой статье не приводятся действия по замене пакета реестра вручную. Не думайте, что новая отправка заменяет существующую запись или сохраняет ее параметры доступности. | Владелец и администратор подключаемого модуля |
| Microsoft Marketplace | Следуйте инструкциям по обновлению для типа предложения, используемого опубликованным предложением. Начните с руководства по Центру партнеров, ссылка на которое приведена в статье "Публикация подключаемого модуля в Microsoft Marketplace". Завершите необходимую проверку и публикацию, прежде чем направлять клиентов к обновлению. | Издатель и администратор клиента, при необходимости |
Для обновления WIQD сохраните установленные идентификаторы ресурса и публикации. При повторной настройке используется существующее удостоверение среды, что может привести к изменению ресурсов, используемых текущими пользователями до утверждения каталога. Протестируйте изменения с учетом этого эффекта. Проверьте жизненный цикл публикации проекта в соответствии с руководством WIQD для существующих проектов; обновление интерфейса командной строки не обновляет файлы проекта.
wiqd plugin publish отправляет проект и среду, а не захваченный ZIP-архив через --package-file. Сохраняйте утвержденный источник и состояние среды фиксированными путем отправки и проверки отправленной версии. Проверка пакета сама по себе не доказывает, что публикация отправляет именно эти байты.
Для маршрута с задокументированной процедурой обновления:
- Используйте процедуру подтвержденной публикации или общего доступа для тестируемой версии и запишите, была ли она отправлена, опубликована, предоставлена к общему доступу, отклонена или заблокирована.
- Предоставьте администратору или владельцу развертывания точную версию, предполагаемых пользователей, необходимую конфигурацию, известные ограничения и контактное лицо службы поддержки.
- Выполните только соответствующие действия, чтобы сделать обновленный подключаемый модуль или агент доступным. Требования к утверждению, назначению и установке зависят от параметров метода и организации.
- При необходимости можно обновлять отдельно управляемые агенты, подключения, удостоверения, удаленные серверы MCP или внешние службы.
- Проверьте, какая версия достигла каждой аудитории.
Планируйте восстановление без предположения об откате
Администраторы могут блокировать и разблокировать подключаемый модуль в Центре администрирования Microsoft 365. Используйте действие Разблокировать плагин, чтобы снять блокировку, а затем проверьте доступ для предполагаемых пользователей. Другие требования к доступности, установке, разрешениям и подключению по-прежнему применяются. Разблокировка не восстанавливает более раннюю версию пакета и не отменяет изменения службы.
В текущем руководстве не описана общая процедура отката версии пакета подключаемого модуля. Используйте операцию отката для конкретного продукта, только если продукт задокументировал это.
Перед выпуском запишите задокументированный параметр восстановления и его предварительные требования или запишите пробел в процедуре и владельца, ответственного за сбой развертывания.
Замена пакета не приводит к автоматическому восстановлению внешней службы, подключения, удостоверения, данных или изменения разрешения. Спланируйте эти зависимости отдельно.
Проверка обновления
- Протестируйте репрезентативные задачи с предполагаемым пользователем в каждом поддерживаемом интерфейсе.
- Убедитесь, что пользователь получил ожидаемую версию.
- Убедитесь, что вход, согласие, подключения, вызовы средств и внешние службы работают.
- Если подключаемый модуль администрируется в вашей организации, проверка, чтобы его состояние, доступность для пользователей и состояние установки соответствовали целевой аудитории вподключаемых модуляхагентов>и средств>. Проверьте, не используются ли по-прежнему какие-либо замененные версии.
- Повторите оценки, использованные для утверждения изменения.
- Просматривайте сигналы использования, отзывы, ошибки и обращения в службу поддержки после выпуска.
- Если обновление не соответствует критериям приемки, приостановите развертывание, зафиксируйте сбой и привлеките ответственного владельца. Используйте операцию восстановления, только если продукт задокументировал это.
Обновление будет завершено, если у предполагаемой аудитории есть правильная версия, параметры доступа соответствуют предполагаемому выпуску, представительские задачи соответствуют критериям приемлемости, а у каждой нерешенной проблемы есть владелец и следующее действие.
Запись обновления
Рекорд:
- Предыдущие и обновленные версии пакета или агента.
- Изменение, причина, затронутые возможности и зависимости.
- Исходные данные, оценка, проверка и результаты тестирования пользователем.
- Способ публикации, аудитория, состояние развертывания и применимое состояние реестра.
- Изменения конфигурации или службы.
- Известные ограничения, задокументированный вариант восстановления или пробел в процедуре, а также владелец поддержки.
Передача владения и поддержки
Перед тем как текущий владелец покинет роль, предоставьте следующему владельцу:
- Источник, идентификатор пакета или агента, текущая версия, записи выпусков и маршрут публикации.
- Отслеживание расположений, репрезентативных тестов, известных проблем и открытых обращений в службу поддержки.
- Целевая аудитория, контакты администрации, требуемые связи и владельцы внешних служб.
- Задокументированные процедуры обновления, восстановления и снятия с учета, включая пробелы.
Для общего агента, встроенного в Agent Builder или Copilot Studio, используйте Назначить агенту нового владельца, если применяется эта процедура. Построитель агентов также поддерживает добавление владельца. Перед внесением изменений проверьте, как это повлияет на доступ предыдущего владельца.
Это процедуры владения агентом, а не общая процедура передачи внешнего пакета плагинов. Отдельно подтвердите доступ к источнику, доступ к публикации, подключения, учетные данные и обязанности по обслуживанию отдельно. Попросите следующего владельца убедиться, что он может отслеживать, обслуживать и поддерживать решение.
Снятие подключаемого модуля или агента с учета
Если решение больше не должно использоваться, откажитесь от него. Решите, прекращаете ли вы распространение для всех клиентов или удаляете доступ только в вашей организации. Эти масштабы разные.
- Определение активных версий, пользователей, расположений публикации и общего доступа, а также общих зависимостей.
- Уведомите пользователей и группы поддержки, указав о замене и дате прекращения поддержки.
- Остановите распространение и доступ по поддерживаемому маршруту и при необходимости удалите установки администратора.
- Владельцы служб удаляют доступ и ресурсы, относящиеся к подключаемому модулю, сохраняя при этом ресурсы, используемые другими решениями.
- Проверьте результат с ранее авторизованным пользователем и запишите сохраненные ресурсы, исключения и владельцев.
Сведения о снятии пакета с учета см. в статье Снятие подключаемого модуля с учета. Для автономного агента используйте применимую процедуру продукта, например удаление агентов. Не думайте, что удаление агента или пакета отзывает все подключения, разрешения или внешние службы.
См. также:
- Мониторинг подключаемого модуля
- Мониторинг агентов в построителе агентов
- Создание или повторное использование возможностей плагина
- Упаковка подключаемого модуля
- Проверка подключаемого модуля
- Выберите, как публиковать и распространять подключаемый модуль
- Обеспечение доступности подключаемых модулей и агентов
- Управление доступом, инструментами и подключениями
- Управление подключаемыми модулями, навыками и серверами MCP
- Снятие подключаемого модуля с учета