Integração do Copilot Studio com o registo de agentes

Os agentes do Microsoft Copilot Studio aparecem automaticamente no registo de agentes quando são criados—proporcionando visibilidade, governação e gestão centralizadas em todo o seu inquilino. Os administradores utilizam o registo de agentes para descobrir, monitorizar e controlar agentes em toda a organização.

Este artigo explica como os agentes do Copilot Studio se integram com o registo de agentes e quais metadados estão visíveis para os administradores.

Registo de agentes

O registo de agentes é um inventário centralizado de todos os agentes no seu inquilino do Microsoft 365:

  • Única fonte de verdade: veja todos os agentes em todas as plataformas (Copilot Studio, código profissional, não Microsoft).
  • Visibilidade em todo o inquilino: os administradores veem agentes de todos os ambientes e equipas.
  • Controlos de governação: aplicar políticas, permissões e ações aos agentes.
  • Monitorização de conformidade: auditoria dos metadados, permissões e utilização dos agentes.

O registo de agentes é acedido através do centro de administração do Microsoft 365 e, em seguida, selecione Agent 365.

O registo de agentes é diferente do centro de administração do Power Platform, pois fornece visibilidade total a nível do inquilino em todas as plataformas, enquanto o inventário do Power Platform mostra apenas aplicações específicas do Power Platform dentro de um ambiente.

Como os agentes do Copilot Studio aparecem no registo

Os agentes do Copilot Studio registam-se automaticamente quando são criados.

Temporização do registo

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

Metadados visíveis

Os administradores veem a seguinte informação para cada agente do Copilot Studio.

Informações básicas:

  • Nome e descrição do agente
  • Informações do editor (e-mail do criador, organização)
  • Tipo de agente (baseado numa aplicação do Copilot Studio)
  • Datas de criação e da última modificação
  • ID do agente (identificador exclusivo)
  • Conectores do Power Platform utilizados

Detalhes de configuração:

  • Estado da implementação
  • Estado ativado ou desativado
  • Informações da versão (se aplicável)

Metadados de governação:

  • Estado de pré-aprovação através de políticas do Power Platform
  • Políticas de prevenção de perda de dados (DLP) aplicadas
  • Conformidade com a política de conector avançada

O Copilot Studio sincroniza automaticamente estes metadados. Não é necessária uma entrada manual.

Registo de agentes vs. catálogo de aplicações do Power Platform

Os agentes do Copilot Studio estão disponíveis tanto no registo de agentes como no catálogo de aplicações do Power Platform, mas cada um serve uma finalidade distinta.

Funcionalidade Registo de agentes Catálogo de aplicações do Power Platform
Âmbito Em todo o inquilino, todas as plataformas de agentes Específico do ambiente, apenas para o Power Platform
Finalidade Governação, visibilidade, conformidade Distribuição, instalação, gestão ambiental
Acesso Centro de administração do Microsoft 365 Centro de administração do Power Platform
Gerido por Administradores de inquilinos Administradores do ambiente
Integração do Agent 365 Sim – observabilidade, governação, controlos Não – apenas governação do Power Platform

Para os programadores, ambos os registos mostram os seus agentes do Copilot Studio, mas o registo de agentes fornece a camada de integração com o Agent 365, incluindo observabilidade, controlos de governação e conformidade.

Ciclo de vida do registo

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

1. Criação

Ao criar um agente do Copilot Studio:

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

2. Atualizações

Quando modificar o seu agente:

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

Não é necessário um novo registo manual.

3. Eliminação

Quando elimina um agente do Copilot Studio:

  • Entrada no registo removida automaticamente
  • Identidade do Entra eliminada
  • Todos os metadados associados foram limpos
  • A telemetria histórica é retida (consulte Integração da Observabilidade)

Atenção

A eliminação é permanente e não pode ser anulada.

Experiência do administrador: ver agentes do Copilot Studio

Os administradores acedem ao registo de agentes a partir do centro de administração do Microsoft 365. Vá para Centro de administração do Microsoft 365>Agent 365>Registo de agentes.

Vistas disponíveis:

  • Todos os agentes: ver todos os agentes em todas as plataformas
  • Filtrar por plataforma: mostrar apenas agentes do Copilot Studio
  • Filtrar por editor: mostrar agentes de equipas ou utilizadores específicos
  • Filtrar por estado: mostrar agentes ativos, bloqueados ou reatribuídos

Página de detalhes do agente:

  • Ver metadados completos do agente
  • Consultar permissões e âmbitos pedidos
  • Reveja dados de observabilidade (utilização, desempenho, erros)
  • Aplicar ações de governação (bloquear, reatribuir, eliminar)

Para obter orientações administrativas detalhadas, consulte:

Controlos de governação para agentes do Copilot Studio

Os administradores podem aplicar ações de governação aos agentes do Copilot Studio através do registo de agentes.

Bloquear

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

  • O agente permanece no registo, mas torna-se inativo
  • Os utilizadores não podem invocar nem interagir com o agente
  • O criador do agente recebe notificação
  • Pode ser desbloqueado mais tarde pelos administradores

Reatribuir

Transferir a propriedade do agente para um utilizador ou equipa diferente:

  • O novo proprietário ganha o controlo total e direitos de edição
  • O proprietário original perde o acesso
  • Metadados do registo atualizados com o novo editor
  • Útil para transições de equipas ou alterações organizacionais

Eliminação

Remove um agente do registo e do inquilino:

  • Agentes do construtor de agentes: os proprietários de agentes podem eliminar através do registo
  • Agentes criados no Copilot Studio: requerem permissões de administrador do ambiente do Power Platform
  • Identidade do agente eliminada do Entra ID
  • Entrada no registo removida
  • Todas as configurações e metadados eliminados
  • Telemetria histórica retida para conformidade

Todas as ações de governação são registadas na Microsoft Purview para monitorização da conformidade.

Para mais detalhes sobre os controlos de governação, consulte Gerir agentes.

Acesso programático: Graph API

Os administradores podem aceder programaticamente aos dados do registo dos agentes utilizando as APIs do Microsoft Graph.

APIs disponíveis:

  • Listar todos os agentes: obter o inventário completo para conformidade e relatórios
  • Obter detalhes do agente: obter metadados de um agente específico para auditoria

Casos de utilização:

  • Gestão e automatização de agentes em massa
  • Integração com os fluxos de trabalho de governação existentes
  • Relatórios e análises personalizados
  • Auditoria e monitorização de conformidade

É necessário ter permissões da função Administrador de IA ou Administrador global para os casos de utilização.

Para mais detalhes sobre a API, consulte Graph API para registo de agentes e detalhes do agente.

Considerações para programadores

Como programador do Copilot Studio, tenha em consideração estes pontos de integração com o registo.

Qualidade dos metadados:

  • Utilize nomes e descrições claras e descritivas dos agentes (visíveis para os administradores)
  • Documente a utilização de conectores e permissões na descrição do agente
  • Mantenha os metadados dos agentes atualizados

Transparência de permissões:

  • Os administradores veem todas as permissões pedidas no registo
  • Apenas adicione os conectores de que necessita
  • Compreenda as políticas do Power Platform que regulam a utilização dos conectores

Integração da observabilidade:

  • O registo liga-se a dados de observabilidade (utilização, desempenho, erros)
  • Os administradores podem monitorizar a atividade do seu agente
  • Estruturar agentes com a observabilidade em mente (consulte Integração da observabilidade)

Sensibilização para a governação:

  • Os agentes podem ser bloqueados, reatribuídos ou eliminados por administradores
  • Estruture agentes para lidar com a desativação de forma adequada
  • Comunique com os administradores sobre as necessidades dos conectores com privilégios elevados

Passos seguintes

  • Last updated on