Início Rápido: Criar seu primeiro plug-in com as Ferramentas de Desenvolvimento do Work IQ

A interface de linha de comando (CLI) do Work IQ Dev Tools permite empacotar seu agente declarativo, habilidade ou servidor MCP (Model Context Protocol) existente como um plug-in. A CLI também pode validar o pacote, provisionar o plug-in e compartilhá-lo com seu locatário.

Importante

Toda a wiqd plugin árvore de comando é alfa e está sujeita a alterações. Se as etapas neste passo a passo não funcionarem, confirme os comandos atuais, as combinações de componentes com suporte, as experiências de destino e os requisitos de recursos em Criar um plug-in com o Work IQ Dev Tools.

Pré-requisitos

  • Node.js 24 ou posterior
  • PowerShell 7 ou posterior (somente Windows)
  • Uma conta do Microsoft 365 com acesso ao Copilot
  • Upload de aplicativo personalizado habilitado em seu locatário
  • Um projeto de origem de agente declarativo com suporte

Confirme se você tem um projeto inicial com suporte

Inicie a partir da pasta raiz de um projeto de origem de agente declarativo local. No mínimo, a pasta deve conter:

contoso-support-agent/
|-- appPackage/
|   |-- manifest.json
|   |-- declarativeAgent.json
|   `-- <the instruction and action files referenced by the manifests>
`-- <a supported lifecycle file>

O arquivo de ciclo de vida pode ser m365agents.yml, m365agents.local.yml, teamsapp.ymlou teamsapp.local.yml. O projeto pode conter outras pastas e arquivos de ambiente.

Este guia de início rápido não se aplica quando:

  • Você tem apenas um agente publicado ou pacote instalado e nenhum projeto de origem local. As Ferramentas de Desenvolvimento do Work IQ não documentam uma maneira compatível de reconstruir o projeto de origem a partir de um título implantado. Recupere o repositório de origem original ou use a ferramenta de criação original.
  • O agente existe apenas em uma experiência de criação gerenciada, como o Agent Builder ou o Copilot Studio. Use o procedimento de publicação e compartilhamento dessa ferramenta.
  • Você tem um agente de mecanismo personalizado. Esta rota Work IQ Dev Tools suporta agentes declarativos.
  • Você tem apenas um pacote de .zipagente . Os comandos do ciclo de vida exigem o projeto de origem e seu arquivo de ciclo de vida.

Se você não tiver um projeto existente, poderá seguir as etapas no Tutorial: Criar agentes declarativos usando o Microsoft 365 Agents Toolkit e JSON para criar um agente básico.

Observação

wiqd plugin importimporta formatos de plug-in aberto, plug-in Claude ou plug-in de cursor com suporte. Ele não importa um projeto ou pacote de agente declarativo do Microsoft 365 existente. Para obter mais informações, consulte Importar/exportar (interoperabilidade).

Criar seu plug-in

  1. Se ainda não fez isso, instale o Work IQ Dev Tools.

  2. Abra sua CLI no diretório em que você deseja criar seu plug-in e entre usando o seguinte comando:

    wiqd auth login --interactive

  3. Na CLI, inicie o GitHub Copilot usando o copilot comando.

  4. Peça ao GitHub Copilot para criar um plug-in com seu agente declarativo, habilidade ou servidor MCP existente. Por exemplo:

    Create a plugin named My Plugin by using the agent in "..\My Agent"

Validar o projeto de plug-in

Se o GitHub Copilot não validou o plug-in automaticamente, peça para validar o projeto antes de provisioná-lo ou empacotá-lo.

Validate the plugin

Provisionar o plug-in

Peça ao GitHub Copilot para provisionar o plug-in.

Provision the plugin using the dev environment

Aguarde a conclusão do provisionamento. Agora você pode testar seu plug-in no Microsoft Copilot Chat.

Importante

O plug-in deve ser provisionado usando o dev ambiente do projeto para habilitar o compartilhamento do agente.

Empacotar o plug-in

Peça ao GitHub Copilot para empacotar o plug-in.

Package the plugin

Importante

Você deve provisionar o plug-in antes de empacotá-lo. Se você empacotar antes de provisionar, o pacote resultante será inválido.

Validar o pacote

Peça ao GitHub Copilot para validar o plug-in empacotado. Essa etapa executa uma validação mais detalhada no pacote ZIP gerado.

Validate the packaged zip

Compartilhar o plug-in

Agora você pode pedir ao GitHub Copilot para compartilhar seu pacote com usuários ou grupos específicos dentro da sua organização ou com toda a sua organização.

Share the plugin with AmberR@contoso.com

Ou:

Share the plugin with my organization

Importante

O compartilhamento de plug-ins personalizados depende das configurações da sua organização para permitir ou bloquear o compartilhamento de plug-ins. Se você encontrar algum erro durante esta etapa, marque com seus administradores. Para obter mais informações, consulte Configurações de compartilhamento e publicação de agentes.

Publique o plug-in no registro de plug-in da sua organização

Como alternativa ao compartilhamento do seu plug-in, você pode solicitar a publicação do seu plug-in no registro de plug-ins da sua organização. Os administradores de sua organização podem revisar seu plug-in e aprovar ou negar a solicitação.

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

Exclua o pacote (opcional)

Se esse foi apenas um plug-in de teste, você pode pedir ao GitHub Copilot para remover o agente. Essa ação exclui todos os recursos de nuvem provisionados.

Delete the plugin

Conteúdo relacionado

  • Last updated on