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 conversaciones a la API como archivos de audio o de 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 conversaciones.

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

ConversationInfo

Son los metadatos de una conversación.

Campo	Tipo	Descripción
categories	Category [ ]	Es opcional. Son las categorías personalizadas para los datos de conversaciones.

Categoría

Es la categoría de datos de conversaciones. Si proporcionas categorías con tus datos de conversaciones, 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	string	Obligatorio. Es un nombre visible para la categoría.

Entry

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

Campo	Tipo	Descripción
texto	string	Obligatorio. Es el texto de este mensaje de conversación.
user_id	integer	Obligatorio. Es un número que identifica al participante de la conversación. Cada participante debe tener un solo user_id, que se usa de forma repetida si participa en varias conversaciones.
rol	string	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 el ciclo de entrenamiento de Unix.

Ejemplo

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

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