Administração e sincronização de agentes do M365 Copilot
Gerencie pelo AI-FW o catálogo, registro, relatórios de uso e exportação de interações do Microsoft 365 Copilot.
A bridge administrativa M365 Copilot conecta AI-FW às superfícies administrativas do Microsoft 365 Copilot via Microsoft Graph e permissões de aplicativo do Entra (app-only, client credentials). Não exige login de usuário, consentimento delegado nem redirect URI.
Gerencia catálogo de agentes Copilot, Agent registry para sincronizar agentes registrados no AI-FW com M365, análises de uso e exportação de interações.
Agent Registry usa endpoint /beta em prévia. A Microsoft informa que APIs beta podem mudar e não têm suporte para produção. Catálogo, relatórios de uso e exportação usam /v1.0 (GA).
Configuração única no Microsoft Entra#
- Registre um aplicativo no Microsoft Entra ou use Enterprise App existente e conceda permissões de aplicativo:
| Permissão | Superfície |
|---|---|
| AgentRegistration.ReadWrite.All | Agent registry |
| CopilotPackages.ReadWrite.All | Catálogo de agentes |
| Reports.Read.All | Relatórios de uso |
| AiEnterpriseInteraction.Read.All | Exportação de interações |
Conclua admin consent no portal Entra. App-only não exige redirect URI.
- No AI-FW, abra Settings -> M365 Copilot Admin, habilite a bridge e informe Tenant ID, Client ID e Client Secret.
- Clique Test connection. AI-FW obtém token app-only e lista o catálogo para verificar permissões.
Sincronizar agentes#
Use ações do catálogo e registro para revisar agentes encontrados e sincronizar os cadastrados no AI-FW. Confira identidade e metadados antes de publicar ou mudar acesso.
Operação e limites#
Proteja Client Secret, limite administradores e faça rotação conforme política. Revise auditoria após mudanças e confirme permissões e implantações no Microsoft 365. A sincronização não modifica políticas Copilot que exigem permissões delegadas.