inventario dell'agente Microsoft Copilot Studio

L'inventario dell'agente Copilot Studio fornisce agli amministratori IT e della sicurezza una visualizzazione centralizzata di tutti gli agenti creati usando Copilot Studio o Generatore agenti nel tenant. L'inventario copre sia gli agenti non pubblicati (bozza) che gli agenti pubblicati. Per ogni agente, l'inventario visualizza i metadati chiave, ad esempio chi ha creato l'agente, quando è stato pubblicato per l'ultima volta, i canali in cui viene distribuito, il modo in cui autentica gli utenti, le relative funzionalità e altro ancora. I dati di inventario vengono aggiornati automaticamente e le modifiche apportate a un agente vengono in genere visualizzate entro 20 minuti.

Gli amministratori possono usare i dati di inventario tramite più metodi, tra cui l'interfaccia di amministrazione di Power Platform, l'API Power Platform e Azure Resource Graph. Per l'elenco completo dei metodi di accesso e dei ruoli necessari, vedere Inventario di Power Platform.

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.

Annotazioni

L'inventario non include gli agenti creati con V1 di Copilot Studio (noti anche come bot classici o power virtual agents). Tuttavia, è comunque possibile passare all'interfaccia di amministrazione di Power Platform e selezionare Manage>Copilot Studio>Classic chatbot per visualizzare tali agenti.

Importante

Questo articolo contiene la documentazione sull'anteprima di Microsoft Copilot Studio ed è pertanto soggetto a modifiche.

Le funzionalità di anteprima non sono destinate all'uso in produzione e potrebbero avere funzionalità limitate. Queste funzionalità sono disponibili prima di una versione ufficiale in modo che sia possibile ottenere l'accesso iniziale e inviare commenti.

Se stai creando un agente destinato alla produzione, vedi Panoramica di Microsoft Copilot Studio.

Proprietà dell'agente

L'inventario fornisce le proprietà seguenti per ogni agente.

Annotazioni

  • L'inventario riflette la struttura della versione pubblicata di ogni agente. Se un agente ha modifiche non pubblicate (una bozza più recente), l'inventario non mostra tali modifiche fino a quando l'agente non viene pubblicato.

  • La configurazione di un agente influisce sui campi popolati. Alcune proprietà potrebbero dipendere null dalla modalità di configurazione dell'agente. Ad esempio, isManaged è null per gli agenti creati in Generatore agenti.

Proprietà principali

Percorso del campo API Tipo di dati Description Esempio Status
properties.displayName stringa Nome visualizzato dell'agente. Customer support agent Generalmente disponibile
properties.name Guid ID dell'agente nell'ambiente Dataverse specifico (ID bot CDS). aaaa0000-bb11-2222-33cc-444444dddddd Generalmente disponibile
properties.createdAt datetime Data e ora di creazione dell'agente. 2024-12-13T04:00:00Z Generalmente disponibile
properties.createdBy Guid Entra ID dell'utente che ha creato l'agente. aaaa0000-bb11-2222-33cc-444444dddddd Generalmente disponibile
properties.ownerId stringa L'ID oggetto (ID Entra) dell'attuale proprietario dell'agente. aaaa0000-bb11-2222-33cc-444444dddddd Generalmente disponibile
properties.environmentId stringa Identificatore dell'ambiente Power Platform che contiene la risorsa. aaaa0000-bb11-2222-33cc-444444dddddd Generalmente disponibile
properties.lastPublishedAt datetime Data e ora dell'ultima pubblicazione dell'agente. Vuoto/null se l'agente è ancora in bozza. 2026-01-15T10:30:00Z Generalmente disponibile
properties.createdIn stringa Strumento di creazione in cui è stato creato l'agente: Copilot Studio o Microsoft 365 Copilot Agent Builder. Copilot Studio Generalmente disponibile
properties.schemaName stringa 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 Boolean Indica se l'agente è attualmente in quarantena. false Anteprima
properties.quarantinedAt datetime Data e ora dell'ultima quarantena dell'agente. 2026-02-01T08:00:00Z Anteprima
properties.isManaged Boolean Indica se l'agente fa parte di una soluzione Dataverse gestita. Null per gli agenti creati in Agent Builder. false Anteprima

Proprietà dell'identità di Entra

Percorso del campo API Tipo di dati Description Esempio Status
properties.botId stringa L'ID del bot CDS nell'ambiente. aaaa0000-bb11-2222-33cc-444444dddddd Generalmente disponibile
properties.entraAppId stringa ID della registrazione dell'app Entra associata all'agente, se presente. aaaa0000-bb11-2222-33cc-444444dddddd Generalmente disponibile
properties.entraAgentId stringa ID identità agente Entra, se esistente. aaaa0000-bb11-2222-33cc-444444dddddd Generalmente disponibile
properties.entraAgentBlueprintId stringa ID blueprint agente Entra, se esistente. aaaa0000-bb11-2222-33cc-444444dddddd Generalmente disponibile

Annotazioni

Non tutte le proprietà di identità sono disponibili per tutti i tipi di agente: entraAppId è un identificatore legacy, gli agenti più recenti usano entraAgentId e entraAgentBlueprintId. Questi campi vengono popolati solo se applicabili all'agente specifico. Nessuna di queste proprietà di identità si applica agli agenti di Microsoft 365 Copilot Agent Builder.

Per altre informazioni sui concetti relativi alle identità di Entra, vedi Registrazione dell'app, identità dell'agente e autenticazione per Copilot Studio.

Proprietà di configurazione

Percorso del campo API Tipo di dati Description Esempio Status
properties.orchestration stringa Modalità di orchestrazione dell'agente (altre informazioni in Modalità di orchestrazione). Generative Anteprima
properties.model stringa Modello di intelligenza artificiale usato dall'agente. gpt-4o Anteprima
properties.authentication stringa La modalità di autenticazione configurata per l'agente (altre informazioni in Modalità di autenticazione). Microsoft Entra Anteprima
properties.channels array I nomi dei canali visualizzati su cui viene pubblicato l'agente. ["Teams","SharePoint"] Anteprima
properties.sharedWithViewers object Conteggio dei singoli utenti visualizzatore () e dei gruppi di visualizzatore (userCountgroupCount) con cui l'agente è condiviso. Se un creatore ha condiviso l'agente con l'intero tenant, entireTenant è impostato su true, anche se un amministratore non ha approvato la condivisione. "groupCount": 0, "userCount": 0, "entireTenant": false Anteprima
properties.sharedWithEditors object Conteggio dei singoli utenti dell'editor (userCount) e dei gruppi di editor (groupCount) con cui l'agente è condiviso. "groupCount": 0, "userCount": 0 Anteprima
properties.capabilitiesCounts object Conteggio totale distinto per ciascun tipo di funzionalità configurata "distinctPowerPlatformConnectorsOperations": 0, "distinctPowerPlatformConnectors": 0 Anteprima

Modalità di orchestrazione

Il properties.orchestration campo accetta i valori seguenti:

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

Modalità di autenticazione

Il properties.authentication campo accetta i valori seguenti:

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

Funzionalità dell'agente

Questa sezione elenca le funzionalità (strumenti e conoscenze) dell'agente. Attualmente visualizza solo dati dettagliati sui connettori usati dall'agente e una configurazione delle informazioni, come descritto nelle sezioni seguenti.

L'inventario ha una limitazione massima di 200 risorse di ogni tipo per agente. Per altre informazioni, vedere Limitazioni note.

L'inventario rimuove automaticamente le risorse duplicate, ad esempio un connettore Power Platform configurato due volte in un agente con la stessa configurazione.

Proprietà del connettore

L'inventario include una matrice denominata powerPlatformConnectors, che contiene i connettori di Power Platform configurati in un agente. Ogni connettore è identificato dal relativo connectorId (stringa contenente l'ID risorsa del connettore, shared_excelonlinebusinessad esempio ). Per ogni connettore configurato, è disponibile un elenco di elementi configurati operations. L'elenco include le proprietà seguenti:

Proprietà Tipo di dati Description Status
OperationId stringa ID dell'operazione specifica all'interno del connettore; Per esempio AddRowV2 Anteprima
createdBy Guid Utente che ha configurato l'operazione Anteprima
isEnabled Boolean Indica se l'operazione del connettore è attualmente abilitata Anteprima
usedAs stringa Modalità di utilizzo dell'operazione:
  • Tool se configurato come strumento generale
  • Topic Tool se configurato come strumento in un argomento specifico
  • Knowledge se il connettore è configurato come origine delle informazioni
 Anteprima
requiresEndUserConsent Boolean Indica se gli utenti finali devono fornire il consenso prima che l'agente possa usare l'operazione Anteprima
whenCanBeUsed stringa Quando l'operazione può essere richiamata:
  • Anytime se lo strumento è disponibile per l'agente senza limitazioni
  • ViaDirectReferenceOnly se l'agente usa lo strumento solo quando l'autore lo ha configurato in modo esplicito in argomenti specifici
  • Conditional se l'agente può usare lo strumento in base a una logica predefinita da parte dell'autore
 Anteprima
connectionProvider stringa Chi fornisce la connessione per l'operazione:
  • User se l'utente finale fornisce le credenziali in fase di esecuzione
  • Maker se il creatore imposta la connessione in fase di progettazione
 Anteprima
connectionIdSharedByMaker Guid ID connessione, valorizzato solo quando connectionProvider = Maker Anteprima

Proprietà della conoscenza

L'inventario include la seguente proprietà per le conoscenze:

Proprietà Tipo di dati Description Status
IsWebSearchEnabledForKnowledge Boolean True se l'agente può usare la ricerca Web come origine delle informazioni Anteprima

Limitazioni note

  • Gli agenti V1 non vengono rilevati: l'inventario non include gli agenti creati con il runtime originale di Power Virtual Agents V1. Tiene traccia solo degli agenti V2 (Copilot Studio).
  • Le proprietà dell'identità potrebbero non essere disponibili per tutti gli agenti - i campi entraAgentId e entraAgentBlueprintId vengono popolati solo per gli agenti per cui viene effettuato il provisioning con il nuovo modello di identità degli agenti Entra. Gli agenti meno recenti potrebbero avere solo entraAppId, e gli agenti di Microsoft 365 Copilot Agent Builder non dispongono di alcuna di queste proprietà di identità.
  • Numero di funzionalità - L'inventario ha un limite massimo di 200 risorse di ogni tipo per agente. Se un agente dispone di più di 200 risorse configurate da un tipo specifico (ad esempio, connettori Power Platform), l'inventario visualizza casualmente 200. Gli amministratori possono usare il capabilitiesCounts campo per comprendere il numero di risorse configurate in un agente per tipo.

Contenuti correlati

  • Last updated on