Supervisar, actualizar y retirar el complemento o agente

Usa la supervisión, los comentarios y las pruebas de soporte técnico para decidir si se corregir, actualizar, entregar o retirar el complemento o el agente. Pruebe los cambios antes de su lanzamiento y compruebe el resultado con los usuarios previstos.

Los constructores mantienen y prueban la solución. Los administradores de Microsoft 365 completan la implementación organizativa y las acciones de acceso cuando es necesario. Los propietarios del servicio mantienen los conectores, los servidores MCP remotos, las identidades y los servicios externos que utiliza. Estas responsabilidades no se transfieren automáticamente juntas.

Elegir una tarea

Use la sección para el trabajo que necesita realizar. La supervisión, el soporte técnico, la entrega y la retirada no requieren que siga el flujo de trabajo de actualización.

Esto es lo que tiene que hacer: Empezar con
Revisar la adopción, los comentarios o los resultados de las tareas Supervisar el uso y los resultados de las tareas
Investigar un problema del usuario Ayudar a los usuarios e investigar problemas
Cambiar y liberar la solución Actualizar el complemento o agente
Transferir responsabilidades de mantenimiento Entrega de propiedad y soporte
Finalización de la distribución o acceso Retirar el complemento o agente

Antes de comenzar

Identificar:

  • La versión y la identidad actual del complemento o agente.
  • Los usuarios afectados y las experiencias de Microsoft 365.
  • El propietario responsable de la tarea y de cualquier conexión o servicio involucrado.

Para un agente independiente, use los procedimientos de supervisión y liberación admitidos por su producto de creación. No asuma que se le aplica un procedimiento de paquete de complementos.

Supervisar el uso y los resultados de las tareas

Elija un período de informe, una versión, una audiencia y tareas representativas. Usa la experiencia de supervisión del producto propietario de la actividad.

Lo que está supervisando Dónde empezar Ámbito que se debe tener en cuenta
Un agente integrado en Agent Builder Supervisar agentes en Agent Builder La pestaña Monitor del agente cubre su uso y comentarios. La visibilidad de los comentarios tiene requisitos previos independientes.
Un agente de Copilot Studio con el arnés estándar Supervisar el rendimiento del agente en Copilot Studio Usar los análisis admitidos para ese agente; no asuma que existen los mismos informes en Agent Builder u otras rutas de compilación.
Acceso a complementos, tareas de usuario y errores Supervisar el complemento Comprueba la disponibilidad del paquete, los resultados de las tareas representativas, los comentarios de los usuarios y los casos de soporte técnico.
Actividad de uso y auditoría de Microsoft 365 Elija qué comprobar Use cada informe para la actividad que cubre. Un evento de auditoría no establece que una tarea se haya realizado correctamente o que una respuesta sea correcta.
Un conector o servicio MCP remoto Investigar los errores y la guía de supervisión del servicio Compruebe el estado de conexión, los permisos de origen, el estado del punto de conexión, los registros y los errores con el propietario del servicio. La disponibilidad del paquete no prueba el estado del tiempo de ejecución.

No asuma que la telemetría o la cobertura de informes se comparten entre las rutas de compilación del complemento y el agente. El informe de un agente incluido cubre ese agente, no necesariamente todas las capacidades del complemento.

Registre los cambios en la adopción, el éxito de la tarea, la calidad de la respuesta, los errores de inicio de sesión o de herramienta, y el volumen de soporte técnico cuando las pruebas disponibles respalden esas conclusiones. Compare las tareas representativas y los comentarios de los usuarios, así como los recuentos de uso.

Ayudar a los usuarios e investigar problemas

Para cada problema, capture la versión, el producto, la audiencia, el resultado esperado, el resultado observado y los detalles relevantes del error afectados. Asignar un propietario y la siguiente acción.

  • Pídale al administrador que investigue la disponibilidad, la instalación, la directiva o las solicitudes de acceso pendientes.
  • Pídale al propietario del generador o agente que investigue las instrucciones, el conocimiento, la selección de herramientas o las regresiones.
  • Pida al propietario de identidad, conexión o servicio que investigue los errores de autenticación, consentimiento, acceso de origen y tiempo de ejecución.

Para errores de inicio de sesión de acción de API o MCP, use Solucionar problemas de autenticación de complementos. Para las comprobaciones de tareas y dependencias, use Investigar errores.

Confirme la corrección con un usuario afectado y registre el resultado. Una configuración corregida o una llamada correcta a la herramienta no establece por sí misma que la tarea completa del usuario ahora funciona.

Actualizar el complemento o agente

Siga este flujo de trabajo cuando necesite cambiar la solución. Usa los pasos del paquete para obtener un complemento compuesto. Use el procedimiento de lanzamiento del producto de creación para un agente independiente.

Antes de actualizar

Tener:

  • Pruebas de supervisión, comentarios de usuarios, casos de soporte técnico o una mejora planeada.
  • Tareas representativas y criterios de aceptación.
  • Acceso al origen y a las funcionalidades afectadas.
  • El registro de publicación, incluida la versión actual, la audiencia y la ruta de distribución.
  • Los propietarios de cualquier conexión, identidad o servicio cambian.

Establecer una línea base

  1. Indique el problema o la mejora que desea abordar.
  2. Identifique la versión del paquete o del agente, los usuarios, las experiencias, las capacidades y las dependencias afectadas.
  3. Definir tareas representativas y criterios de aceptación medibles.
  4. Ejecutar las tareas con la versión actual y registrar los resultados.
  5. Si su organización administra el complemento, registre su estado actual, la disponibilidad del usuario y el estado de instalación en los complementosde herramientas> de agentes>. Para obtener los controles aplicables de un agente, use el Registro de todos>los agentes>de Agentes.
  6. Conserve las evidencias que necesita para comparar el comportamiento actual y el actualizado.

Para un complemento que incluya un agente, use la descripción general de la evaluación del agente para diseñar una evaluación cuando la calidad de la respuesta, las instrucciones, el conocimiento o el uso de herramientas sean parte del cambio. La evaluación puede proporcionar evidencia previa al lanzamiento y ayudar a investigar los problemas de calidad posteriores a la implementación, incluidos los generados por las señales de uso, los comentarios de los usuarios o los cambios de agentes y dependencias.

La evaluación del agente no es necesaria para todos los complementos. No reemplaza las pruebas de capacidad, la validación de paquetes ni las pruebas de la experiencia completa del usuario.

Para los agentes declarativos implementados, use el flujo de trabajo guiadowiqd agent eval. Para el control directo de la línea de comandos o de la canalización, consulte Información general sobre las evaluaciones de Microsoft 365 Copilot CLI.

Aplicar y probar el cambio

Vuelva a Compilar o reutilizar cuando necesite cambiar una funcionalidad, integración o origen. Vuelva a Empaquetar & prueba cuando necesite preparar y validar la versión candidata. Mantenga las dependencias afectadas y las experiencias admitidas en el ámbito.

  1. Actualice el origen o la funcionalidad afectada.
  2. Actualice los servicios operados por separado o la configuración cuando el cambio lo requiera.
  3. Pruebe cada funcionalidad modificada y dependencia afectada.
  4. Vuelva a ejecutar las tareas y evaluaciones de línea base.
  5. Compare los resultados con los criterios de aceptación.
  6. Investigue las regresiones antes de crear el paquete de versión.

Cuando el cambio afecta a un conector, servidor MCP remoto, identidad, permiso o servicio externo, implique al propietario de esa dependencia. No asuma que cambiar el paquete actualiza un servicio operado por separado.

Crear y validar el paquete

Para un agente independiente, siga las instrucciones de versiones, pruebas y publicación de su producto de creación. Los siguientes pasos del paquete se aplican a complementos compuestos.

  1. Asigne una nueva versión del paquete y compruebe los requisitos de identidad del método de publicación.
  2. Crea el paquete de complementos.
  3. Valide y pruebe el paquete exacto que desea publicar.
  4. Pruebe el inicio de sesión, el consentimiento, las conexiones y los servicios externos necesarios.
  5. Pruebe el paquete en cada experiencia de Microsoft 365 que tenga previsto admitir.
  6. Registre las limitaciones conocidas, la configuración necesaria y cualquier opción de recuperación documentada.

No publiques un paquete diferente del paquete que has validado.

Publicar e implementar la actualización

Elija el procedimiento de actualización del producto y la ruta de distribución. Las rutas de publicación distinguen el uso compartido, el envío de la organización y la publicación en Marketplace.

Ruta de distribución Orientación o limitación documentada Quién actúa
Un complemento compartido a través de Cowork Sigue el procedimiento documentado de carga y volver a compartir para una versión más reciente de un complemento ya compartido. Este procedimiento se aplica al uso compartido de Cowork, no a la sustitución general del Registro. Propietario del complemento
Envío del catálogo de aplicaciones de la organización a través de las herramientas de desarrollo de Work IQ Seguir Enviar una actualización aprobada al catálogo de aplicaciones de la organización. Conserve la identidad y el estado del entorno existentes del destino de la versión, pruebe la versión actualizada, envíela con wiqd plugin publishy obtenga la aprobación del administrador. Propietario y administrador del complemento
Carga manual del Registro u otro método de uso compartido directo Confirme el procedimiento de actualización de elementos existentes específico del producto antes del lanzamiento. En este artículo no se proporcionan pasos manuales para reemplazar paquetes en el Registro de herramientas. No asumas que una nueva carga reemplaza una entrada existente o conserva su configuración de disponibilidad. Propietario y administrador del complemento
Microsoft Marketplace Sigue las instrucciones de actualización para el tipo de oferta que usa la oferta publicada. Comienza con la guía del Centro de partners vinculada desde Publica tu complemento en Microsoft Marketplace. Complete cualquier revisión y publicación necesarias antes de dirigir a los clientes a la actualización. Editor y administrador de clientes, cuando sea necesario

Para una actualización del WIQD, conserve los identificadores de recurso y publicación establecidos. El reaprovisionamiento usa la identidad del entorno existente y puede cambiar los recursos que usan los usuarios actuales antes de la aprobación del catálogo. Pruebe los cambios teniendo ese efecto en mente. Compruebe el ciclo de vida de publicación del proyecto con la guía WIQD para los proyectos existentes; la actualización de la CLI no actualiza los archivos del proyecto.

wiqd plugin publish envía un proyecto y un entorno, no un archivo ZIP capturado a través de --package-file. Mantenga el estado de origen y entorno aprobado corregido a través del envío y compruebe la versión enviada. La validación de paquetes por sí sola no prueba que la publicación envíe esos bytes exactos.

Para una ruta con un procedimiento de actualización documentado:

  1. Use el procedimiento de publicación o uso compartido confirmado para la versión probada y registre si se envió, publicó, compartió, rechazó o bloqueó.
  2. Proporcione al administrador o propietario del lanzamiento la versión exacta, los usuarios previstos, la configuración necesaria, las limitaciones conocidas y el contacto de soporte técnico.
  3. Complete solo los pasos aplicables para que el complemento o agente actualizado esté disponible. Los requisitos de aprobación, asignación e instalación dependen del método y la configuración de la organización.
  4. Actualice agentes, conexiones, identidades, servidores MCP remotos o servicios externos controlados por separado cuando sea necesario.
  5. Confirme qué versión llegó a cada audiencia.

Planear la recuperación sin asumir la reversión

Los administradores pueden bloquear y desbloquear un complemento en el Centro de administración de Microsoft 365. Usa la acción Desbloquear del complemento para eliminar un bloqueo y, a continuación, verifica el acceso de los usuarios previstos. Siguen aplicándose otros requisitos de disponibilidad, instalación, permisos y conexión. El desbloqueo no restaura una versión anterior del paquete ni deshace cambios en el servicio.

Las instrucciones actuales no documentan un procedimiento general de reversión de la versión del paquete del complemento. Use una operación de reversión específica del producto solo cuando ese producto lo documente.

Antes de la publicación, anota la opción de recuperación documentada y sus requisitos previos, o anota la brecha de procedimiento y el propietario responsable de un lanzamiento erróneo.

Reemplazar un paquete no restaura automáticamente un servicio externo, una conexión, una identidad, unos datos o un cambio de permiso. Planifique esas dependencias por separado.

Comprobar la actualización

  1. Pruebe las tareas representativas con un usuario previsto en cada experiencia compatible.
  2. Confirme que el usuario ha recibido la versión esperada.
  3. Confirme que funcionan el inicio de sesión, el consentimiento, las conexiones, las llamadas a herramientas y los servicios externos.
  4. En el lugar donde se administra el complemento en su organización, compruebe que su estado, disponibilidad de usuario y estado de instalación coincidan con el público previsto en los complementosde herramientas> de agentes>. Compruebe si hay alguna versión sustituida todavía en uso.
  5. Repita las evaluaciones usadas para aprobar el cambio.
  6. Revise las señales de uso, los comentarios, los errores y los casos de soporte técnico después de la implementación.
  7. Si la actualización no cumple los criterios de aceptación, detenga el lanzamiento, registre el error e implique al propietario responsable. Usa una operación de recuperación solo cuando el producto la documente.

La actualización se completa cuando el público previsto tiene la versión correcta, su configuración de acceso coincide con el lanzamiento previsto, las tareas representativas cumplen sus criterios de aceptación y cada problema sin resolver tiene un propietario y una acción siguiente.

Registrar la actualización

Record:

  • Versiones anteriores y actualizadas del paquete o agente.
  • Cambio, motivo, funcionalidades afectadas y dependencias.
  • Línea base, evaluación, validación y resultados de pruebas de usuario.
  • Método de publicación, público, estado del lanzamiento y estado del registro aplicable.
  • Cambios en la configuración o servicio.
  • Limitaciones conocidas, opción de recuperación documentada o brecha en el procedimiento y propietario del soporte técnico.

Entrega de propiedad y soporte

Antes de que el propietario actual deje el rol, proporcione al siguiente propietario:

  • La identidad del origen, del paquete o del agente, la versión actual, los registros de versión y la ruta de publicación.
  • Ubicaciones de supervisión, pruebas representativas, problemas conocidos y casos de soporte técnico abiertos.
  • El público previsto, los contactos de administración, las conexiones necesarias y los propietarios de servicios externos.
  • Los procedimientos documentados de actualización, recuperación y retirada, incluidas las lagunas.

Para un agente compartido integrado en Agent Builder o Copilot Studio, use Asignar nuevo propietario a un agente cuando se aplique ese procedimiento. Agent Builder también admite agregar un propietario. Revise los efectos en el acceso del propietario anterior antes de realizar un cambio.

Esos son procedimientos de propiedad del agente, no un procedimiento general de transferencia para el paquete de complementos externo. Confirme el acceso de origen, el acceso de publicación, las conexiones, las credenciales y las responsabilidades de servicio por separado. Pida al siguiente propietario que compruebe que puede supervisar, mantener y dar soporte a la solución.

Retirar el complemento o agente

Retire la solución cuando ya no se deba usar. Decida si va a finalizar la distribución para todos los clientes o quitar el acceso solo en su organización; esos ámbitos son diferentes.

  1. Identifique las versiones activas, los usuarios, las ubicaciones de publicación y uso compartido y las dependencias compartidas.
  2. Notifique a los usuarios y equipos de soporte, incluido cualquier reemplazo y la fecha de retirada.
  3. Detenga la distribución y el acceso a través de la ruta compatible y quite las instalaciones del administrador cuando sea necesario.
  4. Haga que los propietarios del servicio quiten el acceso y los recursos específicos del complemento mientras conservan los recursos utilizados por otras soluciones.
  5. Compruebe el resultado con un usuario previamente autorizado y registre los recursos retenidos, las excepciones y los propietarios.

Para retirar un paquete, consulte Retirar el complemento. Para un agente independiente, use el procedimiento del producto aplicable, como Eliminar agentes. No asuma que al quitar un agente o un paquete se revocan todas las conexiones, permisos o servicios externos.