Nota
L'accesso a questa pagina richiede l'autorizzazione. È possibile provare ad accedere o modificare le directory.
L'accesso a questa pagina richiede l'autorizzazione. È possibile provare a modificare le directory.
Questo articolo elenca e descrive le attività di Copilot Studio che il portale di Microsoft Purview registra e rende disponibili. Gli sviluppatori possono anche accedere a questi log tramite l'API Office 365 Management.
Le modifiche al contenuto e alle impostazioni di un agente possono influire sulla sicurezza e sul comportamento di agente. Il controllo di queste azioni consente di attenuare gli errori, contenere sistemi di vincoli di sicurezza, rispettare i requisiti di conformità e risolvere le minacce alla sicurezza.
Copilot Studio registra le attività correlate a attività amministrative e a interazioni dei maker e degli utenti con agenti.
Copilot Studio archivia i dati usati per generare i log di controllo in conformità agli standard di sicurezza e conformità. Per altre informazioni, vedere Microsoft Copilot Studio sicurezza e conformità.
Nota
Per gli agenti con ID agente Microsoft Entra, anche l'attività di autenticazione viene registrata Microsoft Entra ID e visibile nel Interfaccia di amministrazione di Microsoft Entra. Per altre informazioni, vedere Automatically create Microsoft Entra agent identities.
Importante
Le attività amministrative di 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
- Gli utenti devono avere una licenza di Microsoft 365 assegnata in modo che Copilot Studio possa registrare gli eventi di controllo e salvare le trascrizioni delle conversazioni con Microsoft 365 Copilot.
- Il tuo locatario non è un locatario conforme al Federal Risk and Authorization Management Program (FedRAMP).
Accesso ai log
Accedere al Portale di Microsoft Purview come amministratore tenant.
Nel menu a sinistra, seleziona Mostra tutto.
In Soluzioni, seleziona Controllo.
Gli amministratori possono filtrare le attività di Copilot Studio nell'elenco Activities. Le attività sono mappate ai tipi e alle categorie di eventi, come elencato nelle tabelle seguenti di questo articolo.
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 della postura della sicurezza dei dati (DSPM).
Vedere gli eventi controllati (creazione di agenti)
Tutte le registrazioni vengono eseguite a livello di SDK, in modo che una singola azione possa attivare più eventi registrati.
Questa tabella elenca gli eventi in genere correlati alle azioni amministrative in Copilot Studio, ad esempio 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 |
Pulizia delle dipendenze dopo l'eliminazione di un agente in Copilot Studio |
| Agenti | BotUpdateOperation-BotNameUpdate |
Aggiornamento del nome dell'agente in Copilot Studio |
| Agenti | BotCreate |
Creazione di un nuovo agente in Copilot Studio |
| Agenti | BotDelete |
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 ad altri utenti in Copilot Studio |
| Agenti | BotAppInsightsUpdate |
Aggiornamento della configurazione di registrazione di App Insights di un agente in Copilot Studio |
| Componente agente | BotComponentCreate |
Creazione di un componente (ad esempio un argomento o una competenza) per un agente in Copilot Studio |
| Componente agente | BotComponentUpdate |
Aggiornamento di un componente (ad esempio un argomento o una competenza) per un agente in Copilot Studio |
| Componente agente | BotComponentDelete |
Eliminazione di un componente (ad esempio un argomento o una competenza) per un agente in Copilot Studio |
| Raccolta componenti dell'agente | BotComponentCollectionCreate |
Creazione di una raccolta di componenti per un agente in Copilot Studio |
| Raccolta componenti dell'agente | BotComponentCollectionDelete |
Eliminazione di una raccolta di componenti per un agente in Copilot Studio |
| Raccolta componenti dell'agente | BotComponentCollectionUpdate |
Aggiornamento di una raccolta di componenti per un agente in Copilot Studio |
| Plug-in di intelligenza artificiale | AIPluginOperationCreate |
Creazione di un plug-in di intelligenza artificiale per un agente in Copilot Studio |
| Plug-in di intelligenza artificiale | AIPluginOperationUpdate |
Aggiornamento di un plug-in di intelligenza artificiale per un agente in Copilot Studio |
| Plug-in di intelligenza artificiale | AIPluginOperationDelete |
Rimozione di un plug-in di intelligenza artificiale 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
Tutte le registrazioni vengono eseguite a livello di SDK, in modo che una singola azione possa attivare più eventi registrati.
Alcuni canali sono esclusi dalla registrazione.
Per gli eventi elencati nella soluzione Audit in Purview, il campo JSON CopilotEventData dell'evento controllato include il canale come AppHost valore.
Nella soluzione DSPM per intelligenza artificiale il canale viene visualizzato nel campo App a cui si accede.
Questa tabella elenca gli eventi che sono interazioni utente con agenti Copilot in Copilot Studio, ad esempio porre domande e visualizzare risposte. L'evento controllato contiene i metadati per tale attività, tra cui la data e l'ora, gli ID organizzazione, utente e risorsa e l'ID del thread di trascrizione.
Copilot Studio salva il testo della chat (trascrizione) separatamente dall'evento controllato in Purview. È possibile visualizzare o accedere alla trascrizione direttamente dall'evento registrato come visualizzato nella soluzione Data Security Posture Management (DSPM) per intelligenza artificiale .
Importante
I log di controllo nella soluzione Audit non includono il testo completo o la trascrizione delle interazioni tra un utente e l'agente, 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 utente con un agente Copilot creato in Copilot Studio, ad esempio porre domande e visualizzare risposte |
Per altre informazioni sugli eventi di interazione Copilot in Microsoft 365, vedere panoramica degli eventi di interazione Copilot.
Campi di controllo schema
Gli schemi definiscono i campi dell'agente inviati al Portale di 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 campi seguenti sono comuni a Power Platform.
| Nome visualizzato del campo | Nome logico | Tipo | Obbligatorio | Descrzione |
|---|---|---|---|---|
| Data | CreationTime |
Edm.Date |
No | Data e ora in cui il log è stato generato in UTC. |
| ID | ID |
Edm.Guid |
No | Un GUID univoco per ogni riga di log. |
| Lo stato del 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 di utente | UserType |
Self.UserType |
No | Il tipo di verifica (amministrativo, standard, sistema). |
Copilot Studio campi di controllo
Oltre ai campi comuni alle attività di amministratore di Power Platform, Copilot Studio include i campi seguenti.
| Name | Tipo | Obbligatorio | Descrzione |
|---|---|---|---|
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 dell'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 plugin AI |
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
Per impedire la conservazione del testo dell'utente e dell'agente, è possibile creare un criterio di gestione del ciclo di vita dei dati in Purview che imposta un criterio di conservazione di 0 giorni per le esperienze Copilot.
Per altre informazioni, vedere Creare e configurare i criteri di conservazione.