Registrere telemetri med Application Insights
Denne artikkelen beskriver hvordan du kan registrere telemetridata fra Copilot Studio agent for bruk i Azure Application Insights.
I tillegg til de opprinnelige analysefunksjonene i Copilot Studio kan du sende telemetridata til Application Insights. Telemetri gir deg innsikt i agenten ved å spore følgende:
- Loggede meldinger og hendelser som sendes til og fra agenten
- Emner som skal utløses under brukersamtaler
- Egendefinerte telemetrihendelser som kan sendes fra emnene dine
Viktig
Application Insights er en funksjon i Azure Monitor, et utvidbart verktøy for programytelsesbehandling (APM) som gjør det mulig å overvåke live-programmer. Det krever et abonnement på Microsoft Azure.
Koble Copilot Studio-agenten til Application Insights
For å kunne koble agenten til Application Insights må du først legge til instrumenteringsnøkkelen i agentens konfigurasjon.
Gå til Innstillinger-siden for agenten, og velg Avansert.
I Application Insights-delen fyller du ut Tilkoblingsstreng -delen. Se Azure Monitor-dokumentasjonen for å finne ut hvordan du finner tilkoblingsstrengen.
Du kan også velge å aktivere en av følgende innstillinger.
Loggaktiviteter: Hvis aktivert logges detaljer om innkommende/utgående meldinger og hendelser.
Logg sensitive aktivitetsegenskaper: Hvis aktivert inkluderes verdiene i bestemte egenskaper som kan betraktes som sensitive for innkommende/utgående meldinger og hendelser, i logger. Egenskapene som anses som potensielt sensitive, er bruker-ID, navn, tekst og tale (tekst- og taleegenskaper gjelder bare for meldinger).
Analyser robottelemetri med Application Insights
Etter at du har koblet roboten til Application Insights, logges telemetridata når brukere samhandler med denne roboten, inklusive testing i Copilot Studio. For å se de loggede telemetridataene gå til Logger-delen av Application Insights-ressursen i Azure.
Herfra kan du bruke Kusto-spørringer til å spørre og analysere dataene. Se eksempelspørringene.
Eksempelspørringer
En spørring kan være så enkel som å angi en enkelt tabell, for eksempel customEvents, som viser alle egendefinerte telemetrihendelser som er logget fra Copilot Studio. Du kan imidlertid også bruke Kusto-spørringer til å begrense resultatene ytterligere, inkludert:
- Legge til et tidsintervall
- Utvide resultatene ved hjelp av egendefinerte dimensjoner Egendefinerte dimensjoner er egendefinerte egenskaper som logges sammen med de forhåndsbygde feltene, for eksempel tidsstempel eller hendelsesnavnet
- En where-setning som begrenser dataene som returneres, basert på en betingelse
- Bruke mer innebygde Kusto-funksjoner til å avgjøre hva og hvordan informasjon vises
Eksempelspørringen nedenfor fører til et linjediagram som viser hvor mange distinkte brukere som har kommunisert med enheten per dag de siste 14 dagene.
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
Viktig
Dataene i noen felt varierer og gjelder mer eller mindre, avhengig av kanalen som brukes. Du vil for eksempel bare få riktig antall unike brukere i spørringen hvis de er godkjente brukere og bruker-ID-ene er konsekvente på tvers av diskusjoner. I anonyme scenarier der en tilfeldig bruker-ID genereres per diskusjon, er feltet for bruker-ID mindre nyttig.
Utelate telemetri fra testsamtaler fra spørringene
Roboten logger telemetri for alle samtaler, inkludert de som skjer i løpet av Copilot Studio testingen. Hvis du vil utelate telemetri som samles inn under testing, kan du utvide spørringen med den egendefinerte designMode-dimensjonen som registreres for alle hendelser, og bruke en where-setning i spørringen.
Eksemplet nedenfor viser alle egendefinerte hendelser, unntatt hendelser som er tatt opp via testlerretet.
customEvents
| extend isDesignMode = customDimensions['designMode']
| where isDesignMode == "False"
Egendefinerte dimensjoner
Mye av de spesifikke aktivitetsdataene som mottas fra Copilot Studio, lagres i customDimensions-feltet. Du kan se et egendefinert dimensjonsfelt som brukes i en spørring for å utelate telemetri fra testsamtaler.
| Felt | Bekrivelse | Eksempelverdier |
|---|---|---|
| type | Type aktivitet | message, conversationUpdate, event, invoke |
| channelId | Kanal-ID | emulator, directline, msteams, webchat |
| fromId | Fra identifikator | <id> |
| fromName | Brukernavn fra klient | John Bonham, Keith Moon, Steve Smith, Steve Gadd |
| locale | Nasjonal innstilling for klientopprinnelse | en-us, zh-cn, en-GB, de-de, zh-CN |
| recipientId | Mottaker-ID | <id> |
| recipientName | Navn på mottaker | John Bonham, Keith Moon, Steve Smith, Steve Gadd |
| tekst | Tekst i melding | find a coffee shop |
| designMode | Det har skjedd en diskusjon på testlerretet | True / False |
