Puedes exportar el registro de interacciones a BigQuery. Una vez configurado, todo el registro de interacciones en vivo se escribe en tu tabla de BigQuery. Esto te proporciona herramientas de análisis avanzadas que pueden ayudarte a depurar y mejorar tu agente, así como 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
asociado con tu proyecto de Google Cloud de Dialogflow
roles/bigquery.dataEditor
El permiso de IAM 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
El usuario que configura la exportación en Dialogflow debe tener permisos sobre proyecto de BigQuery. De lo contrario, el proyecto de BigQuery no aparecerá como una opción en la consola de Dialogflow.
El permiso mínimo requerido en el proyecto de BigQuery para
el usuario lo vea en Dialogflow es resourcemanager.projects.get
.
Como alternativa, puedes asignar uno de los siguientes roles predefinidos de Google Cloud
que incluyen este permiso, pero que no requieren que el usuario tenga acceso al
Conjunto de datos de BigQuery: roles/browser
o roles/bigquery.metadataViewer
.
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 tiempo del turno de la conversación. |
language_code | STRING | La etiqueta de idioma. |
solicitud | JSON | La solicitud de detección de intent. |
respuesta | JSON | Es la respuesta de detección de intent. |
partial_responses | JSON | Respuestas parciales, si corresponde. |
derived_data | JSON | Son metadatos adicionales para este turno de conversación. |
conversation_signals | JSON | Datos de estadísticas relacionados con la CLN. Consulta ConversationSignals para ver el esquema JSON. |
bot_answer_feedback | JSON | Responde los comentarios si se proporcionan. |
Configuración
Para configurar la exportación de registros de interacción, haz lo siguiente:
- Asegúrate de que el registro de interacciones esté habilitado.
- Sigue la guía de BigQuery guía de creación de conjuntos de datos para crear un conjunto de datos. Toma nota del nombre del conjunto de datos, ya que lo necesitarás en el siguiente paso.
Sigue la guía de BigQuery guía para la creación de tablas para crear una tabla con una definición de esquema de 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 );
Configura tu configuración del agente para habilitar la exportación a BigQuery y proporcionar los nombres del conjunto de datos y de la tabla que creaste anteriormente.