Delen via


Activiteiten van Copilot Studio controleren in Microsoft Purview

In dit artikel worden de Copilot Studio-activiteiten vermeld en beschreven die zijn geregistreerd en beschikbaar zijn via de Microsoft Purview-portal. Deze logboeken zijn ook toegankelijk voor ontwikkelaars via de Office 365 Management-API.

Wijzigingen in de inhoud en instellingen van een agent kunnen van invloed zijn op de beveiliging en het gedrag van de agent. Het is belangrijk om dergelijke acties te controleren om fouten te beperken, beveiligingsbeperkingen in systemen te beperken, te voldoen aan nalevingsvereisten en om beveiligingsbedreigingen aan te pakken.

Copilot Studio registreert activiteiten met betrekking tot zowel administrative als maker en gebruikersinteracties met agents.

De gegevens die worden gebruikt om de auditlogboeken te genereren, worden opgeslagen in overeenstemming met Copilot Studio-beveiligings- en nalevingsstandaarden. Zie Microsoft Copilot Studio security and compliance voor meer informatie.

Belangrijk

Beheeractiviteiten voor Copilot Studio zijn standaard ingeschakeld voor alle tenants. U kunt het verzamelen van activiteiten niet uitschakelen, maar u kunt wel de controlelogboeken in Purview uitschakelen en bewaarbeleid gebruiken om te voorkomen dat berichten en antwoorden van gebruikers worden bewaard.

Voorwaarden

De logboeken openen

  1. Meld u als tenantbeheerder aan bij de Microsoft Purview-portal.

  2. Selecteer in het menu aan de linkerkant Alles weergeven​.

  3. Selecteer onder OplossingenControleren.

Beheerders kunnen filteren op Copilot Studio-activiteiten in de lijst Activiteiten. Activiteiten worden toegewezen aan gebeurtenistypen en -categorieën, zoals vermeld in de volgende tabellen in dit artikel.

Schermopname van de zoekresultaten met vriendelijke namen voor activiteiten in Purview.

Compliancemanagers kunnen ook de Data Security Posture Management (DSPM) voor AI-oplossing gebruiken om chattranscripties voor CopilotInteraction-gebeurtenissen te bekijken. Zie Data Security Posture Management (DSPM) voor meer informatie.

Bekijk gecontroleerde gebeurtenissen (agentaanmaak)

De logboekregistratie wordt gedaan op de SDK-laag, dus met één actie kunnen meerdere gelogde gebeurtenissen worden geactiveerd.

Deze tabel bevat gebeurtenissen die doorgaans betrekking hebben op beheeracties in Copilot Studio, zoals het verwijderen van een agent of het bijwerken van de naam, details of configuratie van een agent.

Categorie Gebeurtenislabel Beschrijving van de gebeurtenis
Agenten BotDeleteCleanup Het opschonen van afhankelijkheden nadat een agent is verwijderd in Copilot Studio
Agenten BotUpdateOperation-BotNameUpdate De naam van de agent bijwerken in Copilot Studio
Agenten BotCreate Het maken van een nieuwe agent in Copilot Studio
Agenten BotDelete Het verwijderen van een agent in Copilot Studio
Agenten BotUpdateOperation-BotAuthUpdate De verificatie-instellingen van een agent bijwerken in Copilot Studio
Agenten BotUpdateOperation-BotIconUpdate Het agentpictogram bijwerken in Copilot Studio
Agenten BotUpdateOperation-BotPublish Publiceren van een agent in Copilot Studio
Agenten BotUpdateOperation-BotShare Delen van een agent aan andere gebruikers in Copilot Studio
Agenten BotAppInsightsUpdate De configuratie van App Insights-logboekregistratie van een agent bijwerken in Copilot Studio
Agentonderdeel BotComponentCreate Het maken van een onderdeel (zoals een onderwerp of vaardigheid) voor een agent in Copilot Studio
Agentonderdeel BotComponentUpdate De update van een onderdeel (zoals een onderwerp of vaardigheid) voor een agent in Copilot Studio
Agentonderdeel BotComponentDelete Het verwijderen van een onderdeel (zoals een onderwerp of vaardigheid) voor een agent in Copilot Studio
Agentonderdelenverzameling BotComponentCollectionCreate Het maken van een onderdeelverzameling voor een agent in Copilot Studio
Agentonderdelenverzameling BotComponentCollectionDelete Het verwijderen van een onderdeelverzameling voor een agent in Copilot Studio
Agentonderdelenverzameling BotComponentCollectionUpdate De update van een onderdeelverzameling voor een agent in Copilot Studio
AI-plug-in AIPluginOperationCreate Een AI-invoegtoepassing voor een agent maken in Copilot Studio
AI-plug-in AIPluginOperationUpdate Een AI-invoegtoepassing voor een agent bijwerken in Copilot Studio
AI-plug-in AIPluginOperationDelete Een AI-invoegtoepassing voor een agent verwijderen in Copilot Studio
Omgevingsvariabele EnvironmentVariableCreate Een omgevingsvariabele maken voor een agent in Copilot Studio
Omgevingsvariabele EnvironmentVariableUpdate Een omgevingsvariabele bijwerken voor een agent in Copilot Studio
Omgevingsvariabele EnvironmentVariableDelete Een omgevingsvariabele voor een agent verwijderen in Copilot Studio

Gecontroleerde gebeurtenissen bekijken (gebruik van agent)

Notitie

De logboekregistratie wordt gedaan op de SDK-laag, dus met één actie kunnen meerdere gelogde gebeurtenissen worden geactiveerd.

Sommige kanalen zijn uitgesloten van registratie. Voor gebeurtenissen die worden vermeld in de Controle-oplossing in Purview, wordt het kanaal geïdentificeerd in het JSON-veld CopilotEventData van de gecontroleerde gebeurtenis als de AppHost-waarde. In de DSPM voor AI-oplossing wordt het kanaal geïdentificeerd onder het veld App die wordt geopend in.

Deze tabel bevat gebeurtenissen die zijn geregistreerd voor gebruikersinteracties met Copilot agents in Copilot Studio, zoals het stellen van vragen en het weergeven van antwoorden. De gecontroleerde gebeurtenis bevat metagegevens voor die activiteit (waaronder de datum/tijd, organisatie-, gebruikers- en resource-id's en de transcriptthread-ID).

Copilot Studio slaat de tekst van de chat (het transcript) afzonderlijk op van de gecontroleerde gebeurtenis in Purview. U kunt het transcript rechtstreeks bekijken of openen vanuit de geregistreerde gebeurtenis zoals deze wordt weergegeven in de Data Security Posture Management (DSPM) voor AI-oplossing.

Belangrijk

De volledige tekst of het transcript van de interacties tussen een gebruiker en de agent worden niet opgenomen in de auditlogs in de Controle-oplossing, alleen de transcript-thread-ID. De Data Security Posture Management (DSPM) voor AI-oplossing probeert de chattekst met betrekking tot de gebeurtenis op te halen, samen met koppelingen naar bronnen die zijn geopend als onderdeel van de geregistreerde gebeurtenis.

Categorie Gebeurtenislabel Beschrijving van de gebeurtenis
Gebruikers CopilotInteraction Gebruikersinteracties met een Copilot-agent die is gemaakt in Copilot Studio (zoals vragen stellen en antwoorden weergeven)

Zie Overzicht van Copilot interactiegebeurtenissen voor meer informatie over Copilot interactiegebeurtenissen in Microsoft 365.

Schema van controlevelden

Schema's definiëren welke agentvelden naar de Microsoft Purview-portal worden verzonden. Sommige velden zijn gebruikelijk voor alle toepassingen die controlegegevens verzenden naar Microsoft Purview, terwijl andere specifiek zijn voor Copilot Studio. Hieronder vindt u velden die bekend zijn bij het Power Platform.

Veldweergavenaam Logische naam Type Verplicht Omschrijving
Datum CreationTime Edm.Date Geen Datum en tijdstip waarop het logboek is gegenereerd in UTC.
ID ID Edm.Guid Geen Unieke GUID voor elke geregistreerde rij.
Status van resultaat ResultStatus Edm.String Geen Status van de gelogde rij.
Organisatie-ID OrganizationId Edm.Guid Ja Unieke id van de organisatie waarvan het logboek afkomstig is.
Werking Operation Edm.String Geen Naam van de bewerking, inclusief het gebeurtenislabel.
Gebruiker UserKey Edm.String Geen De unieke id van de gebruiker in Microsoft Entra ID.
Gebruikerstype UserType Self.UserType Geen Het type audit (admin, regulier, of systeem).

Copilot Studio-auditvelden

Naast de velden die gebruikelijk zijn voor Power Platform-beheerdersactiviteiten, bevat Copilot Studio de volgende velden.

Naam Type Verplicht Omschrijving
BotId Edm.String Geen Een unieke identificator van de agent
BotSchemaName Edm.String Geen Ee n unieke tekenreeks die aangeeft wie de agent is
BotUpdateDetails Edm.ComplexType (Verzameling) Geen Details van de eigenschappen die in de agent zijn bijgewerkt
BotComponentId Edm.String Geen Een unieke identificatie van de agentonderdelen, zoals onderwerpen of entiteiten
BotComponentSchemaName Edm.String Geen Een unieke tekenreeks die de onderdelen van een agent identificeert, zoals onderwerpen of entiteiten
BotComponentType Edm.String Geen Het type van het agentonderdeel, zoals onderwerpen of entiteiten
BotComponentUpdateDetails Edm.ComplexType (Verzameling) Geen Details van de bijgewerkte eigenschappen van het agentonderdeel
AIPluginOperationId Edm.String Geen Een unieke identificatie voor de bewerking met de AI-plug-in
AIPluginOperationName Edm.String Geen De naam van de bewerking met de AI-invoegtoepassing
EnvironmentVariableDefinitionSchemaName Edm.String Geen Schemanaam voor de definitie van de omgevingsvariabele die is gekoppeld aan de agent
EnvironmentVariableDefinitionId Edm.String Geen Een unieke id voor de definitie van de omgevingsvariabele die is gekoppeld aan de agent

Auditlogboekregistratie uitschakelen

U kunt het vastleggen van gebeurtenissen voor alle auditgebeurtenissen in uw tenant in Purview uitschakelen.

Als u wilt voorkomen dat gebruikers- en agenttekst wordt bewaard, kunt u een beleid voor gegevenslevenscyclusbeheer maken in Purview waarmee een bewaarbeleid van 0 dagen wordt ingesteld voor Copilot Experiences.

Zie Bewaarbeleid maken en configureren voor meer informatie.