Monitore os agentes usando o Inventário de Agentes no Copilot Agent Kit

O recurso Inventory de Agentes oferece aos administradores visibilidade para todo o locatário sobre todos os agentes personalizados e agentes declarativos do Copilot Studio na organização, em diversos 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 governança e métricas de uso.

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 arquivo AGENT_INVENTORY_V1.md.

Dashboard

O painel do Estoque do Agente oferece um resumo para todo o locatário e uma navegação detalhada no estoque. Selecione um bloco, gráfico ou item de lista para abrir uma visualização filtrada na grade do agente.

Contexto do inventário

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

Se o inventário está atual, vazio ou uma sincronização está em andamento.
A porcentagem de registros enriquecidos com configuração detalhada.
O número de agentes com detalhes limitados.
O número de ambientes sincronizados.
O último tempo de sincronização bem-sucedido, quando disponível.

Métricas de portfólio

Os blocos métricos ajudam você a pular diretamente para segmentos importantes do inventário:

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

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

Análise e governança

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

Crescimento do portfólio com intervalos de seis e doze meses.
Distribuição de autenticação .
Prioridades de governança que exigem revisão de administradores.
Distribuição do status do portfólio.
Adoção de capacidade entre agentes enriquecidos.
Melhores ambientes classificados por número de agentes.
Agentes para observar registros que exijam atenção.

As porcentagens dependem dos ambientes para os quais as identidades de conexão configuradas podem recuperar dados do agente e configurações detalhadas. Saiba mais sobre os modos de coleta de dados.

Navegue por todos os agentes

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

Você pode filtrar, ordenar e agrupar por qualquer coluna, adicionar ou remover colunas para ajustar a grade às suas necessidades e exportar a visualização atual para o Excel.

Detalhes do agente

Selecione o nome de um agente na grade para abrir os detalhes do agente. O cabeçalho mostra a identidade do agente, contexto do ambiente, status do ciclo de vida, propriedade e ações disponíveis. Um banner de informações informa se o registro possui enriquecimento completo do Dataverse ou apenas detalhes limitados de configuração.

Aba Visão Geral

A aba Visão Geral mostra o resumo do agente e informações de ambiente, postura de governança e sinais, além de um snapshot de uso quando o histórico de uso existe. Se as descrições geradas por IA estiverem ativadas e o agente for um agente do Copilot elegível do GitHub, uma descrição gerada por IA também é mostrada.

Aba Componentes

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

Guia Uso

A aba Uso aparece apenas quando existem registros de uso para o agente. Ele inclui:

Mês até o momento, os dois meses anteriores, os últimos três meses e os últimos seis meses. Os últimos seis meses são selecionados por padrão.
Total de créditos de Copilot e média de créditos por semana ativa.
Usuários reportados e recurso de uso principal.
Tendências semanais de crédito.
Destaques de uso, créditos por funcionalidade e canal, e registros recentes de uso.
Uma exportação específica de Excel para agentes.

Aba de metadados

A aba 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 Inventário de Agentes separa a sincronização da atualização do painel.

Agentes de sincronização

Selecione Sincronizar agentes quando precisar coletar o inventário do inquilino novamente. A sincronização segue os filtros, grupos de ambiente, modo de coleta de dados, configuração de uso e cronograma salvos no Configurar Inventário de Agente.

Enquanto uma sincronização estiver em andamento:

O status do inventário muda para Sincronização em andamento.
Os agentes de sincronização estão desativados para evitar operações duplicadas.
Configurações que poderiam alterar a configuração de sincronização ativa não estão disponíveis.
O painel recarrega os detalhes do agente, o histórico de uso, o status de sincronização e as informações da última sincronização depois que a sincronização é concluída.

Atualizar dados do painel

Selecione Atualizar dados do painel para recarregar os dados já armazenados nas tabelas de Detalhes do Agente e Histórico de Uso do Agente . O refresh não inicia um Agent Sync e não redescobre ambientes ou agentes. Use-o após a conclusão de uma sincronização ou quando o painel mostrar dados em cache desatualizados.

Importante

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

Ações de governação

O Inventário de Agentes permite as ações Reatribuir, Colocar em quarentena e Remover da quarentena. As ações aparecem apenas quando cada agente selecionado é elegível.

Disponibilidade de ação

A coluna Status na grade é preenchida durante a última sincronização de inventário e reflete o valor vindo do centro de administração do Power Platform (dados do One Stock). Quais ações são mostradas dependem de quantos registros você seleciona e do status deles.

Ação	Regra de seleção	Escondido quando
Reatribuir	Um ou vários registros (até um máximo de 50) podem ser selecionados.	Qualquer agente selecionado não é elegível para reatribuição.
Quarentena	Um ou vários registros em status 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	Um ou vários registros em status Bloqueado (até um máximo de 50) podem ser selecionados.	Qualquer agente selecionado está em Rascunho, Disponível ou não está qualificado para sair da quarentena.

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

Na página de detalhes do agente, a disponibilidade para colocar e retirar da quarentena é baseada no status em tempo real do agente, e não no status sincronizado exibido na grade.

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, excluí-lo ou compartilhar com os colegas de equipe de acordo com suas permissões.

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

Colocar em quarentena e retirar da quarentena

Quarentena bloqueia um agente elegível. Remover da quarentena restaura um agente bloqueado elegível. A caixa de diálogo de confirmação identifica os agentes, ambientes e estados afetados antes que uma operação seja enviada.

Ações em massa suportam até 50 agentes por operação e estão disponíveis apenas quando cada registro selecionado é elegível.

Configurar inventário de agente

Selecione Configurações no cabeçalho do painel para abrir a configuração de sincronização do agente. Use-o para controlar quais ambientes e tipos de agentes são coletados, ajustar opções de inventário e definir o cronograma de sincronização e o modo de coleta.

Note

Essas configurações no aplicativo presumem que as referências de conexão da solução necessárias já estejam configuradas. Saiba mais sobre como configurar as referências de conexão em Configure Agent Inventory.

Tipos de ambiente

Escolha quais tipos de ambiente são escaneados:

Desenvolvedor
Default
Sandbox
Produção
Teste
Teams

Se você não selecionar um tipo de ambiente, o sistema inclui todos os tipos de ambiente.

Tipos de agente

Escolha se o estoque inclui:

Agentes personalizados
Agentes declarativos

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

Grupos de ambiente

Grupos de ambiente fornecem escopos de sincronização reutilizáveis. Como administrador, você pode:

Crie e edite um grupo.
Selecione ambientes membros usando os filtros de tipo de ambiente e região.
Ative ou desative o grupo.
Exclua um grupo que você não precisa mais.

Se você não ativar um grupo, todos os ambientes permitidos pelas outras configurações estão incluídos.

Opções de estoque

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

Exclua agentes do sistema: Pula agentes fornecidos pela Microsoft durante a sincronização.
Habilitar a descrição gerada por IA para agentes do GitHub Copilot: Permite a geração de descrições quando uma página de detalhes de agente elegível é visitada.
Incluir métricas de uso: Coleta a janela de uso de 180 dias mantida durante a sincronização.

Agendamento de sincronização e modo de coleta

Escolha como a sincronização roda e qual modo de coleta de dados usar:

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 o inventário diretamente de ambientes acessíveis.
Habilitar a sincronização automática diária: Executa o Inventário do Agente no cronograma diário configurado.

Selecione Salvar para aplicar as alterações. O save é desativado quando nenhuma configuração foi alterada, quando um save está em andamento ou quando as configurações não estão disponíveis durante uma sincronização ativa.

Dica

Use Atualizar os dados do painel após a sincronização concluída quando o painel precisar recarregar dados de tabela existentes. Use agentes de Sync apenas quando a coleta de inventário precisar ser executada novamente. Mantenha os filtros de ambiente e agente o mais restritos possível em tenants muito grandes e desative a coleta de uso quando não for necessário fazer análises de uso de 180 dias.

Modos de coleta de dados

A configuração do modo de coleta de dados determina como o sistema descobre e coleta registros de agentes.

Modo One Inventory (recomendado)

Quando você define o modo de coleta como One Inventory, o Agent Inventory usa os dados One Inventory:

Ele recupera os dados dos agentes do One Inventory através do centro de administração do Power Platform.
Ele lista ambientes usando a referência de conexão Copilot Agent Kit - Power Platform for Admins V2.
Ele combina os dados do agente One Inventory com a lista de ambientes para construir detalhes do ambiente.
Para cada ambiente, ele carrega os detalhes dos agentes no Inventário de Agentes ao mesclar os agentes obtidos do ambiente com os dados correspondentes do One Inventory.

Use este modo quando precisar de uma descoberta mais ampla de locatários e de metadados mais detalhados no centro de administração do Power Platform. Agentes descobertos pelo centro de administração, mas inacessíveis em seu ambiente, ainda são adicionados com detalhes limitados.

Modo padrão

Quando você define o modo de coleta para Standard, o Agent Inventory utiliza a abordagem padrão de coleta de dados:

Ele lista todos os ambientes usando a referência de conexão do Copilot Agent Kit - Power Platform for Admins (V1).
Ele busca agentes para cada ambiente.
Ele carrega os dados do agente no Inventário do Agente.

Use esse modo quando quiser que a coleta dependa apenas de ambientes acessíveis.

Em ambos os modos, o Agent Inventory utiliza a referência de conexão Copilot Agent Kit - Dataverse para se conectar a cada ambiente e coletar informações detalhadas sobre agentes, incluindo metadados, uso de recursos 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 uso

O Inventário de Agentes pode armazenar e exibir até 180 dias de dados de uso do agente. Para habilitar análises de uso:

Garanta que as conexões necessárias da solução estejam configuradas e permitidas pelas políticas de dados.
Abra a configuração de sincronização do agente.
Ative Incluir métricas de uso.
Clique em Salvar.
Selecione Sincronizar agentes ou aguarde a sincronização automática diária.

Os dados de uso são armazenados nas tabelas Detalhes do Agente e Histórico de Uso do Agente. A aba de Uso do agente aparece apenas quando registros de histórico de uso correspondentes estão disponíveis.

Configure a conexão HTTP com o Microsoft Entra ID

As métricas de uso dependem do conector HTTP com Microsoft Entra ID (pré-autorizado). Os valores de conexão dependem da nuvem em que seu tenant roda. Use a URL do Recurso Base e o URI de Recursos do Microsoft Entra ID que correspondam à sua nuvem quando você criar a conexão.

Nuvem	URL do Recurso Base	URI do recurso do Microsoft Entra ID
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 visibilidade total para todo o locatário, configure as referências de conexão com uma conta que tenha o papel de administrador do Power Platform . Para recuperar todos os detalhes em nível de funcionalidade, essa conta também precisa de acesso do administrador do sistema aos ambientes relevantes. Você pode usar outras contas, mas a visibilidade do inventário do agente é limitada aos ambientes em que o usuário tem acesso de administrador do sistema.

O Inventário de Agentes se baseia nos seguintes conectores, que devem ser permitidos pelas políticas de dados aplicadas ao ambiente:

Microsoft Dataverse
Power Platform para Administradores de Sistemas
Power Platform para Administradores V2
HTTP com Microsoft Entra ID (pré-autenticado)