Samla in telemetri med Application Insights

I den här artikeln beskrivs hur du samlar in telemetridata från din Copilot Studio-agent för användning i Azure Application Insights.

Förutom de interna analysfunktionerna i Copilot Studio kan du skicka telemetridata till Application Insights. Telemetri ger insikter om dina agent genom att spåra:

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

Important

Application Insights är en funktion i Azure Monitor, ett utökningsbart APM-verktyg (Application Performance Management) som du kan använda för att övervaka dina liveprogram. Det kräver en prenumeration på Microsoft Azure.

Ansluta din Copilot Studio-agent till Application Insights

Om du vill ansluta agenten till Application Insights lägger du först till instrumentationsnyckeln i agentens konfiguration.

1. Gå till sidan Inställningar för din agent och välj Avancerad.

2. I avsnittet Application Insights anger du anslutningssträngen. Mer information om hur du hittar reťazec pripojenia finns i dokumentationen Azure Monitor.

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

   • Loggaktiviteter: Om det är aktiverat loggar systemet information om inkommande och utgående meddelanden och händelser.

   • Egenskaper för loggkänslig aktivitet: Om det är aktiverat innehåller loggarna värdena för vissa egenskaper som kan anses vara känsliga för inkommande och utgående meddelanden och händelser. De egenskaper som anses vara potentiellt känsliga är userid, name, textoch speak (text- och talegenskaper gäller endast för meddelanden).

Analysera robottelemetri med Application Insights

När du har anslutit roboten till Application Insights loggar den telemetridata när användare interagerar med roboten, inklusive under testning inom Copilot Studio. Om du vill se loggade telemetridata går du till avsnittet Logs i Application Insights-resursen i Azure.

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

Exempel på förfrågningar

En fråga kan vara så enkel som att ange en enda tabell, till exempel customEvents, som visar alla anpassade telemetrihändelser som loggas från Copilot Studio. Men du kan också använda Kusto-frågor för att begränsa dina resultat ytterligare, inklusive:

• Lägga till ett tidsintervall
• Utöka dina resultat med hjälp av anpassade dimensioner. Anpassade dimensioner är anpassade egenskaper som du loggar tillsammans med de fördefinierade fälten, till exempel tidsstämpel eller händelsenamnet
• Lägga till en where-sats för att begränsa de data som returneras baserat på ett villkor
• Med hjälp av mer inbyggda Kusto-funktioner för att avgöra vilken information som ska visas, och hur

Följande exempelfråga resulterar i ett linjediagram som visar hur många distinkta användare som kommunicerat med din robot per dag under 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

Important

Data inom vissa fält varierar och är mer eller mindre tillämplig, beroende på vilken kanal som används. Du får till exempel bara rätt antal unika användare i frågan om användarna autentiseras och deras användar-ID:n är konsekventa mellan konversationer. I anonyma scenarier där ett slumpmässigt användar-ID genereras i varje konversation är användar-ID-fältet mindre användbart.

Undanta telemetri från testkonversationer i dina frågor

Din robot loggar telemetri för alla konversationer, inklusive de som sker i Copilot Studio under testningen. Om du vill undanta telemetri som samlats in under testningen utökar du frågan med den designMode anpassade dimension som alla händelser samlar in och använder en where-sats i frågan.

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 tas emot från 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ältet	Description	Exempelvärden
Typ	Aktivitetstyp	message, conversationUpdate, , eventinvoke
channelId	Kanalidentifierare	emulator, directline, , msteamswebchat
fromId	Från identifierare	<id>
fromName	Användarnamn från klient	John Bonham, Keith Moon, , Steve SmithSteve Gadd
Lokalisering	Språk för klientursprung	en-us, zh-cn, en-GB, de-dezh-CN
recipientId	Mottagarens identifierare	<id>
recipientName	Mottagarens namn	John Bonham, Keith Moon, , Steve SmithSteve Gadd
Text	Meddelandetext	find a coffee shop
designMode	Konversationen inträffade i testarbetsytan	True / False

Visa övervakningsresultat (förhandsversion)

Important

Den här artikeln innehåller dokumentation om förhandsversionen av Microsoft Copilot Studio och kan ändras.

Förhandsgranskningsfunktioner ska inte användas i produktion, och funktionerna kan vara begränsade. Funktionerna är tillgängliga före den officiella publiceringen så att du kan få tidig tillgång och ge feedback.

Om du bygger en produktionsklar agent, se Översikt över Microsoft Copilot Studio.

Instrumentpanelen i Copilot Studio-vyn hämtar signaler från Azure Monitor Application Insights. Den gör förfrågningar till Application Insights via Azure Workbooks och skapar visualiseringar.

Dessa vyer ger viktiga mått, till exempel totalt antal konversationer, svarstider, undantag, verktygsanvändning och ämnesanalys, i en enda vy. Den enda vyn ger teamen transparens så att de kan spåra drifthälsa och kvalitet, förstå trender och utvärdera kontinuerligt för att förbättra sitt program.

Följ dessa steg för att komma åt och använda den inbyggda övervakningsvyn i Application Insights:

1. Gå till din Application Insights-resurs.
2. Välj fliken Övervakning i det vänstra navigeringsfönstret.
3. Under fliken Övervakning väljer du Arbetsböcker. Öppna Copilot Studio Dashboard från arbetsboksgalleriet.

Anpassa och dela din instrumentpanel

Application Insights är ett kraftfullt verktyg för övervakning av programprestanda (APM) som ger insikter om hälsotillstånd och prestanda för dina program.

Instrumentpanelen öppnas som en redigerbar arbetsbok där du kan anpassa arbetsboken och spara den efter dina behov.

1. Välj Redigera i kommandofältet.

   

2. Ändra element efter behov för ditt användningsfall. Välj de tre prickarna (...) för ett element att redigera, lägga till, flytta eller ändra storlek, klona eller ta bort det. Du kan till exempel lägga till en panel som använder KQL för att spåra ett anpassat attribut som du samlar in som den inbyggda vyn inte visar.

   

3. Välj Spara för att spara de senaste ändringarna och skapa olika vyer efter behov.

   

4. Välj ikonen Dela i kommandofältet för att dela med ditt team.

   Anmärkning

   När du delar den här arbetsboken med dina teammedlemmar måste de ha minst rollen Läsare för den anslutna Application Insights-resursen för att kunna se informationen.