Integração do registro do agente para Copilot Studio

Os agentes do Microsoft Copilot Studio aparecem automaticamente no registro do agente quando você os cria, fornecendo visibilidade centralizada, governança e gerenciamento em seu locatário. Os administradores usam o registro do agente para descobrir, monitorar e controlar agentes em toda a organização.

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

Registro do agente

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

  • Fonte única de verdade: Visualize todos os agentes em várias plataformas (Copilot Studio, codificação profissional, não Microsoft).
  • Visibilidade em toda a entidade: os administradores podem visualizar agentes de todos os ambientes e equipes.
  • Controles de governança: aplicar políticas, permissões e ações aos agentes.
  • Acompanhamento de conformidade: metadados, permissões e uso do agente de auditoria.

O registro do agente é acessado por meio de 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 inventário do Power Platform mostra apenas aplicativos específicos do Power Platform em um ambiente.

Como os agentes do Copilot Studio aparecem no registro

Copilot Studio agentes se registram automaticamente quando você os cria.

Tempo de registro

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

Metadados visíveis

Os administradores veem as informações a seguir para cada agente de Copilot Studio.

Informações básicas:

  • Nome e descrição do agente
  • Informações do publicador (email do criador e organização)
  • Tipo de agente (Copilot Studio baseado em app)
  • Criação e datas da ú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 de versão (se aplicável)

Metadados de governança:

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

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

Registro de agente versus 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 serve a um propósito diferente.

Característica Registro do agente Catálogo de aplicativos do Power Platform
Scope Em todo o inquilino, todas as plataformas de agentes Específico do ambiente, somente Power Platform
Finalidade Governança, visibilidade, conformidade Distribuição, instalação, gerenciamento de ambiente
Acessar 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 Agente 365 Sim – observabilidade, governança, controles Não – somente governança do Power Platform

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

Ciclo de vida de registro

Agentes do Copilot Studio seguem um ciclo de vida de inscrição automática.

1. Criação

Ao criar um agente de Copilot Studio:

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

2. Atualizações

Ao modificar 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 registrar novamente manualmente.

3. Exclusão

Quando você exclui um agente de Copilot Studio:

  • Entrada do Registro removida automaticamente
  • Identidade de entra excluída
  • Todos os metadados associados foram limpos
  • Telemetria histórica retida (consulte a integração com Observabilidade)

Cuidado

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

Experiência de administrador: Visualização de 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>Agent registry.

Exibições disponíveis:

  • Todos os agentes: consulte todos os agentes em todas as plataformas
  • Filtro por plataforma: mostrar apenas Copilot Studio agentes
  • Filtrar por editor: mostrar agentes de equipes ou usuários específicos
  • Filtrar por status: mostrar agentes ativos, bloqueados ou reatribuídos

Página de detalhes do agente:

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

Para obter diretrizes detalhadas de administrador, consulte:

Controles de governança para agentes de Copilot Studio

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

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 ou interagir com o agente
  • Criador de agente recebe notificação
  • Pode ser desbloqueado posteriormente pelos administradores

Reatribuir

Transferir a propriedade do agente para um usuário ou equipe diferente:

  • Novo proprietário ganha controle total e direitos de edição
  • Proprietário original perde o acesso
  • Metadados do Registro atualizados com o novo publicador
  • Útil para transições de equipe ou alterações organizacionais

Delete

Remove um agente do registro e do locatário:

  • Agentes de criação de agentes: os proprietários dos agentes podem excluir através do registro do sistema
  • Agentes construídos dentro do 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 retida para conformidade

Todas as ações de governança são registradas em Microsoft Purview para acompanhamento de conformidade.

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

Acesso programático: API do Graph

Os administradores podem acessar os dados do registro do agente programaticamente usando APIs de Microsoft Graph.

APIs disponíveis:

  • Listar todos os agentes: recuperar o inventário completo para conformidade e relatórios
  • Obter detalhes do agente: buscar metadados para 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 e análises personalizados
  • Auditoria e monitoramento de conformidade

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

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

Considerações do desenvolvedor

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

Qualidade dos metadados:

  • Usar nomes de agente descritivos claros e descrições (visíveis aos administradores)
  • Uso e permissões do conector de documento na descrição do agente
  • Manter os metadados do agente atualizados

Transparência de permissão:

  • Os administradores veem todas as permissões solicitadas no Registro
  • Adicione apenas os conectores que você realmente necessita
  • Entender as políticas do Power Platform que regem o uso do conector

Integração de observabilidade:

  • Links do Registro para dados de observabilidade (uso, desempenho, erros)
  • Os administradores podem monitorar a atividade do agente
  • Projete agentes com a observabilidade em mente (consulte integração com Observabilidade)

Reconhecimento de governança:

  • Os agentes podem ser bloqueados, reatribuídos ou excluídos pelos administradores
  • Projetar agentes para lidar com a desativação de forma tranquila
  • Comunicar-se com administradores sobre as necessidades de conectores de elevado privilégio

Próximas etapas

  • Last updated on