Estoque de Agentes do Microsoft Copilot Studio

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

Os administradores podem acessar os dados do estoque por meio 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 necessárias, consulte Estoque do Power Platform.

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

Observação

O estoque não inclui agentes criados com a V1 do Copilot Studio (também conhecidos como bots clássicos ou Power Virtual Agents). No entanto, você ainda pode acessar o Centro de administração do Power Platform e selecionar Gerenciar>Copilot Studio>Chatbots clássicos 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 são disponibilizados antes de um lançamento oficial para que você possa ter acesso antecipado e fornecer comentários.

Se você estiver criando um agente preparado para produção, consulte Visão geral do Microsoft Copilot Studio.

Propriedades do agente

O inventário fornece as propriedades a seguir 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 estoque não exibirá essas alterações até que o agente seja publicado.

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

Propriedades básicas

Caminho do campo da API Tipo de dados Descrição Exemplo Status
properties.displayName string (cadeia de caracteres) O nome de exibição do agente. Customer support agent Geralmente disponível
properties.name GUID O ID do agente no ambiente específico do Dataverse (ID do bot do CDS). aaaa0000-bb11-2222-33cc-444444dddddd Geralmente disponível
properties.createdAt datetime A data e a hora em que o agente foi criado. 2024-12-13T04:00:00Z Geralmente disponível
properties.createdBy GUID ID do Entra do usuário que criou o agente. aaaa0000-bb11-2222-33cc-444444dddddd Geralmente disponível
properties.ownerId string (cadeia de caracteres) A ID do objeto (Entra ID) do atual proprietário do agente. aaaa0000-bb11-2222-33cc-444444dddddd Geralmente disponível
properties.environmentId string (cadeia de caracteres) 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/nulo se o agente ainda estiver no estado de rascunho. 2026-01-15T10:30:00Z Geralmente disponível
properties.createdIn string (cadeia de caracteres) A ferramenta de criação usada para criar o agente: Copilot Studio ou Construtor de Agentes do Microsoft 365 Copilot. Copilot Studio Geralmente disponível
properties.schemaName string (cadeia de caracteres) 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 (booliano) Se o agente está em quarentena atualmente. false Versão preliminar
properties.quarantinedAt datetime A data e a hora em que o agente ficou em quarentena pela última vez. 2026-02-01T08:00:00Z Versão preliminar
properties.isManaged boolean (booliano) Se o agente faz parte de uma solução gerenciada do Dataverse. Nulo para agentes criados no Construtor de Agentes. false Versão preliminar

Propriedades de identidade do Entra

Caminho do campo da API Tipo de dados Descrição Exemplo Status
properties.botId string (cadeia de caracteres) A ID do bot do CDS no ambiente. aaaa0000-bb11-2222-33cc-444444dddddd Geralmente disponível
properties.entraAppId string (cadeia de caracteres) ID de registro do aplicativo Entra associada ao agente, quando existir. aaaa0000-bb11-2222-33cc-444444dddddd Geralmente disponível
properties.entraAgentId string (cadeia de caracteres) ID da identidade do Agente do Entra, quando existir. aaaa0000-bb11-2222-33cc-444444dddddd Geralmente disponível
properties.entraAgentBlueprintId string (cadeia de caracteres) ID do blueprint do Agente do Entra, quando existir. aaaa0000-bb11-2222-33cc-444444dddddd Geralmente disponível

Observação

Nem todas as propriedades de identidade estão disponíveis para todos os tipos de agente: entraAppId é um identificador herdado. 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 do Entra, consulte Registro de aplicativos, identidades de agentes e autenticação para o Copilot Studio.

Propriedades de configuração

Caminho do campo da API Tipo de dados Descrição Exemplo Status
properties.orchestration string (cadeia de caracteres) O modo de orquestração do agente (saiba mais em Modos de orquestração). Generative Versão preliminar
properties.model string (cadeia de caracteres) O modelo de IA usado pelo agente. gpt-4o Versão preliminar
properties.authentication string (cadeia de caracteres) O modo de autenticação configurado para o agente (saiba mais em Modos de autenticação). Microsoft Entra Versão preliminar
properties.channels matriz Os nomes de exibição dos canais nos quais o agente é publicado. ["Teams","SharePoint"] Versão preliminar
properties.sharedWithViewers objeto Contagem 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 é definido como true, mesmo que um administrador não tenha aprovado o compartilhamento. "groupCount": 0, "userCount": 0, "entireTenant": false Versão preliminar
properties.sharedWithEditors objeto Contagem de usuários editores individuais (userCount) e grupos de editores (groupCount) com os quais o agente é compartilhado. "groupCount": 0, "userCount": 0 Versão preliminar
properties.capabilitiesCounts objeto Contagem total distinta de cada tipo de recursos configurados "distinctPowerPlatformConnectorsOperations": 0, "distinctPowerPlatformConnectors": 0 Versão preliminar

Modos de orquestração

O campo properties.orchestration aceita os seguintes valores:

Valor descrição
Clássico O agente usa orquestração clássica baseada em tópicos com árvores de diálogo criadas.
Generativa O agente usa orquestração generativa, na qual um modelo de IA seleciona dinamicamente tópicos e ações.

Modos de autenticação

O campo properties.authentication aceita os seguintes valores:

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

Recursos do agente

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

O estoque tem uma limitação de um máximo 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 você configurou duas vezes em um agente com a mesma configuração.

Propriedades do conector

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

Propriedade Tipo de dados Descrição Status
OperationId string (cadeia de caracteres) A ID da operação específica dentro do conector. Por exemplo, AddRowV2 Versão preliminar
createdBy GUID O usuário que configurou a operação Versão preliminar
isEnabled boolean (booliano) Se a operação do conector está habilitada no momento Versão preliminar
usedAs string (cadeia de caracteres) 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 fonte de conhecimento
 Versão preliminar
requiresEndUserConsent boolean (booliano) Se os usuários finais devem consentir antes que o agente possa usar a operação Versão preliminar
whenCanBeUsed string (cadeia de caracteres) 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
 Versão preliminar
connectionProvider string (cadeia de caracteres) Quem fornece a conexão para a operação:
  • User se o usuário final fornecer credenciais em runtime
  • Maker se o criador definir a conexão no momento da criação
 Versão preliminar
connectionIdSharedByMaker GUID ID da conexão, preenchida somente quando connectionProvider = Maker Versão preliminar
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 estoque inclui a seguinte propriedade de conhecimento:

Propriedade Tipo de dados Descrição Status
IsWebSearchEnabledForKnowledge boolean (booliano) Verdadeiro se o agente pode usar a pesquisa na Web como fonte de conhecimento Versão preliminar

Limitações conhecidas

  • Os agentes V1 não são rastreados – o estoque não inclui agentes criados com o runtime original dos Power Virtual Agents V1. Ele rastreia somente 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 somente para agentes provisionados com o modelo de identidade de agente do Entra mais recente. Agentes mais antigos podem ter apenas entraAppId, e os agentes do Construtor de Agentes do Microsoft 365 Copilot não têm nenhuma dessas propriedades de identidade.
  • Contagem de capacidade – o estoque 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 determinado tipo (por exemplo, conectores do Power Platform), o inventário exibirá 200 recursos aleatórios. Os administradores podem usar o campo capabilitiesCounts para entender quantos recursos estão configurados em um agente por tipo.

Conteúdo relacionado

  • Last updated on