Inventario degli agenti in Microsoft Copilot Studio

L'inventario degli agenti di Copilot Studio offre agli amministratori IT e della sicurezza una panoramica centralizzata di tutti gli agenti creati in Copilot Studio o Generatore di agenti nel tenant. L'inventario copre sia agenti non pubblicati (bozza) che agenti pubblicati. Per ciascun agente, l'inventario mostra i metadati chiave, come chi ha creato l'agente, quando è stato pubblicato l'ultima volta, su quali canali è distribuito, come autentica gli utenti, le sue funzionalità e altro ancora. I dati dell'inventario vengono aggiornati automaticamente e le modifiche apportate a un agente di norma si riflettono entro 20 minuti.

Gli amministratori possono consumare i dati dell'inventario attraverso più metodi, tra cui l'interfaccia di amministrazione Power Platform, l'API di Power Platform e Azure Resource Graph. Per l'elenco completo dei metodi di accesso e dei ruoli richiesti, vedi 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 per tutti i tipi di risorse, consulta riferimento allo schema dell'inventario di Power Platform.

Proprietà agente

L'inventario elenca le seguenti proprietà per ciascun agente.

Proprietà principali

Proprietà dell'identità di Entra

Per saperne di più sui concetti di identità di Entra, vedi Registrazione delle app, identità degli agenti e autenticazione per Copilot Studio.

Proprietà di configurazione

Modalità di orchestrazione

Il campo properties.orchestration accetta i valori seguenti:

Modalità di autenticazione

Il campo properties.authentication accetta i valori seguenti:

Funzionalità dell'agente

Questa sezione elenca le capacità (strumenti e conoscenze) dell'agente. Attualmente, visualizza solo dati dettagliati sui connettori utilizzati dall'agente e una configurazione della conoscenza, come descritto nelle sezioni successive.

L'inventario ha un limite massimo di 200 risorse per ogni tipo per agente. Altre informazioni in Limitazioni note.

L'inventario rimuove automaticamente le risorse duplicate, come ad esempio un connettore Power Platform configurato due volte nello stesso agente con la medesima configurazione.

Proprietà connettore

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

Esempio

{
  "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 tracciati: l'inventario non include gli agenti creati con il runtime originale Power Virtual Agents V1. L'inventario traccia solo gli agenti V2 (Copilot Studio).
• Le proprietà di identità potrebbero non essere disponibili per tutti gli agenti: i campi entraAgentId e entraAgentBlueprintId sono popolati solo per gli agenti che sono stati sottoposti a provisioning con il modello più recente di identità di agente Entra. Gli agenti più vecchi potrebbero avere solo entraAppId e gli agenti del generatore di agenti Microsoft 365 Copilot non hanno nessuna di queste proprietà di identità.
• Conteggio delle capacità: l'inventario ha un limite massimo di 200 risorse di ciascun tipo per agente. Se un agente ha più di 200 risorse configurate di uno stesso tipo (ad esempio, connettori Power Platform), l'inventario mostra 200 scelte casualmente. Gli amministratori possono utilizzare il campo capabilitiesCounts per determinare quante risorse sono configurate in un agente per tipo.

Contenuto correlato

• Inventario Power Platform
• Riferimento schema inventario Power Platform
• API inventario Power Platform