Exportación de registros de interacción a BigQuery

Puedes exportar el registro de interacción a BigQuery. Una vez configurado, todo el registro de interacción en vivo se escribe en tu tabla de BigQuery. Esto te proporciona herramientas de análisis avanzado que pueden ayudarte a depurar y mejorar tu agente, y a descubrir patrones en los datos de conversación.

Limitaciones

Se aplica la siguiente limitación:

  • Se puede exportar un máximo de 500 turnos para cada conversación.

Permisos entre proyectos

Si tu agente de Dialogflow y los datos de BigQuery no están en el mismo proyecto, la cuenta de servicio asociada con tu proyecto de Google Cloud de Dialogflow debe tener el permiso de IAM roles/bigquery.dataEditor para el conjunto de datos de BigQuery en tu proyecto de Google Cloud de BigQuery.

Formato de la cuenta de servicio: service-<dialogflow-project-number>@gcp-sa-dialogflow.iam.gserviceaccount.com

Descripción de la tabla

Cada fila de la tabla contiene un turno de conversación con las siguientes columnas:

Columna Tipo Descripción
project_id STRING El ID del proyecto.
agent_id STRING El ID del agente.
conversation_name STRING El nombre del recurso completamente calificado para la sesión.
turn_position INTEGER El número de turno de la conversación.
request_time TIMESTAMP El momento del turno de la conversación.
language_code STRING Es la etiqueta de idioma.
solicitud JSON La solicitud de detección de intent.
respuesta JSON La respuesta de detección de intent.
partial_responses JSON Respuestas parciales, si corresponde.
derived_data JSON Metadatos adicionales para este turno de conversación.
conversation_signals JSON Datos de estadísticas relacionados con CLN. Consulta ConversationSignals, para obtener el esquema JSON.
bot_answer_feedback JSON Si se proporcionan, responde los comentarios.

Configuración

Para configurar la exportación del registro de interacción, haz lo siguiente:

  1. Asegúrate de que el registro de interacciones esté habilitado.
  2. Sigue la guía de creación de conjuntos de datos de BigQuery para crear un conjunto de datos. Toma nota del nombre del conjunto de datos, ya que lo necesitarás en el siguiente paso.
  3. Sigue la guía de creación de tablas de BigQuery para crear una tabla con una definición de esquema SQL. Usa la siguiente instrucción de SQL para la creación:

    CREATE TABLE <your_dataset_name>.dialogflow_bigquery_export_data(
      project_id STRING,
      agent_id STRING,
      conversation_name STRING,
      turn_position INTEGER,
      request_time TIMESTAMP,
      language_code STRING,
      request JSON,
      response JSON,
      partial_responses JSON,
      derived_data JSON,
      conversation_signals JSON,
      bot_answer_feedback JSON
    );
    
  4. Establece la configuración del agente para habilitar la exportación a BigQuery y proporcionar los nombres de conjuntos de datos y tablas creados anteriormente.