Registrere telemetri med Application Insights

I denne artikel beskrives det, hvordan du kan hente telemetridata fra din Copilot Studio-agent til brug i Azure Application Insights.

Ud over de oprindelige analysefunktioner i Copilot Studio kan du sende telemetridata 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

Opret forbindelse mellem din Copilot Studio-agent og Application Insights

Du skal føje din instrumenteringsnøgle til din agents konfiguration for at kunne oprette forbindelse mellem din agent og Application Insights.

1. Gå til siden Indstillinger for din agent, og vælg Avanceret.

2. I sektionen Application Insights udfyldes indstillingen Forbindelsesstreng. Se dokumentationen til Azure Monitor for at få mere at vide om, hvordan du finder dine connection string.

3. 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 oprettet forbindelse mellem din robot og Application Insights, logføres telemetridata, når brugerne interagerer med robotten, herunder under test i Copilot Studio. Hvis du vil se de logførte telemetridata, skal du gå til afsnittet Logs i 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å enkel som at angive en enkelt tabel, f.eks. customEvents, som viser alle brugerdefinerede telemetrihæ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

Udelukke telemetrikker fra testsamtaler fra forespørgsler

Din robot logfører telemetri for alle samtaler, herunder dem, der sker i Copilot Studio under test. 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 feltet customDimensions. Du kan se, at der anvendes et brugerdefineret felt i en forespørgsel til at udelukke telemetri fra testsamtaler.

Visning af overvågningsresultater (prøveversion)

I dashboardvisningen Copilot Studio bruges der signaler fra Azure Monitor Application Insights, der forespørger den via Azure projektmapper og opretter visualiseringer.

Disse visninger er designet til at overføre vigtige målepunkter, f.eks. samlede samtaler, ventetid, undtagelser, brug af værktøjer og emneanalyser, til en enkelt visning. Den enkelte visning giver teams gennemsigtighed, så de kan spore driftsmæssig tilstand og kvalitet, forstå tendenser og løbende vurdere for at forbedre deres anvendelse.

Følg disse trin for at få adgang til og bruge den indbyggede overvågningsvisning i Application Insights:

1. Gå til din Application Insights.
2. Vælg fanen Overvågning i venstre navigationsrude.
3. Under fanen Overvågning skal du vælge Arbejdsbøger og åbne Copilot Studio Dashboard fra projektmappegalleriet.

Tilpas og del dit dashboard

Application Insights er et effektivt værktøj til overvågning af programydeevne (APM), der giver indsigt i dine programmers tilstand og ydeevne.

Dashboardet åbnes som en redigerbar projektmappe, hvor du kan tilpasse projektmappen og gemme efter dine behov.

1. Vælg Rediger på kommandolinjen.

   

2. Rediger elementer efter behov for din use case. Vælg de tre prikker (...) for et element, der skal redigeres, tilføjes, flyttes eller ændres størrelse, klones eller fjernes. For eksempel kan du tilføje en flise ved hjælp af KQL til at spore en brugerdefineret attribut, du samler ind, som vores indbyggede visning ikke viser.

   

3. Gem dine seneste ændringer, og opret forskellige visninger efter behov ved at vælge Gem.

   

4. Del med dit team ved at vælge ikonet Del på kommandolinjen.

   Notat

   Når du deler projektmappen med dine gruppemedlemmer, skal de som minimum have rollen Læser for den tilknyttede Application Insights-ressource for at få vist de viste oplysninger.