Power Apps'dan indirilen konuşma transkriptlerini anlama

Hem Power Apps hem de Copilot Studio'da temsilcinizle 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.

Önemli

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

Bu makale, Power Apps konuşma transkriptlerini indirmeyi ve bunları Power BI rapor oluşturmak için kullanmayı kapsar. Transkriptleri doğrudan Copilot Studio'da indirmek için bkz. Copilot Studio'da konuşma transkriptlerini indirme.

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

Not

Bilgi kaynağı olarak SharePoint kullanan ve hassas veriler içeren belgeleri kullanan aracı yanıtları konuşma transkriptine dahil değildir.

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

• Teams ortamları için Microsoft Dataverse
• 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.

konuşma transkriptlerini Power Apps portalından görüntüleme ve dışarı aktarma

1. Power Apps'e 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.

   Verileri dışa aktarmak için derlemek birkaç dakika sürer.

   

6. Power Apps verileri dışarı aktarmaya hazırlaması için birkaç dakika bekleyin ve ardından Dışarı aktarılan verileri indir öğesini 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 transkripti, CSV (virgülle ayrılmış değerler) dosyası olarak indirebileceğiniz bir Dataverse tablosu olarak mevcuttur. Sistemin konuşma transkriptlerine ne zaman ve nasıl bilgi kaydettiğini belirleyen mantık şudur:

• Sistem, 30 dakikalık hareketsizlikten sonra bir konuşmayı transkript kaydına kaydeder. Konuşma, hareketsizlik süresinden sonra devam ederse, sistem yeni faaliyetleri aynı Name değerine, ancak yeni ConversationStartTime değerine sahip olarak yeni bir kayda kaydeder.
• Telefoncu kanalında yayınlanan ajanlar için, konuşmalar Konuşmayı Bitirme etkinliğinden üç dakika sonra sona erer.
• Her kaydın transkript (Content sütun) için 1 MB sınırı vardır. Bir transkript bu sınırdan büyük olduğunda, sistem transkripti, hepsi aynı Name ve ConversationStartTime değerlerine sahip ancak farklı Metadata.BatchId değerlerine sahip birden fazla kayda böler.
• Transkriptleri birleştirmek için, aynı Name ve ConversationStartTime değerine sahip tüm kayıtları alın ve ardından bu kayıtları BatchId'e göre sıralayın.

Aşağıda tabloda, konuşma dökümlerinizde bulacağınız en önemli alanlar yer almaktadı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	JSON içinde temsilci kimliği, kiracı kimliği, temsilci adı ve parti kimliği yer alır	{"BotId": "aaaabbbb-0000-cccc-1111-dddd2222eeee", "AADTenantId": "bbbbcccc-1111-dddd-2222-eeee3333ffff", "BotName": "Test Bot", "BatchId":2}
Name	ConversationId ve ardından BotId ile 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. Güvenlik ve gizliliği sağlamak için, sistem transkribe yazmadan önce kimliği hashleme işlemi uygular.
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) ve konuşmanın yerel ayarından olup olmadığı
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), sonuç (Escalated, Resolved, Abandon), oturum başlangıç ve bitiş zamanı (startTimeUtc, endTimeUtc), ve oturumun tur sayısı
VariableAssignment	Değişkene bir değer atandı

Geliştirilmiş döküm

Ajanlar, düğüm düzeyinde veri içeren geliştirilmiş transkriptler oluşturacak şekilde yapılandırmak mümkündür. 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. Enhance Transcripts seçeneğini seçin, ardından Node düzeyindeki detayları transkriptlere dahil et seçeneğini etkinleştirin.

Düğüm düzeyinde veriler

Geliştirilmiş transkriptleri açtığınızda, transskript bir konunun çağrıldığı her düğüm için bir nodeTraceData etkinlik türü içerir. 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 analiz çözümleri oluşturmak için müşteriler ham transkriptleri veri işlem hatlarına alabilir veya Copilot Studio Kit gibi bir eklenti kullanabilir.

Copilot Studio Kit'teki Conversation KPI çözümü transkriptleri otomatik olarak ayrıştırarak toplanan verileri Dataverse tablolarına doldurur.

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

Power Apps toplu silme görevi, 30 günden eski aracı transkriptlerini 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, Settings>Gelişmiş ayarlar'ı seçin.

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

   

2. Ayarların yanındaki sembolü seçin. System altında Data Management öğesini 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 seçeneğini seçin. 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çin.
   • SchemaType'ı seçin, eşittir olarak bırakın ve "powervirtualagents" girin.

   

3. sonrakiseç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.

Konuşma dökümlerimi neden ConversationTranscript Power Apps tablosunda 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 Control transcript access sayfasına bakınız.

Önemli

Geliştirici ortamlarında konuşlandırılan ajanlar için transkriptler saklanmaz.

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

Ajanınız içeriği veya ajan kullanıcınla ilgili verileri depolamak için değişkenler kullanın . Değişkeni ve değerini konuşma transkriptinden ayrıştırarak, verileri değişkene göre filtreleyebilir veya dilimleyebilirsiniz.

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.