Telemetrie vastleggen met Application Insights
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.
Navigeer naar de pagina Copilot-details onder Instellingen.
Ga naar het tabblad Geavanceerd.
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.
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 |
