Integrazione del Registro dell'agente per Copilot Studio

Gli agenti di Microsoft Copilot Studio vengono visualizzati automaticamente nel registro degli agenti quando vengono creati, offrendo visibilità centralizzata, governance e gestione all'interno del tenant. Gli amministratori usano il Registro di sistema degli agenti per individuare, monitorare e controllare gli agenti a livello di organizzazione.

Questo articolo illustra come gli agenti di Copilot Studio si integrano con il registro degli agenti e quali metadati sono visibili agli amministratori.

Registro dell'agente

Il Registro di sistema dell'agente è un inventario centralizzato di tutti gli agenti nel tenant Microsoft 365:

  • Singola fonte di verità: visualizzare tutti gli agenti tra piattaforme (Copilot Studio, pro-code, non Microsoft).
  • Visibilità a livello di tenant: gli amministratori vedono gli agenti di tutti gli ambienti e i team.
  • Controlli di governance: applicare criteri, autorizzazioni e azioni agli agenti.
  • Rilevamento della conformità: controlla i metadati, le autorizzazioni e l'utilizzo dell'agente.

È possibile accedere al Registro di sistema dell'agente tramite interfaccia di amministrazione di Microsoft 365 e quindi selezionare Agent 365.

Il Registro di sistema dell'agente è diverso dall'interfaccia di amministrazione di Power Platform in quanto offre visibilità a livello di tenant in tutte le piattaforme, mentre l'inventario di Power Platform mostra solo le app specifiche di Power Platform all'interno di un ambiente.

Come vengono visualizzati gli agenti Copilot Studio nel Registro di sistema

Copilot Studio agenti vengono registrati automaticamente quando vengono creati.

Tempi di registrazione

Evento Azione del Registro
Creare un agente in Copilot Studio Agent viene visualizzato immediatamente nel Registro di sistema
Aggiornare i metadati dell'agente Voce del Registro di sistema aggiornata automaticamente
Eliminare l'agente Voce del Registro di sistema rimossa automaticamente

Metadati visibili

Gli amministratori visualizzano le informazioni seguenti per ogni agente Copilot Studio.

Informazioni di base:

  • Nome e descrizione dell'agente
  • Informazioni editore (email del creatore, organizzazione)
  • Tipo di agente (basato su app Copilot Studio)
  • Data di creazione e ultima modifica
  • ID agente (identificatore univoco)
  • Connettori usati di Power Platform

Dettagli di configurazione:

  • Stato della distribuzione
  • Stato abilitato o disabilitato
  • Informazioni sulla versione (se applicabile)

Metadati di governance:

  • Stato di pre-approvazione tramite i criteri di Power Platform
  • Criteri di prevenzione della perdita dei dati applicati
  • Conformità avanzata dei criteri del connettore

Copilot Studio sincronizza automaticamente questi metadati. Nessun input manuale richiesto.

Registro degli agenti vs. catalogo di app di Power Platform

Copilot Studio agenti compaiono sia nel registro degli agenti che nel catalogo delle app di Power Platform, ma ciascuno ha scopi diversi.

Caratteristica / Funzionalità Registro dell'agente Catalogo app Power Platform
Scope A livello di tenant, tutte le piattaforme degli agenti Specifico per ambiente, solo Power Platform
Scopo Governance, visibilità, conformità Distribuzione, installazione, gestione dell'ambiente
Accedi interfaccia di amministrazione di Microsoft 365 Interfaccia di amministrazione di Power Platform
Gestito da Amministratori di tenant Amministratori dell'ambiente
Integrazione di Agent 365 Sì : osservabilità, governance, controlli No - Solo governance di Power Platform

Per gli sviluppatori, entrambi i registri mostrano gli agenti Copilot Studio, ma il registro dell'agente fornisce il livello di integrazione di Agent 365, comprendente osservabilità, controlli di governance e conformità.

Ciclo di vita della registrazione

Copilot Studio agenti seguono un ciclo di vita di registrazione automatica.

1. Creazione

Quando si crea un agente Copilot Studio:

  • Provisioning automatico dell'identità Entra (vedere integrazione dell'identità dell'agente)
  • L'agente viene visualizzato nel Registro di sistema entro pochi secondi
  • Metadati sincronizzati da Copilot Studio
  • Stato: attivo (approvato in modo preliminare tramite i criteri di Power Platform)

2. Aggiornamenti

Quando si modifica l'agente:

  • Modifiche ai metadati (nome, descrizione): Registro di sistema aggiornato automaticamente
  • Modifiche alle autorizzazioni (nuovi connettori): registro aggiornato, criteri DLP rivalutati
  • Modifiche alla configurazione: il Registro di sistema riflette lo stato corrente

Non è richiesta alcuna registrazione manuale.

3. Eliminazione

Quando si elimina un agente Copilot Studio:

  • Voce del Registro di sistema rimossa automaticamente
  • Entra identity eliminata
  • Tutti i metadati associati sono stati puliti
  • Dati di telemetria cronologici conservati (vedere Integrazione dell'osservabilità)

Attenzione

L'eliminazione è permanente e non può essere annullata.

Esperienza amministratore: visualizzazione degli agenti di Copilot Studio

Gli amministratori accedono al Registro di sistema dell'agente dal interfaccia di amministrazione di Microsoft 365. Passare a interfaccia di amministrazione di Microsoft 365>Agent 365>Agent registry.

Visualizzazioni disponibili:

  • Tutti gli agenti: vedere tutti gli agenti tra piattaforme
  • Filter per piattaforma: Mostra solo agenti Copilot Studio
  • Filtrare in base all'editore: mostra gli agenti di team o utenti specifici
  • Filtro in base allo stato: mostra agenti attivi, bloccati o riassegnati

Pagina dei dettagli dell'agente:

  • Visualizzare i metadati completi dell'agente
  • Vedere autorizzazioni e ambiti richiesti
  • Esaminare i dati di osservabilità (utilizzo, prestazioni, errori)
  • Applicare azioni di governance (blocco, riassegnazione, eliminazione)

Per indicazioni dettagliate di amministrazione, consultare:

Controlli di governance per gli agenti Copilot Studio

Gli amministratori possono applicare azioni di governance agli agenti di Copilot Studio tramite il registro degli agenti.

Blocco

Impedisce l'uso di un agente a livello di organizzazione:

  • L'agente rimane nel registro, ma diventa inattivo.
  • Gli utenti non possono richiamare o interagire con l'agente
  • L'autore dell'agente riceve una notifica
  • Può essere sbloccato in un secondo momento dagli amministratori

Riassegna

Trasferire la proprietà dell'agente a un utente o a un team diverso.

  • Il nuovo proprietario ottiene il controllo completo e i diritti di modifica
  • Il proprietario originale perde l'accesso
  • Metadati del Registro di sistema aggiornati con il nuovo server di pubblicazione
  • Utile per le transizioni dei team o le modifiche dell'organizzazione

Delete

Rimuove un agente dal Registro di sistema e dal tenant:

  • Agenti del generatore di agenti: i proprietari dell'agente possono eliminare tramite il Registro di sistema
  • Agenti creati all'interno di Copilot Studio richiedono autorizzazioni di amministratore dell'ambiente Power Platform.
  • Identità dell'agente eliminata da Entra ID
  • Voce del Registro di sistema rimossa
  • Tutte le configurazioni e i metadati eliminati
  • Dati di telemetria cronologici conservati per la conformità

Tutte le azioni di governance vengono registrate Microsoft Purview per il rilevamento della conformità.

Per altri dettagli sui controlli di governance, vedere Gestire gli agenti.

Accesso a livello di codice: API Graph

Gli amministratori possono accedere ai dati del Registro di sistema dell'agente a livello di codice usando Microsoft Graph API.

API disponibili:

  • Elencare tutti gli agenti: recuperare l'inventario completo per la conformità e la creazione di report
  • Ottenere i dettagli dell'agente: recuperare i metadati per un agente specifico per il controllo

Casi d'uso:

  • Gestione e automazione degli agenti in blocco
  • Integrazione con i flussi di lavoro di governance esistenti
  • Creazione di report e analisi personalizzati
  • Controllo e monitoraggio della conformità

Per i casi d'uso sono necessarie autorizzazioni di amministratore di intelligenza artificiale o ruolo amministratore globale.

Per informazioni dettagliate sull'API, vedere API Graph per i dettagli del Registro di sistema e dell'agente.

Considerazioni per gli sviluppatori

In qualità di sviluppatore Copilot Studio, tenere presenti questi punti di integrazione del Registro di sistema.

Qualità dei metadati:

  • Usare i nomi e le descrizioni degli agenti chiari e descrittivi (visibili agli amministratori)
  • Documentare l'utilizzo e le autorizzazioni del connettore nella descrizione dell'agente
  • Mantenere i metadati dell'agente up-to-date

Trasparenza delle autorizzazioni:

  • Gli amministratori visualizzano tutte le autorizzazioni richieste nel Registro di sistema
  • Aggiungere solo connettori necessari
  • Informazioni sui criteri di Power Platform che regolano l'utilizzo del connettore

Integrazione dell'osservabilità:

Consapevolezza della governance:

  • Gli agenti possono essere bloccati, riassegnati o eliminati dagli amministratori
  • Progettare agenti per gestire correttamente la disattivazione
  • Comunicare con gli amministratori sulle esigenze del connettore con privilegi elevati

Passaggi successivi

  • Last updated on