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 de inventário do agente incluem metadados básicos como tempos de criação, estado de publicação e modo de autenticação, bem como informações sobre o uso de funcionalidades como fontes de conhecimento, uso de prompts, tipo de orquestração e mais.

Dashboard

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

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

Vista detalhada

No painel Inventário de agentes, você pode ver o número total de agentes no locatário, a porcentagem de uso de recursos de IA generativa, ações, prompts e quantos agentes usam fontes de conhecimento. Você também pode ver o mecanismo de autenticação utilizado pelos agentes personalizados, uma linha do tempo de criação dos agentes que visualiza o crescimento dos mesmos, e uma lista dos cinco principais ambientes classificados por contagem de agentes.

Selecione um agente e, em seguida, 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 de Agentes exibindo metadados, ambiente, data e hora de criação e uso de recursos, como ações e IA.

Visualização da lista

Quando você seleciona Mostrar mais na exibição do painel, você vê uma exibição de lista. Encontre as informações de que precisa filtrando, classificando e adicionando colunas extras.

Captura de ecrã da vista de lista Inventário de Agentes com opções para filtrar, ordenar e adicionar colunas para obter informações detalhadas.

Agir contra agentes

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

Captura de ecrã da grelha do Inventário de Agentes mostrando as ações de Ver Detalhes, Reatribuir, Quarentena e Desquarentena na barra de comandos.

Disponibilidade em ação

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

Action Regra de seleção Escondido quando
Ver Detalhes Mostrado apenas quando exatamente um registo é selecionado. São selecionados zero ou mais do que um registo.
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.
Desquarentena Podem ser selecionados um ou vários registos em estado Bloqueado (até um máximo de 50). Qualquer agente selecionado está no draft, disponível ou não é elegível para desquarentena.

Quando a seleção inclui um agente que não cumpre os critérios para uma ação, a ação fica oculta da barra de comandos.

Captura de ecrã que mostra que as ações inelegíveis estão ocultas da barra de comandos quando a seleção inclui um agente que não cumpre os critérios de ação.

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

Captura de ecrã que mostra 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 proprietário do agente pode editar o agente, publicar atualizações, apagá-lo ou partilhá-lo com os colegas de equipa. Selecionar Reatribuir abre um diálogo onde pode escolher qualquer utilizador que tenha licença para o Microsoft 365 Copilot. Todos os agentes selecionados são reatribuídos ao utilizador escolhido.

Captura de ecrã do diálogo Reatribuir Agente para selecionar um utilizador-alvo a quem reatribuir os agentes selecionados.

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

Captura de ecrã da grelha do Inventário do Agente mostrando o Estado de Reatribuição definido para Concluído após uma reatribuição bem-sucedida.

Quarentena e desquarentena

Quarentena bloqueia um agente, e Desquarentena desbloqueia um agente. Quando selecionas uma ação, abre-se um diálogo de confirmação que lista o ambiente, o agente e o estado atual do agente. Confirme a operação para aplicar a alteração aos agentes selecionados.

Captura de ecrã do diálogo de confirmação de Quarentena ou Desquarentena listando o ambiente, agente e estado 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 estado de quarentena ou desquarentena mostrado baseia-se no estado ativo do agente, em vez do estado sincronizado exibido na grelha.

Modos de recolha de dados

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

Quando defines Ativar Um Inventário como Sim, o Agente Inventário utiliza os dados do Único Inventário:

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

Modo padrão

Quando define Permitir Um Inventário para Não, o Inventário do Agente utiliza a abordagem padrão de recolha de dados:

  1. Lista todos os ambientes usando a referência de ligação (V1) do Copilot Agent Kit - Power Platform for Admins.
  2. Traz agentes para cada ambiente.
  3. Carrega os dados do agente no Inventário do Agente.

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.

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

Ver métricas de utilização

Pode consultar os detalhes de utilização do seu agente nos últimos 180 dias no Inventário de Agentes.

Para visualizar os dados de utilização, consulte a grelha de Agentes no painel de Inventário de Agentes. Se o campo Total de Utilização/Mês contiver um valor, a secção de métricas de Utilização aparece na página de Detalhes do Agente .

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

Os dados de utilização são atualizados automaticamente quando o Inventory do Agente é executado no seu cronograma diário. Também pode atualizá-lo manualmente executando uma operação de Sincronização de Agentes .

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

As métricas de utilização dependem do HTTP com conector Microsoft Entra ID (pré-autorizado). Os valores da ligação dependem da cloud onde o teu tenant corre. 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/

Note

As referências de conexão na solução limitam e controlam a visibilidade para os agentes. A referência de ligação Copilot Agent Kit - Power Platform for Admins recebe a lista de ambientes no tenant, e a referência de ligação Copilot Agent Kit - Dataverse recolhe a informação do agente dos ambientes. Para visibilidade total, configure as referências de conexão com uma conta que tenha a função de administrador da Power Platform e 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 onde o usuário tem acesso de administrador do sistema. Saiba mais em Configurar inventário de agentes.

Passo seguinte

Configurar inventário de agentes

  • Last updated on