Observação
O acesso a essa página exige autorização. Você pode tentar entrar ou alterar diretórios.
O acesso a essa página exige autorização. Você pode tentar alterar os diretórios.
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. Para obter uma visão geral do recurso de inventário, consulte o inventário do Power Platform.
Propriedades principais
| Caminho do campo de API | Tipo de dados | Description | Example | Status |
|---|---|---|---|---|
properties.ownerId |
cadeia | O identificador do objeto do proprietário do recurso. | aaaa0000-bb11-2222-33cc-444444dddddd |
Disponível para o público geral |
properties.environmentId |
cadeia | O identificador do ambiente 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 se o agente ainda estiver no estado de 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 |
booleano | Se o agente está em quarentena. | 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 |
booleano | Se o agente faz parte de uma solução gerenciada. | false |
Preview |
Propriedades de identidade
| Caminho do campo de API | Tipo de dados | Description | Example | Status | Disponível para |
|---|---|---|---|---|---|
properties.botId |
cadeia | O ID do bot do CDS no ambiente. | aaaa0000-bb11-2222-33cc-444444dddddd |
Disponível para o público geral | Agentes do Copilot Studio, agentes do Construtor de Agentes do Microsoft 365 Copilot |
properties.entraAppId |
cadeia | A ID de Registro do Aplicativo Entra. | aaaa0000-bb11-2222-33cc-444444dddddd |
Disponível para o público geral | agentes do Copilot Studio |
properties.entraAgentId |
cadeia | O identificador de identidade do agente Entra. | aaaa0000-bb11-2222-33cc-444444dddddd |
Disponível para o público geral | agentes do Copilot Studio |
properties.entraAgentBlueprintId |
cadeia | O ID do Blueprint de Agente Entra. | aaaa0000-bb11-2222-33cc-444444dddddd |
Disponível para o público geral | agentes do Copilot Studio |
Note
O entraAppId campo é um identificador herdado. Os agentes mais recentes usam entraAgentId e entraAgentBlueprintId , em vez disso. Nenhuma dessas propriedades de identidade se aplica aos agentes do Construtor de Agentes do Microsoft 365 Copilot.
Propriedades de configuração
| Caminho do campo de API | Tipo de dados | Description | Example | Status |
|---|---|---|---|---|
properties.orchestration |
cadeia | O modo de orquestração do agente (consulte os 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 (consulte os 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 |
Modos de orquestração
Os valores a seguir são possíveis para o properties.orchestration campo.
| Value | Description |
|---|---|
Classic |
O agente usa orquestração clássica baseada em tópicos com árvores de diálogo criadas. |
Generative |
O agente usa orquestração generativa, em que um modelo de IA seleciona dinamicamente tópicos e ações. |
Modos de autenticação
Os valores a seguir são possíveis para o properties.authentication campo.
| Value | Description |
|---|---|
None |
Nenhuma autenticação é necessária. |
Microsoft Entra |
Autenticação por meio da ID do Microsoft Entra. |
Generic OAuth 2.0 |
Autenticação por meio de um provedor OAuth 2.0 genérico. |
Limitações conhecidas
- Agentes V1 não são rastreados. Os agentes criados com o runtime original do Power Virtual Agents V1 não estão incluídos no inventário. Apenas os agentes V2 (Copilot Studio) são rastreados.
- As propriedades de identidade podem não estar disponíveis para todos os agentes. Os campos
entraAgentIdeentraAgentBlueprintIdsão preenchidos apenas para agentes que foram provisionados com o mais recente modelo de identidade do agente Entra. Agentes mais antigos podem ter apenasentraAppId, e os agentes do Construtor de Agentes Copilot do Microsoft 365 não têm nenhuma dessas propriedades de identidade.