Share via

Telemetrie vastleggen met Application Insights

  • Artikel

Belangrijk

Power Virtual Agents-mogelijkheden en -functies maken nu deel uit van Microsoft Copilot Studio na aanzienlijke investeringen in generatieve AI en verbeterde integraties binnen Microsoft Copilot.

Sommige artikelen en schermopnamen verwijzen mogelijk naar Power Virtual Agents terwijl we de documentatie en trainingsinhoud bijwerken.

In dit artikel wordt besproken hoe u telemetriegegevens van uw Microsoft Copilot Studio-copilot voor gebruik in Azure Application Insights kunt vastleggen.

Naast de native analysefuncties in Microsoft Copilot Studio kunt u telemetriegegevens verzenden naar Application Insights. Telemetrie biedt inzicht in uw copilot door het volgen van:

  • Gelogde berichten en gebeurtenissen die zijn verzonden naar en van uw copilot
  • Onderwerpen die moeten worden geactiveerd tijdens gebruikersgesprekken
  • Aangepaste telemetriegebeurtenissen die vanuit uw onderwerpen kunnen worden verzonden

Belangrijk

Application Insights is een functie van Azure Monitor, een uitbreidbare APM-tool (Application Performance Management) waarmee u uw live-applicaties kunt bewaken. Het vereist een abonnement op Microsoft Azure.

Uw Copilot Studio-copilot verbinding laten maken met Application Insights

Als u uw copilot wilt verbinden met Application Insights, moet u eerst uw instrumentatiesleutel aan het project toevoegen.

  1. Navigeer naar de pagina Copilot-details onder Instellingen.

  2. Ga naar het tabblad Geavanceerd.

  3. Vul in de sectie Application Insights de instelling Verbindingsreeks in. Raadpleeg de Azure Monitor-documentatie om erachter te komen hoe u uw verbindingsreeks kunt vinden.

  4. U kunt er ook voor kiezen om een van de volgende instellingen in te schakelen.

    • Activiteiten vastleggen: indien ingeschakeld, worden details van inkomende/uitgaande berichten en gebeurtenissen vastgelegd.

    • Gevoelige activiteitseigenschappen vastleggen: indien ingeschakeld, kunnen de waarden van bepaalde eigenschappen die als gevoelig kunnen worden beschouwd voor inkomende/uitgaande berichten en gebeurtenissen worden opgenomen in logboeken. De eigenschappen die als potentieel gevoelig worden beschouwd, zijn gebruikersnaam, naam, tekst en spraak (tekst- en spraakeigenschappen zijn alleen van toepassing op berichten).

Bottelemetrie analyseren met Application Insights

Nadat u uw bot hebt verbonden met Application Insights, worden telemetriegegevens vastgelegd wanneer gebruikers interactie hebben met de bot, inclusief tests in Microsoft Copilot Studio. Om de vastgelegde telemetriegegevens te zien, navigeert u naar de sectie Logboeken van uw Application Insights-resource in Azure.

Hier kunt u Kusto-query's gebruiken om uw gegevens op te vragen en te analyseren. Bekijk voorbeeldquery's.

Voorbeeldquery's

Een query kan zo eenvoudig zijn als de opgave van een enkele tabel, zoals customEvents, waarin alle aangepaste telemetriegebeurtenissen worden weergegeven die zijn geregistreerd vanuit Microsoft Copilot Studio. U kunt ook Kusto-query's gebruiken om uw resultaten verder te verfijnen, inclusief;

  • Een tijdsinterval toevoegen
  • Uw resultaten uitbreiden met behulp van aangepaste dimensies. Aangepaste dimensies zijn aangepaste eigenschappen die worden vastgelegd, samen met de vooraf gebouwde velden, zoals tijdstempel of gebeurtenisnaam
  • A WHERE-component om de geretourneerde gegevens te beperken op basis van een voorwaarde
  • Meer ingebouwde Kusto-functies gebruiken om te bepalen welke informatie op welke wijze wordt weergegeven

De onderstaande voorbeeldquery resulteert in een lijndiagram waarin wordt aangegeven hoeveel verschillende gebruikers de afgelopen 14 dagen per dag met uw bot hebben gecommuniceerd.

let queryStartDate = ago(14d);
let queryEndDate = now();
let groupByInterval = 1d;
customEvents
| where timestamp > queryStartDate
| where timestamp < queryEndDate
| summarize uc=dcount(user_Id) by bin(timestamp, groupByInterval)
| render timechart

Belangrijk

De gegevens in sommige velden variëren en zijn min of meer van toepassing, afhankelijk van het kanaal dat wordt gebruikt. U krijgt bijvoorbeeld alleen een correct aantal unieke gebruikers in de query als het geverifieerde gebruikers zijn en hun gebruikers-id's consistent zijn in alle gesprekken. In anonieme scenario's waarbij per gesprek een willekeurig gebruikers-id wordt gegenereerd, is het veld voor de gebruikers-id minder nuttig.

Telemetrie uit testgesprekken uitsluiten van uw query's

Uw bot registreert telemetrie voor alle gesprekken, inclusief die binnen het Microsoft Copilot Studio-testcanvas. Als u telemetrie wilt uitsluiten die is verzameld tijdens tests, kunt u uw query uitbreiden met de aangepaste dimensie designMode die wordt vastgelegd voor alle gebeurtenissen en een WHERE-component hgebruiken in uw query.

In het volgende voorbeeld worden alle aangepaste gebeurtenissen weergegeven, met uitzondering van de gebeurtenissen die via het testcanvas zijn vastgelegd.

customEvents
| extend isDesignMode = customDimensions['designMode']
| where isDesignMode == "False"

Aangepaste dimensies

Veel van de specifieke activiteitsgegevens die van Microsoft Copilot Studio worden ontvangen, worden opgeslagen in het veld customDimensions. U kunt kijken hoe een veld voor aangepast dimensies wordt gebruikt in een query om telemetrie uit te sluiten van testgesprekken.

Veld Omschrijving Voorbeeldwaarden
type Type activiteit message, conversationUpdate, event, invoke
channelId Kanaal-id emulator, directline, msteams, webchat
fromId Van-id <id>
fromName Gebruikersnaam van klant John Bonham, Keith Moon, Steve Smith, Steve Gadd
locale Oorspronkelijke landinstelling van klant en-us, zh-cn, en-GB, de-de, zh-CN
recipientId Ud van ontvanger <id>
recipientName Naam van ontvanger John Bonham, Keith Moon, Steve Smith, Steve Gadd
sms verzenden Tekst in bericht find a coffee shop
designMode Het gesprek vond plaats in het testcanvas True / False