Observação
O acesso a essa página exige autorização. Você pode tentar entrar ou alterar diretórios.
O acesso a essa página exige autorização. Você pode tentar alterar os diretórios.
Durante a Preparação, transforme suas opções de funcionalidade em um plano de compilação. Comece com o Work IQ Dev Tools para desenvolvimento profissional, escolha um ambiente documentado e adicione Microsoft 365 Agents Toolkit ou um SDK somente quando o cenário precisar. Você termina com uma ferramenta, local de origem, proprietário e pré-requisitos para cada componente.
Para criar recursos do Copilot em um aplicativo que você possui, siga Criar aplicativos com tecnologia Copilot .
Comece com o Work IQ Ferramentas de Desenvolvimento
As Ferramentas de Desenvolvimento do Work IQ são o caminho padrão de desenvolvedor profissional para cenários de plug-in compatíveis. Use seu fluxo de trabalho guiado para criar e compor um plug-in e, em seguida, validá-lo, provisioná-lo, empacotá-lo e compartilhá-lo. Use comandos diretos da CLI quando precisar de execução ou script repetível.
Escolha a superfície de comando que possui sua origem:
| Sua origem e tarefa | Comece aqui | Limite |
|---|---|---|
| Um novo plug-in que contém habilidades compatíveis, conectores de plug-in para servidores MCP remotos ou um agente declarativo opcional | Crie um plugin com WIQD |
wiqd plugin add agent scaffolds um componente do agente; Ele não importa um projeto de agente existente. |
| Um projeto de origem de agente declarativo existente | Ciclo de vida do componente do agente | Use o fluxo de trabalho documentado wiqd agent para esse projeto. |
| Um plug-in aberto, plug-in Claude ou fonte de plug-in de cursor com suporte | Importação e exportação de WIQD | A conversão de formato não estabelece um comportamento de tempo de execução equivalente ou suporte a host. |
| Uma implantação compartilhada testada para usuários selecionados | Crie um plugin com WIQD | O compartilhamento concede acesso; Não é o envio do catálogo da organização. |
| Um plug-in testado para o catálogo da organização | Publicação e projetos existentes |
wiqd plugin publish é enviado para aprovação do administrador, não para certificação pública do Marketplace. |
Use a validação explícita da origem para verificações offline. O modo de validação padrão é a validação de pacote em relação a um ZIP existente; Ele pode carregar o pacote e exigir autenticação. Nenhum dos modos substitui o teste das funcionalidades reais na experiência pretendida.
Escolha seu ambiente
A tabela a seguir lista as rotas WIQD documentadas. Não é uma matriz de compatibilidade exaustiva:
| Ambiente | Use-o para | Configuração e restrições |
|---|---|---|
| CLI do GitHub Copilot | Criação guiada de plug-ins com o plug-in do assistente de codificação WIQD | Instale o host e seu plug-in WIQD Marketplace e, em seguida, inicie uma nova sessão. O plug-in do marketplace não instala a CLI do WIQD. |
| Código Claude | Criação guiada com o plug-in WIQD para esse host | Siga as etapas do marketplace específicas do host na instalação do WIQD. |
| Linha de comando direta | Validação e comandos repetíveis de plugin ou ciclo de vida do agente | Instale a CLI separada. A rota do script de instalação requer Node.js 24.15 ou posterior e npm; O Windows requer o PowerShell 7 ou posterior. |
| Visual Studio Code | Edição de projeto e diagnóstico de manifesto por meio da extensão opcional WIQD | Siga a instalação do WIQD para a integração atual do editor. Os diagnósticos do editor não substituem a validação do pacote final. |
| Pipelines de CI/CD confiáveis | Operações de provisionamento, publicação e compartilhamento com suporte de núcleo, sujeitas aos limites de autenticação da versão selecionada | Siga as orientações de CI/CD do Plug-in e a autenticação de pipeline. Os exemplos de pipeline agent-project não são um gerador de pipeline com reconhecimento de plug-in. |
Para operações de locatário local, entre interativamente antes de provisionar. Para automação, use o contrato de pipeline confiável publicado e o armazenamento secreto. Não execute a interação na wiqd auth login CI nem exponha credenciais a trabalhos de solicitação de pull não confiáveis. A autenticação do ciclo de vida principal não autentica consultas, avaliações ou outras extensões do Work IQ. Não aplique um corpo de comando agent-project inalterado a um projeto de plug-in.
Para pré-requisitos de conta, locatário e ferramenta, use Configurar seu ambiente de desenvolvimento. Um assistente de codificação pode ajudar a criar arquivos, mas não substitui a ferramenta de criação, o tempo de execução, as permissões ou os requisitos de publicação do componente.
Adicione ferramentas específicas do componente quando necessário
Use essas rotas de produto quando o componente selecionado precisar de controles específicos de criação ou projeto. Siga o procedimento do próprio produto, em vez de tratar as ferramentas como formatos de embalagem intercambiáveis.
| Requisito | Entrega de ferramenta ou produto |
|---|---|
| Controle de nível inferior de um projeto, manifestos ou integrações de agente declarativo com suporte | Microsoft 365 Agents Toolkit, usando JSON ou TypeSpec |
| Uma experiência de criação de agente declarativo guiada e gerenciada | Construtor de Agentes; Usar seu próprio procedimento de habilidade para habilidades com suporte |
| Fluxos de trabalho gerenciados, conectores do Power Platform, ambientes e lógica de agente de baixo código | Copilot Studio; usar seu canal de publicação do Microsoft 365 quando aplicável |
| Um agente fundamentado em sites ou bibliotecas de documentos selecionados do SharePoint | Diretrizes de agente do SharePoint e diretrizes de atualização para o formato selecionado |
| Conectores de habilidades ou plug-ins para o Copilot Cowork | Crie plug-ins para o Copilot Cowork para requisitos de arquivo, tempo de execução e teste específicos do produto |
| Um conector do Copilot (sincronizado) que ingere conteúdo externo no Microsoft Graph | Crie seu primeiro conector Copilot personalizado |
| Uma ação MCP remota em um agente declarativo | Criar um plug-in de um servidor MCP |
Atualmente, o Agent Builder no Copilot Studio não dá suporte à adição de habilidades. Não deduza seu conjunto de recursos da experiência separada do Construtor de Agentes no Microsoft 365 Copilot. Os agentes autônomos do Copilot Studio aparecem no Registro de Agentes, não em plug-ins.
Para projetos do Cowork importados, marque as limitações atuais no guia de desenvolvimento do Cowork antes de planejar o empacotamento ou a publicação.
Use um SDK no caminho do aplicativo quando precisar de sua própria orquestração, modelos, hospedagem ou tempo de execução. Não mova o desenvolvimento de aplicativos de mecanismo personalizado para o fluxo de trabalho do plug-in só porque ele também usa os serviços do Microsoft 365.
Registre o plano de build
Para cada componente, registre:
- A tarefa, a experiência pretendida e o formato do componente documentado.
- Se você constrói um novo componente, configura a origem existente ou usa um fluxo de trabalho de reutilização específico do produto.
- A ferramenta de criação, o repositório de origem ou o ambiente gerenciado e o proprietário responsável.
- Contas, assinaturas, permissões, serviços e usuários de teste necessários.
- A ferramenta que produz o artefato e o método de distribuição que o aceita.
- Os testes de tempo de execução e as evidências necessárias antes do pacote & teste.
Um pacote compartilhado não significa uma experiência idêntica em todos os lugares. Os recursos suportados, a disponibilidade e a configuração necessária variam de acordo com o produto, a rota de publicação e a distribuição.
Próxima etapa
Digite Criar ou reutilizar com Criar ou reutilizar recursos para seu plug-in. Para criar um novo plug-in, siga Criar um plug-in com WIQD. Se você já tiver a origem do agente declarativo, siga Empacotar um agente declarativo existente como um plug-in.