對話資料格式

Customer Experience Insights 會使用您上傳至 Cloud Storage bucket 的對話資料。您可以提供音訊或文字檔案，做為 API 的對話資料。

對話轉錄稿資料

文字檔包含下列詳細資料。

對話

對話資料的頂層物件。

欄位	類型	說明
conversation_info	ConversationInfo { }	選用。對話的中繼資料。
項目	Entry [ ]	這是必要旗標，依時間順序排列的對話訊息。

ConversationInfo

對話的中繼資料。

欄位	類型	說明
類別	類別 [ ]	選用。對話資料的自訂類別。

類別

對話資料類別。如果您提供對話資料的類別，系統會使用這些類別識別對話中的主題。如未提供類別，系統會根據內容自動分類對話。

欄位	類型	說明
display_name	字串	這是必要旗標，類別的顯示名稱。

項目

單一對話訊息的資料。

欄位	類型	說明
文字	字串	這是必要旗標，這則對話訊息的文字。
user_id	整數	這是必要旗標，用於識別對話參與者的號碼。每位參與者都應只有一個 user_id，如果參與多場對話，則應重複使用。
角色	字串	這是必要旗標，對話參與者角色。可為下列其中之一：「AGENT」、「AUTOMATED_AGENT」、「CUSTOMER」、「END_USER」。
start_timestamp_usec	整數	這是必要旗標，這個對話回合的開始時間戳記 (採用世界標準時間，自 Unix Epoch 紀元時間開始算起，以微秒為單位)。

範例

以下是對話資料檔案的範例。

{
  "conversation_info":{
    "categories":[
      {
        "display_name":"Category 1"
      }
    ]
  },
  "entries": [
    {
      "start_timestamp_usec": 1000000,
      "text": "Hello, I'm calling in regards to ...",
      "role": "CUSTOMER",
      "user_id": 1
    },
    {
      "start_timestamp_usec": 5000000,
      "text": "Yes, I can answer your question ...",
      "role": "AGENT",
      "user_id": 2
    }
  ]
}