Dela via

Hämta telemetri med Application Insights

  • Artikel

Viktigt!

Power Virtual Agents-funktioner ingår nu i Microsoft Copilot Studio efter betydande investeringar i generativ AI och förbättrade integrationer mellan Microsoft Copilot.

Vissa artiklar och skärmbilder kan referera till Power Virtual Agents när vi uppdaterar dokumentation och utbildning.

Den här artikeln beskriver hur du samlar in telemetridata från din Microsoft Copilot Studio-copilot för användning i Azure Application Insights.

Förutom de ursprungliga analysfunktionerna inom Microsoft Copilot Studio kan du skicka telemetridata till Application Insights. Telemetri ger dig insikter i din copilot genom att spåra:

  • Loggade meddelanden och händelser som skickats till och från din copilot
  • Ämnen som ska utlösas under användarkonversationer
  • Anpassade telemetrihändelser som kan skickas från dina ämnen

Viktigt!

Application Insights är en funktion i Azure Monitor ett utbyggbart APM-verktyg (Application Performance Management) som låter dig övervaka dina live-program. Det kräver en prenumeration på Microsoft Azure.

Anslut din Copilot Studio-copilot till Application Insights

Om du vill ansluta copiloten till Application Insights måste du lägga till instrumentationsnyckeln i projektet.

  1. Navigera till sidan Copilot-information under Inställningar.

  2. Växla till fliken Avancerat.

  3. I avsnittet Application Insights fyller du i inställningen Anslutningssträng. Se Azure Monitor-dokumentationen för information om hur du hittar din anslutningssträng.

  4. Alternativt kan du också välja att aktivera en av följande inställningar.

    • Logga aktiviteter: Om den här funktionen aktiveras loggas information om inkommande/utgående meddelanden och händelser.

    • Egenskaper för loggkänslig aktivitet: Om den här funktionen aktiveras inkluderas värden för vissa egenskaper som kan vara känsliga för inkommande/utgående meddelanden och händelser i loggar. De egenskaper som anses vara potentiellt känsliga är användar-ID, namn, text och tal (egenskaper för text och tal gäller endast meddelanden).

Analysera robottelemetri med Application Insights

När du har anslutit din robot till Application Insights loggas telemetridata när användarna interagerar med roboten, inklusive tester inom Microsoft Copilot Studio. För att se loggade telemetridata navigerar du till avsnittet Loggar för din Application Insights-resurs i Azure.

Härifrån kan du använda Kusto-frågor för att fråga och analysera dina data. Se exempelfrågor.

Exempelfrågor

En fråga kan vara så enkel som att ange en enskild tabell, till exempel customEvents, som visar alla anpassade telemetrihändelser som har loggats från Microsoft Copilot Studio. Du kan emellertid också använda Kusto-frågor för att begränsa resultaten ytterligare, inklusive:

  • Lägga till ett tidsintervall
  • Utöka resultatet med hjälp av anpassade mått. Anpassade mått är anpassade egenskaper som loggas tillsammans med de fördefinierade fälten, t.ex. tidsstämpel eller händelsenamn
  • En var-sats om att begränsa returnerade data baserat på ett villkor
  • Med hjälp av mer inbyggda Kusto-funktioner för att avgöra vilken information som ska visas, och hur

Exempelfrågan nedan resulterar i ett linjediagram som visar hur många olika användare som har kommunicerat med din robot per dag de senaste 14 dagarna.

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

Viktigt!

Datan inom vissa fält varierar och är mer eller mindre tillämplig, beroende på vilken kanal som används. Du får exempelvis bara rätt antal unika användare i frågan ovan om dessa är autentiserade användare och deras användar-ID är konsekventa i alla konversationer. I anonyma scenarier där ett slumpmässigt användar-ID genereras per konversation är fältet för användar-id mindre användbart.

Utesluta telemetri från testkonversationer från dina frågor

Din robot loggar telemetri för alla konversationer, även de som sker inom Microsoft Copilot Studio-testarbetsytan. Om du vill utesluta telemetri som samlas in under testning kan du utöka din fråga med den designMode anpassade dimension som används vid alla händelser och använda en var-sats i din fråga.

I exemplet nedan visas alla anpassade händelser utom de som registrerats via testarbetsytan.

customEvents
| extend isDesignMode = customDimensions['designMode']
| where isDesignMode == "False"

Anpassade dimensioner

Mycket av de specifika aktivitetsdata som mottagits från Microsoft Copilot Studio lagras i fältet customDimensions. Du kan visa ett anpassat dimensionsfält som används i en fråga för att utesluta telemetri från testkonversationer.

Fält Beskrivning Exempelvärden
type Aktivitetstyp message, conversationUpdate, event, invoke
channelId Kanalidentifierare emulator, directline, msteams, webchat
fromId Från identifierare <id>
fromName Användarnamn från klient John Bonham, Keith Moon, Steve Smith, Steve Gadd
locale Språk för klientursprung en-us, zh-cn, en-GB, de-de, zh-CN
recipientId Mottagarens identifierare <id>
recipientName Mottagarens namn John Bonham, Keith Moon, Steve Smith, Steve Gadd
text Meddelandetext find a coffee shop
designMode Konversationen inträffade i testarbetsytan True / False