Esta é a página mais copiável do guia. São seis conjuntos completos de perguntas em português, prontos para colar no seu código e adaptar ao seu domínio.
Todos seguem a mesma forma, que é a que repete em quase todo caso real: um Choice com opção de escape, dois ou três Scores e um ou dois Nouls. As três primitivas viajam na mesma requisição, porque o conteúdo entra uma vez e cada pergunta soma apenas os próprios tokens — o motivo está em várias perguntas numa chamada.
Antes de copiar, três avisos. As descrições precisam falar do seu domínio. Os Nouls existem para disparar política no código, não para entrar em média. E nada disto substitui rodar contra vinte casos seus com a resposta esperada.
1. Triagem de ticket de suporte
{
"categoria": {
"type": "choice",
"instructions": "Qual o assunto principal deste ticket?",
"criteria": {
"duvida_tecnica": "Algo não funciona, dá erro ou o cliente não sabe usar um recurso.",
"cobranca": "Fatura, valor, estorno, plano ou forma de pagamento.",
"elogio": "O cliente agradece ou elogia, sem pedir nada.",
"outro": "Não se encaixa em nenhuma das categorias acima."
}
},
"urgencia": {
"type": "score",
"instructions": "Qual a urgência declarada ou implícita no pedido?",
"criteria": [
"Nenhuma pressa; o cliente não cita prazo.",
"Pressa comum; quer resposta nos próximos dias.",
"Pressa clara; cita prazo curto ou impacto no trabalho.",
"Bloqueio total; a operação do cliente está parada."
]
},
"risco_de_cancelamento": {
"type": "score",
"instructions": "Quanto o texto indica risco de o cliente cancelar o serviço?",
"criteria": [
"Nenhum sinal.",
"Insatisfação sem menção a sair.",
"Compara com concorrente ou ameaça reclamar formalmente.",
"Diz que vai cancelar ou já iniciou o cancelamento."
]
},
"pede_reembolso": {
"type": "noul",
"instructions": "O cliente pede explicitamente estorno, reembolso ou crédito?"
},
"cita_procon": {
"type": "noul",
"instructions": "O texto menciona Procon, advogado, processo ou órgão de defesa do consumidor?"
}
}
É o conjunto que roda no playground e o caso completo está em classificação de tickets.
2. Moderação de conteúdo
{
"violacao": {
"type": "choice",
"instructions": "Qual regra da comunidade este post viola, se alguma?",
"criteria": {
"nenhuma": "Não viola nenhuma regra; conteúdo comum da comunidade.",
"assedio": "Ataque dirigido a uma pessoa ou grupo, xingamento, humilhação.",
"spam": "Divulgação repetitiva, link comercial fora de contexto, golpe.",
"incerto": "O texto está na fronteira e a regra aplicável não é clara."
}
},
"gravidade": {
"type": "score",
"instructions": "Qual o dano potencial se este post permanecer no ar?",
"criteria": [
"Nenhum dano; no máximo desagrada.",
"Dano leve; incomoda a pessoa citada.",
"Dano relevante; humilha, expõe ou engana.",
"Dano grave; incita violência ou risco à saúde."
]
},
"expoe_dado_pessoal": {
"type": "noul",
"instructions": "O texto expõe dado pessoal de terceiro: telefone, endereço, CPF ou foto identificável?"
}
}
A opção incerto explícita vem do cookbook oficial de autoconsistência, e o
caso está em moderação de conteúdo.
3. Qualificação de lead
{
"estagio": {
"type": "choice",
"instructions": "Em que estágio de compra esta mensagem indica que a pessoa está?",
"criteria": {
"pesquisando": "Quer entender o que o produto faz; sem prazo nem orçamento.",
"comparando": "Já conhece alternativas e está avaliando qual escolher.",
"decidindo": "Tem prazo, necessidade explícita e poder de decisão ou acesso a ele.",
"suporte": "Já é cliente e escreveu para pedir ajuda, não para comprar.",
"indefinido": "A mensagem não permite dizer o estágio."
}
},
"intencao_de_compra": {
"type": "score",
"instructions": "Quanto a mensagem indica intenção real de comprar em breve?",
"criteria": [
"Curiosidade; nenhuma necessidade declarada.",
"Interesse genérico, sem prazo.",
"Necessidade clara, sem prazo.",
"Necessidade clara com prazo declarado."
]
},
"pede_contato_humano": {
"type": "noul",
"instructions": "A mensagem pede explicitamente falar com uma pessoa, ligar ou agendar reunião?"
}
}
O caso completo, com os pesos, está em roteamento de leads.
4. Avaliação de produto
{
"tema": {
"type": "choice",
"instructions": "Qual é o assunto principal da reclamação ou do elogio?",
"criteria": {
"qualidade_do_produto": "Defeito, durabilidade, desempenho ou acabamento.",
"entrega": "Prazo, embalagem, extravio, item faltando ou transportadora.",
"atendimento": "Resposta, troca, garantia ou falta de retorno da empresa.",
"elogio_geral": "Elogio sem apontar problema.",
"outro": "Não se encaixa em nenhum dos temas acima."
}
},
"severidade": {
"type": "score",
"instructions": "Qual a gravidade do problema relatado para o cliente?",
"criteria": [
"Nenhum problema relatado.",
"Incômodo pequeno; o cliente seguiu usando.",
"Problema relevante; exigiu esforço do cliente.",
"Problema grave; produto inutilizável, risco ou prejuízo."
]
},
"menciona_risco_a_saude": {
"type": "noul",
"instructions": "O texto menciona risco à saúde, ferimento, choque, queimadura ou incêndio?"
}
}
O corte desse último Noul deve ser baixo de propósito: falso positivo custa a leitura de um analista, falso negativo custa um recall que ninguém fez. Ver análise de avaliações.
5. Cobrança e negociação
{
"postura": {
"type": "choice",
"instructions": "Qual a postura do cliente nesta mensagem em relação à dívida?",
"criteria": {
"quer_negociar": "Reconhece a dívida e propõe ou pede forma de pagamento.",
"contesta_valor": "Discorda do valor, do contrato ou diz que já pagou.",
"pede_prazo": "Reconhece e pede apenas mais tempo.",
"sem_condicoes": "Declara não ter como pagar, sem propor alternativa.",
"indefinida": "A mensagem não permite identificar a postura."
}
},
"clareza_da_proposta": {
"type": "score",
"instructions": "Quanto a mensagem traz uma proposta concreta de pagamento?",
"criteria": [
"Nenhuma proposta.",
"Intenção genérica de pagar, sem detalhe.",
"Proposta com valor ou prazo, mas incompleta.",
"Proposta completa: valor, número de parcelas e data."
]
},
"afirma_ja_ter_pago": {
"type": "noul",
"instructions": "O cliente afirma que já pagou este valor ou que a cobrança é indevida?"
},
"cita_vulnerabilidade": {
"type": "noul",
"instructions": "A mensagem menciona desemprego, doença, luto, idade avançada ou outra situação de vulnerabilidade?"
}
}
Este é o conjunto mais sensível da página: decisão de cobrança afeta uma pessoa. Os dois Nouls são de proteção e devem interromper o fluxo automático. Ver cobrança e inadimplência e LGPD e decisões.
6. Triagem de currículo
{
"experiencia_na_funcao": {
"type": "score",
"instructions": "Quanta experiência direta na função descrita na vaga o texto evidencia?",
"criteria": [
"Nenhuma experiência na função.",
"Contato pontual, em outra função.",
"Atuou na função em projetos ou por período curto.",
"Atuou na função como atribuição principal.",
"Atuou na função com escopo amplo e responsabilidade sobre resultados."
]
},
"evidencia_de_resultado": {
"type": "score",
"instructions": "Quanto o texto descreve resultados concretos, e não apenas atribuições?",
"criteria": [
"Só lista cargos e períodos.",
"Descreve atribuições.",
"Descreve entregas nomeadas.",
"Descreve entregas com efeito observável descrito pelo candidato."
]
},
"requisito_obrigatorio_presente": {
"type": "noul",
"instructions": "O texto evidencia o requisito obrigatório da vaga: registro profissional ativo no conselho da categoria?"
}
}
Requisito obrigatório é Noul e sinaliza, não elimina. Ver triagem de currículos.
Como adaptar sem estragar
Descreva situações, não graus. “Problema relevante; exigiu esforço do cliente” funciona; “moderadamente grave” não. A documentação mostra o caso extremo em níveis de Score.
Mantenha uma dimensão por Score. Se a descrição junta duas coisas com “e”, divida em duas perguntas e combine no código.
Não tire a opção de escape. É ela que transforma o caso fora de escopo em sinal em vez de erro silencioso.
Teste antes de ligar. Vinte casos reais, a resposta que você esperava, e a comparação. O roteiro está em critérios em português ou inglês, e o índice desta seção em português.
Perguntas frequentes
Posso usar estes exemplos direto em produção?
Use como ponto de partida, não como resposta final. As descrições precisam falar do seu domínio: o que conta como urgente, grave ou fora de escopo muda de empresa para empresa. Rode contra vinte casos seus com a resposta esperada antes de ligar em produção.
Por que todos têm uma opção chamada outro?
Porque Choice sempre escolhe alguém. Sem uma opção de escape, um conteúdo que não cabe em nenhuma categoria é empurrado para a mais parecida, às vezes com confiança alta. Com escape, ele vira um sinal útil e uma pilha que você revisa depois.
Por que algumas condições são Noul em vez de nível de régua?
Porque disparam política, e política não se pondera. Risco à saúde, menção a órgão de defesa do consumidor ou pedido explícito de atendente são condições binárias que mudam o destino do caso independentemente de qualquer nota.
Quantas perguntas posso mandar de uma vez?
O limite é de tokens, não de contagem: 64 mil por requisição e 32 mil para o state mais a pergunta mais longa, segundo a documentação oficial. Os seis conjuntos desta página cabem com folga em uma chamada cada.
As perguntas em português funcionam bem?
Nas nossas cinco execuções de 18/09/2026 funcionaram, mas não temos teste A/B contra a versão em inglês. A documentação declara que o inglês é a língua principal de treino e recomenda testar no próprio conteúdo.