API Conversational Analytics: faça perguntas úteis

A API Conversational Analytics é uma ferramenta eficiente que permite consultar seus dados usando linguagem natural. Esta página fornece orientações sobre como formatar perguntas eficazes para ter a saída ideal. Esta página 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, inclua detalhes relevantes, como datas, categorias específicas ou filtros numéricos, para restringir o escopo.

Exemplo

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

Pergunta refinada: "Forneça uma contagem de faturas criadas manualmente e sistematicamente a cada ano. Supondo que leva 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.

Faça perguntas com várias partes para análises mais complexas

Divida perguntas complexas em várias partes para ajudar a API Conversational Analytics a processar cada componente com precisão.

Exemplo

Pergunta original: "Qual é o tempo médio de resposta em dias do pagamento na entrega e da compensação de pagamento para cada tipo de recebível (PHA, desconto cooperativo, cartão de crédito, mídia de varejo) e qual é a porcentagem de compensações manuais? Supondo que gastemos 15 minutos para cada recebível liquidado manualmente, quanto tempo gastamos no app de caixa e na liquidaçã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: "Considerando que gastamos 15 minutos para cada recebível compensado manualmente, quanto tempo gastamos no app de caixa e na compensação de cada tipo de recebível por ano?"

Por que isso funciona: fazer as perguntas separadamente permite que a API Conversational Analytics aborde cada métrica específica (tempo médio de resposta, porcentagem de liberaçõ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 sua pergunta, incluindo datas exatas, limites de números e categorias específicas. Verifique se a API Conversational Analytics aplica os filtros corretos (intervalos de datas, principais N resultados, categorias específicas etc.).

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, junto 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 pendente, a idade média e o tipo de recebível dos registros com mais de 46 dias. Limite os resultados a até cinco registros por saldo pendente". Essa pergunta especifica a idade do registro, fornece um limite e requisitos de classificação.

  • "Apresente os principais setores por valor de variância nos saldos de contas a receber dos clientes, além dos valores para 2025FP1 em comparação com o final do ano anterior." Essa pergunta especifica "principais setores" e os períodos para comparação.

Pedir agregação de dados

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

Exemplo

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

"Forneça o nome do cliente, a soma do saldo pendente, 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, faça referência ao 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, informe claramente os novos parâmetros.

Exemplos

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

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 idade superior a" 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 Conversational Analytics determina o formato mais adequado aos critérios específicos e aos termos principais fornecidos na pergunta.

Você pode orientar a API Conversational Analytics a fornecer resultados nos seguintes formatos incluindo termos-chave na sua pergunta:

Orientar a API Conversational Analytics para 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 pendente, a idade média e o tipo de recebível para os registros com mais de 46 dias."

Orientar a API Conversational Analytics para retornar resultados como texto

Usar termos-chave como "resumo" ou fazer uma pergunta que só exige uma resposta direta orienta a API Conversational Analytics 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 Conversational Analytics para retornar resultados como um gráfico de linhas

Usar termos-chave como "tendência", "mudança" ou "mudança delta" em uma pergunta orienta a API Conversational Analytics 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 dos saldos finais de cada setor em 2024?"

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

Instruir a API Conversational Analytics a retornar resultados como um gráfico de barras ou de comparação

Usar termos-chave como "comparar" e "variância" orienta a API Conversational Analytics 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:

"Informe os principais setores por valor de variância nos saldos de contas a receber dos clientes, além dos valores para o 1º semestre de 2025 em comparação com o fim do ano anterior."

Os resultados dessa pergunta serão retornados como um gráfico de barras que mostra a variância 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 Conversational Analytics.

Para mais informações sobre erros da API e possíveis soluções, consulte o guia Resolver erros da API Conversational Analytics.