Probar y validar el complemento para Microsoft 365 Copilot

Probar el artefacto versionado exacto producido por Crea el paquete de complementos. En la prueba de & del paquete, conecte las evidencias del componente a ese archivo ZIP, instálelo a través de una ruta compatible y compruebe la versión entregada, el acceso y el comportamiento en tiempo de ejecución real en cada experiencia de Microsoft reclamada.

Termine con esta evidencia: "Probé estos componentes, empaqueté estas referencias exactas, instalé esta versión exacta, ejecuté estos escenarios y mantuve estos resultados". Una comprobación de esquema, un comando de provisión o una respuesta plausible correctos no establecen esa cadena.

Antes de comenzar

Tener:

  • Pruebas de integración y componentes completadas, incluidos los datos de prueba conocidos y los resultados esperados.
  • El ZIP candidato, su identidad/versión del paquete y las versiones de los componentes, puntos finales y referencias de conexión que contiene.
  • Un inquilino de desarrollo, datos que no son de producción, una ruta de instalación compatible con los componentes del paquete y permiso para usarlo.
  • Probar identidades para usuarios permitidos y restringidos; Un administrador autorizado para pruebas de disponibilidad y bloqueo.
  • Licencias necesarias, inicio de sesión, consentimiento, conexiones y servicios externos para cada experiencia de destino.
  • Un registro de prueba para cada escenario e identidad.

Antes de realizar la prueba, defina el paquete necesario, la instalación, las comprobaciones de acceso y tiempo de ejecución, y las pruebas que establecerán cada resultado. Utilice los criterios de evidencia específicos del componente para las reclamaciones en tiempo de ejecución y la evidencia de instalación descrita en Confirmar la versión entregada.

Obtén aprobación antes de cargar un paquete, instalarlo, otorgar consentimiento, compartirlo o cambiar la configuración de administración. Estos procedimientos cambian el estado del inquilino; Usar identidades y audiencias de prueba controladas.

Validar esquemas y referencias de componentes

Abrir el ZIP candidato sin modificarlo. Lee su raíz manifest.json, grabación id, version, y manifestVersion. Confirme que:

  • El manifiesto usa el esquema de manifiesto de la aplicación Microsoft 365 requerido por la ruta.
  • Las definiciones de agente y los manifiestos de acción incluidos usan sus esquemas aplicables. Un manifiesto de complemento de API describe una acción de agente, no el complemento de registro externo.
  • Las carpetas de habilidades, los archivos complementarios, los iconos y las descripciones de herramientas a los que se hace referencia existen en sus rutas de acceso de paquete declaradas.
  • Las versiones, los identificadores, los puntos de conexión y las referencias de conexión coinciden con los registros de prueba de componentes y el entorno previsto.
  • No se incluyen credenciales, secretos, registros ni archivos de prueba no relacionados.

Para las herramientas de desarrollo de Work IQ, use los requisitos previos de la CLI documentados, incluidos Node.js 24.15+, npm y PowerShell 7+ para estos ejemplos de Windows. Una comprobación opcional de origen sin conexión en el proyecto existente es:

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

Verificar: Las comprobaciones de origen aplicables se superan y se registran las funcionalidades omitidas o descubiertas.

El modo de origen comprueba los diagnósticos de agente declarativo guardados y las protecciones básicas del proyecto. No valida completamente el esquema de la aplicación, el contenido de aptitudes, la raíz agentConnectors[]o el contenido de API/OpenAPI al que se hace referencia. Un proyecto solo de aptitudes o solo conector no puede tener comprobaciones de agente aplicables. Usar source explícitamente: el modo predeterminado es la validación de paquetes, no una comprobación sin conexión.

Validar el paquete exacto

Seleccione un archivo ZIP explícitamente en lugar de depender de un directorio de compilación con varios candidatos. En PowerShell, reemplace la ruta de ejemplo por el artefacto:

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

Verificar: El archivo resuelto es el candidato previsto. Opcionalmente, conserve el hash calculado localmente para detectar cambios posteriores; Un hash local no prueba qué bytes ejecuta el host.

  1. Antes de una validación autenticada, inicie sesión con la identidad de Microsoft 365 prevista:

    wiqd auth login --interactive
    wiqd doctor
    

    Verificar: Las comprobaciones de autenticación y preparación se realizan correctamente para el inquilino previsto.

  2. Con la aprobación para cargar este archivo ZIP en el servicio de validación de plataforma, ejecute:

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

    Verificar: Los hallazgos para este archivo ZIP exacto satisfacen las comprobaciones requeridas; conservar los informes JSON y HTML inmutables devueltos.

  3. Si la ruta de publicación requiere la directiva de Marketplace adicional y comprobaciones de evidencia, ejecute:

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

    Verificar: Se superan las comprobaciones necesarias de paquetes, directivas y pruebas, sin que falte ninguna prueba necesaria.

Ambos package usan marketplace el archivo ZIP integrado, cárguelo y puede requerir inicio de sesión. No la crean ni inician sesión automáticamente. También aceptan un archivo ZIP sin su proyecto de origen. El modo Marketplace agrega comprobaciones de directivas y pruebas. Su informe no es la aprobación oficial de Store o del Centro de partners. Siga el contrato de validación de WIQD actual, no los nombres obsoletos deep, statico manifest de modo.

Lea los hallazgos, la cobertura, las comprobaciones omitidas y la evidencia requerida, no solo el resultado de salida del comando. Para una ruta de paquete de Agents Toolkit compatible, use Validar paquete de la aplicación mediante reglas de validación o atk validate --app-package-file-path <path> como se documenta en Validar la aplicación.

Si algo cambia en el archivo ZIP, cree un nuevo candidato y repita la validación. Los cambios de servicio remotos requieren volver a realizar las pruebas en tiempo de ejecución pertinentes, incluso cuando el archivo ZIP no se modifica.

Instalar o transferir localmente el paquete

Use una ruta que acepte el paquete de la aplicación Microsoft 365 nativa y admita sus componentes. Un enlace de instalación y prueba de aprovisionamiento WIQD identifica una implementación; Al abrirlo, no se establece que se instaló el archivo zip validado final.

Instalación de archivos zip personales

Siga el procedimiento de instalación de prueba personal de Cowork para la instalación, autenticación e instalación de paquetes de CLI cuando se admitan el paquete y la experiencia de destino. Pasar el archivo exacto seleccionado en Validar el paquete exacto, usando $packageFile como valor de --file-path y Personal como ámbito.

Verificar: La instalación se realiza correctamente para la cuenta prevista. Guarde lo devuelto TitleId junto AppId con la identidad/versión del paquete y la salida del instalador. En la experiencia compatible, confirme que el complemento instalado expone los componentes y la identidad esperados y que las conexiones requeridas están completas.

Si la directiva deshabilita la ruta personal o la ruta no es compatible con el candidato, utilice una ruta compatible aprobada en lugar de cambiar los controles de seguridad.

Carga de paquetes de Cowork

Para obtener un paquete de Cowork compatible, siga Cargar un paquete de complementos y sus instrucciones de uso compartido. Elija el archivo ZIP nativo de Microsoft 365 validado exacto y limite el acceso a la identidad de prueba o a un público de prueba autorizado explícitamente. Seguir Use complementos con Cowork para habilitar el complemento y completar las conexiones requeridas en una nueva conversación.

Verificar: El archivo seleccionado y la identidad del complemento mostrada coinciden con el registro del candidato. El complemento se instala para la identidad prevista, aparecen las aptitudes esperadas y el estado del conector, y las operaciones protegidas usan la cuenta conectada deseada.

Las cargas en formato extranjero se pueden convertir automáticamente. Esta conversión no es una prueba de que el archivo postal de Microsoft 365 original se haya probado sin cambios. Volver a establecer el artefacto y las evidencias de validación si la ruta lo transforma.

Confirme la versión entregada

Mantenga un registro de instalación que vincule el archivo ZIP seleccionado exacto y su manifiesto id con version la instalación correcta, la cuenta prevista y las identidades de instalación devueltas. Para la ruta de instalación de prueba personal documentada, conserve el comando con su ruta de acceso al archivo resuelta, los metadatos del manifiesto del candidato y la salida del instalador que contiene TitleId y AppId. Para una carga nativa de Cowork compatible, conserva el archivo seleccionado y el registro de carga/instalación correcta con la identidad del complemento mostrada y la cuenta de prueba.

Use esa cadena como evidencia de instalación para el candidato probado. Correlacione los metadatos de versión expuestos por la ruta host o de administración con el candidato e investigue las discrepancias antes de realizar las pruebas. Registre las pruebas de instalación por separado de la invocación.

Los pasos de instalación personal citados no documentan una consulta de versión instalada universal ni un hash de paquete del lado servidor. Ninguno de los dos es requerido por este procedimiento: el registro de instalación establece qué candidato se envió e instaló con éxito, no una verificación independiente de los bytes que ejecuta el host. Si sus criterios de liberación requieren una versión independiente del lado del host o una verificación de bytes, obtenga esa evidencia; su ausencia permanece sin verificar y bloquea esa notificación de liberación. Un vínculo de aprovisionamiento, un nombre de complemento, una respuesta correcta o un hash local por sí solos no establecen la cadena de instalación.

Para un candidato administrado por el administrador, debe seguir el procedimiento de carga e instalación actual del Registro, limitar el ámbito de los usuarios de prueba y conservar el artefacto y el registro de instalación aceptados. Si la ruta acepta un tipo de artefacto diferente o no puede establecer su relación con el archivo ZIP validado, trate la comprobación de enlace de artefactos como no comprobada, no equivalente.

Probar el complemento empaquetado

Repita los escenarios de integración completos con el candidato instalado, no con la implementación de desarrollo anterior:

  1. Inicie una nueva conversación en cada experiencia reclamada. Use el mismo rol de identidad, registro conocido, entrada y resultado esperado que las pruebas del componente.

    Verificar: Se selecciona el componente instalado previsto.

  2. Reúna la evidencia específica del componente. En el caso de las llamadas remotas, correlacione los registros de servicio autenticados con la solicitud, las entradas y los datos devueltos.

    Verificar: La evidencia del host identifica la aptitud seleccionada o cargada cuando corresponda. Las llamadas de herramienta necesarias tienen evidencia de invocación correlacionada y los datos devueltos contribuyen a la respuesta.

  3. Inspeccione los archivos de salida y las citas. Repita los casos de error y límite aplicables.

    Verificar: La corrección, los límites de acceso, las aprobaciones y el comportamiento de error cumplen los criterios predefinidos.

Para las aptitudes de notas de versión, vuelva a usar Added CSV export; Fixed duplicate rows; Updated help text. los archivos de comprobación, características, correcciones, otros y prometidos. Para realizar una búsqueda de MCP, compare el título exacto, el estado y la dirección URL del problema conocido con los registros de servicio. Utilizar las herramientas de evidencia específicas de los componentes; Una ruta de diagnóstico de agente por sí sola no establece que se haya ejecutado un complemento instalado independiente.

Mantenga separados los resultados de la corrección y la invocación. La evidencia faltante para un cheque requerido sigue sin verificarse. Registre diagnósticos adicionales no disponibles como limitaciones, no como detalles de ejecución verificados o errores automáticos. Repite las pruebas de descubrimiento, conexión, selección y tiempo de ejecución por separado en Chat y en Cowork al reclamar ambas.

Probar la autenticación y el acceso

Haga que un administrador autorizado prepare la configuración de prueba controlada a través de Establecer la disponibilidad del complemento para los usuarios y Administrar complementos, habilidades y servidores MCP. Registre la configuración original y restáurela después de la prueba aprobada. Usa la misma búsqueda inofensiva o un escenario equivalente que admite tu complemento. En el caso de una comprobación inaplicable, como el consentimiento de servicio en un escenario de solo aptitudes, registre el motivo en lugar de agregar una funcionalidad.

Prueba Configuración y acción Resultados esperados
Usuario permitido Incluye la identidad de prueba en el público aprobado. Inicie sesión como ese usuario y complete las conexiones o el consentimiento necesarios. El escenario admitido se realiza correctamente dentro de los permisos de origen de ese usuario; Las evidencias de invocación identifican la capacidad esperada.
Usuario restringido Restrinja la disponibilidad al público aprobado y, a continuación, pruebe con una cuenta fuera de ese público. El usuario no puede usar el complemento. En el canal Copilot, la lista puede seguir siendo detectable como bloqueada; Los usuarios elegibles pueden solicitar acceso. La visibilidad por sí sola no es un fracaso.
Consentimiento denegado Use una identidad o conexión de prueba sin una concesión existente. Declina el consentimiento necesario de la operación y vuelve a intentar la búsqueda protegida. La operación no obtiene el acceso protegido solicitado. Registre el error de inicio de sesión o consentimiento y asegúrese de que ningún resultado protegido se presente como correcto. Las funcionalidades permitidas no relacionadas pueden seguir funcionando.
Bloquear y desbloquear Pida al administrador que le siga Bloquear un complemento o una habilidad para el candidato. Repita la solicitud con un usuario previamente permitido, luego haga que el administrador seleccione Desbloquear para el complemento y repita la solicitud nuevamente. Mientras está bloqueado, el complemento y los agentes dependientes no se pueden utilizar. Los servidores/conectores MCP asociados siguen estando disponibles para otros complementos. Después del desbloqueo, el usuario previamente permitido puede volver a usar el complemento, sujeto a los requisitos originales de disponibilidad, permiso y conexión.

Las restricciones de categoría del publicador son controles independientes. Si prueba uno, registre la categoría y su resultado de política; No cambie la configuración de toda la organización simplemente para probar un candidato. Pruebe la renovación o reconexión del inicio de sesión, los permisos de origen y las conexiones que faltan, si procede.

Para la autenticación con código de autorización de Microsoft Entra, el consentimiento denegado devuelve un error de autorización; use el error del proveedor real en lugar de esperar palabras idénticas en cada host.

Probar experiencias compatibles

Registre un resultado por experiencia, identidad, rol y escenario, incluidas las pruebas de la instalación y de la versión de entrega. Un pase en Cowork no establece un pase en el chat u otro host. Use la ruta admitida para cada uno; La evidencia de instalación o versión no resuelta impide una notificación de versión para esa experiencia.

Registrar resultados con calidad de agente

Si se incluye un agente y los criterios de versión requieren una evaluación de calidad, evalúe la versión implementada correspondiente y vincule sus resultados al registro candidato. Comience con la introducción a la evaluación del agente. Las puntuaciones de calidad no reemplazan las pruebas del paquete, la versión instalada, el acceso o la invocación.

Repetir pruebas de regresión para un candidato

Vuelva a ejecutar los escenarios de línea base registrados, las pruebas de acceso, los casos de error y cualquier evaluación necesaria del agente en relación con el candidato instalado. Agregue casos específicos de cambios sin quitar la línea base. Conserve ambos conjuntos de registros de prueba, compare los resultados y resuelva las regresiones o las comprobaciones no verificadas necesarias antes de la aprobación.

Para la preparación de línea base y el ciclo de vida de la actualización, incluidas las decisiones de publicación, implementación, reemplazo y reversión, siga Supervisar, actualizar y retirar su complemento o agente. No asuma actualizaciones automáticas, asignaciones preservadas o un desencadenador de nuevo consentimiento en particular. Después del lanzamiento, repita la verificación de la versión entregada y del entorno de ejecución.

Determinar la preparación de la versión

Complete el registro de prueba compartido con la identidad y versión del paquete, el archivo ZIP exacto y el hash opcional, las versiones de los componentes y los puntos finales, el entorno, el rol de identidad de prueba, el escenario, los resultados esperados y reales, las pruebas de invocación saneadas, el estado y el propietario. Adjunte informes de validación y pruebas de instalación y versión.

Asignar un resultado:

  • Listo - El candidato exacto pasó todas las comprobaciones requeridas con evidencia completa y sin bloqueador de liberación sin resolver.
  • Bloqueado : faltó una comprobación necesaria o sigue sin comprobarse, incluido el enlace de artefactos, la versión entregada, el acceso o la invocación.
  • Listo con limitaciones - Comprobaciones requeridas superadas; Las limitaciones restantes de no bloqueo están documentadas, aceptadas y son adecuadas para su divulgación.

Aplique los controles requeridos y los criterios de evidencia definidos antes de la prueba. Una limitación diagnóstica aceptada no puede convertir la falta de evidencia requerida en un pase; Los diagnósticos adicionales no son obligatorios cuando las comprobaciones requeridas ya tienen pruebas suficientes. Para cada bloqueador, registre un propietario y una resolución. Cree un nuevo candidato cuando cambie el artefacto, vuelva a instalarlo y repita las pruebas afectadas y de regresión.

Siguiente paso

Cuando se complete la evidencia requerida, continúe publicando & distribuyendo: