Registrere telemetri med Application Insights

Koble Copilot Studio-kopiloten til Application Insights

For å kunne koble kopiloten til Application Insights må du først legge til instrumenteringsnøkkelen i prosjektet.

1. Gå til siden Kopilotdetaljer under Innstillinger.

2. Bytt til Avansert-fanen.

3. I Application Insights-delen fyller du ut Tilkoblingsstreng -delen. Se Azure Monitor-dokumentasjonen for å finne ut hvordan du finner tilkoblingsstrengen.

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

   • Logg aktiviteter: Hvis aktivert, logges detaljer om innkommende/utgående meldinger og hendelser.

   • Logg sensitive aktivitetsegenskaper: Hvis aktivert, inkluderes verdiene for bestemte egenskaper som kan anses 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 Microsoft 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 Microsoft 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

Utelate telemetri fra testsamtaler fra spørringene

Robeten logger telemetri for alle diskusjoner, inkludert de som skjer innenfor Microsoft Copilot Studio-testlerretet. 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 Microsoft Copilot Studio, lagres i customDimensions-feltet. Du kan se et egendefinert dimensjonsfelt som brukes i en spørring for å utelate telemetri fra testsamtaler.

Du kan bruke Bot Framework Composer med Microsoft Copilot Studio til å sende hendelsesdata til en telemetritjeneste i Application Insights. Telemetri gir deg innsikt i roboten ved å vise hvilke funksjoner som brukes mest, oppdage uønsket virkemåte og gi data om tilgjengelighet, ytelse og bruk.

Koble til Application Insights

For å legge til Application Insights-tjenesten i Composer må du legge til Instrumenteringsnøkkelen i prosjektet.

1. I Composer går du til Konfigurer-siden.

   

2. Aktiver Visning for avanserte innstillinger (json).

   

3. Finn delen applicationInsights, og legg deretter til Application Insights i instrumenteringsnøkkelen i instrumentationKey-innstillingen.

   

Hvis du vil finne ut mer om hvordan du konfigurerer og bruker Application Insights og oppretter spørringer for de adaptive dialogene for Composer, kan du se disse ressursene:

• Abonnement på Microsoft Azure.
• Kom i gang med Application Insights.
• De grunnleggende konseptene for loggspørringer i Azure Monitor.
• Eksempel på Kusto-spørringer etter adaptive dialogbokser i Composer.