Empaquetar el complemento para Microsoft 365 Copilot

Cree el artefacto versionado exacto que desea probar y publicar. Este es el segundo paso en Empaquetar y probar, después de que los componentes completados funcionen juntos en el entorno de desarrollo o prueba previsto.

Importante

Una .zip aplicación producida para un agente o Microsoft 365 no es automáticamente un paquete de complementos para cada combinación de componentes. Use una ruta solo cuando admita los componentes y las experiencias de Microsoft 365 que desea publicar.

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

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

¿Qué construiste?	Crear el paquete	Resultado
Un proyecto de agente declarativo admitido por Work IQ Dev Tools	Ejecute wiqd agent validate para validar un proyecto estático y, a continuación, ejecute wiqd agent package. Valide en profundidad el paquete resuelto en el paso siguiente.	Un implementable .zip para la instalación de prueba o la carga.
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 proyecto de manifiesto de aplicación de Microsoft 365 compatible creado con el Kit de herramientas de agentes de Microsoft 365	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.	appPackage/build/appPackage.<environment>.zip.
Un agente para Microsoft 365 Copilot creado en Copilot Studio	Seleccione Publicar y use Descargar como .zip en las opciones de disponibilidad. Consulte Publicar y configurar un agente para Microsoft 365 Copilot.	A .zip para la carga manual o el envío a un administrador.
Componentes compatibles con otro flujo de trabajo específico del complemento	Siga el comando documentado, la acción de la interfaz de usuario o el flujo de trabajo automatizado.	El artefacto instalable identificado por ese procedimiento.

Si una ruta no admite los componentes previstos y las experiencias objetivo, deténgase. Elige una ruta 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. Abra el procedimiento para la ruta 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 ruta de publicación prevista.
• 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 para validar y probar el paquete exacto. No publique el artefacto hasta que pase las comprobaciones aplicables de paquete, instalación, acceso, escenario, experiencia y calidad del agente.