Puedes exportar el registro de interacciones a BigQuery. Una vez configurado, todo el registro de interacciones en directo se escribe en tu tabla de BigQuery. De esta forma, tendrás herramientas de análisis avanzadas que te ayudarán a depurar y mejorar tu agente, así como a descubrir patrones en los datos de las conversaciones.
Limitaciones
Se aplican las siguientes limitaciones:
- Se pueden exportar un máximo de 500 conversaciones por cada conversación.
Permisos entre proyectos
Si tu agente de Dialogflow y tus datos de BigQuery no están en el mismo proyecto, la cuenta de servicio asociada a tu proyecto de Dialogflow Google Cloud también debe tener el permiso de gestión de identidades y accesos roles/bigquery.dataEditor para el conjunto de datos de BigQuery en tu proyecto de BigQuery Google Cloud .
Formato de la cuenta de servicio: service-<dialogflow-project-number>@gcp-sa-dialogflow.iam.gserviceaccount.com
El usuario que configure la exportación en Dialogflow debe tener permisos en el proyecto de BigQuery. Si no lo hacen, el proyecto de BigQuery no aparecerá como opción en la consola de Dialogflow.
El permiso mínimo necesario en el proyecto de BigQuery para que el usuario lo vea en Dialogflow es resourcemanager.projects.get.
También puede asignar uno de los siguientes Google Cloud roles predefinidos
que incluyen este permiso, pero 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 una 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 | Nombre de recurso completo de la sesión. |
| turn_position | INTEGER | Número de turno de la conversación. |
| request_time | TIMESTAMP | La hora del turno de conversación. |
| language_code | STRING | La etiqueta de idioma. |
| solicitud | JSON | La solicitud de detección de intención. |
| response | JSON | Respuesta de detección de intent. |
| partial_responses | JSON | Respuestas parciales, si procede. |
| derived_data | JSON | Metadatos adicionales de este turno de conversación. |
| conversation_signals | JSON | Datos analíticos relacionados con el procesamiento del lenguaje natural. Consulta el esquema JSON de ConversationSignals. |
| bot_answer_feedback | JSON | Responde a los comentarios, si los hay. |
Configuración
Para configurar la exportación de registros de interacciones, sigue estos pasos:
- Comprueba que el registro de interacciones esté habilitado.
- Sigue la guía para crear conjuntos de datos de BigQuery para crear un conjunto de datos. Anota el nombre del conjunto de datos, ya que lo necesitarás en el siguiente paso.
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 SQL para crearla:
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 los ajustes del agente para habilitar la exportación a BigQuery y proporcionar los nombres del conjunto de datos y de la tabla que has creado anteriormente.