openthorDocumentação

Refinar e continuar a conversa

A primeira resposta raramente é a última pergunta. O assistente lembra o contexto da conversa — aproveite: comece amplo e vá afunilando, como quem confere o romaneio antes de abrir caixa por caixa. O diálogo abaixo é fictício, da Distribuidora Modelo Ltda.

O ciclo: amplo, estreito, pivô, fundo

Abra com o resumo — ele dá o chão da conversa:

você
Me dá um resumo das vendas de junho, de 1º a 30.
assistente
Junho fechou com R$ 2.450.000 em vendas e R$ 85.000 em devoluções —
líquido de R$ 2.365.000, em 3.120 notas. Dados de 12 min atrás.

Por trás, get_sales_summary fez o trabalho. Agora os três movimentos:

1. Estreitar: mesma pergunta, recorte menor

você
Agora só a filial 2.
assistente
Na quebra por filial, a filial 2 respondeu por R$ 610.000 do líquido
de junho — cerca de um quarto do total.

Repare: você não repetiu o período — o assistente lembra. Estreitar é manter a métrica e o período e apertar o recorte (aqui, via get_gross_margin_by_branch, a quebra por filial).

2. Pivotar: mesmo período, outra dimensão

você
Volta para a empresa inteira e quebra junho por vendedor, top 10.
assistente
Top 3 do ranking, líquido de devoluções: RCA 42 (João) R$ 312.000 ·
RCA 51 R$ 288.000 · RCA 17 R$ 240.500. Dados de 12 min atrás.

Pivotar é trocar a dimensão — de filial para vendedor — sem mexer no período (get_top_sales_reps). O número total não muda; muda a lente.

3. Aprofundar: da lista para o caso

você
Quais os 10 clientes inativos do João (RCA 42), pelos de maior valor?
assistente
Os 10 maiores clientes parados da carteira do RCA 42 somam R$ 145.000
em compras nos últimos 12 meses; o maior está há 74 dias sem pedir.

Aprofundar é pegar um nome do ranking e abrir o caso dele (find_inactive_customers com o vendedor como filtro). O roteiro de visitas da semana sai daqui.

Encadear: peça a sequência de uma vez

Quando você já sabe os dois passos, peça os dois na mesma frase:

prompt
Liste os clientes inativos há mais de 60 dias e depois faça o RFM deles.

O assistente chama find_inactive_customers, pega os códigos da resposta e passa para get_customer_rfm — recência, frequência e valor de cada um. A resposta de uma ferramenta vira o argumento da próxima, como o pedido separado que segue direto para a conferência.

O que o assistente não consegue fazer

  • Ampliar o recorte da sua credencial. A parede é do servidor: um vendedor que pede “mostre a empresa inteira” recebe o total dele — sem erro, por desenho. Os filtros da conversa estreitam o que a credencial vê, nunca ampliam. Veja Segurança e privacidade.
  • Inventar períodos sem dados. A série de get_monthly_sales_trend não cria linha de R$ 0 para mês sem venda — o mês simplesmente não aparece. Se a série “pulou” um mês, faltou venda, não sobrou defeito.
  • Escrever no Winthor. Todas as ferramentas são somente leitura: nada de criar pedido, baixar título ou alterar cadastro. O OpenThor é o espelho do ERP, não o balcão.
Mês em andamento é sempre parcial

O período corrente vem incompleto por definição — comparado com um mês fechado, sempre parece queda. Compare mês fechado com mês fechado, ou pergunte pelo acumulado até o mesmo dia.

Faltou a base? A fórmula da pergunta está em Anatomia de uma boa pergunta; as perguntas prontas, em Vendas e outros domínios.