API Conversational Analytics: faça perguntas úteis

A API Análises de conversação é uma ferramenta poderosa que permite consultar seus dados usando linguagem natural. Esta página oferece orientações sobre como formatar perguntas eficazes para a saída ideal. Ela inclui práticas recomendadas para as seguintes ações:

Fazer perguntas gerais

Ao fazer perguntas gerais, seja específico e forneça contexto. Em vez de perguntas amplas, restrinja o escopo incluindo detalhes relevantes, como datas, categorias específicas ou filtros numéricos.

Um agente de dados que usa uma fonte de dados do Looker pode fazer perguntas complementares para esclarecer ambiguidades na consulta original. Por exemplo, se houver vários campos com nomes semelhantes, o agente de dados poderá pedir que você esclareça qual campo é mais adequado para usar no processamento da consulta. Essas perguntas vão aparecer em uma resposta Esclarecimento necessário.

Exemplo

Pergunta original: "Quantas faturas são criadas manual e sistematicamente a cada ano?"

Pergunta refinada: "Forneça uma contagem de faturas criadas manual e sistematicamente a cada ano. Supondo que leve 15 minutos para criar uma fatura manual, calcule e forneça um resumo do tempo total gasto em horas para processar todas as faturas manuais."

Por que isso funciona: a pergunta refinada adiciona um requisito de cálculo específico (tempo gasto em faturas manuais) e especifica um formato de saída, um resumo.

Fazer perguntas em várias partes para análises mais complexas

Divida perguntas complexas em várias partes para ajudar a API de Análises de conversação a processar cada componente com precisão.

Exemplo

Pergunta original: "Qual é o tempo médio de resposta em dias do dinheiro na entrega e da compensação de pagamento para cada tipo de recebível (PHA, co-op, cartão de crédito, mídia de varejo) e qual porcentagem deles são compensações manuais? Supondo que gastemos 15 minutos para cada recebível compensado manualmente, quanto tempo gastamos no app de dinheiro e na compensação de cada tipo de recebível por ano?"

Pergunta refinada, parte 1: "Qual é o tempo médio de resposta em dias para cada tipo de recebível entre 05/05/2025 e 01/06/2025?"

Pergunta refinada, parte 2: "Qual é a porcentagem de compensações manuais entre 05/05/2025 e 01/06/2025 para cada tipo de recebível?"

Pergunta refinada, parte 3: "Supondo que gastemos 15 minutos para cada recebível compensado manualmente, quanto tempo gastamos no app de dinheiro e na compensação de cada tipo de recebível por ano?"

Por que isso funciona: fazer as perguntas separadamente permite que a API Análises de conversação aborde cada métrica específica (tempo médio de resposta, porcentagem de compensações manuais, tempo total gasto) com os filtros adequados, para um resultado mais preciso.

Fazer perguntas com condições de dados

Ao fazer perguntas com condições de dados, declare claramente todos os filtros e condições necessários na pergunta, incluindo datas exatas, limites de números e categorias específicas. Verifique se a API Análises de conversação aplica os filtros corretos (intervalos de datas, principais resultados N, categorias específicas, por exemplo).

Exemplos

As perguntas a seguir especificam corretamente os critérios de filtro:

  • "Mostre a data da fatura de 02/05/2025 a 03/06/2025, juntamente com a idade média das faturas em aberto." Essa pergunta especifica claramente o período.

  • "Forneça o nome do cliente, a soma do saldo em aberto, a idade média e o tipo de recebível para os registros com mais de 46 dias. Limite os resultados a até 5 registros por saldo em aberto." Essa pergunta especifica a idade do registro, fornece um limite e requisitos de classificação.

  • Forneça os principais setores por valor de variação nos saldos de recebíveis de clientes, juntamente com os valores do 2025FP1 em comparação com o final do ano anterior. Essa pergunta especifica "principais setores" e os períodos de comparação.

Pedir agregação de dados

Ao fazer perguntas para agregar dados, especifique o tipo de agregação (por exemplo, "soma do saldo em aberto" ou "idade média") e as dimensões que você quer agregar (por exemplo, "nome do cliente", "tipo de recebível" ou "setor").

Exemplo

A pergunta a seguir especifica requisitos claros para agregação de dados:

"Forneça o nome do cliente, a soma do saldo em aberto, a idade média e o tipo de recebível para os registros com mais de 46 dias."

Fazer perguntas complementares

Ao fazer uma pergunta complementar, consulte o contexto estabelecido anteriormente, mas seja explícito sobre mudanças ou adições. Por exemplo, se você quiser mudar um período ou um limite, declare claramente os novos parâmetros.

Exemplos

Pergunta original: "Forneça o nome do cliente, a soma do saldo em aberto, a idade média e o tipo de recebível para os registros com mais de 46 dias. Limite os resultados a até 5 registros por saldo em aberto."

Pergunta complementar: "Forneça as métricas anteriores para registros com mais de 90 dias e limite até os 10 principais registros."

Por que isso funciona: a pergunta complementar especifica claramente as mudanças no filtro "com mais de" e no limite de resultados, ao mesmo tempo em que faz referência às mesmas métricas da pergunta anterior para contexto.

Pedir resultados formatados

Quando você faz uma pergunta que não especifica um formato de resultados, a API Análises de conversação determina o formato mais adequado aos critérios específicos e aos termos principais fornecidos na pergunta.

Você pode orientar a API Análises de conversação a fornecer resultados nos seguintes formatos, incluindo termos principais na pergunta:

Orientar a API Análises de conversação a retornar resultados em uma tabela

A pergunta a seguir implica que os resultados devem ser retornados em formato de tabela, porque especifica nomes de colunas de dimensão e métrica:

"Forneça o nome do cliente, a soma do saldo em aberto, a idade média e o tipo de recebível para os registros com mais de 46 dias."

Orientar a API Análises de conversação a retornar resultados como texto

Usar termos principais, como "resumo", ou fazer uma pergunta que exija apenas uma resposta direta, orienta a API Análises de conversação a fornecer resultados como texto.

As perguntas a seguir implicam que os resultados devem ser retornados em uma saída de texto:

  • "Calcule e forneça um resumo do tempo total gasto em horas para processar todas as faturas manuais."

  • "Qual é o tempo total gasto para processar faturas manuais na semana passada?"

Orientar a API Análises de conversação a retornar resultados como um gráfico de linhas

Usar termos principais, como "tendência", "mudança" ou "variação delta", em uma pergunta orienta a API Análises de conversação a fornecer resultados como um gráfico de linhas.

As perguntas a seguir implicam que os resultados devem ser retornados como um gráfico de linhas:

  • "Qual é a tendência mensal de saldos finais para cada setor no ano de 2024?"

  • "Qual é a variação delta diária na idade média das faturas em aberto para o dia em relação ao dia anterior entre 02/05/2025 e 03/06/2025?"

Orientar a API Análises de conversação a retornar resultados como um gráfico de barras ou de comparação

Usar termos principais, como "comparar" e "variância", orienta a API Análises de conversação a fornecer resultados como um gráfico de barras ou de comparação.

A pergunta a seguir implica que os resultados devem ser retornados como um gráfico de barras ou de comparação:

Forneça os principais setores por valor de variação nos saldos de recebíveis de clientes, juntamente com os valores do 2025FP1 em comparação com o final do ano anterior.

Os resultados dessa pergunta serão retornados como um gráfico de barras que mostra a variação de cada setor.

Outros recursos

Para mais dicas de solução de problemas e respostas a perguntas frequentes, consulte a página Perguntas frequentes sobre a API Análises de conversação.

Para mais informações sobre erros de API e possíveis soluções, consulte o guia Solucionar problemas de erros da API Análises de conversação.