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 atas untuk data percakapan.

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

ConversationInfo

Metadata untuk percakapan.

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

Category

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

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

Entry

Data untuk satu pesan percakapan.

Kolom	Jenis	Deskripsi
text	string	Wajib diisi. Teks untuk pesan percakapan ini.
user_id	integer	Wajib diisi. Angka yang mengidentifikasi peserta percakapan. Setiap peserta harus memiliki satu user_id, yang digunakan berulang kali jika mereka berpartisipasi dalam beberapa percakapan.
role	string	Wajib diisi. Peran peserta percakapan. Salah satu dari: "AGENT", "AUTOMATED_AGENT", "CUSTOMER", "END_USER".
start_timestamp_usec	integer	Wajib diisi. 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
    }
  ]
}