Plugins do Copilot, grounding no Microsoft Graph e conectores do Copilot Studio explicados
By Mirko Peters ·
O que são plugins, plugins de API, grounding por meio do Microsoft Graph, conectores do Copilot e conectores do Copilot Studio no Microsoft 365 Copilot, em que diferem e qual usar em cada situação.
Automatically translated with AI from the original post. Read the English original
Esses termos se sobrepõem, e a Microsoft alterou alguns deles. Em resumo: o grounding é de onde o Copilot obtém os fatos, os conectores trazem dados externos, os plugins de API permitem que um agente execute ações em outros sistemas, e um plugin é agora o pacote instalável que pode reunir vários desses elementos. Os conectores do Copilot Studio são outra coisa: são conectores do Power Platform usados por agentes criados no Copilot Studio.
Pontos-chave
- A Microsoft agora usa plugin para se referir a um pacote instalável que pode reunir um agente declarativo, uma skill, um conector do Copilot e uma integração MCP.
- Os plugins MCP e de API são ações personalizadas para agentes declarativos. Eles não são habilitados como experiências independentes no Microsoft 365 Copilot.
- Grounding significa os dados nos quais uma resposta se baseia: a web pública e, para usuários licenciados, dados organizacionais por meio do Microsoft Graph e do Work IQ, sempre limitados pelas permissões do usuário.
- Os conectores do Copilot trazem dados externos como conteúdo sincronizado (indexado no Microsoft Graph) ou federado (buscado em tempo real por MCP).
- Os conectores do Copilot Studio são conectores do Power Platform que os agentes usam como ferramentas ou ações. Os padrão estão em todos os planos; os premium, apenas em planos selecionados.
Grounding: de onde vêm as respostas
O Microsoft Learn afirma que todas as experiências do Copilot são baseadas em grandes modelos de linguagem, com grounding em dados da web e/ou organizacionais (Microsoft Graph e Work IQ), e acesso limitado pelas permissões do usuário. Como o grounding funciona depende da licença:
| Licença | Grounding | |---|---| | Copilot Chat (Basic) | Principalmente a web pública. Você deve fornecer o conteúdo organizacional com o seu prompt. | | Microsoft 365 Copilot (Basic) | Web, a menos que o usuário envie conteúdo ou use conteúdo aberto no Teams e no Outlook | | Microsoft 365 Copilot (Premium) | Web e dados organizacionais automaticamente por meio do Microsoft Graph e do Work IQ |
Os administradores gerenciam a pesquisa na web para o grounding com a política Permitir pesquisa na web no Copilot. A página de privacidade da Microsoft acrescenta que o Copilot só exibe dados organizacionais que o usuário pode, no mínimo, visualizar. Dados de conectores do Graph podem aparecer nas respostas se o usuário tiver permissão para acessá-los.
Conectores do Copilot: mais conhecimento
Os conectores do Copilot trazem dados externos de linha de negócios para o Copilot. A Microsoft define dois modelos:
- Conectores sincronizados ingerem e indexam conteúdo externo no Microsoft Graph. A indexação semântica ajuda com correspondências além de palavras-chave e com relações entre pontos de dados. As citações permitem que os usuários visualizem os itens.
- Conectores federados recuperam conteúdo em tempo real por meio do Model Context Protocol (MCP). Nada é sincronizado nem armazenado no Microsoft Graph, e a indexação semântica não é compatível.
Os modelos sincronizado e federado também alimentam o Microsoft Search, o Copilot no Excel e o agente Researcher. Uma galeria lista mais de 100 conectores da Microsoft e de parceiros, incluindo Box, Confluence, Salesforce e ServiceNow. Para um conector sincronizado personalizado, você pode usar o Microsoft 365 Agents Toolkit, o SDK de conectores ou as APIs de conectores do Copilot.
Para a configuração, um administrador de IA registra um aplicativo e concede consentimento de administrador para as permissões do Graph necessárias no centro de administração do Microsoft Entra. Os conectores implantados têm escopo de locatário, a menos que a segurança de itens externos esteja restrita.
Plugins de API: ações em outros sistemas
A Microsoft Learn descreve os plugins de MCP e de API como ações personalizadas que permitem que agentes declarativos trabalhem com servidores MCP ou APIs REST que tenham uma descrição OpenAPI. Os usuários podem consultar dados e, quando a API oferece suporte, criar, atualizar ou excluir esses dados.
Detalhes que vale conhecer:
- Um manifesto de plugin informa ao Copilot o que o plugin pode fazer.
- O Copilot pede confirmação antes de enviar dados a um plugin pela primeira vez. Depois disso, ferramentas que apenas leem dados não precisam de confirmação, e ferramentas que alteram dados precisam.
- Com cinco ou menos plugins, todos são injetados no prompt. Com mais do que isso, a correspondência semântica usa a descrição do plugin.
- A qualidade pode degradar com mais de 10 funções ou ferramentas.
- Plugins de API só têm suporte como ações em agentes declarativos, não como recursos independentes do Copilot.
Plugins: o novo termo de pacote
A visão geral atual de plugins da Microsoft define um plugin como um pacote instalável para uma tarefa específica. Ele pode incluir um agente declarativo, uma skill, um conector do Copilot e uma integração MCP, e pode usar uma capacidade ou várias. Os usuários ainda podem precisar de aprovação, instalação ou configuração de conexão antes de usar um plugin compartilhado. A Microsoft indica o Microsoft Agent 365 para administrar plugins.
A própria página de plugins de API faz a distinção entre os dois: ela usa "plugin" para a ação técnica que um agente declarativo chama e direciona os leitores para as páginas de plugins para o pacote voltado ao cliente. Interprete o termo de acordo com o contexto.
Conectores do Copilot Studio
No Copilot Studio, conectores são conectores do Power Platform que funcionam como wrappers de APIs. As categorias são conectores padrão pré-criados, conectores premium pré-criados e conectores personalizados. Os agentes podem usá-los como ferramentas, como ações em fluxos de agente ou como fontes de conhecimento (prévia).
Para adicionar um no nível do agente:
- Selecione Agents e abra o agente.
- Abra Tools e selecione Add a tool.
- Selecione Connector e escolha o serviço.
- Crie uma conexão, se necessário, e selecione Add and configure.
Por padrão, a conexão usa as credenciais do usuário. Para usar credenciais do criador, defina Credentials to use como Maker-provided credentials na página de visão geral da ferramenta. Uma limitação: o logon único não é compatível com conectores quando um agente usa autenticação personalizada do Active Directory e é implantado no Teams.
De qual você precisa?
- O Copilot deve responder com base em documentos ou registros fora do Microsoft 365: use um conector do Copilot, sincronizado ou federado.
- Um agente deve fazer algo em outro sistema: use um plugin de API ou MCP como ação.
- Você cria um agente no Copilot Studio e precisa de um serviço SaaS: use um conector do Copilot Studio.
- Você quer entregar várias partes juntas: empacote-as como um plugin.
Erros comuns
- Esperar que um plugin de API apareça no Copilot Chat por conta própria.
- Presumir que um conector substitui as permissões. Os usuários ainda precisam de acesso para ver os resultados.
- Confundir as orientações de autenticação. A Microsoft alerta que as orientações de autenticação de plugins de MCP e de API não se aplicam automaticamente aos conectores do Copilot.
Relacionados
- Microsoft 365 Copilot
- Conectores do Copilot
- Plugins de API para o Microsoft 365 Copilot
- Grounding (Copilot)
Fontes
- O que é um plugin para o Microsoft 365 Copilot
- Visão geral de plugins de MCP e de API
- Visão geral dos conectores do Microsoft 365 Copilot
- Ecossistema de extensibilidade do Copilot
- Arquitetura do Microsoft 365 Copilot
- Privacidade e permissões do Microsoft 365 Copilot
- Conectores em agentes do Copilot Studio
Perguntas frequentes
Qual é a diferença entre um plugin e um plugin de API?
O Microsoft Learn define um plugin do Microsoft 365 Copilot como um pacote instalável que pode incluir um agente declarativo, uma skill, um conector do Copilot e uma integração MCP. Um plugin de API ou MCP é mais restrito: é uma ação personalizada que permite a um agente declarativo chamar uma API REST com uma descrição OpenAPI ou um servidor MCP.
O que significa grounding no Microsoft 365 Copilot?
O Microsoft Learn usa grounding para se referir aos dados nos quais uma resposta se baseia. O Copilot é ancorado em dados da web e/ou organizacionais, que são o Microsoft Graph e o Work IQ, e o acesso é limitado pelas permissões do usuário. A página de arquitetura não traz uma definição formal separada.
Qual é a diferença entre conectores do Copilot sincronizados e federados?
De acordo com o Microsoft Learn, os conectores sincronizados ingerem e indexam conteúdo externo no Microsoft Graph, enquanto os conectores federados recuperam conteúdo em tempo real por meio do Model Context Protocol, sem indexá-lo. Os conectores federados não oferecem suporte à indexação semântica.
Os conectores do Copilot Studio têm custo extra?
O Microsoft Learn informa que os conectores padrão estão incluídos em todos os planos do Copilot Studio, e que os conectores premium estão disponíveis em planos selecionados. A página não traz preços e remete ao artigo sobre requisitos e licenciamento do Copilot Studio.
Um plugin de API pode funcionar sozinho no Copilot Chat?
Não. O Microsoft Learn afirma que os plugins MCP e de API são compatíveis como ações dentro de agentes declarativos e não são habilitados como experiências independentes no Microsoft 365 Copilot.