docs
Comece aqui

Introdução

O Katuok é um modelo de decisão. Você manda um texto ou uma imagem e as perguntas com opções; ele devolve a escolha e o quanto tem certeza.

Decisões, não texto

Chatbots escrevem respostas para pessoas lerem. O Katuok não escreve: ele escolhe. Cada resposta é um valor que o seu programa usa direto, sem interpretar frase nenhuma.

estadotexto ou imagemperguntascom as opçõesKatuokkatuok-1escolhaprobabilidadescertezacerteza altao código agecerteza baixauma pessoa olha

Uma ordem de manutenção chega: "turbina 1 com vibração no mancal 3 subindo de 3,2 para 7,8 mm/s". Você pergunta "qual especialidade atende?" com Mecânica, Elétrica, Hidráulica e Instrumentação. O Katuok responde Mecânica, certeza 0,94, em cerca de 0,3 segundo. Com certeza baixa, o seu programa mandaria a ordem para uma pessoa.

Um "se" inteligente

Pense no Katuok como um if que entende linguagem. O seu programa continua no comando: ele decide o fluxo, as regras fixas e o que fazer com cada resposta. O Katuok entra só onde uma regra escrita à mão quebraria, como entender o que o operador escreveu na ordem.

r = katuok.decidir(estado=ordem, perguntas={"esp": esp, "parar": parar})
if r["esp"]["certeza"] < 0.8:
    revisao.add(ordem)                 # dúvida: o planejador olha
else:
    filas[r["esp"]["escolha"]].add(ordem)

O que vem em cada resposta

CampoO que é
escolhaA opção mais provável
probabilidadesA chance de cada opção, somando 1
certezaO quanto o Katuok confia na escolha, de 0 a 1

Por que um modelo de decisão

Por onde seguir