Zachycení telemetrie pomocí Application Insights

Tento článek popisuje, jak můžete zachytit telemetrická data z vašeho Copilot Studio agent pro použití v Azure Application Insights.

Kromě nativních analytických funkcí v rámci Copilot Studio můžete odesílat telemetrická data do Application Insights. Telemetrie nabízí přehled o vašem agent sledováním:

• Zaznamenané zprávy a události odeslané do a z vašeho agent
• Témata, která se mají spouštět během uživatelských konverzací
• Vlastní telemetrické události, které lze odesílat z vašich témat

Důležité

Application Insights je funkcí Azure Monitoru, rozšiřitelného nástroje Správa výkonu aplikací (APM), který vám umožňuje sledovat vaše živé aplikace. Vyžaduje předplatné služby Microsoft Azure.

Webová aplikace

Připojení agenta Copilot Studio k Application Insights

Pokud chcete připojit agent k Application Insights, musíte nejprve přidat instrumentační klíč do konfigurace agent.

1. Přejděte na stránku Nastavení pro svého agenta a vyberte Pokročilé.

2. V sekci Application Insights vyplňte nastavení Připojovací řetězec . Informace o tom, jak najít připojovací řetězec, najdete v dokumentaci Azure Monitor.

3. Volitelně se můžete rozhodnout zapnout jednou z následujících nastavení.

   • Protokolovat aktivity: Pokud je zapnuto, budou protokolovány údaje o příchozích/odchozích zprávách a událostech.

   • Protokolování citlivých vlastností aktivity: Pokud je zapnuto, hodnoty určitých vlastností, které by mohly být považovány za citlivé na příchozích/odchozích zprávách a událostech, budou zahrnuty do protokolů. Vlastnosti, které jsou považovány za potenciálně citlivé, jsou ID uživatele, jméno, text a mluvení (vlastnosti text a mluvení se vztahují pouze na zprávy).

Analýza telemetrie robota pomocí Application Insights

Po připojení vašeho robota k Application Insights budou při interakci uživatelů s robotem zaznamenána telemetrická data, včetně testování v rámci Copilot Studio. Chcete-li zobrazit protokolovaná data telemetrie, přejděte do sekce Protokoly v rámci prostředku Application Insights v Azure.

Odtud můžete pomocí dotazů Kusto vyhledávat a analyzovat svá data. Viz Vzorové dotazy.

Vzorové dotazy

Dotaz může být stejně jednoduchý jako zadání jedné tabulky, například customEvents, která zobrazuje všechny vlastní telemetrické události zaznamenané z Copilot Studio. Ale můžete také použít dotazy Kusto k dalšímu zúžení výsledků, včetně:

• Přidání časového intervalu
• Rozšíření výsledků pomocí vlastních dimenzí. Vlastní dimenze jsou vlastní vlastnosti, které se zaznamenávají spolu s předem vytvořenými poli, jako je časové razítko nebo název události
• Výraz where omezující data vrácená na základě podmínky
• Použití více vestavěných funkcí Kusto k určení toho, jaké a jak se informace zobrazí

Výsledkem příkladu dotazu níže je spojnicový graf, který ukazuje, kolik různých uživatelů komunikovalo s vaším robotem za den za posledních 14 dní.

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

Důležité

Údaje v některých polích se liší a jsou více nebo méně použitelné v závislosti na používaném kanálu. Správný počet unikátních uživatelů ve výše uvedeném dotazu například získáte pouze v případě, že se jedná o ověřené uživatele a jejich uživatelská ID jsou ve všech konverzacích konzistentní. V anonymních scénářích, kde se generuje náhodné ID uživatele na konverzaci, je pole ID uživatele méně užitečné.

Vyloučení telemetrie z testovacích konverzací z vašich dotazů

Robot protokoluje telemetrii pro všechny konverzace, včetně těch, které probíhají během Copilot Studio testování. Pokud chcete vyloučit telemetrii shromážděnou během testování, můžete svůj dotaz rozšířit o vlastní dimenzi designMode, která je zachycena u všech událostí, a použít a výraz where v dotazu.

Níže uvedený příklad ukazuje všechny vlastní události s výjimkou těch, které byly zachyceny prostřednictvím testovacího plátna.

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

Vlastní dimenze

Velká část dat o specifických aktivitách přijatých z Copilot Studio je uložena v poli customDimensions. Můžete zobrazit pole vlastní dimenze používaná v dotazu k vyloučení telemetrie z testovacích konverzací.

Pole	Description	Ukázkové hodnoty
type	Typ aktivity	message, conversationUpdate, event, invoke
channelId	Identifikátor kanálu	emulator, directline, msteams, webchat
fromId	Identifikátor Od	<id>
fromName	Uživatelské jméno od klienta	John Bonham, Keith Moon, Steve Smith, Steve Gadd
locale	Národní prostředí původního klienta	en-us, zh-cn, en-GB, de-de, zh-CN
recipientId	Identifikátor příjemce	<id>
recipientName	Jméno příjemce	John Bonham, Keith Moon, Steve Smith, Steve Gadd
text	Text ve zprávě	find a coffee shop
designMode	Konverzace proběhla na testovacím plátně	True / False

Klasické

Poznámka:

Tento článek se týká pouze klasických chatbotů. Chcete-li rozšířit agenty vytvořené v Copilot Studio, nemusíte používat Bot Framework nástroj Composer. Všechny funkce popsané v tomto článku jsou k dispozici pro agenty přímo v Copilot Studio.

Bot Framework Composer spolu s Copilot Studio můžete použít k odeslání dat událostí do telemetrické služby v Application Insights. Telemetrie nabízí přehledy o vašem robotovi s údaji o tom, které funkce se používají nejvíce, detekuje nežádoucí chování a poskytuje údaje o dostupnosti, výkonu a využití.

Důležité

Application Insights je funkcí Azure Monitoru, rozšiřitelného nástroje Správa výkonu aplikací (APM), který vám umožňuje sledovat vaše živé aplikace. Vyžaduje předplatné služby Microsoft Azure.

Připojit Application Insights

Chcete-li se připojit ke službě Application Insights v aplikaci Composer, musíte do projektu přidat instrumentační klíč.

1. V aplikaci Composer přejděte na stránku Konfigurovat.

   

2. Zapněte Zobrazení pokročilých nastavení (json).

3. Najděte sekci applicationInsights a přidejte svůj instrumentační klíč Application Insights do nastavení instrumentationKey.

   

Chcete-li se dozvědět více o tom, jak nastavit a používat Application Insights a vytvářet dotazy pro adaptivní dialogy Composeru, přečtěte si tyto zdroje:

• Předplatné služby Microsoft Azure.
• Seznámení s aplikací Application Insights.
• Základní pojmy protokolování dotazů v Azure Monitoru.
• Ukázkové dotazy Kusto pro adaptivní dialogy v aplikaci Composer.