Nota
O acesso a esta página requer autorização. Pode tentar iniciar sessão ou alterar os diretórios.
O acesso a esta página requer autorização. Pode tentar alterar os diretórios.
Um plug-in reúne recursos compatíveis para uso em experiências do Microsoft 365 Copilot. Por exemplo, uma solução pode usar uma habilidade para orientar uma tarefa, um conector Copilot para acessar conteúdo organizacional e um servidor MCP para fornecer ferramentas. O plug-in oferece a essa solução uma maneira de ser empacotada, publicada e disponibilizada por meio de rotas com suporte da Microsoft.
Você desenvolve cada funcionalidade com as ferramentas e diretrizes que se aplicam a ela. O modelo de plug-in conecta esses recursos a um ciclo de vida de publicação e gerenciamento; Isso não altera a forma como cada recurso é executado.
Importante
Os componentes, pacotes, rotas de publicação, etapas de administração e experiências da Microsoft com suporte variam de acordo com o produto e a distribuição. Use as orientações vinculadas para os recursos e a rota que você escolher.
Escolha seu caminho
Escolha a rota que corresponde ao que você precisa fazer:
- Empacotar e compartilhar um agente existente: Se você tiver o projeto de origem local para um agente declarativo compatível, siga o início rápido das Ferramentas de Desenvolvimento do Work IQ para validar, provisionar, empacotar, compartilhar e testá-lo sem recriar o agente.
- Criar novas funcionalidades: Se você precisar criar um novo agente, habilidade, conector Copilot ou servidor MCP, planeje seu plug-in e siga o ciclo de vida completo.
- Administrar plug-ins e agentes: Siga as diretrizes do administrador para revisá-las, disponibilizá-las, controlá-las, monitorá-las, atualizá-las ou desativá-las.
- Publicar para clientes: Siga as orientações de ISV e fornecedores de software para distribuição pública, certificação, manutenção e suporte.
Decidir o que sua solução precisa
Comece com o trabalho que a solução deve ajudar alguém a fazer, quem a usará e onde a usará. Em seguida, escolha os recursos que dão suporte a esse trabalho.
| Recursos | Use-o para | Saiba mais |
|---|---|---|
| Agente declarativo | Crie uma experiência direcionada a objetivos usando instruções, conhecimento e ferramentas | Visão geral dos agentes declarativos |
| Habilidade | Forneça instruções reutilizáveis ou um fluxo de trabalho para um trabalho específico | Habilidades como recursos de plug-in |
| Conector do Copilot | Disponibilizar conteúdo organizacional externo aprovado | Conectores do Copilot como recursos de plug-in |
| Servidor MCP | Fornecer ferramentas e recursos de um servidor remoto | Servidores e plug-ins MCP |
Um plug-in pode reunir um recurso compatível ou vários. Você pode criar novos componentes ou reutilizar os existentes. Um componente também pode existir fora de um plug-in e ter seus próprios requisitos de administração.
Um plug-in não contém necessariamente o serviço que usa. Por exemplo, seu pacote pode incluir a configuração para um servidor MCP remoto enquanto esse servidor é executado separadamente.
Tire seu plug-in da ideia ao uso
- Prepare-se para criar seu plug-in. Defina os usuários pretendidos, o resultado, as experiências-alvo, as funcionalidades e os requisitos.
- Criar ou reutilizar funcionalidades. Crie ou reutilize cada componente necessário usando suas diretrizes de desenvolvimento compatíveis e confirme se cada componente funciona de forma independente.
- Empacote e teste. Integre os recursos, crie e valide o pacote necessário, teste a experiência resultante e avalie a qualidade do agente quando apropriado.
- Publicar e distribuir. Envie o artefato validado por meio de uma rota de distribuição com suporte.
- Disponibilizar e administrar. Conclua as ações de revisão, aquisição, atribuição, habilitação, conexão, acesso e controle que se aplicam à rota e à funcionalidade.
- Monitorar, atualizar e desativar. Monitore os sinais disponíveis, avalie o comportamento quando apropriado, libere atualizações validadas, gerencie a propriedade e o acesso e desative a solução quando necessário.
A publicação por si só não torna um plugin utilizável. As ações após a publicação dependem da rota de distribuição e dos componentes. Siga o procedimento para sua rota em vez de supor que a revisão, aquisição, atribuição, habilitação e conexão ocorrem como uma etapa.
A governança se aplica a todo o ciclo de vida. Defina os requisitos durante o planejamento, valide a identidade e as dependências antes da publicação, aplique controles de disponibilidade e conexão ao disponibilizar a solução e gerencie atualizações, restrições e desativação durante a operação.
Entender o pacote e o Registro
| Termo | Significado |
|---|---|
| Plug-in | A solução que reúne recursos suportados para um uso específico |
| Pacote de plug-ins | O artefato versionado usado para validação, publicação e atualizações |
| Componente | Uma funcionalidade suportada usada pelo plug-in |
| Registro de plug-in | Infraestrutura compartilhada para registro e distribuição de plug-ins |
O pacote pode descrever e conectar componentes sem conter seus serviços de tempo de execução. Os componentes também podem aparecer em inventários administrativos independentemente de um plug-in.
O registro e a distribuição não substituem a administração específica do produto. Disponibilidade, acesso, ferramentas, conexões, serviços externos, dados e comportamento de tempo de execução podem usar superfícies de controle separadas.
Siga as diretrizes para sua função
- Plug-ins de compilação: Planeje a solução, selecione ferramentas e componentes e, em seguida, crie, empacote e teste.
- Administrar plug-ins e agentes: Examine os requisitos antecipadamente e gerencie a disponibilidade, o acesso, as conexões e os controles operacionais aplicáveis.
- Publicar plug-ins para clientes: Siga o ciclo de vida completo, incluindo os requisitos para distribuição pública, certificação, manutenção e suporte ao cliente.
- Usuários: Encontre e use plug-ins disponibilizados em sua experiência Microsoft.
Verificar requisitos específicos do produto
O modelo de plug-in não substitui as ferramentas de desenvolvimento, manifestos, certificação, comportamento de runtime ou procedimentos de administração para cada funcionalidade.
Os agentes podem participar do modelo de plug-in mais amplo de maneiras diferentes, dependendo do tipo de agente, do pacote, da rota de publicação e da experiência da Microsoft. Siga as diretrizes de publicação do agente e da ferramenta de criação que você usa.
Os plug-ins de API existentes permanecem com suporte como ações para agentes declarativos. Consulte Plug-ins de MCP e API para agentes declarativos para obter orientações sobre empacotamento e ciclo de vida.