Inventário do Microsoft Copilot Studio Agent

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 usando o Copilot Studio ou o Agent Builder no tenant. O inventário abrange tanto agentes não publicados (em rascunho) como publicados. Para cada agente, o inventário apresenta metadados chave, como quem criou o agente, quando foi publicado pela última vez, em que canais foi implementado, como autentica os utilizadores, as suas capacidades e mais. Os dados de inventário são atualizados automaticamente, e as alterações a um agente normalmente aparecem dentro de 20 minutos.

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

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

Propriedades do agente

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

Propriedades principais

Propriedades de identidade da Entra

Saiba mais sobre Identidades de Agentes e autenticação no Copilot Studio.

Propriedades de configuração

Modos de orquestração

O properties.orchestration campo aceita os seguintes valores:

Modos de autenticação

O properties.authentication campo aceita os seguintes valores:

Recursos do agente

Esta secção lista as capacidades (ferramentas e conhecimento) do agente. Atualmente, apenas apresenta dados detalhados sobre conectores usados 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 Power Platform que configurou duas vezes num agente com a mesma configuração.

Propriedades do conector

O inventário inclui um array chamado powerPlatformConnectors, que contém os conectores Power Platform configurados num agente. Cada conector é identificado pelo seu connectorId (uma string contendo o ID de recurso do conector; por exemplo, shared_excelonlinebusiness). Para cada conector configurado, há uma lista de operations configurados. A lista inclui as seguintes propriedades:

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 do conhecimento:

Limitações conhecidas

• Os agentes V1 não são rastreados - O inventário não inclui agentes criados com o runtime original dos Power Virtual Agents V1. Só rastreia agentes da 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 do ID do Agente Entra, mais recente. Os agentes mais antigos podem ter apenas entraAppId, e os agentes do Agent Builder do Microsoft 365 Copilot não têm nenhuma destas propriedades de identidade.
• Número de capacidades - O inventário tem uma limitação máxima 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 Power Platform), o inventário mostra 200 aleatórios. Os administradores podem usar o capabilitiesCounts campo para perceber quantos recursos estão configurados num agente por tipo.

Conteúdo relacionado

• Inventário da Power Platform
• Referência do esquema de inventário Power Platform
• API de inventário da Power Platform