Alguns produtos e recursos estão sendo renomeados. Os recursos de playbook generativo e de fluxo também estão sendo migrados para um único console consolidado. Confira os detalhes.
Exportação de registros de interação para o BigQuery
Mantenha tudo organizado com as coleções
Salve e categorize o conteúdo com base nas suas preferências.
É possível exportar os registros de interação para o BigQuery.
Depois de configurado, todo o registro de interação em tempo real é gravado na tabela do BigQuery.
Isso oferece ferramentas de análise avançadas
que podem ajudar a depurar e melhorar o agente
e descobrir padrões nos dados de conversa.
Limitações
Considere as seguintes limitações:
É possível exportar no máximo 500 turnos para cada conversa.
Permissões entre projetos
Se o agente do Dialogflow e os dados do BigQuery não estiverem no mesmo projeto, a conta de serviço associada ao projeto do Dialogflow Google Cloud também precisará ter a permissão roles/bigquery.dataEditor do IAM para o conjunto de dados do BigQuery no projeto do BigQuery Google Cloud .
Formato da conta de serviço: service-<dialogflow-project-number>@gcp-sa-dialogflow.iam.gserviceaccount.com
O usuário que configura a exportação no Dialogflow precisa ter permissões no projeto do BigQuery. Caso contrário, o projeto do BigQuery não vai aparecer como uma opção no console do Dialogflow.
A permissão mínima necessária no projeto do BigQuery para que o usuário possa acessá-lo no Dialogflow é resourcemanager.projects.get.
Como alternativa, atribua um dos papéis predefinidos Google Cloud a seguir que incluem essa permissão, mas não exigem que o usuário tenha acesso ao conjunto de dados do BigQuery: roles/browser ou roles/bigquery.metadataViewer.
Descrição da tabela
Cada linha da tabela contém uma vez na conversa
com as seguintes colunas:
Coluna
Tipo
Descrição
project_id
STRING
O código do projeto.
agent_id
STRING
O ID do agente.
conversation_name
STRING
O nome do recurso totalmente qualificado para a sessão.
Siga o guia de criação de conjuntos de dados do BigQuery para criar um conjunto de dados.
Anote o nome do conjunto de dados, porque você vai precisar dele na próxima etapa.
Siga o guia de criação de tabelas do BigQuery para criar uma tabela com uma definição de esquema SQL.
Use a seguinte instrução SQL para criação:
[[["Fácil de entender","easyToUnderstand","thumb-up"],["Meu problema foi resolvido","solvedMyProblem","thumb-up"],["Outro","otherUp","thumb-up"]],[["Difícil de entender","hardToUnderstand","thumb-down"],["Informações incorretas ou exemplo de código","incorrectInformationOrSampleCode","thumb-down"],["Não contém as informações/amostras de que eu preciso","missingTheInformationSamplesINeed","thumb-down"],["Problema na tradução","translationIssue","thumb-down"],["Outro","otherDown","thumb-down"]],["Última atualização 2025-08-18 UTC."],[[["\u003cp\u003eDialogflow interaction logs can be exported to BigQuery, enabling advanced analysis for debugging, agent improvement, and identifying conversation patterns.\u003c/p\u003e\n"],["\u003cp\u003eA maximum of 500 turns per conversation can be exported, and if the Dialogflow agent and BigQuery data are in different projects, the Dialogflow service account needs \u003ccode\u003eroles/bigquery.dataEditor\u003c/code\u003e permission on the BigQuery dataset.\u003c/p\u003e\n"],["\u003cp\u003eEach row in the exported BigQuery table represents a single conversational turn and contains columns such as project ID, agent ID, conversation name, turn number, request/response details, and additional metadata.\u003c/p\u003e\n"],["\u003cp\u003eTo configure the export, interaction logging must be enabled, a BigQuery dataset and table must be created using the provided SQL schema, and the agent settings must be updated with the dataset and table names.\u003c/p\u003e\n"],["\u003cp\u003eUsers configuring the export must have permissions on the BigQuery project, with the minimum being \u003ccode\u003eresourcemanager.projects.get\u003c/code\u003e or one of the roles \u003ccode\u003eroles/browser\u003c/code\u003e or \u003ccode\u003eroles/bigquery.metadataViewer\u003c/code\u003e.\u003c/p\u003e\n"]]],[],null,["# Interaction logging export to BigQuery\n\nYou can export\n[interaction logging](/dialogflow/cx/docs/concept/agent-settings#settings-general)\nto\n[BigQuery](/bigquery/docs).\nOnce configured, all live interaction logging is written\nto your BigQuery table.\nThis provides you with advanced analysis tools\nthat can help you debug and improve your agent\nand to discover patterns in conversation data.\n\nLimitations\n-----------\n\nThe following limitations apply:\n\n- A maximum of 500 turns can be exported for each conversation.\n\nCross project permissions\n-------------------------\n\nIf your Dialogflow agent and BigQuery data are not in the\nsame project, the [service account](/dialogflow/cx/docs/quick/setup#sa)\nassociated with your Dialogflow Google Cloud project must also have the\n`roles/bigquery.dataEditor` IAM permission for the BigQuery dataset in\nyour BigQuery Google Cloud project.\n\nService account format: `service-\u003cdialogflow-project-number\u003e@gcp-sa-dialogflow.iam.gserviceaccount.com`\n\nThe user configuring the export in Dialogflow must have permissions on\nthe BigQuery project. If they don't, the BigQuery project\nwon't appear as an option in the Dialogflow Console.\n\nThe minimum permission required on the BigQuery project in order for\nthe user to see it in Dialogflow is `resourcemanager.projects.get`.\nAlternatively, you can assign one of the following Google Cloud predefined roles\nthat include this permission but don't require the user to have access to the\nBigQuery dataset: `roles/browser` or `roles/bigquery.metadataViewer`.\n\nTable description\n-----------------\n\nEach row of the table contains one conversational turn\nwith the following columns:\n\nConfiguration\n-------------\n\nTo configure interaction logging export:\n\n1. Ensure that [interaction logging](/dialogflow/cx/docs/concept/agent-settings#settings-general) is enabled.\n2. Follow the BigQuery [dataset creation guide](/bigquery/docs/datasets#create-dataset) to create a dataset. Note the dataset name, as you will need this in the next step.\n3. Follow the BigQuery\n [table creation guide](/bigquery/docs/tables)\n to create a table with a SQL schema definition.\n Use the following SQL statement for creation:\n\n CREATE TABLE \u003cyour_dataset_name\u003e.dialogflow_bigquery_export_data(\n project_id STRING,\n agent_id STRING,\n conversation_name STRING,\n turn_position INTEGER,\n request_time TIMESTAMP,\n language_code STRING,\n request JSON,\n response JSON,\n partial_responses JSON,\n derived_data JSON,\n conversation_signals JSON,\n bot_answer_feedback JSON\n );\n\n4. Configure your\n [agent settings](/dialogflow/cx/docs/concept/agent-settings#settings-general)\n to enable BigQuery export, and to provide the dataset and table names\n created above.\n\n | **Note:** If your agent is protected by a Customer Managed Encryption Key (CMEK), you will see a warning if the destination BigQuery table is not protected by CMEK."]]
