Receitas do Jev: os cookbooks oficiais em português

Uma receita é diferente de um padrão. O padrão diz como organizar o sistema; a receita resolve uma tarefa. A TypeSafe publica 18 delas no índice oficial que lemos em 18 de setembro de 2026, quase sempre com código e, em vários casos, com o número que a própria empresa mediu naquele experimento.

Esta seção traduz essas receitas para português e faz duas coisas que o material original não faz: separa o que foi medido do que foi afirmado, e comenta o que muda quando o texto está em português brasileiro.

O que as receitas medem

Quatro receitas trazem número publicado. Vale ler os números como o que são: resultado de um experimento da fabricante, em um conjunto de dados escolhido por ela.

As demais receitas descrevem desenho, não placar: deduplicação de cadastro com um Score de três níveis sobre 450 pares candidatos, classificação de relatórios da SEC em 75 grupos industriais usando a confiança para subir um nível quando ela cai, recuperação de estrutura de markdown em duas requisições, cascata de extração em dois estágios, extração de datas por partes, seleção de valores já encontrados por expressão regular, function calling com argumentos de conjunto fechado, guardrails de entrada e saída para aplicações com LLM, filtragem de passagens de RAG, conferência de citações, classificação hierárquica com beam search e um laço de autoresearch que alimenta um modelo clássico com as probabilidades do Jev.

O fio que liga todas elas

Lendo as 18 em sequência, o mesmo desenho aparece:

1. O código prepara o material. Busca, filtra, corta o que não interessa. Quase toda receita começa reduzindo o state, porque a documentação é explícita sobre acurácia cair quando o state cresce com detalhe irrelevante.
2. Uma requisição faz muitas perguntas. Em vez de um laço de chamadas, uma chamada com todas as perguntas. É o fan-out aplicado.
3. A decisão fica no código. A receita não termina na resposta do modelo; termina em um if, um limiar ou uma ordenação que você escreveu.
4. A incerteza tem destino. Confiança baixa manda o caso para revisão, para um nível mais alto da taxonomia ou para um segundo estágio mais caro.

Esse é o ponto que diferencia uma receita de um prompt esperto: ela devolve números que o seu código sabe comparar, e não um texto que alguém precisa interpretar.

O que nós acrescentamos

Cada página desta seção segue o mesmo formato: o problema em português, o desenho da solução, o que a receita oficial mediu (com a fonte), o exemplo adaptado para conteúdo brasileiro e a parte chata — onde essa receita encosta nos limites do jev-1.13. Duas receitas dependem de aritmética e datas, exatamente o que a documentação diz que o modelo não faz bem; as duas resolvem isso tirando a conta do modelo e deixando no código, e é essa a lição que interessa.

Se você ainda não leu como as perguntas funcionam, comece pelas primitivas. Se quer ver o resultado de um fluxo inteiro montado com essas peças, vá para casos de uso.