Registrere telemetri med Application Insights
I denne artikel beskrives, hvordan du kan hente telemetridata fra din Copilot Studio-agent til brug i Azure Application Insights.
Ud over de indbyggede analysefunktioner i Copilot Studio kan du sende telemetriske data til Application Insights. Telemetri kan give dig indsigt i din agent ved at spore:
- Logførte meddelelser og hændelser, der sendes til og fra din agent
- Emner, der skal udløses under brugersamtaler
- Brugerdefinerede telemetrikhændelser, der kan sendes fra emnerne
Vigtigt
Application Insights er en funktion i Azure Monitor, et udvidelsesværktøj til APM (Application Performance Management), der giver dig mulighed for at overvåge dine live programmer. Der kræves et abonnement til Microsoft Azure.
Opret forbindelse fra din Copilot Studio-agent til Application Insights
Du skal føje din instrumenteringsnøgle til din agents konfiguration for at kunne oprette forbindelse mellem din agent og Application Insights.
Gå til siden Indstillinger for din agent, og vælg Avanceret.
I sektionen Application Insights udfyldes indstillingen Forbindelsesstreng. Se Azure Monitor-dokumentation for at finde ud af, hvordan du finder din forbindelsesstreng.
Alternativt kan du vælge at aktivere en af følgende indstillinger.
Logaktiviteter: Hvis det er aktiveret, logføres der oplysninger om indgående/udgående meddelelser og hændelser.
Logfører følsomme aktivitetsegenskaber: Hvis det er aktiveret, medtages værdierne for visse egenskaber, der kan opfattes som følsomme i indgående/udgående meddelelser og hændelser, i loggene. De egenskaber, der opfattes som potentielt følsomme, er bruger-id, navn, tekst og tale (egenskaber for tekst og tale gælder kun for meddelelser).
Analysere robottelemetri med Application Insights
Når du har forbundet din robot med Application Insights, logføres telemetridata, når brugere kommunikerer med brugeren, herunder test i Copilot Studio. Hvis du vil se logførte telemetridata, skal du gå til sektionen Logfiler for din Application Insights-ressource i Azure.
Herfra kan du bruge Kusto-forespørgsler til at forespørge om og analysere dine data. Se eksempelforespørgsler.
Eksempelforespørgsler
En forespørgsel kan være så simpel som at angive en enkelt tabel, f.eks. customEvents, der viser alle brugerdefinerede telemetriske hændelser, der er logført fra Copilot Studio. Men du kan også bruge Kusto-forespørgsler til at indskrænke dine resultater yderligere, herunder:
- Tilføjelse af et tidsinterval
- Udvidelse af resultaterne ved hjælp af brugerdefinerede mål. Brugerdefinerede dimensioner er brugerdefinerede egenskaber, der logføres, sammen med de foruddefinerede felter, f.eks. tidsstempel eller hændelsesnavnet
- En hvor-sætning begrænser de returnerede data baseret på en betingelse
- Brug af mere indbyggede Kusto-funktioner til at bestemme, hvad og hvordan oplysninger skal vises
Eksempelforespørgslen nedenfor resulterer i et kurvediagram, der viser, hvor mange forskellige brugere, der har brug for hjælpen hver dag i de seneste 14 dage.
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
Vigtigt
Dataene i visse felter varierer og er mere eller mindre relevante, afhængigt af den kanal, der bruges. Du får f.eks. kun det korrekte antal entydige brugere i forespørgslen, hvis de er godkendte brugere, og deres bruger-id'er er konsistente på tværs af samtaler. I anonyme scenarier, hvor der genereres et tilfældigt bruger-id pr. samtale, er feltet med bruger-id mindre nyttigt.
Udelukke telemetrikker fra testsamtaler fra forespørgsler
Din robot logfører telemetri for alle samtaler, herunder dem, der finder sted i Copilot Studio i testfasen. Hvis du vil udelukke telemetri, der er indsamlet under testen, kan du udvide forespørgslen med den brugerdefinerede designMode-dimension, der registreres for alle hændelser og brug en hvor-sætning i forespørgslen.
I følgende eksempel vises alle brugerdefinerede hændelser, med undtagelse af hændelser, der registreres via testlærredet.
customEvents
| extend isDesignMode = customDimensions['designMode']
| where isDesignMode == "False"
Brugerdefinerede dimensioner
Mange af de specifikke aktivitetsdata, der modtages fra Copilot Studio, gemmes i customDimensions-feltet. Du kan se, at der anvendes et brugerdefineret felt i en forespørgsel til at udelukke telemetri fra testsamtaler.
| Felt | Beskrivelse | Eksempelværdier |
|---|---|---|
| type | Type af aktivitet | message, conversationUpdate, event, invoke |
| channelId | Kanal-id | emulator, directline, msteams, webchat |
| fromId | Fra identifikator | <id> |
| fromName | Brugernavn fra klient | John Bonham, Keith Moon, Steve Smith, Steve Gadd |
| locale | Landestandard for klientoprindelse | en-us, zh-cn, en-GB, de-de, zh-CN |
| recipientId | Identifikation af modtager | <id> |
| recipientName | Modtagernavn | John Bonham, Keith Moon, Steve Smith, Steve Gadd |
| tekst | Tekst i besked | find a coffee shop |
| designMode | Samtalen fandt sted i testlærredet | True / False |
