Integração de registro de agente no Copilot Studio

Os agentes do Microsoft Copilot Studio aparecem automaticamente no registro de agentes quando são criados — proporcionando visibilidade, governança e gerenciamento centralizados em todo o locatário. Os administradores usam o registro de agentes para descobrir, monitorar e controlar agentes em toda a organização.

Este artigo explica como os agentes do Copilot Studio se integram ao registro de agentes e quais metadados são visíveis para os administradores.

Registro de agentes

O registro de agentes é um estoque centralizado de todos os agentes em seu locatário do Microsoft 365:

  • Fonte única da verdade: exiba todos os agentes em todas as plataformas (Copilot Studio, pro-code, que não são da Microsoft).
  • Visibilidade em todo o locatário: os administradores podem visualizar agentes de todos os ambientes e equipes.
  • Controles de governança: aplique políticas, permissões e ações aos agentes.
  • Rastreamento de conformidade: audite metadados, permissões e uso dos agentes.

Acesse o registro de agentes pelo Centro de administração do Microsoft 365 e, em seguida, selecione Agent 365.

O registro do agente é diferente do centro de administração do Power Platform, pois fornece visibilidade em todo o locatário em todas as plataformas, enquanto o estoque do Power Platform mostra apenas aplicativos específicos do Power Platform em um ambiente.

Como os agentes do Copilot Studio aparecem no registro

Os agentes do Copilot Studio são registrados automaticamente quando você os cria.

Tempo de registro

Evento Ação de registro
Criar um agente no Copilot Studio O agente aparece imediatamente no registro
Atualizar metadados do agente Entrada do registro atualizada automaticamente
Excluir agente Entrada do registro removida automaticamente

Metadados visíveis

Os administradores veem as seguintes informações para cada agente do Copilot Studio.

Informações Básicas:

  • Nome e descrição do agente
  • Informações sobre o editor (email do criador, organização)
  • Tipo de agente (baseado em aplicativo do Copilot Studio)
  • Datas de criação e de última modificação
  • ID do Agente (identificador exclusivo)
  • Conectores do Power Platform usados

Detalhes da configuração:

  • Status da Implantação
  • Estado habilitado ou desabilitado
  • Informações da versão (se aplicável)

Metadados de governança:

  • Status de pré-aprovação via políticas do Power Platform
  • Políticas DLP (prevenção contra perda de dados) aplicadas
  • Conformidade da política de conector avançada

O Copilot Studio sincroniza automaticamente esses metadados. Nenhuma entrada manual necessária.

Registro de agentes vs. catálogo de aplicativos do Power Platform

Os agentes do Copilot Studio aparecem tanto no registro de agentes quanto no catálogo de aplicativos do Power Platform, mas cada um tem um propósito diferente.

Recurso Registro de agentes Catálogo de aplicativos do Power Platform
Escopo Em todo o locatários, todas as plataformas de agentes Específico do ambiente, somente Power Platform
Finalidade Governança, visibilidade, conformidade Distribuição, instalação, gerenciamento de ambientes
Acesso Centro de administração do Microsoft 365 Centro de administração do Power Platform
Gerenciado por Administradores de locatários Administradores de ambiente
Integração do Agent 365 Sim – observabilidade, governança, controles Não – somente governança do Power Platform

Para desenvolvedores, ambos os registros mostram seus agentes do Copilot Studio, mas o registro de agentes fornece a camada de integração do Agent 365, incluindo observabilidade, controles de governança e conformidade.

Ciclo de vida do registro

Os agentes do Copilot Studio seguem um ciclo de vida de registro automático.

1. Criação

Quando você cria um agente do Copilot Studio:

  • A identidade do Entra é provisionada automaticamente (consulte Integração de identidade do agente)
  • O agente aparece no registro em segundos
  • Metadados sincronizados do Copilot Studio
  • Status: Ativo (pré-aprovado pelas políticas do Power Platform)

2. Atualizações

Quando você modifica seu agente:

  • Alterações de metadados (nome, descrição): registro atualizado automaticamente
  • Alterações de permissão (novos conectores): registro atualizado, políticas DLP reavaliadas
  • Alterações de configuração: o registro reflete o estado atual

Não é necessário o registro manual novamente.

3. Exclusão

Quando você exclui um agente do Copilot Studio:

  • Entrada do registro removida automaticamente
  • Identidade do Entra excluída
  • Todos os metadados associados são limpos
  • A telemetria histórica é retida (consulte Integração de observabilidade)

Cuidado

A exclusão é permanente e não pode ser desfeita.

Experiência do administrador: exibindo agentes do Copilot Studio

Os administradores acessam o registro do agente no Centro de administração do Microsoft 365. Acesse Centro de administração do Microsoft 365>Agent 365>Registro de agentes.

Exibições disponíveis:

  • Todos os agentes: veja todos os agentes em todas as plataformas
  • Filtrar por plataforma: mostre somente agentes do Copilot Studio
  • Filtrar por publicador: mostre agentes de equipes ou usuários específicos
  • Filtrar por status: mostre agentes ativos, bloqueados ou reatribuídos

Página de detalhes do agente:

  • Ver os metadados completos do agente
  • Ver as permissões e os escopos solicitados
  • Revisar os dados de observabilidade (uso, desempenho, erros)
  • Aplicar ações de governança (bloquear, reatribuir, excluir)

Para obter orientações detalhadas para administradores, consulte:

Controles de governança para agentes do Copilot Studio

Os administradores podem aplicar ações de governança aos agentes do Copilot Studio por meio do registro de agentes.

Bloquear

Impede que um agente seja usado em toda a organização:

  • O agente permanece no registro, mas fica inativo
  • Os usuários não podem invocar nem interagir com o agente
  • O criador do agente é notificado
  • Pode ser desbloqueado posteriormente pelos administradores

Reatribuir

Transfira a propriedade do agente para outro usuário ou equipe:

  • O novo proprietário passa a ter controle total e direitos de edição
  • O proprietário original perde o acesso
  • Metadados do registro atualizados com o novo editor
  • Útil para transições de equipe ou mudanças organizacionais

Excluir

Remove um agente do registro e do locatário:

  • Agentes do construtor de agentes: os proprietários dos agentes podem excluir através do registro do sistema
  • Agentes criados no Copilot Studio: exigem permissões de administrador de ambiente do Power Platform
  • Identidade do agente excluída do Entra ID
  • Entrada do registro removida
  • Todas as configurações e metadados excluídos
  • Telemetria histórica mantida para conformidade

Todas as ações de governança são registradas no Microsoft Purview para rastreamento da conformidade.

Para obter mais detalhes sobre os controles de governança, consulte Gerenciar agentes.

Acesso de programático: API do Graph

Os administradores podem acessar os dados do registro de agentes de forma programática usando as APIs do Microsoft Graph.

APIs disponíveis:

  • Listar todos os agentes: recupere a lista completa de agentes para fins de conformidade e geração de relatórios
  • Obter detalhes do agente. obtenha metadados de um agente específico para auditoria

Casos de uso:

  • Gerenciamento e automação de agente em massa
  • Integração com fluxos de trabalho de governança existentes
  • Relatórios personalizados e análise
  • Auditoria e monitoramento da conformidade

Permissões de administrador de IA ou administrador global são necessárias para esses casos de uso.

Para obter detalhes da API, consulte API do Graph para registro de agentes e detalhes dos agentes.

Considerações do desenvolvedor

Como desenvolvedor do Copilot Studio, tenha em mente estes pontos de integração do registro.

Qualidade dos metadados:

  • Use nomes e descrições claras e descritivas dos agentes (visíveis para os administradores)
  • Uso e permissões do conector de documento na descrição do agente
  • Mantenha os metadados dos agentes atualizados

Transparência das permissões:

  • Os administradores veem todas as permissões solicitadas no registro
  • Adicione somente os conectores de que você realmente precisa
  • Entenda as políticas do Power Platform que regem o uso dos conectores

Integração de observabilidade::

  • O registro vincula dados de observabilidade (uso, desempenho, erros)
  • Os administradores podem monitorar a atividade do seu agente
  • Projete os agentes com a observabilidade em mente (consulte Integração de observabilidade)

Conscientização sobre governança:

  • Os agentes podem ser bloqueados, reatribuídos ou excluídos pelos administradores
  • Projetar agentes para lidar com a desativação de forma adequada
  • Comunique aos administradores a necessidade de conectores com privilégios elevados

Próximas etapas

  • Last updated on