Format data percakapan

Customer Experience Insights menggunakan data percakapan yang Anda upload ke bucket Cloud Storage. Anda dapat memberikan data percakapan ke API sebagai file audio atau teks.

Data transkrip percakapan

File teks Anda mencakup detail berikut.

Percakapan

Objek tingkat teratas untuk data percakapan.

Kolom	Jenis	Deskripsi
conversation_info	ConversationInfo { }	Opsional. Metadata untuk percakapan.
entries	Entri [ ]	Wajib. Pesan percakapan yang diurutkan secara kronologis.

ConversationInfo

Metadata untuk percakapan.

Kolom	Jenis	Deskripsi
kategori	Kategori [ ]	Opsional. Kategori kustom untuk data percakapan.

Kategori

Kategori data percakapan. Jika Anda memberikan kategori dengan data percakapan Anda, kategori tersebut akan digunakan untuk mengidentifikasi topik dalam percakapan Anda. Jika Anda tidak memberikan kategori, sistem akan otomatis mengategorikan percakapan berdasarkan kontennya.

Kolom	Jenis	Deskripsi
display_name	string	Wajib. Nama tampilan untuk kategori.

Entri

Data untuk satu pesan percakapan.

Kolom	Jenis	Deskripsi
teks biasa	string	Wajib. Teks untuk pesan percakapan ini.
user_id	integer	Wajib. Angka yang mengidentifikasi peserta percakapan. Setiap peserta harus memiliki satu user_id, yang digunakan berulang kali jika mereka berpartisipasi dalam beberapa percakapan.
peran	string	Wajib. Peran peserta percakapan. Salah satu dari: "AGENT", "AUTOMATED_AGENT", "CUSTOMER", "END_USER".
start_timestamp_usec	integer	Wajib. Stempel waktu untuk awal giliran percakapan ini dalam mikrodetik waktu UTC sejak epoch Unix.

Contoh

Berikut ini contoh file data percakapan.

{
  "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
    }
  ]
}