Hämta telemetri med Application Insights
Den här artikeln beskriver hur du samlar in telemetridata från din Copilot Studio-agent för användning i Azure Application Insights.
Förutom de ursprungliga analysfunktionerna inom Copilot Studio kan du skicka telemetridata till Application Insights. Telemetri ger insikter om dina agent genom att spåra:
- Loggade meddelanden och händelser som skickas till och från din agent
- Ämnen som ska utlösas under användarkonversationer
- Anpassade telemetrihändelser som kan skickas från dina ämnen
Viktigt!
Application Insights är en funktion i Azure Monitor ett utbyggbart APM-verktyg (Application Performance Management) som låter dig övervaka dina live-program. Det kräver en prenumeration på Microsoft Azure.
Ansluta till din Copilot Studio-agent till Application Insights
Om du vill ansluta din agent till Application Insights måste du först lägga till instrumenteringsnyckeln i agentens konfiguration.
Gå till sidan Inställningar för din agent och välj Avancerad.
I avsnittet Application Insights fyller du i inställningen Anslutningssträng. Se Azure Monitor-dokumentationen för information om hur du hittar din anslutningssträng.
Alternativt kan du också välja att aktivera en av följande inställningar.
Logga aktiviteter: Om den här funktionen aktiveras loggas information om inkommande/utgående meddelanden och händelser.
Egenskaper för loggkänslig aktivitet: Om den här funktionen aktiveras inkluderas värden för vissa egenskaper som kan vara känsliga för inkommande/utgående meddelanden och händelser i loggar. De egenskaper som anses vara potentiellt känsliga är användar-ID, namn, text och tal (egenskaper för text och tal gäller endast meddelanden).
Analysera robottelemetri med Application Insights
När du har anslutit din robot till Application Insights loggas telemetridata när användarna interagerar med roboten, inklusive tester inom Copilot Studio. För att se loggade telemetridata navigerar du till avsnittet Loggar för din Application Insights-resurs i Azure.
Härifrån kan du använda Kusto-frågor för att fråga och analysera dina data. Se exempelfrågor.
Exempelfrågor
En fråga kan vara så enkel som att ange en enskild tabell, till exempel customEvents, som visar alla anpassade telemetrihändelser som har loggats från Copilot Studio. Du kan emellertid också använda Kusto-frågor för att begränsa resultaten ytterligare, inklusive:
- Lägga till ett tidsintervall
- Utöka resultatet med hjälp av anpassade mått. Anpassade mått är anpassade egenskaper som loggas tillsammans med de fördefinierade fälten, t.ex. tidsstämpel eller händelsenamn
- En var-sats om att begränsa returnerade data baserat på ett villkor
- Med hjälp av mer inbyggda Kusto-funktioner för att avgöra vilken information som ska visas, och hur
Exempelfrågan nedan resulterar i ett linjediagram som visar hur många olika användare som har kommunicerat med din robot per dag de senaste 14 dagarna.
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
Viktigt!
Datan inom vissa fält varierar och är mer eller mindre tillämplig, beroende på vilken kanal som används. Du får exempelvis bara rätt antal unika användare i frågan ovan om dessa är autentiserade användare och deras användar-ID är konsekventa i alla konversationer. I anonyma scenarier där ett slumpmässigt användar-ID genereras per konversation är fältet för användar-id mindre användbart.
Utesluta telemetri från testkonversationer från dina frågor
Roboten loggar telemetri för alla konversationer, inklusive de som sker Copilot Studio under testningen. Om du vill utesluta telemetri som samlas in under testning kan du utöka din fråga med den designMode anpassade dimension som används vid alla händelser och använda en var-sats i din fråga.
I exemplet nedan visas alla anpassade händelser utom de som registrerats via testarbetsytan.
customEvents
| extend isDesignMode = customDimensions['designMode']
| where isDesignMode == "False"
Anpassade dimensioner
Mycket av de specifika aktivitetsdata som mottagits från Copilot Studio lagras i fältet customDimensions. Du kan visa ett anpassat dimensionsfält som används i en fråga för att utesluta telemetri från testkonversationer.
| Fält | Beskrivning | Exempelvärden |
|---|---|---|
| type | Aktivitetstyp | message, conversationUpdate, event, invoke |
| channelId | Kanalidentifierare | emulator, directline, msteams, webchat |
| fromId | Från identifierare | <id> |
| fromName | Användarnamn från klient | John Bonham, Keith Moon, Steve Smith, Steve Gadd |
| locale | Språk för klientursprung | en-us, zh-cn, en-GB, de-de, zh-CN |
| recipientId | Mottagarens identifierare | <id> |
| recipientName | Mottagarens namn | John Bonham, Keith Moon, Steve Smith, Steve Gadd |
| text | Meddelandetext | find a coffee shop |
| designMode | Konversationen inträffade i testarbetsytan | True / False |
