Registrere telemetri med Application Insights

Denne artikkelen forklarer hvordan du registrerer telemetridata fra Copilot Studio agenten 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 du kan sende fra emnene

Viktig!

Application Insights er en funksjon i Azure Monitor, et utvidbart programytelsesbehandlingsverktøy (APM) som du kan bruke til å overvåke live-programmene dine. Det krever et abonnement for å Microsoft Azure.

Koble Copilot Studio-agenten til Application Insights

Hvis du vil koble agenten til Application Insights, må du først legge til instrumenteringsnøkkelen i agentens konfigurasjon.

1. Gå til Innstillinger-siden for agenten, og velg Avansert.

2. Skriv inn tilkoblingsstrengen i application insights-delen. Hvis du vil lære hvordan du finner tilkoblingsstreng, kan du se dokumentasjonen for Azure Monitor.

3. Du kan også velge å aktivere en av følgende innstillinger.

   • Loggaktiviteter: Hvis aktivert, logger systemet detaljer om innkommende og utgående meldinger og hendelser.

   • Egenskaper for loggsensitiv aktivitet: Hvis det er aktivert, inkluderer loggene verdiene for bestemte egenskaper som kan betraktes som sensitive for innkommende og utgående meldinger og hendelser. Egenskapene som anses som potensielt sensitive, er userid, name, textog speak (tekst- og taleegenskaper gjelder bare for meldinger).

Analyser robottelemetri med Application Insights

Når du har koblet boten til Application Insights, logger den telemetridata når brukere samhandler med roboten, inkludert under testing i Copilot Studio. Hvis du vil se de loggførte telemetridataene, kan du gå til delen Logs i 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 én 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 du logger sammen med de forhåndsbygde feltene, for eksempel tidsstempel eller hendelsesnavnet
• Legge til en where-setningsdel for å begrense dataene som returneres basert på en betingelse
• Bruke mer innebygde Kusto-funksjoner til å avgjøre hva og hvordan informasjon vises

Følgende eksempelspørring resulterer i et linjediagram som viser hvor mange distinkte brukere som har kommunisert med roboten 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 får for eksempel bare et riktig antall unike brukere i spørringen hvis brukerne godkjennes og bruker-ID-ene deres er konsekvente på tvers av samtaler. I anonyme scenarioer der en tilfeldig bruker-ID genereres i hver samtale, er bruker-ID-feltet mindre nyttig.

Utelat telemetri fra testsamtaler i spørringene

Roboten logger telemetri for alle samtaler, inkludert de som skjer i Copilot Studio under testing. Hvis du vil utelate telemetri som samles inn under testing, utvider du spørringen ved hjelp av den egendefinerte dimensjonen designMode som alle hendelser registrerer, og bruker en where-setningsdel 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 feltet customDimensions. Du kan se et egendefinert dimensjonsfelt som brukes i en spørring for å utelate telemetri fra testsamtaler.

Felt	Description	Eksempelverdier
type	Type aktivitet	message, , conversationUpdate, eventinvoke
kanal-ID	Kanal-ID	emulator, , directline, msteamswebchat
fromId	Fra identifikator	<id>
fraNavn	Brukernavn fra klient	John Bonham, , Keith Moon, Steve SmithSteve Gadd
nasjonal innstilling	Klientopphavsinnstilling	en-us, zh-cn, en-GB, , de-dezh-CN
recipientId	Mottaker-ID	<id>
mottakerNavn	Navn på mottaker	John Bonham, , Keith Moon, Steve SmithSteve Gadd
SMS	Tekst i melding	find a coffee shop
designMode	Det har skjedd en diskusjon på testlerretet	True / False

Vise overvåkingsresultater (forhåndsvisning)

Viktig!

Denne artikkelen inneholder dokumentasjon for Microsoft Copilot Studio-forhåndsversjonen og kan bli endret.

Evalueringsfunksjonalitet er ikke ment for produksjonsbruk og kan ha begrensninger. Disse funksjonene er tilgjengelige før en offisielle utgivelsen slik at du kan få tidlig tilgang og gi tilbakemeldinger.

Hvis du skal bygge en produksjonsklar agent, kan du se Oversikt over Microsoft Copilot Studio.

Instrumentbordvisningen Copilot Studio bruker signaler fra Azure Monitor Application Insights. Det spør Application Insights gjennom Azure arbeidsbøker og oppretter visualiseringer.

Disse visningene gir viktige måledata, for eksempel totalt antall samtaler, ventetid, unntak, verktøybruk og emneanalyse, inn i én enkelt visning. Den ene visningen gir teamene gjennomsiktighet, slik at de kan spore driftstilstand og kvalitet, forstå trender og vurdere kontinuerlig for å forbedre programmet.

Følg disse trinnene for å få tilgang til og bruke den innebygde overvåkingsvisningen i Application Insights:

1. Gå til Application Insights-ressursen.
2. Velg Overvåking-fanen fra venstre navigasjonsrute.
3. Velg Arbeidsbøker under Overvåking-fanen. Åpne Copilot Studio instrumentbord fra arbeidsbokgalleriet.

Tilpasse og dele instrumentbordet

Application Insights er et kraftig verktøy for overvåking av programytelse (APM) som gir innsikt i tilstanden og ytelsen til programmene dine.

Instrumentbordet åpnes som en redigerbar arbeidsbok der du kan tilpasse arbeidsboken og lagre den etter dine behov.

1. Velg Rediger på kommandolinjen.

   

2. Endre elementer etter behov for brukstilfellet. Velg de tre prikkene (...) for et element å redigere, legge til, flytte eller endre størrelse, klone eller fjerne det. Du kan for eksempel legge til en flis som bruker KQL til å spore et egendefinert attributt du samler inn, som den innebygde visningen ikke viser.

   

3. Velg Lagre for å lagre de nyeste endringene og opprette forskjellige visninger etter behov.

   

4. Velg Del-ikonet på kommandolinjen for å dele med gruppen.

   Bemerkning

   Når du deler denne arbeidsboken med gruppemedlemmene, må de minst ha leserrollen for den tilkoblede Application Insights-ressursen for å kunne vise informasjonen som vises.