Application Insights ile telemetriyi yakalama
Bu makalede Azure Application Insights'ta kullanmak üzere Microsoft Copilot Studio yardımcı pilotunuzdan telemetri verilerini nasıl yakalayabileceğiniz açıklanmaktadır.
Microsoft Copilot Studio içindeki yerel analizler özelliklerine ek olarak, telemetri verilerini Application Insights uygulamasına da gönderebilirsiniz. Telemetri, aşağıdakileri izleyerek yardımcı pilotunuz için içgörüler sunar:
- Yardımcı pilotunuza ve yardımcı pilotunuzdan gönderilen günlüğe kaydedilmiş iletiler ve olaylar
- Kullanıcı görüşmeleri sırasında tetiklenecek konular
- Konularınızdan gönderilebilecek özel telemetri olayları
Önemli
Application Insights Azure İzleyicisi'nin bir özelliğidir, canlı uygulamalarınızı izlemenizi sağlayan genişletilebilir bir Uygulama Performansı Yönetimi (APM) aracıdır. Microsoft Azure'a abonelik gerektirir.
Copilot Studio yardımcı pilotunuzu Application Insights ile bağlama
Yardımcı pilotunuzu Application Insights'a bağlamak için öncelikle izleme anahtarınızı projeye eklemeniz gerekir.
Ayarlar altındaki Copilot ayrıntıları sayfasına gidin.
Gelişmiş sekmesine geçin.
Application Insights bölümü içinde, Bağlantı dizesi ayarını doldurun. Bağlantı dizginizi bulma hakkında bilgi için Azure Monitör belgelerine bakın.
İsteğe bağlı olarak, aşağıdaki ayarlardan birini etkinleştirmeyi seçebilirsiniz.
Günlük etkinlikleri: Etkinleştirilirse, gelen/giden mesajların ve olayların ayrıntıları günlüğe kaydedilir.
Günlük hassas Etkinlik özellikleri: Etkinleştirilirse, gelen/giden iletiler ve olaylar için hassas olarak kabul edilebilecek belirli özelliklerin değerleri günlüklere dahil edilir. Duyarlı olarak kabul edilen özellikler kullanıcı kimliği, ad, metin ve konuştur (metin ve konuş özellikleri yalnızca iletilere uygulanır).
Application Insights ile telemetri analizi botu
Botunuzu Application Insights'a bağladıktan sonra, kullanıcılar bot ile etkileşim kurduktan sonra Microsoft Copilot Studio'ta sınama da dahil olmak üzere, telemetri verileri günlüğe kaydedilir. Günlüğe kaydedilen telemetri verilerini görmek için, Azure'da Application Insights kaynağının Günlükler bölümüne gidin.
Buradan, verilerinizi sorgulamak ve çözümlemek için Kusto sorgularını kullanabilirsiniz. Örnek sorgulara göz atın.
Örnek sorgular
Bir sorgu, Microsoft Copilot Studio tarafından kaydedilen tüm özel telemetri olaylarını gösteren customEvents gibi tek bir tablo belirtmek kadar basit olabilir. Ancak aşağıdakiler dahil olmak üzere Kusto sorgularını sonuçları daha da daraltmak için kullanabilirsiniz;
- Zaman aralığı ekleme
- Özel boyutları kullanarak sonuçlarınızı uzatma. Özel boyutlar, zaman damgası veya olay adı gibi önceden oluşturulmuş alanlarla birlikte günlüğe kaydedilen özel özelliklerdir.
- Koşula göre döndürülen verileri sınırlamak için bir nerede yan tümcesi
- Hangi bilgilerin nasıl gösterildiğini belirlemek için yerleşik daha fazla Kusto işlevini kullanma
Aşağıdaki örnek sorgu, son 14 gün boyunca günde kaç farklı kullanıcıya ait bot uygulamanıza nasıl iletilebileceğini gösteren çizgi grafik olarak sonuçlanır.
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
Önemli
Bazı alanlardaki veriler değişiklik gösterir ve kullanılan kanala bağlı olarak daha çok veya daha az uygulanabilir. Örneğin, sorguda yalnızca kimliği doğrulanmış kullanıcılar olduğunda ve kullanıcı kimlikleri konuşmalar arasında tutarlı olduğunda, yalnızca doğru benzersiz kullanıcı sayısına ulaşabilirsiniz. Görüşme başına rasgele bir kullanıcı kimliği üretilen anonim senaryolarda, kullanıcı kimliği alanı daha az yararlıdır.
Sorgulardan gelen sınama konuşmalarının telemetrisini dışta tutma
Botunuz Microsoft Copilot Studio test tuvali içinde gerçekleşenler dahil tüm konuşmalar için telemetrileri kaydeder. Sınama sırasında toplanan telemetrinin hariç tutulmasını istiyorsanız, sorgunuzu, tüm olaylarda yakalanan designMode özel boyutla genişletebilir ve sorgunuzda bir nerede yan tümcesini kullanabilirsiniz.
Aşağıdaki örnekte, sınama tuvali üzerinden yakalananlar hariç tüm özel olaylar gösterilmektedir.
customEvents
| extend isDesignMode = customDimensions['designMode']
| where isDesignMode == "False"
Özel Boyutlar
Microsoft Copilot Studio'tan alınan belirli aktivite verilerinin çoğu customDimensions alanında depolanır. Test konuşmalarında telemetrileri çıkarmak için bir sorguda kullanılan özel boyut alanını görebilirsiniz.
| Alan | Veri Akışı Açıklaması | Örnek Değerler |
|---|---|---|
| Tür | Etkinlik türü | message, conversationUpdate, event, invoke |
| channelId | Kanal tanımlayıcısı | emulator, directline, msteams, webchat |
| fromId | From Tanımlayıcısı | <id> |
| fromName | İstemciden kullanıcı adı | John Bonham, Keith Moon, Steve Smith, Steve Gadd |
| locale | İstemci başlangıç yerel ayarı | en-us, zh-cn, en-GB,, de-de zh-CN |
| recipientId | Alıcı tanımlayıcısı | <id> |
| recipientName | Alıcı adı | John Bonham, Keith Moon, Steve Smith, Steve Gadd |
| text | Mesajda metin | find a coffee shop |
| designMode | Sınama tuvali içinde konuşma gerçekleşti | True / False |
