Schema di inventario degli agenti di Copilot Studio

Questo articolo descrive i campi specifici per gli agenti di Copilot Studio (microsoft.copilotstudio/agents) nell'inventario di Power Platform. Per i campi condivisi disponibili in tutti i tipi di risorse, vedere Informazioni di riferimento sullo schema di inventario di Power Platform. Per una panoramica della funzionalità di inventario, vedere Inventario di Power Platform.

Proprietà principali

Percorso del campo API Tipo di dati Description Example stato
properties.ownerId corda ID dell'oggetto del proprietario della risorsa. aaaa0000-bb11-2222-33cc-444444dddddd Generalmente disponibile
properties.environmentId corda Identificatore dell'ambiente che contiene la risorsa. aaaa0000-bb11-2222-33cc-444444dddddd Generalmente disponibile
properties.lastPublishedAt datetime Data e ora dell'ultima pubblicazione dell'agente. Vuoto se l'agente è ancora in bozza. 2026-01-15T10:30:00Z Generalmente disponibile
properties.createdIn corda Strumento di creazione in cui è stato creato l'agente: Copilot Studio o Microsoft 365 Copilot Agent Builder. Copilot Studio Generalmente disponibile
properties.schemaName corda Nome dello schema Dataverse. Disponibile per gli agenti di Copilot Studio e gli agenti di Copilot Agent Builder di Microsoft 365. cr5e3_agentName Generalmente disponibile
properties.isQuarantined booleano Indica se l'agente è in quarantena. false Anteprima
properties.quarantinedAt datetime Data e ora dell'ultima quarantena dell'agente. 2026-02-01T08:00:00Z Anteprima
properties.isManaged booleano Indica se l'agente fa parte di una soluzione gestita. false Anteprima

Proprietà dell'identità

Percorso del campo API Tipo di dati Description Example stato Disponibile per
properties.botId corda L'ID del bot CDS nell'ambiente. aaaa0000-bb11-2222-33cc-444444dddddd Generalmente disponibile Agenti di Copilot Studio, agenti di Microsoft 365 Copilot Agent Builder
properties.entraAppId corda ID registrazione app Entra. aaaa0000-bb11-2222-33cc-444444dddddd Generalmente disponibile agenti di Copilot Studio
properties.entraAgentId corda ID identificativo dell'agente Entra. aaaa0000-bb11-2222-33cc-444444dddddd Generalmente disponibile agenti di Copilot Studio
properties.entraAgentBlueprintId corda ID progetto Agente Entra. aaaa0000-bb11-2222-33cc-444444dddddd Generalmente disponibile agenti di Copilot Studio

Note

Il entraAppId campo è un identificatore legacy. Gli agenti più recenti usano entraAgentId e entraAgentBlueprintId . Nessuna di queste proprietà di identità si applica agli agenti di Microsoft 365 Copilot Agent Builder.

Proprietà di configurazione

Percorso del campo API Tipo di dati Description Example stato
properties.orchestration corda Modalità di orchestrazione dell'agente (vedere Modalità di orchestrazione). Generative Anteprima
properties.model corda Modello di intelligenza artificiale usato dall'agente. gpt-4o Anteprima
properties.authentication corda La modalità di autenticazione configurata per l'agente (vedere Modalità di autenticazione). Microsoft Entra Anteprima
properties.channels array I nomi dei canali visualizzati su cui viene pubblicato l'agente. ["Teams","SharePoint"] Anteprima

Modalità di orchestrazione

Per il campo sono possibili i properties.orchestration valori seguenti.

Valore Description
Classic L'agente usa l'orchestrazione classica basata su temi con alberi di dialogo predefiniti.
Generative L'agente usa l'orchestrazione generativa, in cui un modello di intelligenza artificiale seleziona in modo dinamico argomenti e azioni.

Modalità di autenticazione

Per il campo sono possibili i properties.authentication valori seguenti.

Valore Description
None Nessuna autenticazione necessaria.
Microsoft Entra Autenticazione tramite Microsoft Entra ID.
Generic OAuth 2.0 Autenticazione tramite un provider OAuth 2.0 generico.

Limitazioni note

  • Gli agenti V1 non vengono rilevati. Gli agenti creati con il runtime originale di Power Virtual Agents V1 non sono inclusi nell'inventario. Vengono tracciati solo gli agenti V2 (Copilot Studio).
  • Le proprietà identity potrebbero non essere disponibili per tutti gli agenti. I campi entraAgentId e entraAgentBlueprintId vengono popolati solo per gli agenti per i quali è stato eseguito il provisioning con il più recente modello di identità dell'agente Entra. Gli agenti meno recenti possono avere solo entraAppId, e gli agenti del Generatore di Agenti Copilot di Microsoft 365 non dispongono di nessuna di queste proprietà di identità.