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 criticidade de um equipamento
Em vez de perguntar "este equipamento é crítico?", pergunte cada critério separado e some com os pesos da planta.
perguntas = {
"parada": {"tipo": "nota", "instrucao": "Quanto da produção para se este equipamento falhar?",
"niveis": {"1": "nada", "2": "uma linha", "3": "uma área", "4": "a planta inteira"}},
"reserva": {"tipo": "sim_nao", "instrucao": "Existe equipamento reserva instalado?"},
"pessoas": {"tipo": "sim_nao", "instrucao": "A falha pode ferir pessoas?"},
}
r = decidir(ficha_do_equipamento, perguntas)["respostas"]
criticidade = 0.5 * (r["parada"]["media"] - 1) / 3 + 0.2 * (1 - r["reserva"]["sim"]) + 0.3 * r["pessoas"]["sim"]
docs