Inventário de Agentes do Microsoft Copilot Studio

O inventário de agentes do Copilot Studio oferece aos administradores de TI e segurança uma visão centralizada de todos os agentes criados utilizando o Copilot Studio ou o Construtor de Agentes no inquilino. O inventário abrange tanto agentes não publicados (rascunho) como publicados. Para cada agente, o inventário apresenta os principais metadados, como quem criou o agente, quando foi publicado pela última vez, em que canais foi implementado, como autentica os utilizadores, as suas capacidades, entre outros. Os dados do inventário são atualizados automaticamente, e as alterações feitas a um agente tipicamente aparecem em até 20 minutos.

Os administradores podem aceder aos dados do inventário através de vários métodos, incluindo o centro de administração do Power Platform, a API do Power Platform e o Azure Resource Graph. Para obter a lista completa de métodos de acesso e funções obrigatórias, consulte Inventário do Power Platform.

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

Nota

O inventário não inclui agentes criados com a V1 do Copilot Studio (também conhecidos como bots Clássicos ou Power Virtual Agents). No entanto, ainda pode ir ao centro de administração do Power Platform e selecionar Gerir>Copilot Studio>Chatbots clássicos para ver esses agentes.

Importante

Este artigo contém documentação de pré-visualização do Microsoft Copilot Studio e está sujeito a alterações.

As funcionalidades de pré-visualização não se destinam à produção e poderão ter caraterísticas restritas. Estas funcionalidades estão disponíveis antes de uma versão oficial para que possa aceder antecipadamente e enviar comentários.

Se está a criar um agente pronto para produção, consulte Descrição Geral do Microsoft Copilot Studio.

Propriedades do agente

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

Nota

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 mostra essas alterações até que o agente seja publicado.
A configuração de um agente afeta quais campos são preenchidos. Algumas propriedades podem assumir o valor null, dependendo de como o agente está configurado. Por exemplo, isManaged é null nos agentes criados com o Construtor de Agentes.

Propriedades principais

Caminho do campo da API	Tipo de dados	Description	Exemplo	Estado
`properties.displayName`	cadeia (de carateres)	O nome a apresentar do agente.	`Customer support agent`	Geralmente disponível
`properties.name`	GUID	O ID do agente no ambiente Dataverse específico (ID do bot CDS).	`aaaa0000-bb11-2222-33cc-444444dddddd`	Geralmente disponível
`properties.createdAt`	datetime	A data e hora em que o agente foi criado.	`2024-12-13T04:00:00Z`	Geralmente disponível
`properties.createdBy`	GUID	Entra ID do utilizador que criou o agente.	`aaaa0000-bb11-2222-33cc-444444dddddd`	Geralmente disponível
`properties.ownerId`	cadeia (de carateres)	O ID do objeto (Entra ID) do atual proprietário do agente.	`aaaa0000-bb11-2222-33cc-444444dddddd`	Geralmente disponível
`properties.environmentId`	cadeia (de carateres)	O identificador do ambiente do Power Platform que contém o recurso.	`aaaa0000-bb11-2222-33cc-444444dddddd`	Geralmente disponível
`properties.lastPublishedAt`	datetime	A data e a hora em que o agente foi publicado pela última vez. Vazio/null se o agente ainda estiver em rascunho.	`2026-01-15T10:30:00Z`	Geralmente disponível
`properties.createdIn`	cadeia (de carateres)	A ferramenta de criação na qual o agente foi criado: Copilot Studio ou Construtor de Agentes do Microsoft 365 Copilot.	`Copilot Studio`	Geralmente disponível
`properties.schemaName`	cadeia (de carateres)	O nome do esquema do Dataverse. Disponível para agentes do Copilot Studio e do Construtor de Agentes do Microsoft 365 Copilot.	`cr5e3_agentName`	Geralmente disponível
`properties.isQuarantined`	boolean	Indica se o agente está atualmente em quarentena.	`false`	Pré-visualização
`properties.quarantinedAt`	datetime	A data e a hora em que o agente foi colocado em quarentena pela última vez.	`2026-02-01T08:00:00Z`	Pré-visualização
`properties.isManaged`	boolean	Indica se o agente faz parte de uma solução gerida do Dataverse. Null para agentes criados no Construtor de Agentes.	`false`	Pré-visualização

Propriedades de identidade do Entra

Caminho do campo da API	Tipo de dados	Description	Exemplo	Estado
`properties.botId`	cadeia (de carateres)	O ID do bot CDS no ambiente.	`aaaa0000-bb11-2222-33cc-444444dddddd`	Geralmente disponível
`properties.entraAppId`	cadeia (de carateres)	ID de Registo da Aplicação Entra associado ao agente, quando existir.	`aaaa0000-bb11-2222-33cc-444444dddddd`	Geralmente disponível
`properties.entraAgentId`	cadeia (de carateres)	ID da Identidade do Agente Entra, quando existir.	`aaaa0000-bb11-2222-33cc-444444dddddd`	Geralmente disponível
`properties.entraAgentBlueprintId`	cadeia (de carateres)	ID do Esquema do Agente Entra, quando existir.	`aaaa0000-bb11-2222-33cc-444444dddddd`	Geralmente disponível

Nota

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

Para saber mais sobre os conceitos de identidade do Entra, consulte Registo de aplicações, identidades de agentes e autenticação para o Copilot Studio.

Propriedades de configuração

Caminho do campo da API	Tipo de dados	Description	Exemplo	Estado
`properties.orchestration`	cadeia (de carateres)	O modo de orquestração do agente (saiba mais em Modos de orquestração).	`Generative`	Pré-visualização
`properties.model`	cadeia (de carateres)	O modelo de IA utilizado pelo agente.	`gpt-4o`	Pré-visualização
`properties.authentication`	cadeia (de carateres)	O modo de autenticação configurado para o agente (saiba mais em Modos de autenticação).	`Microsoft Entra`	Pré-visualização
`properties.channels`	matriz	Os nomes a apresentar dos canais onde o agente é publicado.	`["Teams","SharePoint"]`	Pré-visualização
`properties.sharedWithViewers`	objeto	Contagem de utilizadores individuais de visualização (`userCount`) e grupos de visualizadores (`groupCount`) com os quais o agente é partilhado. Se um criador partilhou o agente com todo o inquilino, `entireTenant` é definido como `true`, mesmo que um administrador não tenha aprovado a partilha.	`"groupCount": 0, "userCount": 0, "entireTenant": false`	Pré-visualização
`properties.sharedWithEditors`	objeto	Contagem de utilizadores editores individuais (`userCount`) e grupos de editores (`groupCount`) com os quais o agente é partilhado.	`"groupCount": 0, "userCount": 0`	Pré-visualização
`properties.capabilitiesCounts`	objeto	Contagem total de valores exclusivos de cada tipo das capacidades configuradas	`"distinctPowerPlatformConnectorsOperations": 0, "distinctPowerPlatformConnectors": 0`	Pré-visualização

Modos de orquestração

O campo properties.orchestration aceita os seguintes valores:

valor	Descrição
Clássico	O agente utiliza a orquestração clássica baseada em tópicos com árvores de diálogo criadas.
Generativo	O agente utiliza a orquestração generativa, em que um modelo de IA seleciona dinamicamente tópicos e ações.

Modos de autenticação

O campo properties.authentication aceita os seguintes valores:

valor	Description
None	Não é necessária autenticação.
Microsoft Entra	Autenticação através do Microsoft Entra ID.
OAuth 2.0 genérico	Autenticação através de um fornecedor OAuth 2.0 genérico.

Capacidades do agente

Esta secção lista as capacidades (ferramentas e conhecimento) do agente. Atualmente, apenas apresenta dados detalhados sobre os conectores utilizados pelo agente e uma configuração de conhecimento conforme detalhado nas secções seguintes.

O inventário tem uma limitação máxima de 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 tenha sido configurado duas vezes num agente com a mesma configuração.

Propriedades dos conectores

O inventário inclui uma matriz chamada powerPlatformConnectors, que contém os conectores do Power Platform configurados num agente. Cada conector é identificado pelo seu connectorId (uma cadeia com o ID de recurso do conector; por exemplo, shared_excelonlinebusiness). Para cada conector configurado, existe uma lista de operations configuradas. A lista inclui as seguintes propriedades:

Propriedade	Tipo de dados	Description	Estado
`OperationId`	cadeia (de carateres)	O ID da operação específica no conector; por exemplo, `AddRowV2`	Pré-visualização
`createdBy`	GUID	O utilizador que configurou a operação	Pré-visualização
`isEnabled`	boolean	Se a operação do conector estiver atualmente ativada	Pré-visualização
`usedAs`	cadeia (de carateres)	Como a operação é utilizada: `Tool` se configurado como uma ferramenta geral `Topic Tool` se configurada como uma ferramenta num tópico específico `Knowledge` se o conector estiver configurado como fonte de conhecimento	Pré-visualização
`requiresEndUserConsent`	boolean	Se os utilizadores finais devem consentir antes de o agente poder utilizar a operação	Pré-visualização
`whenCanBeUsed`	cadeia (de carateres)	Quando a operação pode ser invocada: `Anytime` se a ferramenta estiver disponível para o agente sem limitações `ViaDirectReferenceOnly` se o agente utilizar a ferramenta apenas quando o criador a tiver configurado explicitamente em tópicos específicos `Conditional` se o agente puder utilizar a ferramenta de acordo com uma lógica predefinida pelo criador	Pré-visualização
`connectionProvider`	cadeia (de carateres)	Quem fornece a ligação para a operação: `User` se o utilizador final fornecer credenciais em runtime `Maker` se o criador definir a ligação no momento de criação	Pré-visualização
`connectionIdSharedByMaker`	GUID	ID de ligação, preenchido apenas quando `connectionProvider = Maker`	Pré-visualização

Exemplo

{
  "type": "microsoft.copilotstudio/agents",
  "properties": {
    "displayName": "Customer Support Agent",
    "createdIn": "Copilot Studio",
    "powerPlatformConnectors": [
      {
        "connectorId": "shared_excelonlinebusiness",
        "operations": [
          {
            "operationId": "RunScriptProd",
            "usedAs": "Tool",
            "isEnabled": true,
            "requiresEndUserConsent": false,
            "whenCanBeUsed": "ViaDirectReferenceOnly",
            "connectionProvider": "Maker",
            "connectionIdSharedByMaker": "11112222-3333-4444-5555-666677778888",
            "createdBy": "52bff06b-5db5-42cd-9919-28f95e3c07af"
          }
        ]
      }
    ],
    "capabilitiesCounts": {
      "distinctPowerPlatformConnectors": 2,
      "distinctPowerPlatformConnectorsOperations": 3
    }
  }
}

Propriedades do conhecimento

O inventário inclui a seguinte propriedade para conhecimento:

Propriedade	Tipo de dados	Description	Status
`IsWebSearchEnabledForKnowledge`	boolean	Verdadeiro se o agente puder utilizar a pesquisa na Web como fonte de conhecimento	Pré-visualização

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. O inventário 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 que estão aprovisionados com o modelo de identidade de agente do Entra, mais recente. Os agentes mais antigos podem ter apenas entraAppId, e os agentes do Construtor de Agentes do Microsoft 365 Copilot não têm nenhuma destas propriedades de identidade.
Contagem de capacidades – O inventário tem um limite máximo de 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 apresenta 200 recursos aleatórios. Os administradores podem utilizar o campo capabilitiesCounts para verificar quantos recursos estão configurados num agente por tipo.

Comentários

Esta página foi útil?

Last updated on 2026-07-30

Inventário de Agentes do Microsoft Copilot Studio

Propriedades do agente

Propriedades principais

Propriedades de identidade do Entra

Propriedades de configuração

Modos de orquestração

Modos de autenticação

Capacidades do agente

Propriedades dos conectores

Exemplo

Propriedades do conhecimento

Limitações conhecidas

Conteúdos relacionados

Comentários

Recursos adicionais