Memahami transkrip percakapan yang diunduh dari Power Apps

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

Important

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

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

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

Note

Respons agen yang menggunakan SharePoint sebagai sumber pengetahuan dan menggunakan dokumen yang menyertakan data sensitif tidak disertakan dalam transkrip percakapan.

Transkrip percakapan tidak ditulis untuk:

  • Microsoft Dataverse untuk lingkungan Teams
  • Lingkungan pengembang Dataverse
  • Agen Microsoft 365 Copilot

Prasyarat

Menampilkan dan mengekspor transkrip percakapan dari portal Power Apps

  1. Masuk ke Power Apps.

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

    Cuplikan layar node 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, percakapan akan berakhir tiga menit setelah peristiwa 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 Name dan ConversationStartTime yang sama, tetapi dengan nilai Metadata.BatchId yang berbeda.
  • Untuk menggabungkan transkrip, ambil semua rekaman dengan nilai Name dan ConversationStartTime yang sama, lalu urutkan rekaman ini berdasarkan BatchId.

Tabel berikut menjelaskan bidang terpenting dalam transkrip percakapan Anda.

Ladang Deskripsi Example
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 ConversationId diikuti 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:

Key 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 berakhir sesi (startTimeUtc, ), endTimeUtcdan 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 node yang dipicu oleh topik. Tabel berikut menjelaskan bidang kunci dalam nilai aktivitas nodeTraceData.

Key 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 Conversation KPI di Copilot Studio Kit secara otomatis mengurai transkrip dan mengisi data agregat ke dalam tabel Dataverse.

Mengubah periode retensi default

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

Note

Jika Anda mengubah periode retensi Dataverse default, hanya analitik kustom yang terpengaruh. Periode retensi untuk halaman Analitik di Copilot Studio tidak terpengaruh.

Batalkan pekerjaan penghapusan massal yang ada

  1. Di Power Apps, pilih Settings>Pengatelan tingkat lanjut.

    Portal Dynamics 365 terbuka di tab baru.

    Cuplikan layar menu Pengaturan Power Apps dengan pengaturan tingkat lanjut disorot.

  2. Pilih ikon panah di samping Pengaturan. Di bawah System, pilih Data Management.

    Screenshot dari menu Pengaturan, dengan Pengelolaan 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 Next.

  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, biarkan tetap sama, 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 bisa melihat transkrip percakapan saya di tabel Power Apps ConversationTranscript?

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

Important

Transkrip tidak disimpan untuk agen yang diterapkan 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