Gerenciar o registro do agente no Centro de administração do Microsoft 365

O registro de agentes no Centro de administração do Microsoft 365 fornece uma exibição centralizada de todos os agentes disponíveis para sua organização. Esta lista ajuda você a monitorar, gerenciar e controlar agentes para sua organização.

Exibir registro do agente

  1. Entre no Centro de administração do Microsoft 365.

  2. No painel de navegação esquerdo, selecione Agentes>Todos os agentes>Registo.

    Captura de tela de uma lista de agentes disponíveis para um locatário.

Tipos de agentes

O Registro do agente lista todos os agentes disponíveis para sua organização. Os agentes são divididos em quatro tipos principais, conforme mostrado na tabela a seguir:

Tipo de agente Descrição
Agentes da Microsoft Agentes criados e mantidos pela Microsoft.
Agentes externos criados por parceiros Agentes criados por desenvolvedores confiáveis que não são da Microsoft e publicados para disponibilidade mais ampla ou pública.
Publicado pela sua organização Agentes personalizados aprovados e publicados por sua organização para uso mais amplo. Esses agentes podem ser chamados de agentes de LOB (Linha de Negócios).
Compartilhado pelo criador Agentes criados e compartilhados por usuários individuais ou desenvolvedores em sua organização. Esses agentes são comumente chamados de agentes compartilhados.

Observação

O mesmo agente do Copilot Studio (mecanismo declarativo ou personalizado) pode aparecer mais de uma vez no registro com diferentes tipos de editor, como Compartilhado pelo criador e Publicado pela sua organização. Essas linhas de aparência duplicada são esperadas e por design. Eles representam registros separados do ciclo de vida e do editor para o mesmo agente subjacente, não um erro de inventário.

Para obter detalhes do ciclo de vida e ações administrativas disponíveis, consulte Como um agente pode aparecer como várias entradas.

Como um agente pode aparecer como várias entradas

Para um agente de mecanismo personalizado, a aparência dele no Registro depende do ciclo de vida de publicação e das ações executadas pelos criadores e administradores:

  • Publicar o agente apenas no Copilot Studio pode não torná-lo visível no centro de administração.
  • Selecionar Ver agente no Microsoft 365 cria uma entrada Compartilhado pelo criador , que os criadores costumam usar para testar o agente antes de compartilhá-lo de forma mais ampla.
  • Optar por mostrar o agente para todos na organização e enviá-lo para aprovação do administrador, seguido por um administrador publicá-lo, cria uma entrada Publicado pela sua organização .

As ações administrativas disponíveis diferem de acordo com o tipo de agente e o estado do fornecedor. Por exemplo, algumas entradas oferecem Excluir, outras oferecem Remover e algumas oferecem apenas Bloquear. Remover uma entrada não remove a outra. Para obter mais informações, consulte Tipos de agente que você pode gerenciar.

Resumo do registro do agente

O Registro do agente fornece detalhes rápidos sobre os agentes que sua organização tem disponíveis, conforme mostrado na tabela a seguir:

Detalhes do agente em todo o locatário Descrição
Total de agentes O número de agentes disponíveis no locatário da sua organização.

Observação: A aplicação de filtros à lista de agentes não altera a contagem total de agentes .

Agentes sem proprietários O número de agentes que não têm mais proprietários em sua organização.
Agentes não gerenciados O número de agentes criados ou gerenciados fora do Agent 365, sem sua proteção contra riscos e observabilidade.

Filtros de registro de agente

O Registro de agentes pode conter um estoque grande e diversificado de agentes. À medida que a adoção de agentes da sua organização aumenta, o gerenciamento de todos os seus agentes pode ser mais complexo e complexo. Além de classificar a lista de agentes por coluna, você pode filtrar a lista. Filtrar essa lista ajuda a restringir a exibição aos agentes nos quais você deseja se concentrar no momento, o que permite:

  • Seja mais eficiente.
  • Tome decisões focadas.
  • Aplique melhor seus processos de governança de agentes.

Você pode filtrar a lista de agentes com base nos seguintes critérios:

  • Status - Você pode filtrar a lista de agentes com base no status do agente.
  • Tipo de editor - O filtro de editor indica quem possui e distribui o agente, em vez de onde ou como ele foi criado. Esse filtro é usado principalmente para distinguir entre agentes da Microsoft, agentes criados por parceiros externos e agentes de propriedade interna publicados por sua organização.
  • Canal - O filtro de canal é o local em que o agente é implantado. É a superfície por meio da qual os membros da sua organização podem descobrir e interagir com o agente. Os valores de canal incluem Copilot, Teams, Outlook, aplicativos Microsoft 365 e SharePoint.
  • Plataforma - O filtro de plataforma indica qual plataforma ou produto foi usado para criar o agente.
  • Fonte de dados – o filtro de fonte de dados permite que você selecione Conhecimento incorporado e Modelos ajustados como opções de fonte de dados. O conhecimento incorporado refere-se a agentes que incluem arquivos que foram carregados pelo agente, criador ou desenvolvedor como fontes de conhecimento. Modelos ajustados indicam que o agente foi criado usando o Ajuste do Microsoft Copilot, permitindo que o agente ajuste LLMs com seus próprios dados da organização.

Dica

Se você não vir os agentes que espera ver na lista de registro de agentes, marque se você não tem um conjunto de filtros existente.

Determinadas colunas permitem classificar a lista de registro de agentes. Para classificar a lista, selecione o título da coluna.

A aplicação de filtros à lista de agentes não altera a contagem total de agentes .

Ações de registro do agente

O Registro do agente fornece ações de agente relacionadas especificamente à lista de agentes do locatário, conforme mostrado na tabela a seguir:

Ação Descrição
Refresh Atualizações a lista para fornecer a exibição mais atual da lista de agentes.
Export Exporta agentes para um arquivo CSV. Essa ação pode levar algum tempo, dependendo do número de agentes no locatário. Para obter mais informações, consulte Exportar para o Excel.
Adicionar agente Fornece um método para carregar um arquivo de manifesto do agente (.zip). Para obter mais informações, consulte Carregar agente personalizado.
Gerenciar agentes fixados Selecione quais agentes são fixados para o usuário. Os agentes fixados são exibidos com mais destaque em cada canal disponível em que o agente está implantado. Você pode alterar a prioridade dos agentes fixados movendo-os para cima e para baixo nesta lista. Se um usuário tiver mais de três agentes fixados, eles não verão os agentes com prioridade mais baixa. Para obter mais informações, consulte Agentes fixados gerenciados.
Personalizar o modo de exibição Personalize como as colunas são exibidas na lista de agentes. Para obter mais informações, consulte Exibição personalizada.
Pesquisa Use a opção de pesquisa para encontrar rapidamente um agente no Registro do agente.

Dica

Além das ações acima, você pode alterar o modo de exibição da lista de Lista normal para Lista compacta selecionando o ícone de lista ao lado da caixa de pesquisa .

Agentes sem proprietários

Os agentes compartilhados podem perder o proprietário quando você exclui da organização o usuário que os criou.

Para ajudar os administradores a gerenciar esses cenários, o Centro de administração do Microsoft 365 permite que você identifique e gerencie agentes compartilhados sem proprietário. O dashboard exibe a contagem total desses agentes, um filtro de um clique para isolá-los rapidamente e atualizações em tempo real que refletem as exclusões do usuário. Quando os administradores usam esses recursos, eles podem revisar e resolver com eficiência as lacunas de propriedade bloqueando ou excluindo os agentes afetados.

Captura de tela da exibição de agentes sem proprietário.

Quando você seleciona o card Agentes sem proprietários, a lista de agentes será filtrada para mostrar os agentes com base no tipo de Editor e Proprietário. Você pode revisar a lista de agentes sem proprietários e tomar as ações apropriadas para cada agente, como bloquear ou excluir o agente.

Principais recursos

  • Contagem de agentes sem proprietário - Os administradores podem visualizar o número total de agentes sem um proprietário válido diretamente no dashboard. Por exemplo, o dashboard mostra 20 agentes sem proprietário, o que indica que os usuários que saíram da organização criaram esses agentes.
  • Filtro com um clique - Selecionar o painel do dashboard filtra instantaneamente a lista de agentes para exibir apenas agentes compartilhados sem um proprietário. Esse recurso permite triagem e ação rápidas.
  • Atualizações em tempo real - A contagem de agentes sem proprietário é atualizada automaticamente quando você exclui irreversivelmente um usuário da organização. Esse recurso garante que o dashboard reflita o estado atual sem exigir atualizações manuais.

Riscos do agente

Observação

A experiência atualizada de detalhes de risco está sendo implementada gradualmente. Se você vir a interface anterior, a experiência atualizada ainda não chegou à sua região.

Os sinais de risco no Registro de Agente são um conjunto consolidado de detecções de segurança relacionadas ao agente que fornecem aos administradores de TI uma visão única dos riscos do agente em seu locatário. Ao reunir sinais de várias plataformas de segurança em um só lugar, os administradores de TI podem entender o que está sinalizado sem alternar entre portais ou elevar suas permissões para diferentes funções de segurança.

As plataformas de segurança detectam sinais de risco quando as atividades de um agente entram em conflito com as políticas de segurança da sua organização. Você pode compartilhar esses detalhes com sua equipe de segurança para investigação e correção.

Pré-requisitos para visualizar sinais de risco

  • Seu locatário deve ter uma licença E7 ou A365. Para exibir suas assinaturas no Centro de administração do Microsoft 365, selecione Assinaturas deLicenças> de Cobrança>. Para obter mais informações, consulte Licenciamento para gerenciamento de agentes.

A coluna Riscos e detalhes de risco

A coluna Riscos na página Todos os agentes mostra a contagem agregada de sinais de risco para cada agente. Quando você seleciona a contagem, o painel Detalhes do risco é aberto. Esse painel oferece uma visão focada e acionável dos sinais de risco do agente. Ela fornece o seguinte:

  • Cobertura total em todos os sinais de alto, médio e baixo risco.
  • Sinais de risco agrupados em seções expansíveis de gravidade alta, média e baixa.
  • Descrições detalhadas de sinais de risco individuais.
  • Uma contagem de ocorrências para cada sinal de risco individual, mostrando quantas vezes esse sinal foi gerado.
  • Os sinais de risco são originados de: Exibe as plataformas de segurança da Microsoft que contribuem com sinais de risco para o agente, como Microsoft Purview, Microsoft Entra e Microsoft Defender. Somente plataformas com sinais de contribuição são mostradas. Cada nome de plataforma é um link profundo para o respectivo portal para investigação adicional, sujeito às funções e permissões do usuário.
  • Quando um agente tem várias instâncias, os sinais de risco são agrupados por instância, permitindo que você analise detalhadamente os sinais agregados para a instância do agente selecionada.

Captura de tela da página Todos os agentes mostrando a coluna Riscos com contagens agregadas de sinais de risco para cada agente.

Captura de tela do painel Detalhes do risco mostrando links de origem e sinais de risco agrupados em seções expansíveis de gravidade alta, média e baixa.

Importante

As contagens de sinal de risco no Centro de administração do Microsoft 365 podem estar até uma hora atrasadas em relação ao que os portais de segurança mostram. As contagens refletem os sinais de risco ativo. Uma contagem de zero indica que nenhum sinal ativo é detectado no momento para esse agente nas plataformas conectadas.

Portal de segurança Função necessária — qualquer uma
Microsoft Entra Administrador global, leitor global, leitor de segurança, administrador de segurança ou administrador de IA
Microsoft Defender Administrador global, leitor global, leitor de segurança, administrador de segurança ou administrador de IA
Microsoft Purview — Alertas IRM Analista de IRM ou Investigador de IRM. O Administrador Global sozinho é insuficiente; um Administrador Global pode atribuir a si mesmo a função IRM adicional.

Bloco de agentes em risco

O bloco Agentes em risco na página Todos os agentes exibe o número total de agentes no locatário que têm um ou mais sinais de risco. Selecionar o bloco abre uma exibição pré-filtrada mostrando apenas agentes com sinais de risco detectados, para que você possa priorizar a investigação e a correção.

Captura de tela do bloco Agentes em risco na página Todos os agentes mostrando a contagem total de agentes com sinais de risco.

Agents at risk card na página Visão geral

O card Agents at risk na página Visão geral do Centro de administração do Microsoft 365 lista os três agentes com as maiores contagens de risco agregado nas plataformas de segurança da Microsoft e nas plataformas de terceiros conectadas.

Captura de tela do card Agents at risk no Centro de administração do Microsoft 365 Página de visão geral listando os três principais agentes com maior risco.

Selecione Exibir agentes para abrir oRegistrode Todos os agentes>, onde a lista é filtrada e classificada por nível de risco para que você possa priorizar a investigação e a correção.

Carregar agente personalizado

O Registro do agente no Centro de administração do Microsoft 365 fornece um método para carregar um agente personalizado, para que você possa gerenciar esses agentes para sua organização.

Observação

Você também pode atualizar um agente existente na Loja de agentes. Para obter mais informações, consulte Exibir detalhes do agente.

Para carregar um agente, o agente deve estar contido em um arquivo de pacote ZIP. O arquivo ZIP contém recursos, como arquivos de manifesto, arquivos de configuração, ícones, identidade visual e arquivos de conhecimento incorporado.

Observação

Você pode baixar o arquivo ZIP do agente no Copilot Studio ou no Agent Builder no Copilot.

Para baixar o arquivo ZIP do agente do Copilot Studio, selecione Agentes>, o nome dos canais do agente>. Selecione o canal que você usa para publicar, como Teams e Microsoft Copilot. Selecionar Opções>de disponibilidade Baixar .zip.

Para baixar o arquivo ZIP do agente declarativo do Construtor de Agentes no Copilot, selecione Todos os agentes>,selecione as reticências ao lado do seu agente>Editar>selecione as reticências à direita>Baixar .zip arquivo.

Para carregar um agente como um arquivo de pacote ZIP no Centro de administração do Microsoft 365:

  1. No Centro de administração do Microsoft 365, selecione Agentes>Todos os agentes>Adicionar agente.

  2. Selecione Escolher arquivo para localizar e selecione o arquivo ZIP do agente. O arquivo ZIP é validado. Em seguida, selecione Avançar.

  3. Verifique o nome, o ícone e os produtos host do agente.

  4. Em Publicar, selecione os usuários ou grupos que podem instalar o agente.

    Captura de tela de Publicar para os usuários durante o upload do agente ZIP no Centro de administração do Microsoft 365.

  5. Em Implantar (opcional), selecione os usuários ou grupos que terão o agente pré-instalado. Em seguida, selecione Avançar.

    Observação

    Você pode selecionar um pequeno público para fins de teste. Por exemplo, selecione Apenas eu ou um único grupo de teste para restringir a disponibilidade do agente.

  6. Escolha aplicar um modelo de política existente, uma política personalizada ou a política padrão. Para obter mais informações sobre modelos de política existentes, consulte Modelos de segurança. Os usuários do Agent 365 podem aplicar políticas e proteções personalizadas selecionadas. As políticas e proteções padrão são gerenciadas por meio de sua plataforma de segurança. Confira o status de cada um na plataforma. Observe que as políticas e proteções podem não estar habilitadas. Em seguida, selecione Avançar.

    Captura de tela de 'Aplicar modelo de segurança' durante o upload do agente ZIP no Centro de administração do Microsoft 365.

  7. Examinar permissões do agente. Em seguida, selecione Avançar.

  8. Revisão e finalizado. Selecione Concluir implantação.

    Observação

    Se o locatário usar o agente unificado e o gerenciamento de aplicativos, todas as alterações nas configurações de locatário em toda a organização no Centro de administração do Microsoft 365 (MAC) serão sincronizadas automaticamente no Centro de administração do Teams (TAC) e vice-versa. Para obter mais informações, consulte Gerenciamento unificado de agentes e aplicativos.

Gerenciar agentes fixados

Como administrador, você pode optar por fixar um agente implantado na lista de Agentes no Microsoft Copilot. Ao fixar agentes no Microsoft Copilot, você pode garantir que esses agentes fiquem visíveis e acessíveis para todos os membros da sua organização ou apenas para usuários ou grupos específicos. Você pode optar por fixar e desafixar agentes. Além disso, você pode classificar a lista de agentes fixados.

O Microsoft Copilot inclui agentes fixados pela Microsoft, administradores e usuários. Os agentes fixados pela Microsoft são agentes específicos fixados por padrão para todos os usuários. Você pode fixar agentes para sua organização no Centro de administração do Microsoft 365. Além disso, usuários individuais podem fixar agentes em seus próprios Microsoft Copilot Chat ou Microsoft Copilot experiência.

Observação

Depois de fixar um agente, pode levar até seis horas para que os usuários finais vejam o agente fixado.

Esta seção explica como os administradores podem fixar, desafixar ou gerenciar agentes para todos ou grupos específicos usando o Centro de administração do Microsoft 365. Ele também aborda ações relacionadas, como classificar a lista de agentes fixados e editar o escopo de agentes fixados.

A fixação de agentes é um recurso que permite aos administradores pré-selecionar e fixar agentes para usuários finais usando o Microsoft Copilot. O administrador fixa o agente para garantir que ele apareça automaticamente na interface do Copilot do usuário final sem exigir nenhuma ação do usuário. O agente agora está prontamente acessível ao usuário na interface do Copilot.

Pré-requisitos

Para fixar agentes de forma que cada agente seja mais visível e acessível aos membros da sua organização, há pré-requisitos para seus usuários (membros da sua organização). Além disso, você deve ter permissões e funções específicas.

Para usuários finais – os membros da sua organização devem ter acesso ao seguinte:

  • Conta corporativa do Microsoft 365
  • Acesso a Microsoft Copilot Chat (por exemplo, via Teams, Web ou aplicativo Microsoft Copilot)
  • O agente a ser fixado deve ser detectável pelo membro da sua organização

Para administradores : você, como administrador, deve ter a seguinte função e acesso:

  • Administrador de IA
  • Acesso ao centro de administração do Microsoft 365
  • (Opcional) Acesso ao centro de administração do Power Platform (se você usar o pagamento conforme o uso para agentes)

Agentes fixados

Captura de tela de agentes no Microsoft Copilot.

Agentes fixados pela Microsoft

  • Esses agentes são agentes que a Microsoft fixa por padrão para todos os usuários.
  • Garante que agentes essenciais ou de alto valor, como os principais recursos do Copilot, estejam sempre visíveis.
  • Os usuários finais não podem desafixar esses agentes. Elas são fixadas na lista fixada.

Agentes fixados pelo administrador

  • Fixado pelo administrador da sua organização por meio do Centro de administração do Microsoft 365.
  • Pode ser fixado para:
    • Todos os usuários.
    • Grupos específicos.
    • Usuários específicos.
  • Os usuários finais geralmente não podem desafixar esses agentes. Elas são fixadas na lista fixada.

Agentes fixados pelo usuário

  • Fixado por usuários individuais em sua própria experiência Microsoft Copilot Chat.
  • Os usuários podem:
    • Agentes de fixação que eles usam com frequência.
    • Desafixe-os a qualquer momento.
  • Essa lista está totalmente sob o controle do usuário, exceto para agentes fixados pela Microsoft ou pelo administrador, que permanecem bloqueados.

Recursos

  • Os agentes fixados pelo administrador aparecem por padrão para os usuários finais, facilitando a descoberta e ajudando a destacar agentes novos ou importantes.
  • Os administradores podem exibir os agentes fixados pela Microsoft no Centro de administração do Microsoft 365.
  • Os administradores podem fixar até três agentes no Centro de administração do Microsoft 365 para usuários finais usando o Microsoft Copilot na organização.
  • Os administradores podem optar por fixar um agente para todos os usuários no locatário ou para usuários ou grupos específicos. Por exemplo:
    • Fixar o agente do Sales Coach somente para o departamento de vendas.
    • Fixar o agente de P&R de RH para todos os usuários.
  • O usuário final não pode desafixar os agentes fixados pelo administrador e pela Microsoft.

Fixar agentes

Você pode optar por fixar agentes usando as seguintes etapas:

  1. Na página Todos os agentes , selecione a reticência à direita para exibir um menu suspenso.

  2. Selecione Gerenciar agentes fixados. No painel Agentes fixados , são exibidas as listas de agentes fixados pela sua organização e agentes fixados pela Microsoft .

  3. Selecione Fixar agente para fixar um novo agente.

  4. No painel Selecione um agente para fixar , localize o agente que deseja fixar na lista de agentes. Você pode pesquisar na lista para encontrar um agente específico pelo nome. Você só pode fixar agentes implantados para alguns ou todos os usuários.

    Captura de tela da lista de seleção de agentes no Centro de administração do Microsoft 365.

  5. Ao encontrar o agente desejado, selecione-o e, em seguida, selecione Avançar.

  6. No painel Escolha quem terá este agente fixado , escolha o escopo do agente que você deseja fixar.

    • Todos os usuários para os quais o agente está implantado – Fixe o agente para todos os usuários para os quais o agente está implantado no locatário.

      Observação

      Se você não vir essa opção, o agente selecionado provavelmente não será implantado.

    • Usuários ou grupos específicos para os quais o agente está implantado - Fixar um ou mais grupos ou contas individuais.

    Captura de tela do painel de seleção de escopo para fixar agentes no Centro de administração do Microsoft 365.

  7. Se você selecionar Usuários ou grupos específicos para os quais o agente está implantado, selecione os usuários ou grupos específicos para fixar o agente.

    Captura de tela da lista de seleção de usuário e grupo para fixar um agente.

  8. Selecione Salvar.

  9. Depois de salvar a configuração, o sistema registra qual agente está fixado para o público-alvo selecionado.

    Captura de tela da lista de agentes fixados no Centro de administração do Microsoft 365.

Agentes que podem ser fixados

Só é possível fixar agentes implantados. Se o agente não estiver implantado, você verá um banner com uma mensagem para primeiro implantar o agente.

Captura de tela da mensagem que solicita que você implante o agente primeiro.

Se o agente estiver bloqueado, desbloqueie o agente antes de fixá-lo.

Captura de tela da mensagem que solicita que você desbloqueie o agente primeiro.

Classificar a lista de agentes fixados

  • O administrador tem três slots reservados para os agentes fixados para cada usuário.

  • O administrador pode usar os botões Mover para cima e Mover para baixo para reordenar a lista de agentes fixados por prioridade para controlar o que é mostrado ao usuário.

Desafixar um agente

Na lista de agentes fixados, encontre o agente que deseja desafixar e selecione Desafixar. Quando você remove o pin, o agente não está mais disponível na seção Fixado por sua organização .

Editar o escopo de fixação de um agente

Selecione o agente e escolha Editar usuários para modificar o escopo de usuários para os quais um agente está fixado.

Captura de tela da opção Editar usuários para fixar agentes no Centro de administração do Microsoft 365.

Ponto de entrada alternativo para fixação

Você também pode fixar um agente no painel de detalhes do agente. Selecione o alfinete do ícone do usuário. O ícone só será habilitado se o agente estiver implantado.

Captura de tela do painel de detalhes do agente no Centro de administração do Microsoft 365.

Personalizar o modo de exibição

A lista de agentes fornecida na página Todos os agentes pode ser personalizada. Você pode escolher quais colunas exibir.

Captura de tela do painel Personalizar exibição no Centro de administração do Microsoft 365.

API do Graph Microsoft Graph para Registro de Agente e Detalhes do Agente (versão prévia)

Você também pode acessar os dados do Registro do Agente programaticamente por meio de APIs do Microsoft Graph, o que lhe dá controle escalonável e programático sobre o gerenciamento de agentes. Usando os novos pontos de extremidade da API do Graph, agora em visualização, os administradores podem integrar as seguintes tarefas aos fluxos de trabalho existentes entre os agentes no Microsoft 365:

  • Automatize o gerenciamento de agentes em massa.
  • Simplifique a integração.
  • Integre a governança.

Além do gerenciamento manual de agentes orientado por UX, a API do Graph da Microsoft ajuda a acelerar o gerenciamento de agentes, manter a segurança e a conformidade e garantir que os agentes estejam disponíveis para os usuários certos no momento certo.

  • Obtenha todos os agentes em seu inventário - Usando a API de pacotes GET, os administradores podem recuperar uma lista abrangente de todos os agentes em seu locatário para atender às necessidades de conformidade e relatórios.

  • Obtenha detalhes de um agente específico em seu inventário - A API GET package details fornece metadados e detalhes avançados para qualquer agente, facilitando a auditoria, o gerenciamento e a otimização do gerenciamento de agentes.

A API funciona com a função de Administração de IA. Para obter mais informações, consulte Visão geral da API de Gerenciamento de Pacotes de Agente e Aplicativo (versão prévia).

O exemplo a seguir mostra como recuperar uma lista de todos os agentes em seu locatário usando o Microsoft Graph PowerShell.

Connect-MgGraph -Scopes 'CopilotPackages.Read.All'

$uri = "https://graph.microsoft.com/v1.0/copilot/admin/catalog/packages"
$agentCount = 0

do {
    $response = Invoke-MgGraphRequest -Method GET -Uri $uri
    $agentCount += @($response.value).Count
    $response.value | ForEach-Object { Write-Host $_.displayName }
    $uri = $response.'@odata.nextLink'
} while ($uri)

Write-Host "Total agents: $agentCount"

Exportar para o Excel para usuários e agentes

Você pode exportar a lista de agentes para um arquivo do Excel. Defina o escopo de exportação como Todos os agentes ou Agentes filtrados para análise e relatórios.

A exportação pode incluir detalhes do agente, como:

  • Nome
  • Status
  • Canal
  • Data de criação
  • Última modificação
  • Publisher
  • Tipo de editor
  • Versão
  • Proprietário
  • Descrição
  • Plataforma
  • Instruções

Dica

Existem mais de 30 itens diferentes para cada agente que podem ser incluídos na lista exportada.

Com essas informações, você pode gerenciar e revisar com eficiência os agentes compartilhados em sua organização, garantindo a conformidade e otimizando a alocação de recursos.

Exporte a lista de usuários ativos dos últimos 30 dias para um arquivo do Excel. Esse recurso é essencial para análise e relatórios detalhados.

O arquivo exportado inclui informações abrangentes sobre cada usuário ativo, como:

  • Nome UPN
  • Total de agentes usados
  • Total de sessões
  • Data da última atividade

Informações adicionais

Importante

Ferramentas que não são da Microsoft, incluindo servidores MCP de terceiros disponíveis em [nome do catálogo/registro/oferta] ("Ferramentas de Terceiros") são produtos que não são da Microsoft sob seu contrato que rege o uso do Produto Microsoft correspondente. Ao se conectar a uma Ferramenta de Terceiros, você o faz por sua conta e risco. Você é responsável por quaisquer termos e encargos associados ao uso de Ferramentas de Terceiros. A Microsoft não tem nenhuma responsabilidade perante você ou outras pessoas em relação ao uso de Ferramentas de Terceiros. Recomendamos que você analise e acompanhe cuidadosamente as Ferramentas de Terceiros adicionadas ao seu cliente MCP.

Algumas de suas informações e dados (como chaves de autenticação e conteúdo de prompt) podem ser passados para a Ferramenta de Terceiros ou seu cliente MCP pode receber dados da Ferramenta de Terceiros. Recomendamos analisar todos os dados compartilhados com ferramentas de terceiros e estar ciente das práticas de terceiros para retenção e localização de dados. É sua responsabilidade gerenciar se os dados fluirão para fora dos limites geográficos e de conformidade da sua organização e quaisquer implicações relacionadas.

As implementações de MCP são suscetíveis a riscos, como ataques, falhas em cascata e perda de supervisão humana. Você pode atenuar esses riscos verificando a segurança e a confiabilidade dos servidores MCP, seguindo as práticas recomendadas pela Microsoft e aspráticas recomendadas do setor, implementando mecanismos de aprovação e monitorando comportamentos em cascata.

Apenas para sua conveniência, a Microsoft oferece pontos de extremidade para facilitar as transmissões de dados de e para servidores MCP por meio de um gateway monitorado. Recomendamos revisar toda a documentação técnica que abrange sua configuração de todas as ferramentas de monitoramento habilitadas pela Microsoft. Esses pontos de extremidade não implicam e não devem ser interpretados como um endosso, atribuição ou propriedade de quaisquer ferramentas de terceiros. O licenciante correspondente, e não a Microsoft, disponibiliza os servidores MCP de terceiros para você. A Microsoft não tem nenhuma responsabilidade perante você ou outras pessoas em relação ao uso de servidores MCP de terceiros.