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.

Proprietà dell'agente

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

Proprietà principali

Proprietà dell'identità Entra

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

Modalità di orchestrazione

Il properties.orchestration campo accetta i valori seguenti:

Modalità di autenticazione

Il properties.authentication campo accetta i valori seguenti:

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:

Example

{
  "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
    }
  }
}

Proprietà della conoscenza

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

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

• Inventario di Power Platform
• Informazioni di riferimento sullo schema di inventario di Power Platform
• API di inventario di Power Platform