A API Conversational Analytics é uma ferramenta poderosa que lhe permite consultar os seus dados através de linguagem natural. Esta página fornece orientações sobre como formatar perguntas eficazes para obter o resultado ideal. Esta página inclui práticas recomendadas para as seguintes ações:
- Fazer perguntas gerais
- Faça perguntas com várias partes para análises mais complexas
- Faça perguntas com condições de dados
- Peça a agregação de dados
- Faça perguntas de seguimento
- Peça resultados formatados
Fazer perguntas gerais
Quando fizer perguntas gerais, seja específico e forneça contexto. Em vez de fazer perguntas gerais, restrinja o âmbito incluindo detalhes relevantes, como datas, categorias específicas ou filtros numéricos.
Exemplo
Pergunta original: "Quantas faturas são criadas manual e sistematicamente todos os anos?"
Pergunta refinada: "Indica o número de faturas criadas manual e sistematicamente a cada ano. Partindo do princípio de que demora 15 minutos a criar 1 fatura manual, calcule e forneça também um resumo do tempo total gasto em horas no processamento de todas as faturas manuais."
Por que motivo isto 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 as 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 de processamento médio em dias do dinheiro no momento da entrega e da compensação de pagamentos para cada tipo de valor a receber (PHA, reembolso de cooperação, cartão de crédito, meios de comunicação de retalho) e qual é a percentagem destes que são compensações manuais? Supondo que gastamos 15 minutos para cada valor a receber liquidado manualmente, quanto tempo gastamos na app de caixa e na liquidação de cada tipo de valor a receber por ano?"
Pergunta refinada, parte 1: "Qual é o tempo de processamento médio em dias para cada tipo de contas a receber entre 05/05/2025 e 01/06/2025?"
Pergunta refinada, parte 2: "Qual é a percentagem de compensações que são compensações manuais entre 05/05/2025 e 01/06/2025 para cada tipo de contas a receber?"
Pergunta refinada, parte 3: "Supondo que gastamos 15 minutos para cada valor a receber liquidado manualmente, quanto tempo estamos a gastar na app de caixa e na compensação para cada tipo de valor a receber por ano?"
Por que motivo isto funciona: fazer as perguntas separadamente permite que a API Conversational Analytics aborde cada métrica específica (tempo de processamento médio, percentagem de limpezas manuais, tempo total gasto) com os filtros adequados, para um resultado mais preciso.
Faça perguntas com condições de dados
Quando faz perguntas com condições de dados, indique claramente todos os filtros e condições necessários na pergunta, incluindo datas exatas, limites de números e categorias específicas. Certifique-se de que a API Conversational Analytics aplica os filtros corretos (intervalos de datas, principais N resultados, categorias específicas, por exemplo).
Exemplos
As seguintes perguntas especificam corretamente os critérios de filtro:
"Mostra-me a data de emissão da fatura de 02/05/2025 a 03/06/2025, juntamente com a respetiva idade média das faturas pendentes apenas." Esta pergunta especifica claramente o intervalo de datas.
"Indica o nome do cliente, a soma do saldo em dívida, a idade média e o tipo de contas a receber dos registos com mais de 46 dias. Limitar os resultados a um máximo de 5 registos por saldo em dívida." Esta pergunta especifica a idade do registo, fornece um limite e indica os requisitos de ordenação.
"Indica as principais indústrias por valor de variação nos saldos a receber de clientes, juntamente com os valores para o 1.º semestre de 2025 em comparação com o final do ano anterior." Esta pergunta especifica as "principais indústrias" e os períodos para comparação.
Pedir agregação de dados
Quando faz perguntas para agregar dados, especifique o tipo de agregação (por exemplo, "soma do saldo em dívida" ou "idade média") e as dimensões pelas quais quer agregar (por exemplo, "nome do cliente", "tipo de valor a receber" ou "setor").
Exemplo
A seguinte pergunta especifica eficazmente requisitos claros para a agregação de dados:
"Indica o nome do cliente, a soma do saldo em dívida, a idade média e o tipo de contas a receber dos registos com antiguidade superior a 46 dias."
Faça perguntas de seguimento
Quando faz uma pergunta de seguimento, refere-se ao contexto estabelecido anteriormente, mas seja explícito sobre as alterações ou as adições. Por exemplo, se quiser alterar um intervalo de datas ou um limite, indique claramente os novos parâmetros.
Exemplos
Pergunta original: "Indica o nome do cliente, a soma do saldo em dívida, a idade média e o tipo de contas a receber dos registos com antiguidade superior a 46 dias. Limitar os resultados a um máximo de 5 registos por saldo em dívida."
Pergunta de seguimento: "Fornece as métricas anteriores para registos com mais de 90 dias e limita-te aos 10 principais registos."
Por que motivo isto funciona: a pergunta de seguimento especifica claramente as alterações ao filtro "com idade superior a" e ao limite de resultados, ao mesmo tempo que faz referência às mesmas métricas da pergunta anterior para contexto.
Pedir resultados formatados
Quando 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-chave fornecidos na pergunta.
Pode orientar a API Conversational Analytics para fornecer resultados nos seguintes formatos, incluindo termos-chave na sua pergunta:
Oriente a API Conversational Analytics para devolver resultados numa tabela
A seguinte pergunta implica que os resultados devem ser devolvidos num formato de tabela, porque especifica os nomes das colunas de dimensões e métricas:
"Indica o nome do cliente, a soma do saldo em dívida, a idade média e o tipo de contas a receber dos registos com antiguidade superior a 46 dias."
Oriente a API Conversational Analytics para devolver resultados como texto
A utilização de termos-chave, como "resumo", ou a colocação de uma pergunta que apenas exija uma resposta direta, orienta a API Conversational Analytics para fornecer resultados como texto.
As seguintes perguntas implicam que os resultados devem ser devolvidos num resultado de texto:
"Calcula e fornece um resumo do tempo total gasto em horas no processamento de todas as faturas manuais."
"Qual é o tempo total necessário para processar faturas manuais na semana passada?"
Oriente a API Conversational Analytics para devolver resultados como um gráfico de linhas
A utilização de termos-chave, como "tendência", "alteração" ou "alteração delta" numa pergunta orienta a API Conversational Analytics para fornecer resultados como um gráfico de linhas.
As seguintes perguntas implicam que os resultados devem ser devolvidos como um gráfico de linhas:
"Qual é a tendência mensal dos saldos finais de cada setor em 2024."
"Qual é a alteração diária da diferença na idade média das faturas pendentes para o dia em relação ao dia anterior entre 02/05/2025 e 03/06/2025?"
Oriente a API Conversational Analytics para devolver resultados como um gráfico de barras ou de comparação
A utilização de termos-chave, como "comparar" e "variação", orienta a API Conversational Analytics para fornecer resultados como um gráfico de barras ou de comparação.
A seguinte pergunta implica que os resultados devem ser devolvidos como um gráfico de barras ou de comparação:
"Indica as principais indústrias por valor de variação nos saldos a receber de clientes, juntamente com os valores para o 1.º semestre de 2025, em comparação com o final do ano anterior."
Os resultados desta pergunta são apresentados como um gráfico de barras que apresenta a variação para cada setor.
Recursos adicionais
Para ver sugestões de resolução de problemas adicionais 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 Resolva problemas de erros da API Conversational Analytics.