Monitora gli agenti utilizzando l'Inventario Agenti nel Copilot Agent Kit

La funzionalità Inventario degli agenti offre agli amministratori una visibilità estesa all’intero tenant su tutti gli agenti personalizzati e gli agenti dichiarativi di Copilot Studio presenti nell’organizzazione, in tutti gli ambienti. I dati dell'Inventory degli Agenti includono metadati sul ciclo di vita e sulla proprietà, segnali di configurazione e adozione delle capacità, indicatori di governance e metriche di utilizzo.

Note

Questo articolo descrive l'attuale funzionalità di inventario degli agenti. L'esperienza precedente è documentata nel repository Copilot Agent Kit su GitHub nel file AGENT_INVENTORY_V1.md.

Dashboard

La dashboard dell'Inventario Agenti ti offre un riepilogo a livello di tenant e una navigazione approfondita nell'inventario. Seleziona una tessella, un grafico o un elemento di lista per aprire una vista filtrata nella griglia dell'agente.

Contesto dell'inventario

La riga di stato in alto nella dashboard mostra lo stato attuale dell'inventario:

Se l'inventario è aggiornato, vuoto o se è in corso una sincronizzazione.
La percentuale di record arricchiti con configurazioni dettagliate.
Il numero di agenti con dettagli limitati.
Il numero di ambienti sincronizzati.
L'ultimo tempo di sincronizzazione riuscito, quando disponibile.

Metriche del portafoglio

Le tessere metriche ti aiutano ad entrare direttamente in segmenti importanti dell'inventario:

Numero di agenti
Alimentato da
Agenti autonomi
Bozza agenti
Agenti con conoscenza

Seleziona una casella per aprire la griglia degli agenti filtrata su quel segmento. Il riquadro Basato su raggruppa gli agenti in categorie quali Standard, GitHub Copilot e Copilot Chat.

Analisi e governance

La dashboard include anche grafici e liste che ti aiutano a individuare schemi e rischi:

Crescita del portafoglio con intervalli a sei e dodici mesi.
Distribuzione di autenticazione .
Priorità di governance che richiedono una revisione da parte degli amministratori.
Distribuzione per stato del portafoglio.
Adozione delle capacità negli agenti arricchiti.
I migliori ambienti classificati in base al numero di agenti.
Agenti da monitorare per i documenti che richiedono attenzione.

Le percentuali dipendono dagli ambienti per cui le identità di connessione configurate possono recuperare i dati dell'agente e la configurazione dettagliata. Scopri di più sulle modalità di raccolta dati.

Sfoglia tutti gli agenti

Seleziona Visualizza l'inventario completo dalla dashboard per aprire la griglia dell'agente. Usa la griglia per trovare, raggruppare ed esportare i dati dell'inventario.

Puoi filtrare, ordinare e raggruppare per qualsiasi colonna, aggiungere o rimuovere colonne per adattare la griglia alle tue esigenze ed esportare la vista corrente in Excel.

Dettagli dell'agente

Seleziona il nome di un agente dalla griglia per aprire i dettagli dell'agente. L'intestazione mostra l'identità dell'agente, il contesto dell'ambiente, lo stato del ciclo di vita, la proprietà e le azioni disponibili. Un banner informativo indica se il record ha un arricchimento completo Dataverse o solo dettagli di configurazione limitati.

Scheda Panoramica

La scheda Panoramica mostra il riassunto dell'agente e le informazioni sull'ambiente, la postura di governance e i segnali, e un'istantanea dell'utilizzo quando esiste la cronologia dell'uso. Se le descrizioni generate dall'IA sono abilitate e l'agente è un GitHub agente Copilot idoneo, viene mostrata anche una descrizione generata dall'IA.

Scheda dei componenti

La scheda Componenti appare solo quando i dati dei componenti sono disponibili per l'agente. Usa questa scheda per esplorare l'architettura degli agenti nella vista mappa dei componenti , sfogliare i contenuti categorizzati nella vista gruppo dei componenti , espandere un gruppo di componenti popolati alla volta, attivare la modalità Raw per ispezionare il JSON o copiare il JSON dei componenti per indagine o supporto.

Scheda Utilizzo

La scheda Utilizzo appare solo quando esistono record di utilizzo per l'agente. Comprende:

Intervalli del mese corrente fino a oggi, dei due mesi di calendario precedenti, degli ultimi tre mesi e degli ultimi sei mesi. Gli ultimi sei mesi sono selezionati di default.
Crediti totali Copilot e crediti media per settimana attiva.
Utenti segnalati e funzione di utilizzo principale.
Tendenze settimanali del credito.
Panoramica dell'utilizzo, crediti per funzionalità e canale e dati recenti sull'utilizzo.
Un'esportazione Excel specifica per agente.

Scheda Metadati

La scheda Metadati è sempre disponibile. Utilizzalo per ispezionare valori tecnici come l'ID dell'agente e il nome dello schema, l'ID e l'URL dell'ambiente, gli identificatori di posizione e sorgente, e i campi grezzi dell'inventario utilizzati per diagnostica e integrazione.

Sincronizzare o aggiornare i dati dell'inventario

Agent Inventory separa la sincronizzazione dal refresh della dashboard.

Agenti di sincronizzazione

Seleziona Sincronizza agenti quando devi raccogliere nuovamente l'inventario del tenant. La sincronizzazione segue i filtri, i gruppi di ambienti, la modalità di raccolta dati, l'impostazione di utilizzo e la pianificazione salvati in Configura l'inventario dell'agente.

Mentre è in esecuzione una sincronizzazione:

Lo stato dell'inventario cambia in Sync in corso.
Gli agenti di sincronizzazione sono disabilitati per prevenire operazioni duplicate.
Le impostazioni che potrebbero modificare la configurazione attiva della sincronizzazione non sono disponibili.
La dashboard ricarica i dettagli dell'agente, la cronologia di utilizzo, lo stato della sincronizzazione e le informazioni sull'ultima sincronizzazione dopo che la sincronizzazione si è stabilizzata.

Aggiorna i dati della dashboard

Seleziona Aggiorna i dati del cruscotto per ricaricare i dati già memorizzati nelle tabelle Dettagli dell'Agente e Cronologia Utilizzo dell'Agente . Refresh non avvia una sincronizzazione agenti e non riscopre ambienti o agenti. Usalo al termine di una sincronizzazione o quando la dashboard mostra dati memorizzati nella cache non aggiornati.

Importante

La sincronizzazione degli agenti non utilizza i crediti Copilot. I crediti vengono utilizzati solo quando le descrizioni generate dall'IA sono abilitate e viene visitata una pagina dettaglio di GitHub agente Copilot idonea.

Azioni di governance

Inventario agenti supporta le azioni Riassegnazione, Quarantena e Rimozione dalla quarantena. Le azioni appaiono solo quando ogni agente selezionato è idoneo.

Disponibilità dell'azione

La colonna Stato nella griglia viene popolata durante l'ultima sincronizzazione dell'inventario e riflette il valore proveniente dal centro di amministrazione Power Platform (dati One Inventario). Le azioni mostrate dipendono da quanti record selezioni e dal loro stato.

Action	Regola di selezione	Nascosto quando
Riassegna	Uno o più record (fino a un massimo di 50) possono essere selezionati.	Nessun agente selezionato è idoneo per la riassegnazione.
Quarantena	Uno o più record in stato di Draft o Disponibile (fino a un massimo di 50) possono essere selezionati.	Qualsiasi agente selezionato è bloccato o non è idoneo per la quarantena.
Rimuovi dalla quarantena	Uno o più record in stato Bloccato (fino a un massimo di 50) possono essere selezionati.	Uno degli agenti selezionati è in stato di Bozza, Disponibile oppure non è idoneo alla rimozione dalla quarantena.

Se un record selezionato è incompatibile con un'operazione, quell'operazione viene nascosta dalla barra dei comandi. I record il cui contesto del centro di amministrazione Power Platform non corrisponde all'ambiente dell'inventario non ricevono azioni di governance non supportate.

Nella pagina dettagli dell'agente , la disponibilità in quarantena e non quarantena si basa sullo stato attivo dell'agente, piuttosto che sullo stato sincronizzato visualizzato nella griglia.

Riassegnare

Alcune organizzazioni richiedono agli agenti di avere proprietari per motivi di conformità. Il proprietario può modificare l'agente, pubblicare aggiornamenti, cancellarlo o condividerlo con i compagni di squadra secondo i loro permessi.

Seleziona Reassign e scegli un utente che possiede una licenza Microsoft 365 Copilot. Per la riassegnazione in massa, la finestra di dialogo mostra gli ambienti selezionati, gli agenti, i proprietari attuali e lo stato delle operazioni. Una volta completata la riassegnazione, lo stato della riassegnazione viene indicato come completato per ogni agente elaborato con successo.

Quarantena e dis-quarantena

La quarantena blocca un agente idoneo. Rimuovi dalla quarantena ripristina un agente bloccato idoneo. La finestra di dialogo di conferma identifica gli agenti, gli ambienti e gli stati interessati prima dell'invio di un'operazione.

Le azioni in blocco supportano fino a 50 agenti per operazione e sono disponibili solo quando ogni record selezionato è idoneo.

Configurare l'inventario degli agenti

Seleziona Impostazioni dall'intestazione del cruscotto per aprire la configurazione di sincronizzazione Agente. Usalo per controllare quali ambienti e tipi di agenti vengono raccolti, regolare le opzioni dell'inventario e impostare il programma di sincronizzazione e la modalità di raccolta.

Note

Queste impostazioni in-app presumono che i riferimenti di connessione necessari alla soluzione siano già configurati. Scopri di più su come configurare i riferimenti di connessione in Configurare l'inventario degli agenti.

Tipo di ambiente

Scegli quali tipi di ambiente vengono scansionati:

Developer
Impostazione predefinita
Sandbox
Produzione
Trial
Teams

Se non selezioni un tipo di ambiente, il sistema include tutti i tipi di ambiente.

Tipi di agente

Scegli se l'inventario include:

Agenti personalizzati
Agenti dichiarativi

Se non selezioni un tipo di agente, l'inventario include tutti i tipi di agenti.

Gruppi di ambienti

I gruppi di ambienti forniscono ambiti di sincronizzazione riutilizzabili. In qualità di amministratore, puoi:

Crea e modifica un gruppo.
Seleziona gli ambienti membri utilizzando filtri per tipo di ambiente e regione.
Abilita o disabilita il gruppo.
Elimina un gruppo di cui non hai più bisogno.

Se non abiliti un gruppo, tutti gli ambienti consentiti dalle altre impostazioni sono inclusi.

Opzioni di inventario

Imposta le seguenti opzioni per controllare ciò che il sistema raccoglie durante la sincronizzazione:

Escludere gli agenti di sistema: Salta gli agenti di sistema forniti da Microsoft durante la sincronizzazione.
Abilita la descrizione generata dall'IA per gli agenti GitHub Copilot: Permette la generazione di descrizioni quando viene visitata la pagina dettagli di un agente idoneo.
Includere metriche di utilizzo: raccoglie la finestra di utilizzo di 180 giorni mantenuta durante la sincronizzazione.

Sincronizzazione del calendario e modalità di raccolta

Scegli come funziona la sincronizzazione e quale modalità di raccolta dati utilizzare:

One Inventory (centro amministrativo Power Platform): Combina l'inventario del centro amministrativo con i dati dell'ambiente per una scoperta più ampia e metadati più ricchi.
Standard (solo ambienti): Recupera l'inventario direttamente dagli ambienti accessibili.
Abilita la sincronizzazione automatica giornaliera: Esegue l'Inventory dell'Agente secondo il programma giornaliero configurato.

Selezionare Salva per applicare le modifiche. Il salvataggio viene disabilitato quando nessuna impostazione è cambiata, quando un salvataggio è in corso o quando le impostazioni non sono disponibili durante una sincronizzazione attiva.

Suggerimento

Usa Aggiorna i dati del dashboard dopo il completamento della sincronizzazione quando il dashboard deve ricaricare i dati esistenti delle tabelle. Usa gli agenti Sync solo quando la raccolta dell'inventario deve essere eseguita di nuovo. Mantieni i filtri per l'ambiente e per l'agente quanto più restrittivi possibile nei tenant molto grandi e disabilita la raccolta dei dati di utilizzo quando non sono necessarie analisi dell'utilizzo su 180 giorni.

Modalità di raccolta dati

L'impostazione della modalità raccolta dati determina come il sistema scopre e raccoglie i record degli agenti.

Modalità One Inventory (consigliata)

Quando imposti la modalità raccolta su One Inventory, Agent Inventory utilizza i dati One Inventary:

Recupera i dati degli agenti da One Inventory tramite il centro di amministrazione Power Platform.
Elenca gli ambienti utilizzando il riferimento alla connessione Copilot Agent Kit - Power Platform for Admins V2.
Combina i dati dell'agente One Inventory con la lista degli ambienti per costruire i dettagli dell'ambiente.
Per ogni ambiente, carica i dettagli degli agenti in Inventario agenti unendo gli agenti recuperati dall'ambiente con i corrispondenti dati di One Inventory.

Usa questa modalità quando hai bisogno di una scoperta più ampia dei tenant e di metadati più ricchi del centro di amministrazione Power Platform. Gli agenti scoperti tramite il centro amministrativo ma inaccessibili nel loro ambiente vengono comunque aggiunti con dettagli limitati.

Modalità Standard

Quando imposti la modalità di raccolta su Standard, Agent Inventory utilizza l'approccio standard di raccolta dati:

Elenca tutti gli ambienti utilizzando il riferimento di connessione (V1) del Copilot Agent Kit - Power Platform for Admins.
Recupera agenti per ogni ambiente.
Carica i dati degli agenti nell'Inventario degli agenti.

Usa questa modalità quando vuoi che la raccolta si basi solo su ambienti accessibili.

In entrambe le modalità, Agent Inventory utilizza il riferimento alla connessione Copilot Agent Kit - Dataverse per connettersi a ciascun ambiente e raccogliere informazioni dettagliate sugli agenti, inclusi metadati, utilizzo delle funzionalità e configurazione. Il sistema recupera informazioni dettagliate solo per ambienti in cui l'account configurato ha accesso amministratore di sistema.

Scopri di più sull'elenco completo dei connettori utilizzati nel kit nei requisiti dei connettori.

Metriche di utilizzo

Agent Inventory può conservare e visualizzare fino a 180 giorni di dati di utilizzo degli agenti. Per abilitare l'analisi dell'uso:

Assicurarsi che le connessioni necessarie alla soluzione siano configurate e consentite dalle politiche dati.
Apri la configurazione di sincronizzazione dell'agente.
Attiva Include le metriche di utilizzo.
Seleziona Salva.
Seleziona Sync agents, oppure aspetta la sincronizzazione automatica giornaliera.

I dati di utilizzo sono memorizzati nelle tabelle Dettagli e CronologiaUtilizzo dell'Agente . La scheda Utilizzo di un agente appare solo quando sono disponibili i record di storia d'uso corrispondenti.

Configura l'HTTP con la connessione Microsoft Entra ID

Le metriche di utilizzo si basano sull'HTTP con connettore Microsoft Entra ID (preautorizzato). I valori della connessione dipendono dal cloud in cui il tuo tenant è utilizzato. Usa l'URL della risorsa di base e l'URI della risorsa Microsoft Entra ID corrispondenti al tuo cloud quando crei la connessione.

Cloud	URL risorsa di base	Microsoft Entra ID Resource URI
Commerciale	`https://licensing.powerplatform.microsoft.com/`	`https://licensing.powerplatform.microsoft.com/`
GCC	`https://gov.licensing.powerplatform.microsoft.us/`	`https://gov.licensing.powerplatform.microsoft.us/`
GCC High	`https://high.licensing.powerplatform.microsoft.us/`	`https://high.licensing.powerplatform.microsoft.us/`

Permessi e requisiti per i connettori

I riferimenti alla connessione nella soluzione limitano e controllano la visibilità agli agenti. Per una visibilità completa a livello di tenant, configura i riferimenti di connessione con un account che abbia il ruolo di amministratore Power Platform . Per recuperare tutti i dettagli a livello di funzionalità, quell'account ha anche bisogno dell'accesso dell'amministratore di sistema agli ambienti rilevanti. È possibile usare altri account, ma la visibilità dell'inventario degli agenti è limitata agli ambienti in cui l'utente ha accesso amministratore di sistema.

L'Inventario degli agenti si basa sui seguenti connettori, che devono essere consentiti dai criteri per i dati applicati all'ambiente:

Microsoft Dataverse
Power Platform per gli amministratori
Power Platform per amministratori V2
HTTP con Microsoft Entra ID (autorizzato in precedenza)