Ekspor logging interaksi ke BigQuery

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.

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:

  1. Pastikan logging interaksi diaktifkan.
  2. Ikuti panduan pembuatan set data BigQuery untuk membuat set data. Catat nama set data, karena Anda akan memerlukannya di langkah berikutnya.
  3. 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
    );
    
  4. Konfigurasikan setelan agen untuk mengaktifkan ekspor BigQuery, dan untuk memberikan nama set data dan tabel yang dibuat di atas.