Monitorize os agentes utilizando o Inventário de Agentes no Copilot Agent Kit

A funcionalidade Inventário de Agentes oferece aos administradores visibilidade a nível do inquilino sobre todos os agentes personalizados e declarativos do Copilot Studio na organização, em vários ambientes. Os dados do inventário de agentes incluem metadados do ciclo de vida e da propriedade, sinais de configuração e adoção de capacidades, indicadores de governação e métricas de utilização.

Note

Este artigo descreve a experiência atual do inventário de agentes. A experiência anterior está documentada no repositório Copilot Agent Kit em GitHub no ficheiro AGENT_INVENTORY_V1.md.

Dashboard

O dashboard de Inventário de Agentes apresenta-lhe um resumo ao nível do inquilino e navegação detalhada para o inventário. Selecione um bloco, gráfico ou item de lista para abrir uma vista filtrada na grelha do agente.

Contexto do inventário

A linha de estado no topo do painel mostra o estado atual do inventário:

Quer o inventário esteja atual, vazio ou uma sincronização esteja em curso.
A percentagem de registos enriquecidos com configuração detalhada.
O número de agentes com detalhes limitados.
O número de ambientes sincronizados.
A hora da última sincronização bem-sucedida, quando disponível.

Métricas de portefólio

As peças métricas ajudam-no a saltar diretamente para segmentos importantes do inventário:

Número de agentes
Alimentado por
Agentes autónomos
Agentes de recrutamento
Agentes com conhecimento

Selecione um mosaico para abrir a grelha de agentes filtrada por esse segmento. O Powered by tile agrupa os agentes em categorias como Standard, GitHub Copilot e Copilot Chat.

Análise e governação

O painel inclui também gráficos e listas que o ajudam a identificar padrões e riscos:

Crescimento da carteira com intervalos de seis e doze meses.
Distribuição de autenticação .
Prioridades de governação que exigem revisão por parte dos administradores.
Distribuição por estado do portefólio.
Adoção de capacidades através de agentes enriquecidos.
Melhores ambientes classificados por número de agentes.
Agentes a observar para registos que exijam atenção.

As percentagens dependem dos ambientes para os quais as identidades de ligação configuradas podem recuperar os dados do agente e a configuração detalhada. Saiba mais sobre os modos de recolha de dados.

Ver todos os agentes

Selecione Ver inventário completo no painel para abrir a grelha do agente. Use a grelha para encontrar, agrupar e exportar dados de inventário.

Podes filtrar, ordenar e agrupar por qualquer coluna, adicionar ou remover colunas para adaptar a grelha às tuas necessidades, e exportar a vista atual para o Excel.

Detalhes do agente

Selecione o nome de um agente na grelha para abrir os detalhes do Agente. O cabeçalho mostra a identidade do agente, contexto do ambiente, estado do ciclo de vida, propriedade e ações disponíveis. Um banner de informação indica se o registo tem enriquecimento total do Dataverse ou apenas detalhes limitados de configuração.

Aba Visão Geral

O separador Visão Geral mostra o resumo do agente e a informação do ambiente, a postura de governação e os sinais, e um instantâneo de utilização quando existe histórico de utilização. Se as descrições geradas por IA estiverem ativadas e o agente for um agente do Copilot elegível no GitHub, também é apresentada uma descrição gerada por IA.

Separador Componentes

O separador Componentes aparece apenas quando os dados dos componentes estão disponíveis para o agente. Use este separador para explorar a arquitetura do agente na vista do mapa de Componentes , navegar pelo conteúdo categorizado na vista de grupo de Componentes , expandir um grupo de componentes preenchidos de cada vez, ativar o modo Raw para inspecionar o JSON ou copiar o JSON dos componentes para investigação ou suporte.

Aba de uso

O separador Utilização aparece apenas quando existem registos de utilização para o agente. Inclui:

Mês até à data, os dois meses de calendário anteriores, os últimos três meses e os últimos seis meses. Os últimos seis meses são selecionados por defeito.
Créditos totais de Copilot e média de créditos por semana ativa.
Utilizadores reportados e funcionalidade principal de uso.
Tendências semanais de crédito.
Destaques de utilização, créditos por reportagem e canal, e registos recentes de utilização.
Uma exportação Excel específica para agente.

Metadados

O separador de Metadados está sempre disponível. Utilize-o para inspecionar valores técnicos como ID do agente e nome do esquema, ID e URL do ambiente, identificadores de localização e origem, e os campos de inventário bruto usados para diagnóstico e integração.

Sincronizar ou atualizar dados de inventário

O Agent Inventory separa a sincronização da atualização do dashboard.

Agentes de sincronização

Seleciona Sincronizar agentes quando precisares de recolher novamente o inventário do inquilino. A sincronização segue os filtros, grupos de ambiente, modo de recolha de dados, definição de utilização e cronograma guardados no Configurar Inventário de Agentes.

Enquanto a sincronização está a funcionar:

O estado do inventário muda para Sincronização em curso.
Os agentes de sincronização estão desativados para evitar operações duplicadas.
As definições que possam alterar a configuração de sincronização ativa não estão disponíveis.
O dashboard recarrega os detalhes do agente, histórico de utilização, estado de sincronização e informações de última sincronização após o estabelecimento da sincronização.

Atualizar os dados do painel

Selecione Atualizar dados do painel para recarregar os dados já armazenados nas tabelas de Detalhes do Agente e Histórico de Utilização do Agente . Refresh não inicia uma sincronização de agentes nem redescobre ambientes ou agentes. Use-o depois de uma sincronização concluída, ou quando o painel mostrar dados em cache obsoletos.

Important

A sincronização de agentes não usa créditos do Copilot. Os créditos são usados apenas quando as descrições geradas por IA são ativadas e uma página de detalhes elegível do GitHub agente do Copilot é visitada.

Ações de governação

O Inventário de Agentes suporta as ações Reatribuir, Colocar em quarentena e Retirar da quarentena. As ações só aparecem quando todos os agentes selecionados são elegíveis.

Disponibilidade da ação

A coluna Estado na grelha é preenchida durante a última sincronização de inventário e reflete o valor proveniente do centro de administração da Power Platform (dados do One Stock). Quais ações são mostradas dependem de quantos registos selecionas e do seu estado.

Action	Regra de seleção	Escondido quando
Reatribuir	Um ou vários registos (até um máximo de 50) podem ser selecionados.	Qualquer agente selecionado não é elegível para reatribuição.
Quarentena	Um ou vários registos em estado de Rascunho ou Disponível (até um máximo de 50) podem ser selecionados.	Qualquer agente selecionado é bloqueado ou não é elegível para quarentena.
Remover da quarentena	Podem ser selecionados um ou vários registos em estado Bloqueado (até um máximo de 50).	Qualquer agente selecionado está em Rascunho, Disponível ou não é elegível para sair da quarentena.

Se algum registo selecionado for incompatível com uma operação, essa operação fica oculta da barra de comandos. Registos cujo contexto do centro de administração Power Platform não corresponde ao ambiente de inventário não recebem ações de governação não suportadas.

Na página Detalhes do agente, a possibilidade de colocar em quarentena e de retirar da quarentena baseia-se no estado em tempo real do agente, em vez do estado sincronizado apresentado na grelha.

Reatribuir

Algumas organizações exigem que os agentes tenham proprietários para fins de conformidade. O proprietário pode editar o agente, publicar atualizações, apagá-lo ou partilhá-lo com os colegas de equipa de acordo com as suas permissões.

Selecione Reatribuir e escolha um utilizador que tenha uma licença Microsoft 365 Copilot. Para a reatribuição em massa, o diálogo mostra os ambientes selecionados, agentes, proprietários atuais e estado da operação. Após a conclusão da reatribuição, o estado da reatribuição é mostrado como completo para cada agente processado com sucesso.

Quarentena e retirar da quarentena

A quarentena bloqueia um agente elegível. Remover da quarentena repõe um agente bloqueado elegível. O diálogo de confirmação identifica os agentes, ambientes e estados afetados antes de uma operação ser submetida.

As ações em lote suportam até 50 agentes por operação e estão disponíveis apenas quando cada registo selecionado é elegível.

Configurar inventário de agentes

Selecione Definições no cabeçalho do painel para abrir a configuração de sincronização do agente. Use-o para controlar quais os ambientes e tipos de agentes que são recolhidos, ajustar opções de inventário e definir o calendário de sincronização e o modo de recolha.

Note

Estas definições dentro da aplicação assumem que as referências de ligação necessárias à solução já estão configuradas. Saiba mais sobre como configurar as referências de conexão em Configurar Inventário de Agentes.

Tipos de ambiente

Escolha que tipos de ambiente são varridos:

Desenvolvedor
Default
Caixa de areia
Produção
Ensaio
Teams

Se não selecionares um tipo de ambiente, o sistema inclui todos os tipos de ambiente.

Tipos de agentes

Escolha se o inventário inclui:

Agentes aduaneiros
Agentes declarativos

Se não selecionares um tipo de agente, o inventário inclui todos os tipos de agentes.

Grupos de ambientes

Os grupos de ambientes fornecem âmbitos de sincronização reutilizáveis. Como administrador, pode:

Cria e edita um grupo.
Selecione os ambientes membros utilizando filtros de tipo de ambiente e região.
Ativa ou desativa o grupo.
Apaga um grupo que já não precisas.

Se não ativares um grupo, todos os ambientes permitidos pelas outras definições estão incluídos.

Opções de inventário

Defina as seguintes opções para controlar o que o sistema recolhe durante a sincronização:

Excluir agentes do sistema: Ignora os agentes fornecidos pela Microsoft durante a sincronização.
Ativar a descrição gerada por IA para agentes do GitHub Copilot: Permite a geração de descrições quando uma página de detalhes do agente elegível é visitada.
Incluir métricas de utilização: Recolhe a janela de utilização retida de 180 dias durante a sincronização.

Sincronização do calendário e modo de recolha

Escolha como a sincronização corre e qual o modo de recolha de dados a utilizar:

One Inventory (centro de administração Power Platform): Combina o inventário do centro de administração com dados do ambiente para uma descoberta mais ampla e metadados mais ricos.
Standard (apenas ambientes): Recupera inventário diretamente de ambientes acessíveis.
Ativar a sincronização automática diária: Executa o Inventário do Agente no cronograma diário configurado.

Selecionar Guardar para aplicar as alterações. Guardar está desativado quando não houver alterações às definições, quando uma operação de gravação estiver em curso ou quando as definições não estiverem disponíveis durante uma sincronização ativa.

Sugestão

Use Atualizar dados do dashboard depois de concluída uma sincronização quando o dashboard precisar de recarregar os dados existentes da tabela. Use agentes Sync apenas quando a recolha de inventário tiver de ser executada novamente. Mantenha os filtros de ambiente e de agente tão restritos quanto possível em inquilinos muito grandes e desative a recolha de utilização quando não forem necessárias análises de utilização de 180 dias.

Modos de recolha de dados

A definição do modo de recolha de dados determina como o sistema descobre e recolhe registos de agentes.

Modo de One Inventory (recomendado)

Quando define o modo de recolha para One Inventory, o Agent Inventory utiliza os dados One Inventory:

Recupera os dados do agente do One Inventory através do centro de administração da Power Platform.
Lista ambientes usando a referência de ligação Copilot Agent Kit - Power Platform for Admins V2.
Combina os dados do agente One Inventory com a lista de ambientes para construir os detalhes do ambiente.
Para cada ambiente, carrega os detalhes do agente no Agent Inventory ao combinar os agentes obtidos do ambiente com os dados correspondentes do One Inventory.

Utilize este modo quando necessitar de uma deteção mais abrangente de inquilinos e de metadados mais completos no centro de administração do Power Platform. Agentes descobertos através do centro administrativo mas inacessíveis no seu ambiente continuam a ser adicionados com detalhes limitados.

Modo padrão

Quando define o modo de recolha para Standard, o Agente Inventory utiliza a abordagem padrão de recolha de dados:

Lista todos os ambientes ao utilizar a referência de conexão (V1) do Copilot Agent Kit - Power Platform for Admins.
Obtém os agentes para cada ambiente.
Carrega os dados do agente no Inventário do Agente.

Usa este modo quando quiseres que a recolha dependa apenas de ambientes acessíveis.

Em ambos os modos, o Agent Inventory utiliza a referência de ligação Copilot Agent Kit - Dataverse para se ligar a cada ambiente e recolher informações detalhadas sobre agentes, incluindo metadados, utilização de funcionalidades e configuração. O sistema recupera informações detalhadas apenas para ambientes onde a conta configurada tem acesso de administrador do sistema.

Saiba mais sobre a lista completa de conectores usados em todo o kit nos requisitos de Conectores.

Métricas de utilização

O Inventário do Agente pode reter e apresentar até 180 dias de dados de utilização do agente. Para permitir análises de utilização:

Garantir que as ligações necessárias à solução estão configuradas e permitidas pelas políticas de dados.
Abra a configuração de sincronização do Agente.
Ative Incluir métricas de utilização.
Selecione Guardar.
Seleciona agentes de sincronização, ou espera pela sincronização automática diária.

Os dados de utilização são armazenados nas tabelas de Detalhes do Agente e Histórico de Utilização do Agente . O separador de Utilização de um agente aparece apenas quando existem registos de histórico de utilização correspondentes disponíveis.

Configurar a ligação HTTP com o Microsoft Entra ID

As métricas de utilização dependem do HTTP com conector Microsoft Entra ID (pré-autorizado). Os valores de ligação dependem da nuvem onde o seu tenant está alojado. Use o URL do Recurso Base e o URI de Recursos do Microsoft Entra ID que correspondam à sua nuvem quando criar a ligação.

Nuvem	URL do recurso base	Microsoft Entra ID Resource URI
Comercial	`https://licensing.powerplatform.microsoft.com/`	`https://licensing.powerplatform.microsoft.com/`
GCC	`https://gov.licensing.powerplatform.microsoft.us/`	`https://gov.licensing.powerplatform.microsoft.us/`
GCC High	`https://high.licensing.powerplatform.microsoft.us/`	`https://high.licensing.powerplatform.microsoft.us/`

Permissões e requisitos de conectores

As referências de conexão na solução limitam e controlam a visibilidade para os agentes. Para uma visibilidade completa ao nível do inquilino, configure as referências de ligação com uma conta que tenha a função de Administrador do Power Platform. Para recuperar todos os detalhes a nível de funcionalidade, essa conta também precisa de acesso do administrador de sistema aos ambientes relevantes. Você pode usar outras contas, mas a visibilidade do inventário do agente é limitada aos ambientes onde o usuário tem acesso de administrador do sistema.

O Inventário de Agentes baseia-se nos seguintes conectores, que as políticas de dados aplicadas ao ambiente devem permitir:

Microsoft Dataverse
Plataforma de energia para administradores
Plataforma de energia para administradores V2
HTTP com Microsoft Entra ID (preautorizado)