O que é um plug-in do Microsoft 365 Copilot?

Um plug-in é um pacote instalável que adiciona novos recursos ao Microsoft 365 Copilot e outras experiências de IA da Microsoft AI. Ele reúne as habilidades, ferramentas e agentes opcionais necessários para um trabalho em uma unidade que as pessoas podem encontrar, instalar, compartilhar e gerenciar.

Por exemplo, um plug-in de suporte pode usar um agente para responder a perguntas, uma habilidade para orientar a solução de problemas, um conector para encontrar conteúdo de suporte e um servidor MCP para fornecer ferramentas.

Um plug-in pode conter um recurso ou vários; Uma única habilidade empacotada também é um plug-in. Os serviços externos, como servidores MCP remotos, podem ser executados separadamente do pacote.

Antes de criar um novo plug-in, navegue pelo Catálogo de Plug-ins do Copilot, um registro público de plug-ins disponíveis.

O que um plug-in pode incluir?

Escolha o que seu plug-in precisa com base na tarefa que ele deve ajudar os usuários a concluir.

Recurso O que ela faz Saiba mais
Habilidades Forneça instruções reutilizáveis para uma tarefa, empacotadas em um diretório que contenha SKILL.md. Competências em agentes declarativos
Ferramentas Conecte-se a aplicativos e dados, incluindo conectores Copilot compatíveis e integrações MCP remotas. Conectores do Copilot e servidores MCP
Agentes Forneça assistentes especializados para uma função ou fluxo de trabalho; Hoje, são agentes declarativos. Visão geral dos agentes declarativos

Um plug-in não precisa de todos os três tipos de recursos. Você pode criar novas funcionalidades ou reutilizar as existentes.

O suporte varia de acordo com o produto. Confira as diretrizes do Agent Builder, Copilot Studio e Copilot Cowork para a experiência que você está visando antes de criar ou empacotar seu plug-in.

Plug-ins e ações de agente declarativo

Um plug-in do Microsoft 365 Copilot é um pacote instalável. Um plug-in de API ou plug-in MCP é uma integração que fornece ações a um agente declarativo. Quando um pacote de plug-in inclui esse agente, suas ações de API e MCP permanecem disponíveis por meio do agente; Eles não se tornam recursos disponíveis independentemente do pacote. A API ou o servidor MCP é executado separadamente.

Os manifestos descrevem diferentes níveis da solução:

Manifesto O que ele descreve
Manifesto do aplicativo Microsoft 365, manifest.json A identidade, os metadados e os recursos com suporte do pacote instalável.
Manifesto do agente declarativo As instruções, conhecimentos e ações do agente. Suas actions entradas fazem referência a manifestos de API embutido ou plug-in MCP.
Manifesto de plug-in API ou MCP, como ai-plugin.json Uma integração de ação do agente, incluindo a conexão da API ou do servidor MCP e a configuração aplicável, ferramenta e autenticação. Não é o manifesto do aplicativo.

Use plug-ins MCP e API para agentes declarativos para adicionar ações a um agente. Para conectar um servidor MCP remoto no nível do pacote, use a configuração MCP remota no manifesto do aplicativo. Essa rota usa agentConnectors, não a API de um agente ou o manifesto do plug-in MCP. Escolha a rota compatível com sua experiência de destino.

Jornada do plug-in

  1. Preparar: Defina o resultado, os usuários pretendidos, os produtos de destino e os requisitos do seu plug-in.
  2. Compilar ou reutilizar: Escolha e integre os recursos necessários e teste como eles funcionam juntos.
  3. Teste & pacote:Empacote seu plug-in e, em seguida, teste-o e valide-o para a rota de publicação pretendida.
  4. Publicar & distribuir: Compartilhe ou publique o plug-in testado por meio de uma rota com suporte para seu público.
  5. Disponibilizar & controlar: Conclua todas as configurações necessárias de administração, instalação, disponibilidade do usuário e acesso.
  6. Monitorar, atualizar & desativar: Examine o desempenho, ofereça suporte aos usuários, libere atualizações e retire seu plug-in quando ele não for mais necessário.
  7. Descubra & usar: Procure os plug-ins disponíveis no Catálogo de Plug-ins do Copilot. Ajudar os usuários a encontrar e usar seu plug-in no produto de destino; para o Cowork, consulte Usar plug-ins com o Copilot Cowork.

Depois de publicar ou compartilhar seu plug-in, os usuários ainda podem precisar de aprovação, instalação ou configuração de conexão antes de usá-lo. As etapas dependem de como você o compartilhou e das configurações da sua organização.

Principais termos

Termo Significado
Catálogo de Plug-ins do Copilot Um registro público para descobrir plug-ins disponíveis.
Registro de plug-in Um destino para plug-ins publicados ou compartilhados com um público-alvo selecionado.
Tools Registry A exibição noRegistro deFerramentas> de Agentes> no Centro de administração do Microsoft 365 para plug-ins, habilidades, servidores MCP e visibilidade do conector.
Agent Registry A exibição em Agentes>Todos os agentes>Registro para controles específicos do agente; um agente empacotado também pode ter um registro de Registro de Agente.
Microsoft Marketplace Uma rota de publicação para alcançar clientes em todas as organizações.

A descoberta pública, a publicação e a administração de locatários são separadas. Uma listagem no Catálogo de Plug-ins do Copilot não estabelece a aprovação ou disponibilidade organizacional. Tools Registry, Agent Registry e Microsoft Marketplace não são nomes intercambiáveis para um catálogo.

Próxima etapa