Probar y validar el complemento para Microsoft 365 Copilot

Valida y prueba el artefacto versionado exacto que creaste en Empaqueta tu plugin. Este es el tercer paso de Empaquetar y probar: validar el paquete, instalarlo y confirmar su acceso, comportamiento y experiencias compatibles de Microsoft 365.

Los componentes y servicios externos a los que hace referencia el complemento ya deben funcionar de forma individual y conjunta. En este artículo se prueba el complemento empaquetado; No reemplaza las pruebas ni la certificación a nivel de componente.

Importante

Use el artefacto exacto que desea publicar. Si la ruta de empaquetado no es compatible con los componentes previstos y las experiencias de destino, vuelve a Empaquetar el complemento y elige una ruta compatible.

Antes de empezar

Preparar:

  • El paquete de complementos versionado exacto que pretende lanzar.
  • El procedimiento de instalación o instalación lateral para su ruta de embalaje.
  • Un entorno de prueba e identidades con el acceso necesario.
  • Escenarios representativos y resultados esperados para cada experiencia de destino de Microsoft 365.

Validar el paquete

Utilice el procedimiento de validación de la ruta de envasado.

Ruta de empaquetado Procedimiento de validación
Herramientas de desarrollo de Work IQ Después de crear el paquete, utilízalo wiqd agent validate --mode deep para validar el paquete de la aplicación resuelto. En flujos de trabajo automatizados, inspeccione el resultado JSON data.valid en lugar de confiar solo en el código de salida del proceso. Consulte Validación y Capa de validación de Microsoft.
Paquete de complementos Alpha WIQD Después de wiqd plugin package crear el artefacto, ejecute wiqd plugin validate --mode deep. Esta validación de paquete primero comprueba el manifiesto de la aplicación de nivel superior, las aptitudes y los conectores MCP remotos que la validación de complementos estáticos no cubre. En flujos de trabajo automatizados, inspeccione el resultado de la validación estructurada en lugar de confiar solo en el código de salida del proceso. Consulte Crear un complemento con las herramientas de desarrollo de Work IQ.
Kit de herramientas de agentes de Microsoft 365 Use Validar paquete de la aplicación mediante reglas de validación o ejecute atk validate --app-package-file-path <path>. Consulte Validar su aplicación.
Copilot Studio Complete el flujo de trabajo de publicación y configuración y resuelva errores antes de descargar el .ziparchivo .
Otro flujo de trabajo específico del complemento Siga el procedimiento de validación documentado para ese tipo de paquete.

Confirma que el artefacto generado cumple los requisitos definidos para su tipo de paquete, usa la identidad, la versión y el entorno previstos y no contiene credenciales, secretos, datos de prueba, registros ni archivos no relacionados.

Corrige los errores del paquete, crea una nueva versión del paquete y repite la validación antes de instalarlo.

Instalar o transferir localmente el paquete

  1. Utilice el procedimiento de instalación o carga lateral para su ruta de embalaje.
  2. Instale el artefacto exacto que pasó la validación del paquete.
  3. Registre la versión del artefacto, el entorno de prueba, la identidad y el resultado de la instalación.
  4. Confirma que se reconoce el complemento instalado y los componentes esperados.

Si se produce un error en la instalación, corrija el paquete, cree una nueva versión, vuelva a instalarla y vuelva a probarla.

Probar el complemento empaquetado

  1. Ejecute los escenarios de usuario completos a través del complemento instalado.
  2. Confirme que se carguen los componentes esperados y que se hayan seleccionado los componentes correctos.
  3. Pruebe los escenarios de éxito, error y recuperación requeridos por los componentes y las experiencias de Microsoft 365 compatibles con el complemento.
  4. Registre el resultado esperado y real de cada escenario.

Si un componente no cumple con sus propios requisitos, vuelva a su guía de compilación o validación de componentes. No redefina un error de componente como un éxito de paquete de complementos.

Probar la autenticación y el acceso

Prueba:

  • Inicio de sesión, consentimiento, renovación de token y reconexión.
  • Acceso denegado, permisos insuficientes, conexiones que faltan y servicios no disponibles.
  • Datos y acciones fuera de los permisos del usuario.

Registre las identidades, permisos, autenticación, consentimiento, conexiones, puntos de conexión y versiones de servicio probadas.

Probar experiencias compatibles

Instale y pruebe el paquete en cada experiencia de Microsoft 365 que tenga previsto admitir. No inferir la compatibilidad en una experiencia a partir de los resultados de otra.

Registre las experiencias, los entornos, las limitaciones, las combinaciones no admitidas y los riesgos aceptados para la versión.

Evaluar la calidad de los agentes cuando sea necesario

Si el paquete incluye un agente y la evaluación de la calidad del agente forma parte de los criterios de lanzamiento, evalúe la versión implementada exacta y agregue los resultados al registro de preparación para la publicación. Comience con la introducción a la evaluación del agente.

La evaluación del agente mide la calidad de la respuesta y las regresiones. No reemplaza la validación de paquetes, las pruebas de instalación, las pruebas de acceso o las pruebas en cada experiencia de Microsoft compatible.

Determinar la preparación de la versión

Asignar un resultado:

  • Listo - El paquete de complementos exacto pasó todas las comprobaciones requeridas y no tiene ningún bloqueador de versiones sin resolver.
  • Bloqueado : un error de paquete, referencia, acceso, compatibilidad o tiempo de ejecución impide la publicación.
  • Listo con limitaciones : se superaron las comprobaciones necesarias y las limitaciones restantes se documentaron, aceptaron y fueron adecuadas para su divulgación en el proceso de publicación.

Para cada error de bloqueo, registre el propietario y la resolución requerida. Corrige el problema, vuelve a empaquetar el complemento, vuelve a instalar el nuevo artefacto y repite las pruebas afectadas.

El complemento está listo para publicarse solo cuando este artefacto exacto ha pasado el paquete requerido, la instalación, el acceso, el escenario, la experiencia y las comprobaciones de calidad del agente aplicables.

Continúa publicando y distribuyendo el complemento.

Pasos siguientes