Mejorar y actualizar el complemento

Mejore su complemento mediante el uso de pruebas de supervisión y evaluaciones para encontrar lo que debe cambiar. Aplique la corrección o mejora, publique el paquete exacto que probó y confirme que el complemento actualizado sigue funcionando para los usuarios previstos.

Los constructores mantienen y prueban el paquete. Los administradores de Microsoft 365 completan las acciones de implementación organizativa cuando es necesario. Los propietarios del servicio mantienen los conectores, los servidores MCP remotos, las identidades y los servicios externos que usa el complemento.

Antes de empezar

Tener:

• La identidad actual del complemento y la versión del paquete.
• Cómo llegó la versión actual a los usuarios: uso compartido directo, carga de administrador o Microsoft Marketplace.
• Pruebas de supervisión, comentarios de usuarios, casos de soporte técnico o una mejora planeada.
• Tareas representativas y criterios de aceptación.
• Los usuarios afectados y las experiencias de Microsoft 365.
• Acceso al origen del complemento y las funcionalidades afectadas.
• Propietarios de las conexiones necesarias y los servicios externos.

Si aún no sabes qué hay que cambiar, empieza por Monitoriza tu plugin.

Establecer una línea base

1. Indique el problema o la mejora que desea abordar.
2. Identifique la versión del paquete, los usuarios, las experiencias, las funcionalidades y las dependencias afectadas.
3. Definir tareas representativas y criterios de aceptación medibles.
4. Ejecutar las tareas en el paquete 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>.
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 obtener el control directo de la línea de comandos o de la canalización, consulte Introducción a la CLI de evaluaciones de agentes.

Aplicar y probar el cambio

1. Actualice el origen del complemento o la capacidad 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

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 la opción de reversión o sustitución disponible.

No publiques un paquete diferente del paquete que has validado.

Publicar e implementar la actualización

Elija un método de publicación o uso compartido compatible para el paquete actualizado y la audiencia prevista. Consulte sus instrucciones sobre cómo actualizar un complemento existente; No asuma que compartir o cargar una nueva versión reemplaza su entrada del registro o transfiere la configuración de disponibilidad.

Antes de la publicación, confirme si el método reutiliza la identidad del paquete o crea una entrada independiente, si la disponibilidad del usuario anterior y la configuración de instalación se transfieren, y cómo reemplazar o restaurar una versión si es necesario. Si aparece una segunda entrada, compruebe que los usuarios previstos se han movido a la nueva versión antes de restringir la anterior. No quite una entrada que todavía esté en uso.

Luego:

1. Publica, carga o comparte el paquete probado exacto mediante el método seleccionado y registra si se ha enviado, publicado, compartido, rechazado o bloqueado.
2. Proporcione al administrador o propietario del lanzamiento la versión exacta del paquete, los usuarios previstos, la configuración necesaria, las limitaciones conocidas y el contacto de soporte técnico.
3. Completa solo los pasos aplicables para que el complemento 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 del paquete llegó a cada audiencia.

Para un complemento alfa de Work IQ Dev Tools, wiqd plugin share se publica en el registro de complementos para el público seleccionado; el envío a la tienda pública se realiza por separado en el Centro de partners. Siga la guía del complemento Work IQ Dev Tools para su secuencia de aprovisionamiento, empaquetado, validado y compartido cuando prepare otra versión.

Antes del lanzamiento, confirme si el método admite la restauración de una versión anterior. Reemplazar el paquete no restaura automáticamente un servicio externo, una conexión, una identidad, unos datos o un cambio de permiso.

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 del paquete.
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, siga el procedimiento de reversión o sustitución admitido y restaure las dependencias afectadas cuando sea necesario.

La actualización se completa cuando el público previsto tiene la versión del paquete 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.
• 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 reversión y propietario del soporte técnico.

Contenido relacionado

• Supervisar el complemento
• Empaquetar el complemento
• Validar y probar el complemento
• Publicar o compartir el complemento
• Hacer que el complemento esté disponible
• Administrar complementos, habilidades y servidores MCP
• Retirar el complemento