Empaquetar el complemento para Microsoft 365 Copilot

Crea el paquete de complementos versionado exacto que deseas probar y publicar. Este paso se produce después de que los componentes del complemento trabajen juntos en el entorno de desarrollo o prueba previsto.

Importante

Un .zip archivo no es automáticamente un paquete de complementos compatible. Usa una ruta de empaquetado solo cuando admita los componentes del complemento y las experiencias de Microsoft 365 que deseas publicar.

El empaquetado es específico de la herramienta. Algunas herramientas crean el paquete de complementos automáticamente, mientras que otras requieren que ensamble sus manifiestos, metadatos, configuración y activos. El paquete hace referencia a servidores MCP remotos, API, servicios de conector y otros servicios externos, en lugar de incluirlos físicamente.

Antes de empezar

Pruebas de integración completas. Confirme que:

  • Los componentes se construyen y prueban individualmente y en conjunto.
  • Se configuran las dependencias, la autenticación, los permisos, las conexiones, los puntos de conexión y los servicios externos.
  • Sabe qué experiencias de Microsoft 365 debe admitir el complemento.
  • Se registran las versiones de los componentes, las limitaciones conocidas y los problemas sin resolver.

No uses el empaquetado para resolver un componente o integración sin terminar. Vuelva a Compilar o reutilizar cuando un componente necesario no funcione.

Elija la ruta de empaquetado

Ruta del paquete de complementos Crear el paquete Resultado
Un proyecto de complemento alfa de WIQD que compone agentes compatibles, aptitudes o conectores MCP remotos Ejecutar wiqd plugin validate, aprovisionar el entorno seleccionado para enlazar la identidad del paquete y, a continuación, ejecutar wiqd plugin package. Valide en profundidad el paquete creado en el paso siguiente. Consulte Crear un complemento con las herramientas de desarrollo de Work IQ. Un implementable .zip para el uso compartido admitido o la carga del administrador.
Un paquete de complementos creado con Microsoft 365 Agents Toolkit, cuando el flujo de trabajo seleccionado admite los componentes del complemento y las experiencias de destino Seleccione el paquete de la aplicación Zip Teams o use la acción del ciclo de teamsApp/zipAppPackage vida. Consulte Personalizar un manifiesto de aplicación en el Kit de herramientas de agentes. El paquete de complementos producido por el flujo de trabajo compatible.
Un paquete de complementos compatible con otro flujo de trabajo específico del complemento Sigue el comando documentado, la acción de la interfaz de usuario o el flujo de trabajo automatizado para ese paquete. El paquete de complementos instalables identificado por ese procedimiento.

Si ninguna ruta de empaquetado admite los componentes y las experiencias de destino del complemento, deténgase. Elige un método compatible o revisa el complemento. No combine ni cambie el nombre de los artefactos para crear un paquete no compatible.

Nota:

Static wiqd plugin validate solo comprueba la superficie del agente declarativo y los archivos API-plugin u OpenAPI a los que se hace referencia. Un complemento de solo aptitudes o de solo conector puede pasar la comprobación estática sin que se validen sus capacidades de nivel superior. Se requiere una validación profunda primero del paquete para comprobar el paquete de la aplicación compilada.

Crear el paquete

  1. Abre el procedimiento de empaquetado de la ruta de complemento seleccionada.
  2. Seleccione el entorno previsto y las versiones exactas de los componentes que ha probado.
  3. Ejecute el comando documentado, la acción de la interfaz de usuario o el flujo de trabajo automatizado.
  4. Registre el nombre del artefacto, la ubicación, la versión, el entorno y la versión de la herramienta.

Comprobar el artefacto generado

Comprueba que:

  • La identidad del complemento y la versión del paquete son correctas.
  • El paquete contiene los manifiestos, metadatos, configuración y recursos esperados.
  • Las declaraciones de componentes, los archivos, los identificadores, los puntos de conexión y las referencias de servicio coinciden con las versiones probadas.
  • El paquete utiliza la configuración de entorno prevista.
  • Los requisitos de autenticación, permiso, consentimiento y conexión se declaran sin credenciales, tokens ni secretos.
  • El paquete no contiene archivos temporales, registros, datos de prueba ni artefactos no relacionados.

Preparación para la publicación de registros

Lleve un registro de preparación para la publicación en las pruebas y validación, y complételo antes de publicar. Record:

  • Identidad de paquete o artefacto y versión exacta.
  • componentes, servicios remotos y referencias externas.
  • Herramienta de empaquetado y método de publicación previsto.
  • Experiencias y entornos de Microsoft 365 probados.
  • Requisitos de autenticación, permiso, consentimiento y conexión.
  • Evidencia de validación y resultado.
  • Limitaciones conocidas, combinaciones no admitidas y riesgos aceptados.
  • Propietario del lanzamiento y fecha de validación.

Siguiente: Probar y validar el complemento

Continúa validando y probando el paquete de complementos exacto. No lo publique hasta que pase el paquete, la instalación, el acceso, el escenario, la experiencia y las comprobaciones de evaluación necesarias aplicables.