Ekspor logging interaksi ke BigQuery

Anda dapat mengekspor logging interaksi ke BigQuery. Setelah dikonfigurasi, semua logging interaksi langsung akan ditulis ke tabel BigQuery Anda. Hal ini menyediakan alat analisis lanjutan yang dapat membantu Anda men-debug dan meningkatkan 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

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 referensi yang sepenuhnya memenuhi syarat untuk sesi.
turn_position INTEGER Nomor giliran percakapan.
request_time TIMESTAMP Waktunya percakapan.
language_code STRING Tag bahasa.
permintaan JSON Permintaan intent deteksi.
respons JSON Respons intent deteksi.
partial_responses JSON Respons sebagian jika berlaku.
derived_data JSON Metadata tambahan untuk percakapan ini.
conversation_signals JSON Data analisis terkait NLU. Lihat ConversationSignals untuk mengetahui skema JSON.
bot_answer_feedback JSON Masukan jawaban 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 {i>dataset<i} tersebut, 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 membuat:

    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 Anda untuk mengaktifkan BigQuery Export, serta untuk memberikan set data dan nama tabel yang dibuat di atas.