Activiteiten in Copilot Studio controleren in Microsoft Purview

In dit artikel worden de Copilot Studio-activiteiten opgesomd en beschreven die door het Microsoft Purview portal worden geregistreerd en beschikbaar gesteld. Ontwikkelaars hebben ook toegang tot deze logboeken 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. Door deze acties te controleren, kunt u fouten beperken, systemen met beveiligingsbeperkingen bevatten, voldoen aan nalevingsvereisten en beveiligingsrisico's aanpakken.

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

Copilot Studio slaat de gegevens op die worden gebruikt om de auditlogboeken te genereren overeenkomstig de beveiligings- en nalevingsstandaarden. Zie Microsoft Copilot Studio security and compliance voor meer informatie.

Notitie

Voor agents met Microsoft Entra Agent-id's wordt verificatieactiviteit ook geregistreerd in Microsoft Entra ID en zichtbaar in de Microsoft Entra admin center. Zie Automatisch Microsoft Entra agentidentiteiten maken 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 (ontwerpen van agents)

Alle logboekregistratie vindt plaats op de SDK-laag, zodat één actie meerdere vastgelegde gebeurtenissen kan activeren.

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
Verzameling van agentonderdelen BotComponentCollectionCreate Het maken van een onderdeelverzameling voor een agent in Copilot Studio
Verzameling van agentonderdelen BotComponentCollectionDelete Het verwijderen van een onderdeelverzameling voor een agent in Copilot Studio
Verzameling van agentonderdelen 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

Alle logboekregistratie vindt plaats op de SDK-laag, zodat één actie meerdere vastgelegde gebeurtenissen kan activeren.

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

Deze tabel bevat gebeurtenissen die gebruikersinteracties zijn 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 en tijd, organisatie, gebruikers- en resource-id's en de transcript thread-id.

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

Belangrijk

De auditlogboeken in de auditoplossing bevatten niet de volledige tekst of transcriptie van de interacties tussen een gebruiker en de agent, alleen de transcriptthread-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 gemaakt in Copilot Studio, zoals het stellen van vragen en het weergeven van antwoorden

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. De volgende velden zijn gebruikelijk voor 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 De 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-velden voor audits

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.

Gerelateerde inhoud

  • Last updated on