Inventário de agentes do Microsoft Copilot Studio

O inventário do agente Copilot Studio fornece aos administradores de TI e segurança uma exibição centralizada de todos os agentes criados usando Copilot Studio ou o Construtor de Agentes no locatário. O inventário abrange tanto os agentes não publicados (em rascunho) quanto os publicados. Para cada agente, o inventário exibe metadados de chave, como quem criou o agente, quando foi publicado pela última vez, em quais canais ele foi implantado, como autentica os usuários, seus recursos e muito mais. Os dados de inventário são atualizados automaticamente e as alterações em um agente normalmente aparecem dentro de 20 minutos.

Os administradores podem consumir os dados de inventário por meio de vários métodos, incluindo o centro de administração do Power Platform, a API do Power Platform e Azure Resource Graph. Para obter a lista completa de métodos de acesso e funções necessárias, consulte o inventário do Power Platform.

Este artigo descreve os campos específicos para agentes do Copilot Studio (microsoft.copilotstudio/agents) no inventário do Power Platform. Para campos compartilhados disponíveis em todos os tipos de recursos, consulte a referência de esquema de inventário do Power Platform.

Observação

O inventário não inclui agentes criados com v1 de Copilot Studio (também conhecidos como bots clássicos ou Agentes Virtuais do Power). No entanto, você ainda pode acessar o centro de administração do Power Platform e selecionar Manage>Copilot Studio>Classic chatbots para ver esses agentes.

Importante

Este artigo contém a documentação da versão preliminar do Microsoft Copilot Studio e está sujeito a alterações.

A versão prévia dos recursos não foi criada para uso em ambientes de produção e pode ter funcionalidade restrita. Esses recursos estão disponíveis antes de um lançamento oficial para que você possa obter acesso antecipado e fornecer comentários.

Se você estiver criando um agente pronto para produção, confira a visão geral do Microsoft Copilot Studio.

Propriedades do agente

O inventário fornece as seguintes propriedades para cada agente.

Observação

  • O inventário reflete a estrutura da versão publicada de cada agente. Se um agente tiver alterações não publicadas (um rascunho mais recente), o inventário não mostrará essas alterações até que o agente seja publicado.

  • A configuração de um agente afeta quais campos são preenchidos. Algumas propriedades podem depender null de como o agente é configurado. Por exemplo, isManaged é null para agentes criados no Construtor de Agentes.

Propriedades principais

Caminho do campo de API Tipo de dados Description Exemplo Status
properties.displayName cadeia O nome de exibição do agente. Customer support agent Disponível para o público geral
properties.name GUID O ID do agente no ambiente específico do Dataverse (ID do bot do CDS). aaaa0000-bb11-2222-33cc-444444dddddd Disponível para o público geral
properties.createdAt datetime Data e hora em que o agente foi criado. 2024-12-13T04:00:00Z Disponível para o público geral
properties.createdBy GUID Entra ID do usuário que criou o agente. aaaa0000-bb11-2222-33cc-444444dddddd Disponível para o público geral
properties.ownerId cadeia A ID do objeto (Entra ID) do atual proprietário do agente. aaaa0000-bb11-2222-33cc-444444dddddd Disponível para o público geral
properties.environmentId cadeia O identificador do ambiente do Power Platform que contém o recurso. aaaa0000-bb11-2222-33cc-444444dddddd Disponível para o público geral
properties.lastPublishedAt datetime A data e a hora em que o agente foi publicado pela última vez. Vazio/nulo se o agente ainda estiver em rascunho. 2026-01-15T10:30:00Z Disponível para o público geral
properties.createdIn cadeia A ferramenta de criação em que o agente foi criado: Copilot Studio ou Microsoft 365 Copilot Agent Builder. Copilot Studio Disponível para o público geral
properties.schemaName cadeia O nome do esquema do Dataverse. Disponível para agentes do Copilot Studio e agentes do Construtor de Agentes do Microsoft 365 Copilot. cr5e3_agentName Disponível para o público geral
properties.isQuarantined booliano Se o agente está em quarentena no momento. false Preview
properties.quarantinedAt datetime A data e a hora em que o agente foi colocado em quarentena pela última vez. 2026-02-01T08:00:00Z Preview
properties.isManaged booliano Se o agente faz parte de uma solução gerenciada do Dataverse. Nulo para agentes criados no Construtor de Agentes. false Preview

Propriedades de identidade do Entra

Caminho do campo de API Tipo de dados Description Exemplo Status
properties.botId cadeia A ID do bot do CDS no ambiente. aaaa0000-bb11-2222-33cc-444444dddddd Disponível para o público geral
properties.entraAppId cadeia ID de registro do aplicativo Entra associada ao agente, quando existir. aaaa0000-bb11-2222-33cc-444444dddddd Disponível para o público geral
properties.entraAgentId cadeia ID de Identidade do Agente do Entra, quando existir. aaaa0000-bb11-2222-33cc-444444dddddd Disponível para o público geral
properties.entraAgentBlueprintId cadeia ID do blueprint do Agente do Entra, quando existir. aaaa0000-bb11-2222-33cc-444444dddddd Disponível para o público geral

Observação

Nem todas as propriedades de identidade estão disponíveis para todos os tipos de agente: entraAppId é um identificador herdado, os agentes mais recentes usam entraAgentId e entraAgentBlueprintId. Esses campos são preenchidos somente quando aplicáveis ao agente específico. Nenhuma dessas propriedades de identidade se aplica aos agentes do Construtor de Agentes do Microsoft 365 Copilot.

Para saber mais sobre os conceitos de identidade no Entra, consulte Registro de aplicativo, identidades de agente e autenticação para o Copilot Studio.

Propriedades de configuração

Caminho do campo de API Tipo de dados Description Exemplo Status
properties.orchestration cadeia O modo de orquestração do agente (saiba mais em modos de orquestração). Generative Preview
properties.model cadeia O modelo de IA usado pelo agente. gpt-4o Preview
properties.authentication cadeia O modo de autenticação configurado para o agente (saiba mais em modos de autenticação). Microsoft Entra Preview
properties.channels matriz Os nomes de exibição dos canais em que o agente é publicado. ["Teams","SharePoint"] Preview
properties.sharedWithViewers objeto Número de usuários visualizadores individuais (userCount) e grupos de visualizadores (groupCount) com quem o agente é compartilhado. Se um criador compartilhou o agente com todo o locatário, entireTenant será definido como true, mesmo que um administrador não tenha aprovado o compartilhamento. "groupCount": 0, "userCount": 0, "entireTenant": false Preview
properties.sharedWithEditors objeto Contagem de usuários de editor individuais (userCount) e grupos de editores (groupCount) com os quais o agente é compartilhado. "groupCount": 0, "userCount": 0 Preview
properties.capabilitiesCounts objeto Contagem total distinta de cada tipo de recursos configurados "distinctPowerPlatformConnectorsOperations": 0, "distinctPowerPlatformConnectors": 0 Preview

Modos de orquestração

O properties.orchestration campo aceita os seguintes valores:

Valor Description
Classic O agente usa orquestração clássica baseada em tópicos com árvores de diálogo criadas.
Generativo O agente usa orquestração generativa, em que um modelo de IA seleciona dinamicamente tópicos e ações.

Modos de autenticação

O properties.authentication campo aceita os seguintes valores:

Valor Description
None Nenhuma autenticação é necessária.
Microsoft Entra Autenticação por meio da ID do Microsoft Entra.
OAuth 2.0 genérico Autenticação por meio de um provedor OAuth 2.0 genérico.

Capacidades do agente

Esta seção lista os recursos (ferramentas e conhecimento) do agente. Atualmente, ele exibe apenas dados detalhados sobre conectores usados pelo agente e uma configuração de conhecimento, conforme detalhado nas seções a seguir.

O inventário tem uma limitação de no máximo 200 recursos de cada tipo por agente. Saiba mais em Limitações conhecidas.

O inventário remove automaticamente recursos duplicados, como um conector do Power Platform que você configurou duas vezes em um agente com a mesma configuração.

Propriedades do conector

O inventário inclui uma matriz chamada powerPlatformConnectors, que contém os conectores do Power Platform configurados em um agente. Cada conector é identificado por ele connectorId (uma cadeia de caracteres que contém a ID do recurso do conector; por exemplo, shared_excelonlinebusiness). Para cada conector configurado, há uma lista de operations configuradas. A lista inclui as seguintes propriedades:

Property Tipo de dados Description Status
OperationId cadeia A ID da operação específica dentro do conector; por exemplo, AddRowV2 Preview
createdBy GUID O usuário que configurou a operação Preview
isEnabled booliano Se a operação do conector está habilitada no momento Preview
usedAs cadeia Como a operação é usada:
  • Tool se configurado como uma ferramenta geral
  • Topic Tool se configurado como uma ferramenta em um tópico específico
  • Knowledge se o conector estiver configurado como uma fonte de conhecimento
 Preview
requiresEndUserConsent booliano Se os usuários finais devem consentir antes que o agente possa usar a operação Preview
whenCanBeUsed cadeia Quando a operação pode ser invocada:
  • Anytime se a ferramenta estiver disponível para o agente sem limitações
  • ViaDirectReferenceOnly se o agente usa a ferramenta somente quando o criador a configurou explicitamente em tópicos específicos
  • Conditional se o agente puder usar a ferramenta de acordo com uma lógica predefinida pelo criador
 Preview
connectionProvider cadeia Quem fornece a conexão para a operação:
  • User se o usuário final fornecer credenciais em tempo de execução
  • Maker se o criador definir a conexão no momento da criação
 Preview
connectionIdSharedByMaker GUID ID de conexão, preenchida somente quando connectionProvider = Maker Preview

Propriedades de conhecimento

O inventário inclui a seguinte propriedade de conhecimento:

Property Tipo de dados Description Status
IsWebSearchEnabledForKnowledge booliano True se o agente puder usar a pesquisa na Web como uma fonte de conhecimento Preview

Limitações conhecidas

  • Agentes V1 não são rastreados – o inventário não inclui agentes criados com o runtime original do Power Virtual Agents V1. Ele rastreia apenas agentes V2 (Copilot Studio).
  • As propriedades de identidade podem não estar disponíveis para todos os agentes - Os campos entraAgentId e entraAgentBlueprintId são preenchidos apenas para agentes provisionados com o modelo mais recente de identidade de agente do Entra. Agentes mais antigos podem ter apenas entraAppId, e os agentes do Microsoft 365 Copilot Agent Builder não têm nenhuma dessas propriedades de identidade.
  • Contagem de recursos – o inventário tem uma limitação de no máximo 200 recursos de cada tipo por agente. Se um agente tiver mais de 200 recursos configurados de um tipo específico (por exemplo, conectores do Power Platform), o inventário exibirá 200 aleatórios. Os administradores podem usar o capabilitiesCounts campo para entender quantos recursos são configurados em um agente por tipo.

Conteúdo relacionado

  • Last updated on