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

SharePoint'i bilgi kaynağı olarak kullanan ve hassas veri içeren belgeler kullanan ajan yanıtları konuşma transkriptine 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.

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

   

6. Power Apps'in verileri dışa aktarmaya hazırlamasını birkaç dakika bekleyin, sonra İnce veriyi 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ı değere sahip ama yeni Name bir değerle yeni bir kayda ConversationStartTime 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 aynı değerlere Name sahip ancak farklı ConversationStartTime değerlere sahip birden fazla kayda Metadata.BatchId böler.
• Transkriptleri birleştirmek için, aynı Name ve ConversationStartTime değerli tüm kayıtları alın ve ardından bu kayıtları .BatchId

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 ile temsilci kimliği, kiracı kimliği, temsilci adı ve parti kimliği yer alıyor	{"BotId": "aaaabbbb-0000-cccc-1111-dddd2222eeee", "AADTenantId": "bbbbcccc-1111-dddd-2222-eeee3333ffff", "BotName": "Test Bot", "BatchId":2}
Name	Oluşturulan ConversationId özel satırın adı BotId	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 gizlilik için, sistem kimliği transkribe yazmadan önce kimliği hash eder.
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), 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 ve ardından Not düzeyinde detayları transkriptlere dahil et.

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 analitik çözümleri oluşturmak için müşteriler, ham transkriptleri veri hatlarına alabilir veya Copilot Studio Kit gibi bir eklenti kullanabilirler.

Copilot Studio Kit'teki Conversation KPIs çözümü, transskriptleri otomatik olarak ayrıştırır ve toplu verileri Dataverse tablolarına doldurur.

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

Power Apps'ın toplu silme işi, 30 günden eski ajan 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 Ayarlar>Gelişmiş ayarlar'ı seçin.

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

   

2. Ayarların yanındaki karayolu seçin. System altında 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 seçeneğini seçin. Sihirbazda Sonraki'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şit tutun 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 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.