Formato dei dati delle conversazioni

Customer Experience Insights utilizza i dati delle conversazioni che carichi in un bucket Cloud Storage. Puoi fornire i dati della conversazione all'API come file audio o di testo.

Dati della trascrizione della conversazione

I file di testo includono i seguenti dettagli.

Conversazione

L'oggetto di primo livello per i dati delle conversazioni.

Campo	Tipo	Descrizione
conversation_info	ConversationInfo { }	Facoltativo. Metadati della conversazione.
entries	Entry [ ]	Obbligatorio. I messaggi della conversazione in ordine cronologico.

ConversationInfo

I metadati di una conversazione.

Campo	Tipo	Descrizione
categorie	Categoria [ ]	Facoltativo. Categorie personalizzate per i dati delle conversazioni.

Categoria

Categoria di dati conversazione. Se fornisci categorie con i dati delle conversazioni, queste verranno utilizzate per identificare gli argomenti delle conversazioni. Se non fornisci categorie, il sistema categorizzerà automaticamente le conversazioni in base ai contenuti.

Campo	Tipo	Descrizione
display_name	string	Obbligatorio. Un nome visualizzato per la categoria.

Voce

Dati per un singolo messaggio di conversazione.

Campo	Tipo	Descrizione
testo	string	Obbligatorio. Il testo di questo messaggio della conversazione.
user_id	integer	Obbligatorio. Un numero che identifica il partecipante alla conversazione. Ogni partecipante deve avere un unico user_id, da utilizzare ripetutamente se partecipa a più conversazioni.
ruolo	string	Obbligatorio. Il ruolo di partecipante alla conversazione. Uno tra i seguenti: "AGENT", "AUTOMATED_AGENT", "CUSTOMER", "END_USER".
start_timestamp_usec	integer	Obbligatorio. Il timestamp dell'inizio di questo turno di conversazione in microsecondi di tempo UTC dall'epoca Unix.

Esempio

Di seguito è riportato un esempio di file di dati delle conversazioni.

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