Formato de datos de conversación

Customer Experience Insights usa los datos de conversaciones que subes a un bucket de Cloud Storage. Puedes proporcionar tus datos de conversación a la API como archivos de audio o texto.

Datos de transcripción de conversaciones

Tus archivos de texto incluyen los siguientes detalles.

Conversación

Es el objeto de nivel superior para los datos de conversación.

Campo	Tipo	Descripción
conversation_info	ConversationInfo { }	Es opcional. Son los metadatos de la conversación.
entradas	Entrada [ ]	Obligatorio. Son los mensajes de la conversación ordenados cronológicamente.

ConversationInfo

Son los metadatos de una conversación.

Campo	Tipo	Descripción
categories	Categoría [ ]	Es opcional. Son categorías personalizadas para los datos de la conversación.

Categoría

Es la categoría de datos de conversación. Si proporcionas categorías con tus datos de conversación, se usarán para identificar temas en tus conversaciones. Si no proporcionas categorías, el sistema categorizará automáticamente las conversaciones según el contenido.

Campo	Tipo	Descripción
display_name	cadena	Obligatorio. Es el nombre visible de la categoría.

Entrada

Son los datos de un solo mensaje de conversación.

Campo	Tipo	Descripción
texto	cadena	Obligatorio. Es el texto de este mensaje de conversación.
user_id	integer	Obligatorio. Número que identifica al participante de la conversación. Cada participante debe tener un solo user_id, que se usará repetidamente si participa en varias conversaciones.
rol	cadena	Obligatorio. Es el rol del participante de la conversación. Puede ser uno de los siguientes: "AGENT", "AUTOMATED_AGENT", "CUSTOMER" o "END_USER".
start_timestamp_usec	integer	Obligatorio. Es la marca de tiempo del inicio de este turno de conversación en microsegundos de la hora UTC desde la época de Unix.

Ejemplo

A continuación, se muestra un ejemplo de un archivo de datos de conversación.

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