Conceitos
Como construir com o Katuok
O seu código manda no fluxo; o Katuok toma as decisões pequenas que nenhuma regra fixa resolve.
Três jeitos de usar IA
| Jeito | Quem decide o próximo passo | Risco |
|---|---|---|
| Programa tradicional | O código, com regras fixas | Quebra quando o texto muda de jeito |
| Agente com chatbot | O próprio chatbot, a cada passo | Cada passo pode sair do trilho; caro e lento |
| Programa com o Katuok | O código; o Katuok só julga | Baixo: cada decisão vem com certeza e pode ir para uma pessoa |
Princípios
- O código manda. Fluxo, regras e efeitos (mandar e-mail, mover pedido) ficam no seu código.
- Uma pergunta, uma propriedade. Quebre julgamentos grandes em perguntas estreitas.
- Mande só o que importa. Menos ruído no estado, mais acerto.
- Junte as perguntas. Várias perguntas sobre o mesmo estado vão numa chamada só.
- Combine no código. Pesos e regras para juntar respostas são seus, e você pode mudar quando quiser.
- Roteie pela certeza. O que é claro segue sozinho; o que é duvidoso vai para uma pessoa.
- Regra fixa antes de modelo. "Vencido há mais de 30 dias" é conta de data: faça no código, não pergunte ao Katuok.
Exemplo: nota de um currículo
Em vez de perguntar "este candidato é bom?", pergunte cada critério separado e some com os pesos da vaga.
perguntas = {
"experiencia": {"tipo": "nota", "instrucao": "Quantos anos de experiência com vendas B2B?",
"niveis": {"1": "nenhuma", "2": "menos de 2 anos", "3": "2 a 5 anos", "4": "mais de 5 anos"}},
"ingles": {"tipo": "sim_nao", "instrucao": "O currículo indica inglês avançado ou fluente?"},
"cidade": {"tipo": "sim_nao", "instrucao": "A pessoa mora na Grande São Paulo ou aceita mudar?"},
}
r = decidir(curriculo, perguntas)["respostas"]
pontos = 0.6 * (r["experiencia"]["media"] - 1) / 3 + 0.25 * r["ingles"]["sim"] + 0.15 * r["cidade"]["sim"]