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.
Este artigo explica o registro do aplicativo, as identidades do agente e a autenticação para agentes Copilot Studio.
Entender as identidades do agente
Esta seção explica como o Copilot Studio identifica agentes e gerencia suas identidades para fins de autenticação.
Como o Copilot Studio identifica agentes para autenticação?
O Copilot Studio atribui um identificador único a cada agente para que ele possa se comunicar com canais (Teams, Omnichannel e outros) e serviços. Copilot Studio cria e gerencia automaticamente essas identidades.
Há dois tipos de identidades de agente:
IDs de Agente Entra: Princípios de serviço Microsoft Entra com subtipo "Agente". O Copilot Studio provisiona automaticamente Entra Agent IDs para novos agentes. O momento do provisionamento do ID do agente Entra depende do harness que dá suporte ao agente.
Registros de aplicativo (legacy): Os agentes existentes que você criou antes da implementação do ID do agente Entra em maio de 2026 continuam usando os app registrations tradicionais.
Importante: IDs de Agente são principais de serviço com um subtipo "Agente". O fluxo de autenticação baseado em OAuth subjacente permanece o mesmo. As IDs do agente fornecem funcionalidades avançadas de visibilidade e gerenciamento de governança em comparação com os registros de aplicativos tradicionais.
Quando um ID do agente Entra é provisionado?
O provisionamento do ID do agente Entra depende do harness do agente.
- Harness padrão: O Copilot Studio fornece o ID do agente Entra quando você cria o agente.
- Microsoft Copilot harness: O Copilot Studio não fornece o ID do agente Entra quando você salva o agente como rascunho. O Copilot Studio provisiona o ID do agente Entra quando você publica o agente pela primeira vez, mesmo que não configure nenhum canal.
Saiba mais em Harnesses no Copilot Studio.
Por que meu agente tem uma identidade em Microsoft Entra ID?
As identidades do agente permitem que seu agente se autentique com segurança ao se comunicar com canais (Teams, Omnichannel e muito mais) e serviços. Copilot Studio cria e gerencia automaticamente essas identidades seguindo Confiança Zero princípios de segurança.
Qual é a diferença entre agentes Copilot Studio e agentes Agente Builder?
Agentes do Copilot Studio: Recebem IDs de Agentes Entra (ou App registrations para agentes legados) para autenticação com canais e serviços.
Agent Builder agents: Atualmente não usam nem exigem IDs de registro de aplicativos ou IDs de Agente. Saiba mais no Agent Builder no Microsoft Copilot.
Trabalhe com identidades de agentes
Esta seção oferece orientações sobre como trabalhar com identidades de agentes no Copilot Studio.
Preciso criar ou configurar manualmente uma identidade de agente?
No. Copilot Studio gerencia automaticamente as identidades do agente:
- Novos agentes: Recebem automaticamente os IDs de agente do Microsoft Entra.
- Agentes existentes: Continuam usando App registrations e serão migrados para usar IDs de Agente no futuro.
os padrões de segurança e conformidade do Microsoft orientam o gerenciamento automático de todas as credenciais. Você tem total visibilidade e controle no centro de administração do Microsoft Entra, onde pode monitorar a atividade de autenticação e gerenciar o ciclo de vida da identidade do agente.
Como fazer para descobrir qual registro de aplicativo ou ID do Agente pertence ao meu agente?
- Em Copilot Studio, vá para Settings>Advanced>Metadata.
- Exiba o ID do agente Entra (GUID) para agentes com identidades Entra.
- Para agentes herdados com registros de aplicativo, a ID do aplicativo é exibida na mesma seção.
- Use este GUID para localizar a identidade em centro de administração do Microsoft Entra.
Posso trazer minha própria ID do Agente ou registro de aplicativo?
No. Para garantir a segurança, a conformidade e a integração com canais e serviços, Copilot Studio requer gerenciamento automático.
Por que o Copilot Studio adiciona o proprietário à identidade do agente?
Copilot Studio adiciona o proprietário do agente para fornecer:
- Rastreabilidade de governança para cada agente
- Responsabilidade pelo ciclo de vida do agente
- Alinhamento com políticas de propriedade organizacional
Para IDs do Agente do Entra: O proprietário do agente é adicionado como responsável com permissões limitadas em comparação com os proprietários plenos, o que reduz preocupações de segurança relacionadas a modificações de permissões. Alguns agentes pré-existentes podem ainda não ter patrocinadores.
Para registros de aplicativos legados: O dono do agente é adicionado como proprietário do registro do aplicativo. Para recusar a adição do proprietário do agente, entre em contato com o suporte.
Segurança e permissões
Esta seção explica a segurança e as permissões associadas às identidades dos agentes no Copilot Studio.
Quem pode gerar tokens usando a identidade do agente?
Para IDs do Agente do Entra
Uma entidade de blueprint da Microsoft cria e gerencia identidades de agente usando Credenciais de Identidade Federadas. Ninguém em seu locatário - incluindo administradores de locatários - pode gerar tokens usando a identidade do agente. Microsoft controla totalmente o blueprint e o mecanismo de autenticação.
Para a validação de habilidades do Azure Serviço de Bot
Important
Este artigo inclui informações sobre Azure Serviço de Bot skills, uma forma baseada em código de expandir as capacidades de um agente no harness padrão. habilidades do Azure Serviço de Bot são diferentes de:
- Habilidades de agentes, habilidades baseadas em instruções que você adiciona aos agentes impulsionados pelo GitHub Copilot ou pelo Cântule de Conversa com Clientes. Saiba mais na visão geral de Habilidades para agentes.
- Habilidades em plugins, uma funcionalidade que um plugin do Microsoft 365 Copilot pode incluir. Saiba mais sobre Habilidades como recursos de plug-in.
Ao validar ou invocar uma habilidade Azure Serviço de Bot, Microsoft Copilot Studio pode obter um token associado à identidade gerenciada do agente e apresentá-lo ao endpoint da habilidade configurada. Esse comportamento é intencional e segue o mesmo modelo de confiança usado durante a execução normal de habilidades.
A identidade do agente é de propriedade do inquilino e está associada apenas ao agente criado pelo criador. Tokens emitidos para a identidade do agente não concedem privilégios além dos já disponíveis para o proprietário do agente e não fornecem acesso a dados ou recursos que o fabricante não estaria autorizado a usar de outra forma. Como resultado, receber um token de identidade de agente por meio de validação de habilidades ou execução em tempo de execução não constitui uma escalonamento de privilégios ou expansão das permissões efetivas do criador.
Os criadores são responsáveis pela configuração e confiabilidade dos endpoints da habilidade, pois esses endpoints podem receber requisições autenticadas do agente tanto durante a validação quanto durante operações normais de execução.
Para registros de aplicativo legado
Usuários com funções de Administrador Global, Administrador de Aplicativos ou Administrador de Aplicativos na Nuvem podem criar segredos ou certificados do cliente para qualquer registro de aplicativo no locatário sem a necessidade de propriedade. Os usuários sem esses papeis devem ser designados como proprietários do registro específico do aplicativo para criar as credenciais necessárias para a geração de tokens. Copilot Studio não adiciona escopos ou permissões de API a esses registros de aplicativo, portanto, os tokens gerados dessas identidades não têm acesso a dados ou recursos do cliente.
Important
Registros de aplicativos criados para os agentes do Copilot Studio são reservados apenas para o uso dos agentes. Não modifique ou exclua as credenciais desses registros de aplicativo. Não os use para nenhum outro propósito.
Quais escopos estão anexados ao ID do agente Microsoft Entra do meu agente?
Quando você publica um agente, o Copilot Studio atribui permissões de API ao ID do agente Microsoft Entra do agente que representam os conectores Power Platform que o agente está configurado para usar. Esses escopos descrevem apenas o acesso aos conectores. Eles não são permissões brutas de recursos como Mail.Read ou Files.Read.All.
Note
O escopo visibilidade em Microsoft Entra ID se aplica a todos os agentes, independentemente do canal. A aplicação do escopo em tempo de execução — incluindo o Acesso Condicional do Microsoft Entra à identidade do agente — atualmente se aplica somente quando o agente é executado no Microsoft Teams, porque o Teams é hoje o único canal que realiza autenticação de ponta a ponta usando o token de ID do agente do Entra. Outros canais ainda chamam conectores usando o fluxo de autenticação existente do conector do Power Platform, de modo que os administradores possam ver os escopos, mas o Acesso Condicional aplicado à identidade do agente ainda não é avaliado para essas chamadas.
Como aparecem os telescópios no Microsoft Entra ID?
Cada conector tem sua própria entidade de serviço principal no seu locatário, por exemplo, Work IQ Calendar MCP Connector. Dependendo de como o criador configura o agente, a entidade de serviço do conector concede uma ou mais das seguintes permissões ao ID do agente Entra do agente:
-
Operations.Execute.Allé concedido quando o agente está configurado para usar o conector no nível do agente (ferramenta). O agente pode invocar qualquer operação exposta pelo conector. - Escopos individuais de operação são concedidos quando o criador adiciona ações específicas do conector em vez do conector inteiro. Somente as operações que o agente realmente utiliza são permitidas.
-
Azure API Connections Runtime.Allé usado como uma alternativa genérica para conectores que não definem escopos granulares.
Você pode revisar essas permissões na entidade de serviço da identidade do agente na central de administração do Microsoft Entra, em Permissões de API.
Esse modelo dá aos administradores do Microsoft Entra ID e do Microsoft 365 visibilidade do que um agente pode fazer. Os administradores não precisam abrir o centro de administração do Power Platform, e o modelo de conector controlado por políticas liderado pelo fabricante permanece em vigor:
- Os criadores continuam a adicionar conexões usando conectores pré-aprovados pelas políticas avançadas de conectores e pelas políticas de dados do seu locatário.
- O runtime do conector do Power Platform só respeita esses escopos. Durante a execução, a plataforma de conectores valida novamente se o agente pode usar o conector de acordo com as políticas avançadas de conectores e as políticas de dados do seu locatário. Se um invasor obtiver a identidade de um agente, não poderá usar esses escopos para chamar o Microsoft Graph, o Outlook nem qualquer outra API diretamente, porque a plataforma de conectores intermedeia cada chamada e aplica suas políticas de governança.
- Como os escopos são permissões de API principais na ID do agente Entra do agente, os administradores podem aplicá-las a eles por meio de políticas de Acesso Condicional do Microsoft Entra. Por exemplo, você pode exigir locais de rede específicos, estado de conformidade do dispositivo ou níveis de risco antes que os tokens possam ser emitidos para um recurso de conector específico em uma identidade de agente. O Acesso Condicional é imposto hoje somente quando o agente é executado no Microsoft Teams (consulte a nota no início desta seção).
Em resumo, os escopos descrevem o que um agente está configurado para fazer , enquanto políticas avançadas de conectores e políticas de dados decidem o que ele pode fazer no momento da execução.
Quando os endoscópios são adicionados ou removidos?
Os escopos são avaliados e aplicados quando o agente é publicado. Adicionar ou remover um conector (ou uma ação específica do conector) no agente e republicá-lo atualiza os escopos de acordo.
Essa mudança se aplica aos registros de aplicativos antigos?
No. Os escopos do conector são adicionados somente às IDs do Agente do Entra. Os registros de aplicativo herdados continuam sem escopos de API anexados, conforme descrito em Quem pode gerar tokens usando a identidade do agente. Hoje, esse comportamento se aplica a conectores de primeira parte e certificados do Power Platform; conectores personalizados, servidores MCP e ferramentas de API REST adicionados aos agentes não adicionam permissões de API ao ID do agente Entra.
Migração do ID do agente Entra
Esta seção explica o processo de migração dos registros de aplicativos legados para os IDs de Agente Entra para agentes existentes.
O que acontece com os agentes existentes que criei antes do ID do agente Entra estar disponível?
Os agentes existentes que você criou antes do ID do agente Entra estar disponível em maio de 2026 continuam usando os registros do aplicativo. Eles migrarão para IDs de Agente no futuro.
Características da migração:
- Preservação de GUID: os identificadores do agente permanecem idênticos (sem mudanças incompatíveis).
- Tempo de inatividade zero: Os agentes continuam funcionando durante a migração.
- Automático: Não é necessário acionar manualmente.
- Compatibilidade de canais mantida: Teams, Omnichannel e habilidades continuam funcionando.
Habilitar a ID do Agente altera a forma como meu agente se autentica?
No. As IDs do agente são entidades de serviço com um subtipo "Agent" que usa os mesmos fluxos de autenticação baseados em OAuth que os registros de aplicativo tradicionais. O aprimoramento é a visibilidade da governança – as IDs do agente aparecem no centro de administração do Microsoft Entra com mais recursos de gerenciamento e monitoramento do ciclo de vida.
O que são Principais do Blueprint?
Quando a primeira identidade do agente é criada em um ambiente, o Copilot Studio adiciona um blueprint de identidade do agente Microsoft Copilot Studio ao seu tenant. Essa entidade principal do blueprint tem privilégios para criar identidades e usuários de agente no locatário.
Saiba mais em:
Por que meu agente não foi criado por causa de uma cota ou limite da Microsoft Entra?
Cada ID do agente Microsoft Entra que o Copilot Studio cria é um objeto de diretório no seu locatário e é contabilizado na cota de recursos do seu locatário no Microsoft Entra ID. A identidade do agente é provisionada quando o agente é criado em Copilot Studio. Se o locatário atingir sua cota nesse momento, o Copilot Studio não consegue criar o ID do agente Microsoft Entra, e a criação do agente falha.
Os limites mais comuns a serem cientes são:
- Cota de recursos para locatário: 50.000 objetos de diretório por padrão, ou 300.000 se seu locatário tiver um domínio verificado. Os locatários criados por meio do cadastro por autoatendimento permanecem limitados a 50.000, mesmo após a verificação de um domínio. As identidades dos agentes (junto com todos os outros recursos Microsoft Entra) não podem usar mais do que 95% dessa cota.
- Restrição de novos inquilinos: Nos dois primeiros dias após a criação de um inquilino, a cota é temporariamente limitada a 600 objetos de diretório.
O limite de 250 identidades de agente por blueprint não se aplica ao Copilot Studio, porque o blueprint do Copilot Studio é de propriedade da Microsoft.
Saiba mais sobre limites e restrições do serviço Microsoft Entra. Para aumentar a cota de recursos para seu locatário, siga as diretrizes nesse artigo.
Ciclo de vida do agente
Esta seção descreve o ciclo de vida das identidades dos agentes no Copilot Studio.
O que acontece com a identidade do agente quando você exclui um agente?
Quando você exclui um agente do Copilot Studio, o processo remove a ID do Agente associada (ou registro de aplicativo) do ID do Microsoft Entra.
Saiba mais em Excluir agentes.
Por que um agente no Teams para de responder sem exibir um erro?
Se um agente no Teams parar de responder sem exibir um erro, seu ID do agente Entra pode ser desativado ou bloqueado. No centro de administração do Microsoft Entra, revise o estado de login e risco da identidade do agente e resolva qualquer política ou condição de risco que bloqueie o login.