Monitore os agentes usando o Inventory 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 do agente incluem metadados básicos, como tempos de criação, status de publicação e modo de autenticação, além de informações sobre o uso de recursos, como fontes de conhecimento, uso de prompts, tipo de orquestração e mais.

Dashboard

O recurso Inventário de Agente inclui um painel que mostra uma visão geral de agentes, crescimento e adoção de IA. Você pode exibir dados detalhados para cada agente e exportá-los para uso em outros aplicativos.

Captura de tela do painel Inventário do Agente mostrando uma visão geral de agentes, crescimento e adoção de IA com opções para exibir dados detalhados e exportar.

Visualização detalhada

No painel de inventário de agentes, você pode ver o número total de agentes no tenant, a porcentagem de uso das funcionalidades de IA generativa, ações, prompts e quantos agentes utilizam fontes de conhecimento. Você também pode ver o mecanismo de autenticação usado pelos agentes personalizados, uma linha do tempo de criação do agente que visualiza o crescimento e uma lista dos cinco principais ambientes por contagem de agentes.

Selecione um agente e selecione Exibir detalhes para ver uma exibição detalhada do agente selecionado. Essa exibição inclui metadados básicos sobre o agente personalizado, o ambiente, o tempo de criação, o criador e informações detalhadas sobre o uso de recursos, como ações, IA generativa, habilidades, prompts e fontes de conhecimento.

Captura de tela da exibição detalhada do inventário do agente exibindo metadados, ambiente, data e hora de criação, e uso de funcionalidades como ações e IA.

Exibição de lista

Ao selecionar Mostrar mais no modo de exibição do painel, você verá uma exibição de lista. Encontre as informações necessárias filtrando, classificando e adicionando colunas extras.

Captura de tela da exibição de lista Inventário do Agente com opções para filtrar, classificar e adicionar colunas para obter informações detalhadas.

Agir contra agentes

O Inventory de Agentes permite que administradores atuem diretamente sobre os agentes a partir da grade. As ações disponíveis são Ver Detalhes, Reatribuir, Quarentena e Desquarentena. Quais ações aparecem na barra de comandos dependem do número de registros selecionados e de seu status.

Captura de tela da grade do Inventário de Agentes mostrando as ações de Visualizar Detalhes, Reatribuir, Quarentena e Desquarentena na barra de comandos.

Disponibilidade de ação

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

Ação Regra de seleção Escondido quando
Exibir Detalhes Mostrado apenas quando exatamente um registro é selecionado. Zero ou mais de um registro é selecionado.
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.
Desquarentena Um ou vários registros em status Bloqueado (até um máximo de 50) podem ser selecionados. Qualquer agente selecionado é Draft, Disponível ou não elegível para desquarentena.

Quando a seleção inclui um agente que não atende aos critérios para uma ação, a ação fica oculta na barra de comandos.

Captura de tela mostrando que ações inelegíveis ficam ocultas na barra de comandos quando a seleção inclui um agente que não atende aos critérios de ação.

Por exemplo, Quarentena é oculta quando a seleção inclui um agente que já está Bloqueado.

Captura de tela mostrando que a ação de Quarentena está oculta quando um agente Bloqueado é incluído na seleção.

Reatribuir

Algumas organizações exigem que os agentes tenham proprietários para fins de conformidade. O dono do agente pode editar o agente, publicar atualizações, excluí-lo ou compartilhá-lo com os colegas de equipe. Selecionar Reatribuir abre um diálogo onde você pode escolher qualquer usuário que tenha licença para o Microsoft 365 Copilot. Todos os agentes selecionados são realocados ao usuário escolhido.

Captura de tela da janela de diálogo Reatribuir Agente para selecionar um usuário-alvo para reatribuir os agentes selecionados.

Após o término da reatribuição, a coluna de Status de Reatribuição mostra Concluído para cada agente.

Captura de tela da grade do Inventário do Agente mostrando o status de Reatribuição definido para Concluído após uma realocação bem-sucedida.

Quarentena e desquarentena

Quarentena bloqueia um agente, e Desquarentena desbloqueia um agente. Quando você seleciona uma ação, uma caixa de confirmação se abre que lista o ambiente, o agente e o status atual do agente. Confirme a operação para aplicar a alteração aos agentes selecionados.

Captura de tela do diálogo de confirmação de Quarentena ou Desquarentena listando o ambiente, agente e status atual.

Ações na página de Detalhes do Agente

As mesmas ações estão disponíveis na página de Detalhes do Agente para cada agente. Nesta página, o status de quarentena ou desquarentena mostrado é baseado no status ativo do agente, em vez do status sincronizado exibido na grade.

Modos de coleta de dados

A variável de ambiente Enable One Inventory controla o processo de coleta de dados. Ele determina como os dados do agente são recuperados e carregados no Inventário do Agente.

Quando você define Permitir Um Inventário como Sim, o Agente Inventário usa dados do Único Inventário:

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

Modo padrão

Quando você define Habilitar Um Inventário como Não, o Agente Inventory utiliza a abordagem padrão de coleta de dados:

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

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.

Para a lista completa de conectores usados em todo o kit, veja Requisitos de conectores.

Exibir métricas de uso

Você pode ver os detalhes de uso do seu agente nos últimos 180 dias no Inventário de Agentes.

Para visualizar os dados de uso, verifique a grade de Agentes no painel de Inventário de Agentes. Se o campo Total de Uso/Mês contiver um valor, a seção de métricas de Uso aparece na página de Detalhes do Agente .

Captura de tela da página de Detalhes do Inventário do Agente com a seção de métricas de uso exibida para um agente específico.

Os dados de uso são atualizados automaticamente quando o Agente Inventory roda em sua rotina diária. Você também pode atualizá-lo manualmente executando uma operação de Operação de Sincronização de Agente .

Configure o HTTP com a conexão do Microsoft Entra ID

As métricas de uso dependem do HTTP com conector 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 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/

Note

As referências de conexão na solução limitam e controlam a visibilidade para os agentes. A referência de conexão Copilot Agent Kit - Power Platform for Admins recebe a lista de ambientes no tenant, e a Copilot Agent Kit - referência de conexão Dataverse coleta as informações do agente dos ambientes. Para visibilidade total, configure as referências de conexão com uma conta que tenha a função de administrador do Power Platform e a permissão de nível de administrador do sistema para todos os ambientes. 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. Saiba mais em Configurar Inventário de Agente.

Próximas etapas

Configurar inventário de agente

  • Last updated on