Controllare le attività di Copilot Studio in Microsoft Purview

Questo articolo elenca e descrive le attività di Copilot Studio che il portale di Microsoft Purview registra e rende disponibili. Gli sviluppatori possono accedere a questi log anche tramite l'API di gestione di Office 365.

Le modifiche al contenuto e alle impostazioni di un agente possono influire sulla sicurezza e sul comportamento di agente. Il controllo di queste azioni contribuisce a ridurre gli errori, includere sistemi di vincoli di sicurezza, rispettare i requisiti di conformità e rispondere alle minacce alla sicurezza in modo efficace.

Copilot Studio registra le attività correlate sia ad interazioni amministrative e di creatori e utenti con gli agenti.

Copilot Studio archivia i dati utilizzati per generare i log di controllo in conformità ai propri standard di sicurezza e conformità. Per altre informazioni, vedi Sicurezza e conformità di Microsoft Copilot Studio.

Nota

Per gli agenti con ID per gli agenti Microsoft Entra, l'attività di autenticazione è anche registrata in Microsoft Entra ID ed è visibile nell'interfaccia di amministrazione di Microsoft Entra. Per altre informazioni, vedi Creare automaticamente identità dell'agente Microsoft Entra.

Importante

Le attività amministrative per Copilot Studio sono abilitate per impostazione predefinita in tutti i tenant. Non è possibile disabilitare la raccolta di attività, ma è possibile disabilitare i log di controllo in Purview e usare i criteri di conservazione per impedire la conservazione del testo del messaggio utente e del testo della risposta.

Prerequisiti

Accesso ai log

  1. Accedi al portale di Microsoft Purview come amministratore del tenant.

  2. Nel menu a sinistra, seleziona Mostra tutto.

  3. In Soluzioni, seleziona Controllo.

Gli amministratori possono filtrare attività di Copilot Studio nell'elenco Attività. Le attività sono mappate ai tipi e alle categorie di eventi, come elencato nelle tabelle seguenti di questo articolo.

Screenshot dei risultati della ricerca che mostrano i nomi descrittivi per le attività in Purview.

I responsabili della conformità possono anche usare la soluzione Data Security Posture Management (DSPM) per l'intelligenza artificiale per visualizzare le trascrizioni delle chat per gli eventi CopilotInteraction. Per ulteriori informazioni, vedi Gestione postura di sicurezza dei dati (DSPM).

Vedere gli eventi controllati (creazione di agenti)

Tutta la registrazione viene eseguita a livello SDK, quindi una singola azione può attivare più eventi registrati.

Questa tabella elenca eventi generalmente correlati ad azioni amministrative in Copilot Studio, come l'eliminazione di un agente o l'aggiornamento del nome, dei dettagli o della configurazione di un agente.

Categoria Etichetta evento Descrizione dell'evento
Agenti BotDeleteCleanup La pulizia delle dipendenze dopo che un agente viene eliminato in Copilot Studio
Agenti BotUpdateOperation-BotNameUpdate Aggiornamento del nome dell'agente in Copilot Studio
Agenti BotCreate La creazione di un nuovo agente in Copilot Studio
Agenti BotDelete L'eliminazione di un agente in Copilot Studio
Agenti BotUpdateOperation-BotAuthUpdate Aggiornamento delle impostazioni di autenticazione di un agente in Copilot Studio
Agenti BotUpdateOperation-BotIconUpdate Aggiornamento dell'icona dell'agente in Copilot Studio
Agenti BotUpdateOperation-BotPublish Pubblicazione di un agente in Copilot Studio
Agenti BotUpdateOperation-BotShare Condivisione di un agente con altri utenti in Copilot Studio
Agenti BotAppInsightsUpdate Aggiornamento della configurazione di registrazione di App Insights di un agente in Copilot Studio
Componente agente BotComponentCreate La creazione di un componente (ad esempio un argomento o una competenza) per un agente in Copilot Studio
Componente agente BotComponentUpdate L'aggiornamento di un componente (ad esempio un argomento o una competenza) per un agente in Copilot Studio
Componente agente BotComponentDelete L'eliminazione di un componente (ad esempio un argomento o una competenza) per un agente in Copilot Studio
Raccolta di componenti agente BotComponentCollectionCreate La creazione di una raccolta di componenti per un agente in Copilot Studio
Raccolta di componenti agente BotComponentCollectionDelete L'eliminazione di una raccolta di componenti per un agente in Copilot Studio
Raccolta di componenti agente BotComponentCollectionUpdate Aggiornamento di una raccolta di componenti per un agente in Copilot Studio
Plug-in IA AIPluginOperationCreate Creazione di un plug-in IA per un agente in Copilot Studio
Plug-in IA AIPluginOperationUpdate Aggiornamento di un plug-in IA per un agente in Copilot Studio
Plug-in IA AIPluginOperationDelete Rimozione di un plug-in IA per un agente in Copilot Studio
Variabile di ambiente EnvironmentVariableCreate Creazione di una variabile di ambiente per un agente in Copilot Studio
Variabile di ambiente EnvironmentVariableUpdate Aggiornamento di una variabile di ambiente per un agente in Copilot Studio
Variabile di ambiente EnvironmentVariableDelete Eliminazione di una variabile di ambiente per un agente in Copilot Studio

Vedere gli eventi controllati (uso di agenti)

Nota

Tutta la registrazione viene eseguita a livello SDK, quindi una singola azione può attivare più eventi registrati.

Alcuni canali sono esclusi dalla registrazione. Per gli eventi elencati nella soluzione Controllo in Purview, il canale è identificato nel campo JSON CopilotEventData include il canale come valore AppHost. Nella soluzione DSPM per l'IA, il canale è identificato nel campo App con accesso in.

Questa tabella elenca gli eventi che rappresentano interazioni degli utenti con gli agenti Copilot in Copilot Studio, come porre domande e visualizzare risposte. L'evento sottoposto a controllo contiene metadati per tale attività, inclusi la data e l'ora, l'organizzazione, gli ID utente e risorsa e l'ID del thread di trascrizione.

Copilot Studio salva il testo della chat (la trascrizione) separatamente dall'evento sottoposto a controllo in Purview. È possibile visualizzare o accedere direttamente alla trascrizione dall'evento registrato, come appare nella soluzione DSPM (Data Security Posture Management) per l'IA.

Importante

I log di controllo nella soluzione Controllo non includono il testo completo o la trascrizione delle interazioni tra un utente e l'agente, ma solo l'ID del thread di trascrizione. La soluzione DSPM (Data Security Posture Management) per l'intelligenza artificiale tenta di recuperare il testo della chat correlato all'evento, insieme ai collegamenti alle risorse a cui si è avuto accesso come parte dell'evento registrato.

Categoria Etichetta evento Descrizione dell'evento
Utenti CopilotInteraction Interazioni degli utenti con un agente Copilot creato in Copilot Studio, ad esempio porre domande e visualizzare le risposte

Per ulteriori informazioni sugli eventi di interazione con Copilot in Microsoft 365, vedi Panoramica degli eventi di interazione con Copilot.

Campi di controllo schema

Gli schemi definiscono quali campi di agenti vengono inviati al portale Microsoft Purview. Alcuni campi sono comuni a tutte le applicazioni che inviano dati di controllo a Microsoft Purview, mentre altri sono specifici di Copilot Studio. I seguenti campi sono comuni a Power Platform.

Nome visualizzato del campo Nome logico Digita Obbligatorio Descrizione
Date CreationTime Edm.Date No Data e ora in cui il log è stato generato in UTC.
ID ID Edm.Guid No GUID univoco per ogni riga registrata.
Stato risultato ResultStatus Edm.String No Stato della riga registrata.
ID organizzazione OrganizationId Edm.Guid Sì Identificatore univoco dell'organizzazione da cui il registro è stato generato.
Operazione Operation Edm.String No Nome dell'operazione, inclusa l'etichetta dell'evento.
Utente UserKey Edm.String No Identificatore univoco dell'utente in Microsoft Entra ID.
Tipo utente UserType Self.UserType No Il tipo di controllo (amministrazione, standard, sistema).

Campi di controllo di Copilot Studio

Oltre ai campi comuni alle attività degli amministratori di Power Platform, Copilot Studio include i seguenti campi.

Nome Tipo Obbligatorio Descrizione
BotId Edm.String No Identificatore univoco dell'agente
BotSchemaName Edm.String No Stringa univoca che identifica l'agente
BotUpdateDetails Edm.ComplexType (raccolta) No Dettagli delle proprietà aggiornate sull'agente
BotComponentId Edm.String No Identificatore univoco dei componenti agente, ad esempio argomenti o entità
BotComponentSchemaName Edm.String No Stringa univoca che identifica i componenti di un agente, ad esempio argomenti o entità
BotComponentType Edm.String No Tipo del componente agente, ad esempio argomenti o entità
BotComponentUpdateDetails Edm.ComplexType (raccolta) No Dettagli delle proprietà aggiornate del componente agente
AIPluginOperationId Edm.String No Identificatore univoco per l'operazione con il plug-in IA
AIPluginOperationName Edm.String No Il nome dell'operazione con il plug-in di IA
EnvironmentVariableDefinitionSchemaName Edm.String No Nome dello schema per la definizione della variabile di ambiente associata all'agente
EnvironmentVariableDefinitionId Edm.String No Identificatore univoco per la variabile di ambiente associata all'agente

Disabilitazione della registrazione di controllo

Puoi disabilitare la registrazione eventi di tutti gli eventi di controllo nel tenant in Purview.

Per impedire la conservazione del testo dell'utente e dell'agente, puoi creare criteri di gestione del ciclo di vita dei dati in Purview che imposta un criterio di conservazione di 0 giorni per le esperienze Copilot.

Per ulteriori informazioni, vedi Creare e configurare i criteri di conservazione.

Contenuto correlato

  • Last updated on