Power Apps'ten indirilen konuşma transkriptlerini anlama

Müşterilerinizin aracınızla olan etkileşimlerinin dökümlerini hem Power Apps hem de Copilot Studio içinde görüntüleyebilir, dışa aktarabilir ve indirebilirsiniz. Her uygulamanın dışa aktardığı bilgiler biraz farklıdır.

Önemli

Ortam oluşturucusu rolüne sahip oluşturucular, dökümlere otomatik olarak erişemez.

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. Copilot Studio içindeki konuşmaların doğrudan transkriptlerini indirmek için Copilot Studio içindeki konuşma transkriptlerini indirin bölümüne bakın.

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

Not

Bilgi kaynağı olarak SharePoint'i kullanan aracı yanıtları konuşma dökümlerine dahil edilmez.

Konuşma transkriptleri şunlar için yazılmaz:

• Microsoft Dataverse for Teams ortamları
• Dataverse geliştirici ortamları
• Microsoft 365 Copilot aracıları

Önkoşul

• Konuşma transkriptlerini görüntülemek için Bot Transkript Görüntüleyicisi güvenlik rolüne sahip olmanız gerekir. Yalnızca yöneticiler Bot Transkript Görüntüleyicisi güvenlik rolü verebilir.

Power Apps Portallarından konuşma dökümlerini görüntüleyin ve dışa aktarın

1. Power Apps'te oturum açın.

2. Yan bölmede Tablolar'ı seçin ve ardından Tümü'nü seçin.

   

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

4. ConversationTranscript tablosunu seçin.

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

5. Üst menü çubuğundan Dışa Aktar>Verileri Dışa Aktar'ı seçin.

   Verilerin verilmesi birkaç dakika sürer.

   

6. 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 bir ZIP arşivi 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.

Not

• Konuşmada 30 dakika etkinlik dışı kalma süresi varsa, konuşma transkript kaydına kaydedilir. Eğer konuşma, hareketsizlikten sonra devam ederse, aynı Name ile yeni bir transkript kaydına kayıt edilir.
• Konuşmanın transkript kaydı 1 MB'tan büyükse, transkript her biri 1 MB'tan büyük olmayan ve her biri aynı Name ve ConversationStartTime değerlere sahip olan birden çok kayda bölünür.

Alan	Açıklama	Örnek
Content	JSON biçiminde tam döküm	Bkz İçerik alanı
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	Aracı kimliğini, kiracı kimliğini ve aracı adını içeren JSON	{"BotId": "aaaabbbb-0000-cccc-1111-dddd2222eeee", "AADTenantId": "bbbbcccc-1111-dddd-2222-eeee3333ffff", "BotName": "Test Bot"}
Name	'ConversationId ve BotId'den sonra oluşturulan özel satırın adı.	8YYe8iif49ZKkycZLe7HUO_198eca5f-1145-4ae6-8c08-835d884a8688
Bot_ConversationTranscript	Aracı kimliği	aaaabbbb-0000-cccc-1111-dddd2222eeee
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 aracıyla olan etkinliklerinin ham kaydıdır. Yaygın etkinlik 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, programlama bilgilerini bir istemciden veya kanaldan bir aracıya 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:

Anahtar	Açıklama
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 - çağıranın kimliği role - 0 veya 1 tutar 0 - etkinlik aracıdan geliyor 1 - etkinlik aracı ile etkileşim kuran kullanıcıdan geliyor Notlar: id, tuval kullanıcının benzersiz kimliğini geçiriyorsa aracı ile etkileşim kuran etkin kullanıcıların sayısını hesaplamak için 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ü	Açıklama
ConversationInfo	Konuşmanın Copilot Studio test bölmesinden (isDesignMode) olup olmadığı ve konuşmanın yerel ayarı
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ı, koşullardan birinin Onaylanmış Başarılı CSAT sistem konusuna (yalnızca klasik botlar) işaret ettiği veya Konuşmanın Sonu sistem konusunu çağırdığı konuda bir soru düğümüne ulaştı
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), Oturum Başlangıç ve Bitiş saati (startTimeUtc, endTimeUtc), ve oturumun dönüş sayısı
VariableAssignment	Değişkene bir değer atandı

Geliştirilmiş döküm

Aracılar, düğüm düzeyinde veriler içeren gelişmiş dökümler oluşturacak şekilde yapılandırılabilir. Bu veriler, bir konu içindeki konuşma akışının izlenmesine yardımcı olur. Örneğin, siparişleri yönet konusunda kullanıcılar yeni bir sipariş gönderme veya mevcut bir siparişi alma arasında seçim yapabilir. Düğüm düzeyindeki veriler, bu seçenekler arasında kullanıcı davranışının analiz edilmesini sağlar.

Geliştirilmiş dökümü etkinleştir

1. Aracınızı açın.

2. Ayarlar>Gelişmiş'e gidin.

3. Dökümleri İyileştir'i seçin, sonra Dökümlere düğüm düzeyindeki ayrıntıları dahil et'i açın.

Düğüm düzeyinde veriler

Geliştirilmiş transkriptler açıldığında, bir konu tarafından çağrılan her düğüm için transkriptte nodeTraceData etkinlik türü görünür. Aşağıdaki tabloda nodeTraceData aktivite değerindeki temel alanlar açıklanmaktadır.

Anahtar	Açıklama
nodeID	Düğüm tanımlayıcısı
nodeType	Düğüm türü, örneğin, SendActivity veya SearchAndSummarizeContent
startTime	Düğümün çağrıldığı zaman damgası
endTime	Düğümün yürütülmesinin tamamlandığı zaman damgası
topicDisplayName	Düğümü çağıran konu

Özel analizler

Konuşmaları özel bir değişkene göre filtreleme gibi bazı senaryolar, analiz için özel bir yaklaşım gerektirir. Özel analitik çözümleri oluşturan müşteriler, ham transkriptleri veri kanallarına alabilir veya Copilot Studio Kiti gibi bir eklenti kullanabilirler

Copilot Studio Kit içerisindeki Konuşma KPI çözümü, transkriptleri otomatik olarak ayrıştırır ve toplanan verileri Dataverse tablolarına doldurur.

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

Power Apps toplu silme işi, 30 günden eski aracı dökümanlarını 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.

   

   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.

   

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

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

   

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

   

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

   

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.

   

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.

   

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

ConversationTranscript Power Apps tablosunda konuşma dökümlerimi neden göremiyorum?

Yöneticiler transkriptlerin Dataverse hedefine kaydedilmesini engelleyebilir. Transkriptlerin nasıl kaydedildiği ve erişimin nasıl yönetileceği hakkında daha fazla bilgi için Transkript erişimini kontrol etme bölümüne bakın.

Önemli

Dökümler, geliştirici ortamlarında dağıtılan aracılar için depolanmaz.

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

Değişkenler aracı içeriğinizle veya aracı kullanıcınızla ilgili verileri depolamak için 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.

Konuşma dökümleri içeriğe yalnızca kimlik numarasıyla atıfta bulunabilir. Örneğin, bir Yönlendirme düğümünde, hedef konuya yalnızca kimliğiyle başvurulur. Bu konunun adını almak için, aracı içeriğinde kimliğine bakın.