É possível exportar a geração de registros de interação para o BigQuery. Uma vez configurado, toda a geração de registros de interação em tempo real é gravada na sua tabela do BigQuery. Isso fornece ferramentas de análise avançadas que podem ajudar a depurar e melhorar seu agente e descobrir padrões em dados de conversa.
Limitações
Considere as seguintes limitações:
- É possível exportar no máximo 500 curvas 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 no Google Cloud também precisará ter a permissão roles/bigquery.dataEditor
do IAM para o conjunto de dados do BigQuery no projeto do Google Cloud no BigQuery.
Formato da conta de serviço: service-<dialogflow-project-number>@gcp-sa-dialogflow.iam.gserviceaccount.com
Descrição da tabela
Cada linha da tabela contém um turno de 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 de recurso totalmente qualificado para a sessão. |
turn_position | INTEGER | O número da rodada da conversa. |
request_time | TIMESTAMP | O tempo da rodada de conversa. |
language_code | STRING | A tag de idioma. |
request | JSON | A solicitação de detecção de intent. |
resposta | JSON | A resposta de detecção de intent. |
partial_responses | JSON | Respostas parciais, se aplicável. |
derived_data | JSON | Outros metadados para esta conversa. |
conversation_signals | JSON | Dados analíticos relacionados ao PLN. Consulte ConversationSignals do esquema JSON. |
bot_answer_feedback | JSON | Responda ao feedback, se houver. |
Configuração
Para configurar a exportação de registros de interação:
- Verifique se a geração de registros de interação está ativada.
- Siga o guia de criação de conjunto de dados do BigQuery para criar um conjunto de dados. Anote o nome do conjunto de dados, porque você precisará dele na próxima etapa.
Siga o guia de criação de tabelas do BigQuery para criar uma tabela com definição de esquema SQL. Use a seguinte instrução SQL para criação:
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 );
Defina as configurações do agente para ativar o BigQuery Export e fornecer os nomes de conjunto de dados e tabela criados acima.