Anda dapat mengekspor logging interaksi ke BigQuery. Setelah dikonfigurasi, semua logging interaksi live akan ditulis ke tabel BigQuery Anda. Hal ini memberi Anda alat analisis lanjutan yang dapat membantu Anda men-debug dan meningkatkan kualitas agen serta menemukan pola dalam data percakapan.
Batasan
Batasan berikut berlaku:
- Maksimum 500 giliran dapat diekspor untuk setiap percakapan.
Izin lintas project
Jika agen Dialogflow dan data BigQuery Anda tidak berada dalam project yang sama, akun layanan yang terkait dengan project Google Cloud Dialogflow Anda juga harus memiliki izin IAM roles/bigquery.dataEditor
untuk set data BigQuery di project Google Cloud BigQuery Anda.
Format akun layanan: service-<dialogflow-project-number>@gcp-sa-dialogflow.iam.gserviceaccount.com
Pengguna yang mengonfigurasi ekspor di Dialogflow harus memiliki izin di project BigQuery. Jika tidak, project BigQuery tidak akan muncul sebagai opsi di Dialogflow Console.
Izin minimum yang diperlukan di project BigQuery agar
pengguna dapat melihatnya di Dialogflow adalah resourcemanager.projects.get
.
Atau, Anda dapat menetapkan salah satu peran standar Google Cloud berikut yang menyertakan izin ini, tetapi tidak mengharuskan pengguna memiliki akses ke set data BigQuery: roles/browser
atau roles/bigquery.metadataViewer
.
Deskripsi tabel
Setiap baris tabel berisi satu giliran percakapan dengan kolom berikut:
Kolom | Jenis | Deskripsi |
---|---|---|
project_id | STRING | Project ID. |
agent_id | STRING | ID agen. |
conversation_name | STRING | Nama resource yang sepenuhnya memenuhi syarat untuk sesi. |
turn_position | INTEGER | Nomor giliran percakapan. |
request_time | TIMESTAMP | Waktu giliran percakapan. |
language_code | STRING | Tag bahasa. |
permintaan | JSON | Permintaan deteksi intent. |
respons | JSON | Respons deteksi intent. |
partial_responses | JSON | Respons sebagian jika ada. |
derived_data | JSON | Metadata tambahan untuk giliran percakapan ini. |
conversation_signals | JSON | Data analisis terkait NLU. Lihat ConversationSignals untuk skema JSON. |
bot_answer_feedback | JSON | Jawab masukan jika diberikan. |
Konfigurasi
Untuk mengonfigurasi ekspor logging interaksi:
- Pastikan logging interaksi diaktifkan.
- Ikuti panduan pembuatan set data BigQuery untuk membuat set data. Catat nama set data, karena Anda akan memerlukannya di langkah berikutnya.
Ikuti panduan pembuatan tabel BigQuery untuk membuat tabel dengan definisi skema SQL. Gunakan pernyataan SQL berikut untuk pembuatan:
CREATE TABLE <your_dataset_name>.dialogflow_bigquery_export_data( project_id STRING, agent_id STRING, conversation_name STRING, turn_position INTEGER, request_time TIMESTAMP, language_code STRING, request JSON, response JSON, partial_responses JSON, derived_data JSON, conversation_signals JSON, bot_answer_feedback JSON );
Konfigurasikan setelan agen untuk mengaktifkan ekspor BigQuery, dan untuk memberikan nama set data dan tabel yang dibuat di atas.