Integrazione del registro degli agenti con Copilot Studio

Gli agenti Microsoft Copilot Studio appaiono automaticamente nel registro degli agenti quando li crei offrendo visibilità centralizzata, governance e gestione su tutto il tuo tenant. Gli amministratori utilizzano il registro degli agenti per individuare, monitorare e controllare gli agenti nell'intera organizzazione.

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

Registro degli agenti

Il registro degli agenti è un inventario centralizzato di tutti gli agenti nel tuo tenant Microsoft 365:

  • Unica fonte attendibile: visualizza tutti gli agenti su tutte le piattaforme (Copilot Studio, a uso intensivo di codice, non Microsoft).
  • Visibilità a livello di tenant: gli amministratori vedono gli agenti di tutti gli ambienti e team.
  • Controlli di governance: applica criteri, permessi e azioni agli agenti.
  • Monitoraggio della conformità: controllo di agenti di audit, permessi e utilizzo.

Il registro degli agenti è accessibile tramite l'interfaccia di amministrazione di Microsoft 365, Agent 365.

Il registro degli agenti è diverso dall'interfaccia di amministrazione Power Platform in quanto fornisce visibilità a livello di tenant attraverso tutte le piattaforme, mentre l'inventario di Power Platform mostra solo le app specifiche per Power Platform all'interno di un ambiente.

Come vengono visualizzati gli agenti di Copilot Studio nel registro

Gli agenti Copilot Studio si registrano automaticamente quando li crei.

Tempo di registrazione

Evento Azione del registro
Creare un agente in Copilot Studio L'agente viene visualizzato immediatamente nel registro di sistema
Aggiornamento dei metadati dell'agente Voce del registro aggiornata automaticamente
Eliminare l'agente Voce del registro rimossa automaticamente

Metadati visibili

Gli amministratori visualizzano le seguenti informazioni per ciascun agente di Copilot Studio.

Informazioni di base:

  • Descrizione e nome dell'agente
  • Informazioni sull'editore (e-mail del creatore, organizzazione)
  • Tipo di agente (basato sull'app Copilot Studio)
  • Date di creazione e ultime modifiche
  • ID agente (identificatore univoco)
  • Connettori Power Platform utilizzati

Dettagli di configurazione:

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

Metadati di governance:

  • Stato di pre-approvazione secondo i criteri di Power Platform
  • Criteri di prevenzione della perdita dei dati
  • Conformità ai criteri dei connettori avanzati

Copilot Studio sincronizza automaticamente questi metadati. Non è richiesto alcun input manuale.

Registro agenti vs. catalogo app Power Platform

Gli agenti di Copilot Studio compaiono sia nel registro degli agenti che nel catalogo delle app Power Platform, ma ciascuno ha uno scopo diverso.

Funzionalità Registro degli agenti Catalogo app Power Platform
Ambito A livello di tenant, tutte le piattaforme degli agenti Specifico per ambiente, solo Power Platform
Scopo Governance, visibilità, conformità Distribuzione, installazione e gestione dell'ambiente
Accedi Interfaccia di amministrazione di Microsoft 365 Interfaccia di amministrazione di Power Platform
Gestito da Amministratori 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 i tuoi agenti Copilot Studio, ma il registro degli agenti fornisce il livello di integrazione Agent 365, inclusi osservabilità, controlli di governance e conformità.

Ciclo di vita della registrazione

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

1. Creazione

Quando si crea un agente di Copilot Studio:

  • Provisioning automatico dell'identità Entra (vedi integrazione dell'identità dell'agente)
  • L'agente appare nel registro in pochi secondi
  • Metadati sincronizzati da Copilot Studio
  • Stato: attivo (pre-approvato tramite i criteri di Power Platform)

2. Aggiornamenti

Quando modifichi il tuo agente:

  • Modifiche ai metadati (nome, descrizione): il registro viene aggiornato automaticamente
  • Modifiche ai permessi (nuovi connettori): registro aggiornato, criteri DLP rivalutati
  • Modifiche alla configurazione: il registro riflette lo stato attuale

Non è richiesta la ri-registrazione manuale.

3. Eliminazione

Quando si elimina un agente di Copilot Studio:

  • Voce del registro rimossa automaticamente
  • Identità Entra eliminata
  • Tutti i metadati associati vengono ripuliti
  • Telemetria storica conservata (vedi Integrazione dell'osservabilità)

Attenzione

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

Esperienza amministratore: visualizzazione degli agenti di Copilot Studio

Gli amministratori hanno accesso al registro degli agenti dall'interfaccia di amministrazione di Microsoft 365. Vai a Interfaccia di amministrazione di Microsoft 365>Agent 365>Registro degli agenti.

Visualizzazioni disponibili:

  • Tutti gli agenti: visualizza tutti gli agenti su tutte le piattaforme
  • Filtra per piattaforma: mostra solo gli agenti di Copilot Studio
  • Filtra per publisher: mostra gli agenti di team o utenti specifici
  • Filtra per stato: mostra gli agenti attivi, bloccati o riassegnati

Pagina dei dettagli degli agenti:

  • Visualizza i metadati completi dell'agente
  • Visualizza i permessi e gli ambiti richiesti
  • Rivedere i dati di osservabilità (utilizzo, prestazioni, errori)
  • Applicare azioni di governance (bloccare, riassegnare, eliminare)

Per istruzioni dettagliate per l'amministratore, consulta:

Controlli di governance per gli agenti di Copilot Studio

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

Blocco

Evita l'uso dell'agente nell'intera organizzazione:

  • L'agente rimane nel registro ma diventa inattivo
  • Gli utenti non possono invocare né interagire con l'agente
  • Il creatore dell'agente riceve una notifica
  • Può essere sbloccato in seguito dagli amministratori

Riassegna

Assegna la proprietà dell'agente a un altro utente o team:

  • Il nuovo proprietario ottiene il pieno controllo e i diritti di modifica
  • Il proprietario originale perde l'accesso
  • Metadati del registro aggiornati con il nuovo editore
  • Utile per transizioni tra team o cambiamenti organizzativi

Elimina

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 i permessi 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 cancellati
  • Telemetria storica mantenuta per conformità

Tutte le azioni di governance vengono registrate in Microsoft Purview ai fini del tracciamento della conformità.

Per maggiori dettagli sui controlli di governance, vedi Gestione degli agenti.

Accesso programmatico: API Graph

Gli amministratori possono accedere ai dati del registro degli agenti programmaticamente tramite le Microsoft Graph API.

API disponibili:

  • Elenca tutti gli agenti: recupera l'inventario completo per conformità e reportistica
  • Ottieni i dettagli dell'agente: recupera i metadati di uno specifico agente per l'audit

Casi d'uso:

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

Sono richieste le autorizzazioni dei ruoli di amministratore IA o amministratore globale per i casi d'uso.

Per i dettagli sull'API, vedi API Graph per il registro degli agenti e i dettagli degli agenti.

Considerazioni per gli sviluppatori

Come sviluppatore di Copilot Studio, tieni presenti questi aspetti dell'integrazione con il registro degli agenti.

Qualità dei metadati:

  • Usare nomi e descrizioni chiari e dettagliati degli agenti (visibili agli amministratori)
  • Documentare l'utilizzo dei connettori e i permessi nella descrizione dell'agente
  • Mantenere aggiornati i metadati degli agenti

Trasparenza delle autorizzazioni:

  • Gli amministratori vedono tutti i permessi richiesti nel registro
  • Aggiungi solo i connettori di cui hai effettivamente bisogno
  • Informazioni sui criteri di Power Platform che governano l'utilizzo dei connettori

Integrazione dell'osservabilità:

  • Il registro si collega ai dati di osservabilità (utilizzo, prestazioni, errori)
  • Gli amministratori possono monitorare l'attività del tuo agente
  • Progettare gli agenti tenendo conto dell'osservabilità (vedi Integrazione dell'osservabilità)

Consapevolezza della governance:

  • Gli agenti possono essere bloccati, riassegnati o eliminati dagli amministratori
  • Progettare gli agenti per gestire correttamente la disattivazione
  • Comunicare con gli amministratori riguardo alle esigenze di connettori ad alto privilegio

Passaggi successivi

  • Last updated on