Bagikan melalui

Memahami transkrip percakapan yang diunduh dari Power Apps

Anda dapat melihat, mengekspor, dan mengunduh transkrip interaksi pelanggan dengan agen Anda baik di Power Apps maupun Copilot Studio. Informasi yang diekspor setiap aplikasi sedikit berbeda.

Penting

Pembuat dengan peran Pembuat lingkungan tidak secara otomatis memiliki akses ke transkrip.

Artikel ini membahas mengunduh transkrip percakapan dalam Power Apps dan menggunakannya untuk membuat laporan Power BI. Untuk mengunduh transkrip secara langsung di Copilot Studio, lihat Mengunduh transkrip percakapan di Copilot Studio.

Secara default, Power Apps mengunduh transkrip percakapan dari 30 hari terakhir. Anda dapat mengubah periode retensi.

Catatan

Respons agen yang menggunakan SharePoint sebagai sumber pengetahuan tidak disertakan dalam transkrip percakapan.

Transkrip percakapan tidak ditulis untuk:

  • Lingkungan Microsoft Dataverse for Teams
  • Lingkungan pengembang Dataverse
  • Agen Microsoft 365 Copilot

Prasyarat

Melihat dan mengekspor Transkrip percakapan dari portal Power Apps

  1. Masuk ke Power Apps.

  2. Di panel sisi, pilih Tabel, lalu pilih Semua.

    Tangkapan layar simpul Tabel dengan Semua dipilih.

  3. Masukkan "percakapan" di kotak Pencarian.

  4. Pilih tabel ConversationTranscript.

    Halaman untuk tabel ConversationTranscript terbuka.

  5. Di bilah menu atas, pilih Ekspor>Ekspor data.

    Dibutuhkan beberapa menit untuk mengkompilasi data untuk diekspor.

    Tangkapan layar yang menunjukkan menu Ekspor dengan opsi Ekspor data.

  6. Tunggu beberapa menit hingga Power Apps menyiapkan data untuk diekspor, lalu pilih Unduh data yang diekspor.

    File disimpan sebagai arsip ZIP ke lokasi unduhan default browser Anda.

Memahami transkrip percakapan

Transkrip percakapan ada sebagai tabel Dataverse yang dapat Anda unduh sebagai file CSV (nilai yang dipisahkan koma). Logika yang menentukan kapan dan bagaimana sistem merekam informasi ke transkrip percakapan adalah:

  • Sistem menyimpan percakapan ke catatan transkrip setelah 30 menit tidak aktif. Jika percakapan dilanjutkan setelah waktu tidak aktif, sistem menyimpan aktivitas baru ke rekaman baru dengan nilai yang sama Name tetapi dengan nilai baru ConversationStartTime .
  • Untuk agen yang dipublikasikan ke saluran Telepon, waktu percakapan habis tiga menit setelah acara Akhiri Percakapan .
  • Setiap catatan memiliki batas 1 MB untuk transkrip (Content kolom). Ketika transkrip lebih besar dari batas ini, sistem membagi transkrip menjadi beberapa catatan, semuanya memiliki nilai dan ConversationStartTime nilai yang samaName, tetapi dengan nilai yang berbedaMetadata.BatchId.
  • Untuk menggabungkan transkrip, ambil semua catatan dengan nilai dan ConversationStartTime nilai yang samaName, lalu urutkan catatan ini berdasarkan BatchId.

Tabel berikut menjelaskan bidang terpenting dalam transkrip percakapan Anda.

Bidang Deskripsi Contoh
Content Seluruh transkrip dalam format JSON Lihat Bidang konten
ConversationStartTime Waktu percakapan dimulai (bukan waktu rekaman transkrip ditulis ke penyimpanan data) 2021-04-19T20:39:09Z
ConversationTranscript Pengidentifikasi unik baris dalam tabel Dataverse 28eccb77-xxxx-4a63-985f-ffaaadd6f391
Metadata JSON yang menyertakan ID agen, ID penyewa, nama agen, dan ID batch {"BotId": "aaaabbbb-0000-cccc-1111-dddd2222eeee", "AADTenantId": "bbbbcccc-1111-dddd-2222-eeee3333ffff", "BotName": "Test Bot", "BatchId":2}
Name Nama baris kustom yang dibuat dari diikuti ConversationId oleh BotId 8YYe8iif49ZKkycZLe7HUO_198eca5f-1145-4ae6-8c08-835d884a8688
Bot_ConversationTranscript ID agen aaaabbbb-0000-cccc-1111-dddd2222eeee
Created on Tanggal dan waktu pembuatan rekaman transkrip 2021-04-20T02:40:13Z

Bidang konten

Bidang Content adalah log mentah dari semua aktivitas yang pengguna miliki dengan agen. Jenis aktivitas umum mencakup pesan dan aktivitas:

  • Aktivitas pesan mewakili konten yang ditampilkan dalam percakapan. Aktivitas pesan dapat berisi teks, ucapan, kartu interaktif, dan lampiran biner atau yang tidak dikenal.
  • Aktivitas Peristiwa mengkomunikasikan informasi programmatis dari klien atau saluran ke agen.

Untuk informasi lebih lanjut tentang jenis aktivitas, lihat skema Aktivitas Bot Framework.

Tabel berikut menjelaskan beberapa bidang utama dalam JSON konten:

Tombol Deskripsi
ID GUID unik dari objek aktivitas
valueType Jenis nilai yang disimpan dalam aktivitas; menentukan informasi apa yang disediakan aktivitas (Jenis nilai aktivitas umum)
timestamp Stempel waktu ketika aktivitas dibuat dalam format Epoch (jumlah detik sejak tengah malam UTC 1 Januari 1970)
type Jenis aktivitas, misalnya, message, event, atau trace
replyToId ID aktivitas yang direspons aktivitas saat ini
from Berisi bidang id dan role:
  • id - ID pemicu
  • role - menyimpan 0 atau 1
    • 0 - aktivitas berasal dari agen
    • 1 - aktivitas berasal dari pengguna yang berinteraksi dengan agen
Catatan:
id dapat digunakan untuk menghitung jumlah pengguna aktif yang berinteraksi dengan agen jika kanvas melintas dalam ID unik pengguna. Jika kanvas tidak melewatkan ID, ID unik per percakapan dilewatkan.
Untuk keamanan dan privasi, sistem melakukan hash ID sebelum menulis ID ke transkrip.
channelId ID saluran tempat aktivitas berasal; misalnya, directline, msteams, atau facebook
textFormat Format teks, misalnya, plain atau markdown
attachments Data kaya dinamis yang terkait dengan aktivitas, misalnya AdaptiveCards, HeroCards, atau Carousel data
text Teks untuk aktivitas message
value Bidang khusus untuk aktivitas berdasarkan jenis nilai, bidang ini adalah tempat sebagian besar informasi berada
channeldata Berisi data Saluran:
  • untuk pesan:
    • DialogTraceDetail
    • DialogErrorDetail
    • VariableDetail (Berisi nilai yang ditetapkan ke variabel)
    • CurrentMessageDetail
  • untuk peristiwa:
    • cci_trace_id
    • traceHistory
    • enableDiagnostics
    • clientTimestamp
    • clientActivityId
name Nama jenis aktivitas peristiwa, misalnya, SetPVAContext

Jenis nilai aktivitas umum

Jenis nilai Aktivitas Deskripsi
ConversationInfo Apakah percakapan berasal dari panel uji Copilot Studio (isDesignMode) dan lokal percakapan
CSATSurveyRequest Pengguna disajikan dengan survei kepuasan pelanggan (CSAT)
CSATSurveyResponse Pengguna merespons survei CSAT
DialogRedirect Pengguna dialihkan ke topik lain
ImpliedSuccess Pengguna mencapai node pertanyaan di topik, di mana salah satu kondisi menunjuk topik sistem CSAT Terkonfirmasi Berhasil (hanya bot klasik) atau memanggil topik sistem Akhir Percakapan
IntentRecognition Pengguna memicu topik
PRRSurveyRequest Pengguna ditanya apakah topik menjawab pertanyaan mereka dari topik Akhir Percakapan
PRRSurveyResponse Respons pengguna terhadap apakah topik menjawab pertanyaan mereka dari topik Akhir Percakapan
SessionInfo Jenis (unengaged atau engaged), hasil (Escalated, Resolved, ), AbandonWaktu Mulai dan Akhir Sesi (startTimeUtc, endTimeUtc), dan jumlah giliran sesi
VariableAssignment Nilai ditetapkan ke variabel

Transkrip yang disempurnakan

Anda dapat mengonfigurasi agen untuk menghasilkan transkrip yang disempurnakan yang menyertakan data tingkat simpul. Data ini membantu melacak alur percakapan dalam topik. Misalnya, dalam topik mengelola pesanan, pengguna dapat memilih antara mengirimkan pesanan baru atau mengambil pesanan yang sudah ada. Data tingkat simpul memungkinkan analisis perilaku pengguna di seluruh opsi ini.

Mengaktifkan transkrip yang disempurnakan

  1. Buka agen Anda.

  2. Buka Pengaturan>Tingkat Lanjut.

  3. Pilih Tingkatkan Transkrip, lalu nyalakan Sertakan detail tingkat simpul dalam transkrip.

Tangkapan layar yang menunjukkan halaman pengaturan Transkrip yang Disempurnakan.

Data tingkat node

Saat Anda mengaktifkan transkrip yang disempurnakan, transkrip menyertakan nodeTraceData jenis aktivitas untuk setiap simpul yang dipanggil topik. Tabel berikut menjelaskan bidang kunci dalam nilai aktivitas nodeTraceData.

Tombol Deskripsi
nodeID Pengidentifikasi node
nodeType Jenis node, misalnya, SendActivity atau SearchAndSummarizeContent
startTime Stempel waktu saat node dipanggil
endTime Stempel waktu saat node selesai dieksekusi
topicDisplayName Topik yang memanggil node

Analitik kustom

Beberapa skenario, seperti memfilter percakapan berdasarkan variabel kustom, memerlukan pendekatan kustom untuk analitik. Untuk membangun solusi analitik kustom, pelanggan dapat menyerap transkrip mentah ke dalam alur data mereka atau menggunakan add-on, seperti Copilot Studio Kit.

Solusi KPI Percakapan di Copilot Studio Kit secara otomatis mengurai transkrip dan mengisi data agregat ke dalam tabel Dataverse.

Mengubah periode retensi default

Pekerjaan penghapusan massal Power Apps secara otomatis menghapus transkrip agen yang lebih lama dari 30 hari. Untuk menyimpan transkrip lebih lama, batalkan pekerjaan yang ada dan buat yang baru yang berjalan pada jadwal yang berbeda.

Batalkan pekerjaan penghapusan massal yang ada

  1. Di Power Apps, pilih Pengaturan>Pengaturan lanjutan.

    Portal Dynamics 365 terbuka di tab baru.

    Tangkapan layar menu Pengaturan Power Apps dengan pengaturan lanjutan disorot.

  2. Pilih tanda sisipan di samping Pengaturan. Di bawah Sistem, pilih Manajemen Data.

    Tangkapan layar menu Pengaturan, dengan Manajemen Data disorot.

  3. Pilih Penghapusan Rekaman Massal.

  4. Dalam daftar Tampilan, pilih Pekerjaan Sistem Penghapusan Massal Berulang.

    Tangkapan layar daftar pekerjaan penghapusan massal berulang.

  5. Pilih pekerjaan Hapus Rekaman Transkrip Percakapan Massal yang lebih lama dari 1 bulan.

    Cuplikan layar daftar pekerjaan penghapusan massal, dengan yang pertama disorot.

  6. Dalam daftar Tindakan Lainnya, pilih Batal.

    Cuplikan layar dari daftar Tindakan lainnya, dengan Batal disorot.

Buat pekerjaan hapus massal baru

  1. Pilih Baru untuk memulai Wizard Penghapusan Massal. Di wizard, pilih Berikutnya.

  2. Tetapkan kriteria pencarian berikut:

    • Di daftar Cari, pilih ConversationTranscripts.
    • Pilih ConversationStartTime, pilih Lebih Lama dari X Bulan, dan masukkan "12".
      Pengaturan ini akan menyimpan transkrip selama 12 bulan. Pilih perbandingan dan nilai yang berbeda jika Anda mau.
    • Pilih SchemaType, pertahankan sama dengan, dan masukkan "powervirtualagents".

    Tangkapan layar pengaturan kriteria pencarian pekerjaan penghapusan massal.

  3. Pilih Selanjutnya.

  4. Masukkan nama untuk pekerjaan, pilih Jalankan pekerjaan ini setelah setiap, dan masukkan 1. Pilih jadwal yang berbeda jika Anda tidak ingin pekerjaan berjalan setiap hari.

    Tangkapan layar nama pekerjaan penghapusan massal dan pengaturan eksekusi.

  5. Pilih Berikutnya, lalu pilih Ajukan.

Mengapa saya tidak dapat melihat transkrip percakapan saya di tabel ConversationTranscript Power Apps ?

Administrator dapat mencegah penyimpanan transkrip ke Dataverse. Untuk informasi selengkapnya tentang cara transkrip disimpan dan cara mengelola akses, lihat Mengontrol akses transkrip.

Penting

Transkrip tidak disimpan untuk agen yang disebarkan di lingkungan pengembang.

Tips untuk mendapatkan hasil terbaik dari transkrip percakapan

Gunakan variabel untuk menyimpan data yang relevan dengan konten agen atau pengguna agen Anda. Dengan mengurai variabel dan nilainya dari transkrip percakapan, Anda dapat memfilter atau mengiris data berdasarkan variabel.

Transkrip percakapan mungkin mengacu hanya pada konten berdasarkan ID. Misalnya, dalam node Pengalihan, topik tujuan hanya dirujuk oleh ID-nya. Untuk mendapatkan nama topik ini, cari ID-nya di konten agen.

  • Last updated on