Pode exportar o registo de interações para o BigQuery. Depois de configurado, todo o registo de interações em direto é escrito na sua tabela do BigQuery. Isto oferece-lhe ferramentas de análise avançadas que podem ajudar a depurar e melhorar o seu agente e a descobrir padrões nos dados de conversas.
Limitações
Aplicam-se as seguintes limitações:
- Pode exportar um máximo de 500 turnos para cada conversa.
Autorizações entre projetos
Se o seu agente do Dialogflow e os dados do BigQuery não estiverem no mesmo projeto, a conta de serviço associada ao seu projeto do Dialogflow Google Cloud também tem de ter a autorização de IAM roles/bigquery.dataEditor para o conjunto de dados do BigQuery no seu projeto do BigQuery Google Cloud .
Formato da conta de serviço: service-<dialogflow-project-number>@gcp-sa-dialogflow.iam.gserviceaccount.com
O utilizador que configura a exportação no Dialogflow tem de ter autorizações no projeto do BigQuery. Caso contrário, o projeto do BigQuery não aparece como uma opção na consola do Dialogflow.
A autorização mínima necessária no projeto do BigQuery para que o utilizador o veja no Dialogflow é resourcemanager.projects.get.
Em alternativa, pode atribuir uma das seguintes Google Cloud funções predefinidasroles/browser que incluem esta autorização, mas não exigem que o utilizador tenha acesso ao conjunto de dados do BigQuery: roles/bigquery.metadataViewer ou.
Descrição da tabela
Cada linha da tabela contém uma interação de conversa com as seguintes colunas:
| Coluna | Tipo | Descrição |
|---|---|---|
| project_id | STRING | O ID do projeto. |
| agent_id | STRING | O ID do agente. |
| conversation_name | STRING | O nome do recurso totalmente qualificado para a sessão. |
| turn_position | INTEGER | O número da interação da conversa. |
| request_time | TIMESTAMP | A hora da interação conversacional. |
| language_code | STRING | A etiqueta de idioma. |
| pedido | JSON | O pedido de deteção de intenção. |
| resposta | JSON | A resposta de deteção de intenção. |
| partial_responses | JSON | Respostas parciais, se aplicável. |
| derived_data | JSON | Metadados adicionais para esta interação conversacional. |
| conversation_signals | JSON | Dados de estatísticas relacionados com a NLU. Consulte ConversationSignals para ver o esquema JSON. |
| bot_answer_feedback | JSON | Responda ao feedback, se fornecido. |
Configuração
Para configurar a exportação de registo de interações:
- Certifique-se de que o registo de interações está ativado.
- Siga o guia de criação de conjuntos de dados do BigQuery para criar um conjunto de dados. Tome nota do nome do conjunto de dados, pois vai precisar dele no passo seguinte.
Siga o guia de criação de tabelas do BigQuery para criar uma tabela com uma definição de esquema SQL. Use a seguinte declaração SQL para a 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 );Configure as definições do agente para ativar o BigQuery Export e fornecer os nomes do conjunto de dados e da tabela criados acima.