Power Apps içinden konuşma dökümlerini anlama

  • Makale

Yardımcı pilotunuzla hem Power Apps hem de Copilot Studio'da müşteri etkileşimlerinin dökümlerini görüntüleyebilir, dışarı aktarabilir ve indirebilirsiniz. Her uygulamanın dışa aktardığı bilgiler biraz farklıdır. Bu makalede, Power Apps içinde konuşma dökümlerini indirme ve Power BI içinde rapor oluşturmak için bunları kullanma açıklanır. Daha fazla bilgi için bkz Copilot Studio içinde oturum bilgilerini analiz etme.

Varsayılan olarak Power Apps, konuşma dökümlerini son 30 günden indirir. Saklama süresini değiştirebilirsiniz.

Not

Artık ortamınıza erişiminiz yoksa Power Platform yönetim merkezinde destek isteği oluşturmanız gerekir.

Önkoşullar

Power Apps portalından yardımcı pilot konuşma dökümlerini görüntüleme ve dışarı aktarma

Yardımcı pilot konuşma metinlerini Power Apps portaldan görüntüleyebilir ve dışa aktarabilirsiniz.

Öncelikle kimlik bilgilerinizle https://www.powerapps.com içinde giriş yapmalısınız.

Konuşma dökümlerini görüntüleme

  1. Yan gezinti bölmesinden Tablolar düğümünü, ardından Tümü'nü seçin.

    Tablolar düğümünde seçili olan tüm gösterimi gösteren ekran görüntüsü.

  2. Arama kutusuna görüşme yazın.

  3. Tablolar altında ConversationTranscript'i seçin.

    ConversationTranscript tablosu için bir sayfa açılır.

Konuşma dökümlerini dışarı aktarma

  1. Yan gezinti bölmesinden Tablolar düğümünü, ardından Tümü'nü seçin.

    Tablolar düğümünde Tümü seçeneğini seçin.

  2. Arama kutusuna görüşme yazın.

  3. Tablolar altında ConversationTranscript'i seçin.

  4. Dışarı aktar>Verileri dışa aktar'ı seçin.

    Verilerin verilmesi birkaç dakika sürer.

    Verme menüsünden Verileri aktar'ı seçme.

  5. İçeriği indirmek için Dışarı aktarılan verileri indir'i seçin.

    Dışarı aktarılan verileri indirme.

Yardımcı pilot konuşma dökümlerini indirme

  1. Power Apps gezinti menüsünde Dataverse>Tablolar'ı, ardından Tümü'nü seçin.

  2. Arama kutusuna görüşme yazın.

  3. ConversationTranscript tablosunu seçin.

  4. Dışarı aktar>Verileri dışa aktar'ı seçin.

    ConversationTranscript tablosu Verileri dışarı aktar seçeneğinin ekran görüntüsü.

  5. Power Apps'in verileri dışarı aktarmaya hazırlaması için birkaç dakika bekleyin ve ardından Dışarı aktarılan verileri indir'i seçin.

Dosya, tarayıcınızın varsayılan indirme konumuna sıkıştırılmış arşiv olarak kaydedilir.

Konuşma dökümlerini anlama

Konuşma dökümü bir CSV (virgülle ayrılmış değerler) dosyasıdır. Aşağıda tabloda, konuşma dökümlerinizde bulacağınız en önemli alanlar yer almaktadır.

Alan Description Örnek
Content JSON biçiminde tam döküm İçerik alanı bölümüne göz atın.
ConversationStartTime Konuşmanın başladığı saat (döküm kaydının veri deposuna yazıldığı saat değil) 2021-04-19T20:39:09Z
ConversationTranscript Dataverse tablosundaki satırın benzersiz tanımlayıcısı 28eccb77-xxxx-4a63-985f-ffaaadd6f391
Metadata Yardımcı pilot kimliği, kiracı kimliği ve yardımcı pilot adını içeren JSON {"BotId": "198eca5f-xxxx-4ae6-8c08-835d884a8688", "AADTenantId": "72f988bf-xxxx-41af-91ab-2d7cd011db47", "BotName": "Test Bot"}
Name ConversationId ve ardından BotId ve ardından batch number ile oluşturulan özel satırın adı. Toplu iş numarası, konuşma için birden çok analiz oturumu bulunduğunda sırayı belirtir. Klasik robotlar toplu iş numarasını içermez. 8YYe8iif49ZKkycZLe7HUO-o_198eca5f-xxxx-4ae6-8c08-835d884a8688_0
Bot_ConversationTranscript Yardımcı pilot kimliği 198eca5f-xxxx-4ae6-8c08-835d884a8688
Created on Döküm kaydının oluşturulduğu tarih ve saat 2021-04-20T02:40:13Z

İçerik alanı

Content alanı, kullanıcıların yardımcı pilotla olan etkinliklerinin ham kaydıdır. Yaygın etkinklik türleri arasında ileti ve olay bulunur:

  • İleti etkinlikleri konuşmada gösterilen içeriği temsil eder. İleti etkinlikleri metin, konuşma, etkileşimli kartlar, ikili veya bilinmeyen ekler içerebilir.
  • Olay etkinlikleri istemci veya kanaldan program yoluyla elde edilen bilgileri yardımcı pilota iletir.

Etkinlik türleri hakkında daha fazla bilgi için, Bot Framework Etkinlik şemasına bakın.

Aşağıdaki tabloda, JSON içeriğindeki bazı temel alanlar açıklanmaktadır:

Tuş Description
ID Etkinlik nesnesinin benzersiz GUID'i
valueType Etkinlikte depolanan değerin türü; etkinliğin hangi bilgileri sağladığını belirler (Ortak etkinlik değeri türleri)
timestamp Etkinliğin oluşturulduğu zaman damgası, Epoch biçiminde (1 Ocak 1970 UTC gece yarısından itibaren saniye sayısı)
type Etkinlik türü; örneğin message, event veya trace
replyToId Geçerli etkinliğin yanıt verdiği etkinliğin kimliği
from id ve role alanlarını içerir:
  • id - başlatıcının kimliği
  • role - 0 veya 1 tutar
    • 0 - Etkinlik yardımcı pilottan geliyor
    • 1 - Etkinlik yardımcı pilotla etkileşim kuran kullanıcıdan geliyor
Notlar:
Tuval kullanıcının benzersiz kimliğinde aktarılıyorsa, yardımcı pilotla etkileşim kuran etkin kullanıcıların sayısını hesaplamak için id kullanılabilir. Tuval bir kimlik iletmezse, her konuşma için benzersiz bir kimlik iletilir.
Kimlik, güvenlik ve gizlilik nedeniyle döküme yazılmadan önce karma hale getirilir.
channelId Etkinliğin geldiği kanalın kimliği (ör. directline, msteams veya facebook)
textFormat Metnin biçimi; örneğin plain veya markdown
attachments Etkinlikle ilişkilendirilmiş dinamik zengin veriler; örneğin AdaptiveCards, HeroCards veya Carousel data
text message etkinlikleri için metin
value Değer türüne göre etkinliğe özgü alanlar; bu alan yararlı bilgilerin çoğunun bulunduğu alandır
channeldata
  • Kanal verilerini içerir:
    • iletiler için:
      • DialogTraceDetail
      • DialogErrorDetail
      • VariableDetail (bir değişkene atanan değeri içerir)
      • CurrentMessageDetail
    • olaylar için:
      • cci_trace_id
      • traceHistory
      • enableDiagnostics
      • clientTimestamp
      • clientActivityId
name Olay etkinliğinin adı; örneğin SetPVAContext

Yaygın etkinlik değeri türleri

Etkinlik değeri türü Description
ConversationInfo Etkinliğin Copilot Studio test bölmesinden olup olmadığını (isDesignMode) ve konuşmanın yerel ayarını içerir
CSATSurveyRequest Kullanıcıya müşteri memnuniyet (CSAT) anketi sunulur
CSATSurveyResponse Kullanıcı bir CSAT anketine yanıt verir
DialogRedirect Kullanıcı başka bir konuya yönlendirilir
ImpliedSuccess Kullanıcı, konuda bir soru düğümüne ulaştı; bu düğümde koşullardan biri Onaylanan Başarı CSAT sistem konusuna işaret ediyor veya Konuşma Sonu sistem konusunu çağırıyor
IntentRecognition Kullanıcı bir konu tetikledi
PRRSurveyRequest Kullanıcıya, Konuşmanın Sonu konusundan konunun sorularını yanıtlayıp yanıtlamadığı soruldu
PRRSurveyResponse Kullanıcının, Konuşmanın Sonu konusundan konunun sorularını yanıtlayıp yanıtlamadığına ilişkin verdiği yanıt
SessionInfo Türü (unengaged veya engaged), sonucu (Escalated, Resolved, Abandon) ve oturum döngü sayısını içerir
VariableAssignment Değişkene bir değer atandı

Konuşma dökümlerinden özel Power BI raporlar oluşturma

Konuşma dökümlerinden özel raporlar oluşturmaya yaklaşmanın faydalı bir yolu, işlenmesi gereken mesaj sayısına bakmaktır.

Basit yaklaşım

Power BI'yı bir Power BI veri akışıyla Dataverse'e bağlama. Diğer altyapılara gerek yoktur ve her yenileme işlemiyle tüm kayıtlar Dataverse'den alınır.

Dataverse'ten Power BI modeline veri akışını gösteren şema.

Artılar Eksiler
En kolay uygulama. Yenileme süresi, döküm sayısı arttıkça artabilir.
Dataverse'te depolamaya yönelik yüksek maliyet.

Standart Azure Data Lake Storage yaklaşımı

Dataverse verilerini Azure Data Lake Storage'e dışa aktarın. Bu yöntem bir Azure Data Lake Storage hesabı gerektirir ancak başka Azure altyapısına gerek yoktur.

Dökümlerde verileri hazırlamak için bir Power Platform veri akışı kullanın ve verileri yapılandırılmış bir forma çıkarın.

Power BI verileri veri akışından yeniler. Power Platform ve Power BI tüm işlem altyapısını yönetir. Her yenileme ile, belirli bir günün kayıtları Dataverse'den alınır.

Dataverse'ten Azure Data Lake Storage'a veri aktığını ve Power Platform ve Power BI tarafından işlendiğini gösteren şema.

Artılar Eksiler
Azure Data Lake Storage'de düşük depolama alanı maliyeti.
Orta derecede basit uygulama.
Azure İşlemi gerektirmez.		 Yenileme süresi, her gün döküm sayısı arttıkça artabilir.

Azure Data Lake Storage + Synapse yaklaşımı

Standart Azure Data Lake Storage yaklaşımdaki veri boyutu, yavaş yenilemelerin veya diğer işlemsel sorunların oluşmasına neden olabilir. Bu durumda, Azure Synapse Analytics'i kullanabilir ve bunu Power BI'ye entegre edebilirsiniz.

Dataverse'den Azure Data Lake'e veri akışını ve verilerin Azure Synapse ve Power Platform tarafından işlenmesini gösteren diyagram.

Artılar Eksiler
Yenileme süresi sabittir.
Orta derecede basit uygulama.
Azure Data Lake Storage'ta düşük depolama alanı maliyeti.		 Azure Synapse için işlem maliyeti.

Varsayılan saklama süresini değiştirme

Power Apps toplu silme işi, 30 günden eski yardımcı pilot dökümlerini otomatik olarak kaldırır. Dökümleri daha uzun süre saklamak için, var olan işi iptal edip farklı bir zamanlamayla çalışan yeni bir iş oluşturun.

Var olan toplu silme işini iptal etme

  1. Power Apps'te Ayarlar>Gelişmiş ayarlar'ı seçin.

    Gelişmiş ayarlar vurgulanmış olarak Power Apps Ayarlar menüsünün ekran görüntüsü.

    Dynamics 365 portalı yeni bir sekmede açılır.

  2. Ayarlar'ın yanındaki şapka işaretini, ardından Sistem altından Veri Yönetimi'ni seçin.

    Veri Yönetimi vurgulanmış olarak Ayarlar menüsünün ekran görüntüsü.

  3. Toplu Kayıt Silme'yi seçin.

  4. Görünüm listesinde, Yinelenen Toplu Silme Sistem İşleri'ni seçin.

    Yinelenen toplu silme işleri listesinin ekran görüntüsü.

  5. 1 Aydan Eski Konuşma Dökümü Kayıtlarını Toplu Sil işini seçin.

    İlk iş vurgulanmış olarak toplu silme işleri listesinin ekran görüntüsü.

  6. Daha Fazla Eylem listesinde İptal Et'i seçin.

    İptal Et seçeneği vurgulanmış olarak Daha Fazla Eylem listesinin ekran görüntüsü.

Yeni bir toplu silme işi oluşturma

  1. Toplu Silme Sihirbazı'nı başlatmak için Yeni'yi seçin ve ardından sihirbazda İleri'yi seçin.

  2. Aşağıdaki arama ölçütlerini ayarlayın:

    • Şunu ara listesinde ConversationTranscripts öğesini seçin.
    • ConversationStartTime ayarını seçin, X aydan daha eski'yi seçin ve "12" girin.
      Bu ayarla, dökümler 12 ay boyunca saklanır. İsterseniz farklı bir karşılaştırma ve değer seçebilirsiniz.
    • SchemaType seçeneğini belirleyin, eşittir alanını bırakın ve "powervirtualagents" girin.

    Toplu silme işi arama ölçütleri ayarlarının ekran görüntüsü.

  3. İleri'yi seçin.

  4. İş için bir ad girin, Bu işi şu aralıkla çalıştır seçeneğini belirleyin ve 1 yazın. Bu işin her gün çalıştırılmasını istemiyorsanız farklı bir zamanlama seçin.

    Toplu silme işi adı ve çalıştırma ayarlarının ekran görüntüsü.

  5. İleri'yi ve ardından Gönder'i seçin.

Konuşma dökümlerinden en iyi şekilde yararlanma ipuçları

Yardımcı pilot kullanıcınız veya yardımcı pilot içeriğinizle ilgili verileri depolamak için değişkenler kullanılabilir. Değişkeni ve değerini konuşma dökümünden ayrıştırmak, verileri değişkene göre filtrelemenizi veya dilimlere ayırmanızı sağlar.

Birçok konumda, konuşma dökümleri içeriğe kimliğine göre başvurur. Örneğin, geçerli konu tarafından yönlendirilen konunun kimliğine yalnızca kendi kimliğiyle başvurulur. Konu adını almak için, adı yardımcı pilot içeriğinde arayın.