Nota:
El acceso a esta página requiere autorización. Puede intentar iniciar sesión o cambiar directorios.
El acceso a esta página requiere autorización. Puede intentar cambiar los directorios.
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.
En este artículo se describe el paquete de la aplicación Microsoft 365 que se usa en el flujo de trabajo documentado del complemento Copilot Cowork. Algunas herramientas crean el paquete por usted; Otros flujos de trabajo le permiten ensamblarla manualmente. Use las instrucciones del producto seleccionado para los componentes compatibles, la versión del manifiesto y la ruta de publicación. Un formato de paquete compartido no garantiza que todos los productos admitan las mismas funcionalidades.
Los servidores MCP remotos, las API y otros servicios conectados se ejecutan por separado. El paquete incluye las declaraciones admitidas o las referencias necesarias para conectarse a ellos, no los servicios en ejecución.
Antes de comenzar
Pruebas de integración completas. Confirme que:
- Ha construido y probado los componentes individualmente y en conjunto.
- Ha configurado 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.
- Ha registrado 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.
Comprender el paquete de la aplicación de Microsoft 365
El paquete es un archivo ZIP con manifest.json los iconos a los que se hace referencia en su raíz. El esquema de manifiesto de la aplicación de Microsoft 365 define su identidad, metadatos y declaraciones de funcionalidad.
| Contenido del paquete | Finalidad |
|---|---|
manifest.json |
Identifica la aplicación, la versión, el desarrollador, los nombres, las descripciones, los iconos y las funcionalidades admitidas. |
| Iconos | Archivos de imagen de color y contorno a los que hace referencia el manifiesto de la aplicación. Los documentos color.png de flujo de trabajo de Cowork y outline.png. |
| Habilidades de agente | Cuando se incluyen, las carpetas de habilidades contienen SKILL.md archivos complementarios compatibles. El manifiesto de la aplicación hace referencia a las carpetas a través de agentSkills. |
| Configuración del conector remoto | Cuando se incluye, agentConnectors las entradas en el manifiesto de la aplicación identifican los puntos de conexión de MCP remotos y la configuración de autorización aplicable. El servidor en sí no está empaquetado. |
| Archivos de componentes a los que se hace referencia | Incluya los archivos requeridos por los componentes seleccionados, como un archivo de descripción de herramienta cuando la configuración del conector hace referencia a uno, o definiciones de agente en un paquete de agente compatible. |
Por ejemplo, la documentación de Cowork muestra un paquete con este diseño:
manifest.json
color.png
outline.png
skills/
contract-analysis/
SKILL.md
references/
clause-taxonomy.md
tools/
contoso-legal-tools.json
Las carpetas de habilidades están presentes solo cuando el complemento incluye habilidades. El archivo de descripción de la herramienta solo es necesario cuando la configuración del conector hace referencia. Seguir Compilar complementos para Copilot Cowork para los requisitos actuales de archivos, esquemas, versiones, iconos y aptitudes, en lugar de tratar el ejemplo como una plantilla para cada producto.
Nota
El esquema de manifiesto de complemento 2.4 describe una API o un componente de acción MCP para un agente declarativo, no el paquete de la aplicación externa de Microsoft 365. Esas acciones solo están disponibles para el agente que las contiene. Usa el esquema del manifiesto de la aplicación para el paquete externo.
Elegir una ruta de empaquetado compatible
| Ruta del paquete de complementos | Crear el paquete | Resultado |
|---|---|---|
| Un proyecto de complemento de herramientas de desarrollo de Work IQ (ruta de código profesional recomendada para escenarios compatibles) | Siga los pasos de validación y aprovisionamiento de origen documentados para el entorno seleccionado y, a continuación, ejecute wiqd plugin package. Consulte Crear un complemento con las herramientas de desarrollo de Work IQ. |
Un paquete de aplicación versionado para validar antes de compartirlo o publicarlo. |
| 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 de Cowork ensamblado manualmente | Siga las instrucciones de diseño de manifiesto, habilidad, conector, icono y archivo zip en Complementos de compilación para Copilot Cowork. | Un paquete de la aplicación Microsoft 365 para la ruta documentada de Cowork. |
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.
Para las aptitudes que se usan directamente en Copilot Chat, empaqueta las aptitudes agentSkills de nivel de complemento a través de la propiedad del manifiesto de la aplicación. Esto difiere de la propiedad del agent_skills manifiesto del agente declarativo. Un ZIP independiente SKILL.md o de aptitudes aceptado por Chat no es un paquete completo de aplicación de complemento. Consulte Empaquetar una aptitud en un complemento.
Para automatizar las comprobaciones de origen de WIQD, el empaquetado de candidatos y la validación del paquete primero, consulte Configurar el complemento CI/CD con Work IQ Dev Tools.
Nota
La validación de código fuente de WIQD no es una validación completa del paquete compilado. Valida el ZIP exacto después del empaquetado, utilizando el procedimiento actual de validación de paquetes en Prueba y valida tu complemento.
Identificar el paquete y sus dependencias
Elija la ruta de publicación y distribución deseada antes de ensamblar el artefacto de versión. Para cada ruta, identifique:
- Identidad: El identificador de la aplicación, la versión del paquete y los identificadores de los componentes.
- Metadatos: Nombres, descripciones, información para desarrolladores, iconos y vínculos aplicables a la privacidad y los términos.
- Autenticación: El modelo de identidad, la configuración de autorización admitida, las necesidades de permisos y consentimiento y las referencias de credenciales.
- Conexiones: Los puntos de conexión, las referencias de conexión y la configuración específica del entorno.
- Dependencias externas: Los servicios remotos, los orígenes de datos, los propietarios y la instalación necesitan fuera del paquete.
Coloque solo declaraciones y referencias admitidas por esquemas en el paquete. Mantenga los detalles operativos en el registro de preparación para la publicación y no incluya credenciales ni secretos.
| Ruta de distribución | Qué confirmar para este paquete |
|---|---|
| Uso compartido directo para pruebas | La audiencia seleccionada, el entorno de prueba, la identidad del paquete y los metadatos, y la autenticación, las conexiones y los servicios externos que necesitan esos evaluadores. |
| Distribución de organizaciones | La identidad del paquete y los metadatos para la revisión del administrador, además de la autenticación, la conexión, los permisos y la configuración de servicios externos necesarios en la organización. |
| Distribución pública | La identidad del paquete y los metadatos para la ruta de envío elegida, además de la autenticación, las conexiones y las dependencias externas que las organizaciones del cliente y los usuarios deben configurar. |
Compartir o publicar el paquete no completa la instalación, la asignación, el consentimiento o la configuración de la conexión. Siga los requisitos actuales de la ruta elegida; En este artículo no se define un contrato de envío.
Crear el paquete
- Abre el procedimiento de empaquetado de la ruta de complemento seleccionada.
- Seleccione el entorno previsto y las versiones exactas de los componentes que ha probado.
- Ejecute el comando documentado, la acción de la interfaz de usuario o el flujo de trabajo automatizado.
- 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
Pruebe y valide un registro de preparación para la publicación y complételo antes de publicarlo. 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.