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.
Use las herramientas de desarrollo de Work IQ con la fuente local de un agente declarativo existente para validarlo, aprovisionarlo, empaquetarlo y compartirlo como un complemento. Este inicio rápido se inicia desde un proyecto de origen existente, no desde un scaffolding de agente nuevo.
Este tutorial no crea un nuevo agente ni reconstruye el origen a partir de un agente instalado. Si vas a empezar un nuevo plugin en su lugar, sigue Crear un plugin con las herramientas de desarrollo de Work IQ.
Recomendación
Vea cómo las herramientas de desarrollo de Work IQ crean un complemento de Copilot a partir de una indicación y lo publican en la tienda de agentes en la demostración interactiva.
Requisitos previos
- CLI de GitHub Copilot con una suscripción activa de Copilot
- El complemento WIQD coding-assistant para la CLI de GitHub Copilot (consulte los comandos de instalación en esta sección)
- Node.js 24.15 o posterior y npm, disponible en su
PATH, para la CLI de WIQD y el script de instalación - PowerShell 7 o posterior (solo Windows)
- Una cuenta de Microsoft 365 con acceso a Copilot
- Carga de aplicaciones personalizadas habilitada en el inquilino
- Un proyecto de origen de agente declarativo compatible
Después de instalar la CLI de GitHub Copilot, instale el complemento WIQD coding-asistente:
copilot plugin install wiqd@awesome-copilot
Como alternativa, agregue el mercado WIQD e instale el complemento desde allí:
copilot plugin marketplace add microsoft/wiqd
copilot plugin install wiqd@wiqd
Instale la CLI de WIQD mediante el script de instalación.
Inicie una nueva sesión de la CLI de GitHub Copilot después de la instalación.
El complemento codeding-assistant proporciona instrucciones de creación; no instala la wiqd CLI. Instale la CLI por separado antes de ejecutar los comandos de validación y ciclo de vida. Confirme la instalación de la CLI y wiqd --version compruebe sus requisitos previos con wiqd doctor.
Confirme que tiene un proyecto inicial compatible
Empiece desde la carpeta raíz de un proyecto de origen de agente declarativo local. Como mínimo, la carpeta debe contener:
contoso-support-agent/
|-- appPackage/
| |-- manifest.json
| |-- declarativeAgent.json
| `-- <the instruction and action files referenced by the manifests>
`-- <a supported lifecycle file>
El archivo del ciclo de vida puede ser m365agents.yml, m365agents.local.yml, teamsapp.ymlo teamsapp.local.yml. El proyecto puede contener otras carpetas y archivos de entorno.
Este inicio rápido no se aplica cuando:
- Solo tiene un agente publicado o un paquete instalado y ningún proyecto de código fuente local. Las herramientas de desarrollo de Work IQ no admiten la reconstrucción del proyecto de origen a partir de un título implementado. Recupere el repositorio de origen original o utilice la herramienta de creación original.
- El agente solo existe en una experiencia de creación administrada, como Agent Builder o Copilot Studio. Use el procedimiento de publicación y uso compartido de la herramienta.
- Tiene un agente de motor personalizado. Esta ruta de herramientas de desarrollo de Work IQ admite agentes declarativos.
- Solo tiene un paquete
.zipde agente . Los comandos del ciclo de vida requieren el proyecto de origen y su archivo de ciclo de vida.
Si no tiene un proyecto existente, comience con el inicio rápido de WIQD para crear un complemento y agregar un agente declarativo. WIQD es el punto de partida recomendado para el código profesional en escenarios compatibles.
Nota
wiqd plugin importimportaciones compatibles con los formatos de complemento Open, complemento Claude o complemento cursor. No importa un proyecto o paquete de agente declarativo de Microsoft 365 existente. Para obtener más información, consulte Importar o exportar (interoperabilidad).
Crea tu complemento
Si aún no lo hizo, instale las herramientas de desarrollo de Work IQ.
Abra la CLI en el directorio en el que desea crear el complemento e inicie sesión con el siguiente comando:
wiqd auth login --interactiveEn la CLI, inicie GitHub Copilot mediante el
copilotcomando.Pida a GitHub Copilot que cree un complemento con su agente declarativo, aptitud o servidor MCP existente. Por ejemplo:
Create a plugin named My Plugin by using the agent in "..\My Agent"
Validar el proyecto del complemento
Selecciona explícitamente la validación de origen sin conexión antes de aprovisionar o empaquetar el complemento. En CLI de GitHub Copilot, pregunte:
Validate the plugin source offline in the dev environment
Aprovisionar el complemento
Importante
En este ejemplo se utiliza el entorno compartido dev estándar. Compruebe la configuración del ciclo de vida eficaz y el archivo de entorno seleccionado en environmentFolderPath (predeterminado env) antes AGENT_SCOPE=shared de aprovisionar para compartir. Un entorno con nombre dev por sí solo no establece un ámbito compartido. Mantenga el mismo entorno de aprovisionamiento, empaquetado, validación y uso compartido.
Pedir a GitHub Copilot que aprovisione el complemento.
Provision the plugin using the dev environment
Espere a que finalice el aprovisionamiento. El aprovisionamiento no establece que todas las funcionalidades del complemento están disponibles en Copilot Chat; el soporte técnico depende del componente y de la experiencia de destino de Microsoft 365.
Empaquetar el complemento
Pida a GitHub Copilot que empaquete el complemento.
Package the plugin using the dev environment
Importante
Debes aprovisionar el complemento antes de empaquetarlo. Si empaqueta antes de aprovisionar, el paquete resultante no será válido.
Validar el paquete
Después del empaquetado, busque el archivo ZIP generado y confirme que el archivo existe. En la CLI de GitHub Copilot, proporcione su ruta real y pregunte:
Validate this existing plugin ZIP in package mode using the dev environment
La validación de paquetes usa --mode package un archivo ZIP proporcionado a través de --package-file, no una compilación automática. Revise el veredicto y los hallazgos devueltos. El código 0 de salida significa que se superaron las comprobaciones seleccionadas; las advertencias aún se pueden notificar. Los hallazgos de bloqueo o los resultados incompletos no son un pase y la validación del paquete no prueba el comportamiento en tiempo de ejecución.
Los modos de validación actuales son source, package, y marketplace.
source es la comprobación explícita sin conexión. El valor predeterminado, packagerequiere un archivo postal existente, carga una copia capturada en el servicio de validación de Microsoft 365 y podría requerir autenticación.
marketplace agrega verificaciones de políticas y evidencia; No es la aprobación oficial de la tienda. La validación no crea automáticamente un archivo ZIP, no inicia la sesión ni aprovisiona el complemento. Para obtener más información, consulte Validación y MVL.
Compartir el complemento
Ahora puedes pedir a GitHub Copilot que comparta la implementación del complemento, ya sea con usuarios específicos de la organización o con toda la organización. Confirme AGENT_SCOPE=shared en el entorno seleccionado antes de compartir. El público que comparte (--scope users o --scope tenant) no cambia el ámbito de implementación.
Share the plugin with AmberR@contoso.com using the dev environment
O bien:
Share the plugin with my organization using the dev environment
Importante
El uso compartido de complementos personalizados depende de la configuración de su organización para permitir o bloquear el uso compartido de complementos. Si encuentra algún error durante este paso, consulte con sus administradores. Para obtener más información, consulte Configuración de publicación y uso compartido del agente.
Publique el complemento en el registro de complementos de su organización
En lugar de compartir el complemento, puedes solicitar su publicación en el registro de complementos de tu organización. Los administradores de su organización pueden revisar el complemento y aprobar o denegar la solicitud.
Submit my plugin to the organization catalog for admin approval using the dev environment
Compartir otorga acceso directo; El envío de catálogos es una operación independiente y no es la aprobación del administrador ni la instalación completa del usuario.
Eliminar el paquete (opcional)
Si este complemento es solo un complemento de prueba, pide a GitHub Copilot que lo quite. Esta acción elimina los recursos en la nube aprovisionados.
Delete the plugin using the dev environment