將互動記錄匯出至 BigQuery

您可以將互動記錄匯出至 BigQuery。設定完成後，所有即時互動記錄都會寫入 BigQuery 資料表。這可提供進階分析工具，協助您對服務機器人進行偵錯及改善，並發掘對話資料中的模式。

限制

限制如下：

  • 每個對話最多可匯出 500 個回合。

跨專案權限

如果 Dialogflow 機器人和 BigQuery 資料不在同一個專案中，與 Dialogflow Google Cloud 專案相關聯的服務帳戶也必須具備 BigQuery Google Cloud 專案中 BigQuery 資料集的 roles/bigquery.dataEditor IAM 權限。

服務帳戶格式：service-<dialogflow-project-number>@gcp-sa-dialogflow.iam.gserviceaccount.com

在 Dialogflow 中設定匯出作業的使用者必須擁有 BigQuery 專案的權限。如果沒有，BigQuery 專案就不會顯示在 Dialogflow 主控台的選項中。

使用者要在 Dialogflow 中查看 BigQuery 專案，必須具備 resourcemanager.projects.get 權限。或者，您也可以指派下列其中一個 Google Cloud 預先定義的角色：roles/browser 或 roles/bigquery.metadataViewer，這些角色具備這項權限，但不需要使用者具備 BigQuery 資料集的存取權。

資料表說明

表格的每個資料列都包含一個對話回合，並包含下列欄位：

欄 類型 說明
project_id STRING 專案 ID。
agent_id STRING 代理人 ID。
conversation_name STRING 工作階段的完整資源名稱。
turn_position INTEGER 對話輪次編號。
request_time TIMESTAMP 對話輪次的時間。
language_code STRING 語言代碼。
要求 JSON 偵測意圖要求。
回應 JSON 偵測意圖回應。
partial_responses JSON 部分回應 (如適用)。
derived_data JSON 這個對話回合中使用的其他中繼資料。
conversation_signals JSON NLU 相關的分析資料。如需 JSON 結構定義，請參閱 ConversationSignals。
bot_answer_feedback JSON 回覆意見回饋 (如果有提供)。

設定

如要設定互動記錄匯出功能，請按照下列步驟操作：

  1. 確認已啟用互動記錄。
  2. 請按照 BigQuery 資料集建立指南建立資料集。請記下資料集名稱，以便在下一個步驟中使用。

  3. 請按照 BigQuery 資料表建立指南建立含有 SQL 結構定義的資料表。請使用下列 SQL 陳述式建立資料表：

    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. 設定代理程式設定，啟用 BigQuery 匯出功能，並提供先前建立的資料集和資料表名稱。

上一頁
Cloud Logging
下一頁
變更記錄