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.
Dica
Recomendado: Comece com o Work IQ Dev Tools para cenários de plug-in e de agente declarativo de código profissional com suporte. Consulte o início rápido do WIQD. As instruções baseadas em kit de ferramentas permanecem disponíveis para projetos e fluxos de trabalho existentes que as exigem. Verifique a capacidade e o suporte à experiência de destino antes de escolher uma ferramenta: O WIQD não tem como alvo agentes de mecanismo personalizados.
Os agentes declarativos no Microsoft 365 Copilot se conectam aos serviços de back-end por meio de plug-ins API ou MCP. Essas integrações de ação conectam o agente a um servidor MCP (Model Context Protocol) ou a uma API descrita por um documento OpenAPI. Configure a autenticação para que o Microsoft 365 Copilot possa obter e enviar as credenciais corretas em nome do usuário conectado.
Observação
Este artigo configura a autenticação em um manifesto de plug-in de API ou MCP para um agente declarativo. Ele não configura o pacote instalável externo. Consulte Plug-ins e ações de agente declarativo para o relacionamento de manifesto.
As orientações de autenticação usam um plug-in MCP como exemplo padrão. O plug-in MCP é a integração do agente com o servidor remoto, não com o servidor em si. As mesmas etapas de configuração se aplicam a plug-ins de API criados a partir de um documento OpenAPI, exceto quando observado em cada artigo.
Esquemas de autenticação com suporte
Escolha o esquema de autenticação que corresponde a como seu servidor MCP ou API protege seus pontos de extremidade:
| Esquema de autenticação | Plug-ins MCP | Plug-ins de API | Artigo |
|---|---|---|---|
| SSO (logon único) do Microsoft Entra | Com suporte | Com suporte | Configurar a autenticação SSO do Microsoft Entra |
| Registro dinâmico de cliente (DCR) | Com suporte | Sem suporte | Configurar o registro de cliente dinâmico |
| Fluxo de código de autorização OAuth 2.0 | Com suporte | Com suporte | Configurar autenticação OAuth 2.0 |
| Chave de API | Sem suporte | Com suporte | Configurar autenticação de chave de API |
| Sem autenticação (anônimo) | Com suporte | Com suporte | Configurar sem autenticação (anônimo) |
Observação
Esta tabela aborda os plug-ins MCP e API usados como ações de agente declarativo. Um plug-in que faz referência a um servidor MCP remoto por meio agentConnectors do manifesto do aplicativo Microsoft 365 usa uma configuração de autorização diferente. Esse esquema inclui ApiKeyPluginVault, enquanto os plug-ins MCP usados como ações de agente declarativo não dão suporte a chaves de API. Para requisitos de configuração e host, consulte Configurar servidores MCP remotos para plug-ins do Microsoft 365 Copilot.
Como funciona a autenticação de plug-in
Para esquemas que exigem credenciais, uma configuração de autenticação (configuração de autenticação) é um registro armazenado no repositório de tokens do Microsoft Enterprise que contém as credenciais ou os detalhes do cliente necessários para autenticar no servidor MCP ou na API. O acesso anônimo não requer uma configuração de autenticação. Escolha o caminho de configuração compatível para o seu projeto:
-
O Work IQ Dev Tools (recomendado) configura a autenticação quando você adiciona uma ação OpenAPI ou MCP remoto com
wiqd agent add action. Para configurar um tipo de autenticação compatível em um manifesto de plug-in existente, usewiqd agent add auth. Siga a orientação WIQD específica do esquema abaixo para obter as opções corretas e conclua o fluxo de trabalho de provisionamento do agente para seu ambiente. - O Microsoft 365 Agents Toolkit cria a configuração de autenticação e atualiza o manifesto do plug-in automaticamente à medida que você cria o agente.
- A habilidade de desenvolvedor do agente declarativo (somente plug-ins do MCP) cria a configuração de autenticação e atualiza o manifesto para você a partir de instruções de linguagem natural.
- O portal do desenvolvedor do Microsoft Teams permite que você crie a configuração de autenticação manualmente ou gerencie uma que o Agents Toolkit ou a habilidade criou.
Para esquemas autenticados, o manifesto do plug-in faz referência à configuração de autenticação por sua ID no objeto de autenticação de runtime. Em tempo de execução, o Microsoft 365 Copilot usa a configuração de autenticação para obter um token ou chave de API do repositório de tokens e a inclui quando o plug-in chama o servidor MCP ou a API.
Comece com a seção WIQD do esquema de autenticação escolhido. Os mesmos artigos mantêm o Kit de ferramentas, a habilidade do desenvolvedor, o portal e as alternativas manuais quando há suporte.
- Configurar a autenticação SSO do Microsoft Entra com WIQD
- Configurar o registro de cliente dinâmico com o WIQD
- Configurar a autenticação OAuth 2.0 com WIQD
- Configurar a autenticação de chave de API com WIQD
- Configurar autenticação anônima com WIQD
Observação
Para um pacote de plug-ins que Cowork conecta a um servidor MCP remoto, siga a autenticação no manifesto do aplicativo. As etapas de registro de credenciais compartilhadas não tornam essa configuração intercambiável com a configuração do manifesto do plug-in MCP de um agente. Se o provedor OAuth usar a plataforma de identidade da Microsoft e a conexão precisar de atualização automática de token, inclua offline_access no campo Escopo da configuração do OAuth os escopos delegados específicos da API.