Inicio rápido: Crear su primer complemento con las herramientas de desarrollo de Work IQ

La interfaz de línea de comandos (CLI) de Work IQ Dev Tools le permite empaquetar su agente declarativo, aptitud o servidor de Protocolo de contexto de modelo (MCP) existente como un complemento. La CLI también puede validar el paquete, aprovisionar el complemento y compartirlo con su inquilino.

Importante

Todo el wiqd plugin árbol de comandos es alfa y está sujeto a cambios. Si los pasos de este tutorial no funcionan, confirme los comandos actuales, las combinaciones de componentes admitidas, las experiencias de destino y los requisitos de características en Crear un complemento con las herramientas de desarrollo de Work IQ.

Requisitos previos

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 documentan una manera admitida de reconstruir el 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, puede seguir los pasos de Tutorial: Crear agentes declarativos mediante el Kit de herramientas de agentes de Microsoft 365 y JSON para crear un agente básico.

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

  1. Si aún no lo hizo, instale las herramientas de desarrollo de Work IQ.

  2. Abra la CLI en el directorio en el que desea crear el complemento e inicie sesión con el siguiente comando:

    wiqd auth login --interactive

  3. En la CLI, inicie GitHub Copilot mediante el copilot comando.

  4. 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

Si GitHub Copilot no validó el complemento automáticamente, pídale que valide el proyecto antes de aprovisionarlo o empaquetarlo.

Validate the plugin

Aprovisionar el complemento

Pedir a GitHub Copilot que aprovisione el complemento.

Provision the plugin using the dev environment

Tiempo de espera para completarse el aprovisionamiento. Ahora puedes probar el complemento en Microsoft Copilot Chat.

Importante

El complemento debe aprovisionarse mediante el entorno del proyecto para permitir el dev uso compartido del agente.

Empaquetar el complemento

Pida a GitHub Copilot que empaquete el complemento.

Package the plugin

Importante

Debes aprovisionar el complemento antes de empaquetarlo. Si empaqueta antes de aprovisionar, el paquete resultante no será válido.

Validar el paquete

Solicitar a GitHub Copilot que valide el complemento empaquetado. En este paso se ejecuta una validación más detallada en el paquete ZIP generado.

Validate the packaged zip

Compartir el complemento

Ahora puedes pedir a GitHub Copilot que comparta tu paquete, ya sea con usuarios o grupos específicos dentro de tu organización, o con toda tu organización.

Share the plugin with AmberR@contoso.com

O bien:

Share the plugin with my organization

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

Como alternativa a compartir el complemento, puedes solicitar la publicación del complemento en el registro de complementos de tu organización. Los administradores de la organización podrán revisar el complemento y aprobar o denegar la solicitud.

Publish my package to the plugin registry so all users in my tenant can use it

Eliminar el paquete (opcional)

Si se trataba solo de un complemento de prueba, puedes pedir a GitHub Copilot que quite el agente. Esta acción elimina los recursos en la nube aprovisionados.

Delete the plugin

Contenido relacionado

  • Se actualizó por última vez el