The Broad Way

[ Sharp Mind · Sharp Blade · Sharp Spirit ]

root@construct:~
/flowform-construindo-formularios-conversacionais-com-llms
$_
<-- back to /logs
2026-03-05//LOG

FlowForm: Construindo Formularios Conversacionais com LLMs

Sim. Eu sei da ironia. Tres dias depois de xingar interface de chat, ca estou eu buildando o FlowForm -- uma ferramenta de formulario conversacional usando LLM. Mas calma, me escuta, porque tem uma diferenca CRUCIAL. Formulario tem estrutura. Chat nao tem. Esse eh o ponto. O FlowForm pega um schema -- um conjunto de campos com tipo e validacao -- e envolve em linguagem natural. O usuario ACHA que ta batendo papo, mas por baixo cada resposta mapeia pra um campo tipado. Nome vai pro campo nome. Email eh validado. Telefone eh formatado. A LLM nao ta decidindo nada, ta COLETANDO dado estruturado com cara amigavel. A arquitetura eh direta. Tu define o schema do formulario em JSON. O FlowForm gera o prompt inicial, coleta respostas turno a turno, valida cada uma contra o schema, e pede correcao quando a validacao falha. A LLM cuida da linguagem natural. O schema cuida da verdade. Buildei isso porque na Yooga a gente lida com onboarding de restaurante. O dono precisa preencher 30+ campos. CNPJ, dados bancarios, categorias do cardapio, horario de funcionamento. Formulario tradicional eh aquela MURALHA de input que faz o cara fechar a aba na hora. Chatbot puro ia alucinar metade dos dados. O FlowForm fica no meio termo. Stack simples. Core em TypeScript, framework-agnostico. Integracao com LLM eh plugavel -- funciona com Claude API, OpenAI ou modelo local. Validacao usa Zod schema entao tu tem type safety ponta a ponta. O maior aprendizado buildando isso: a parte dificil NAO eh integracao com LLM. Eh lidar com os EDGE CASES. Usuario manda duas respostas numa mensagem so. Usuario corrige resposta anterior. Usuario viaja no assunto. Usuario cola um textao e espera que tu faca o parse. Cada um desses precisa de estrategia, e "joga pra LLM resolver" nao eh estrategia. Status atual: biblioteca core funcionando, adapters React e Vue em andamento, demo CLI disponivel. Open source, MIT. Solto o link do repo quando arrumar a doc. A diferenca entre o FlowForm e "todo app virou chat" eh intencao. Chat UI substitui interface que ja funciona. O FlowForm substitui interface que NAO funciona -- formulario longo e chato que ninguem quer preencher. Eh ai que conversa faz sentido. Quando a alternativa eh pior.
The Broad Way | Kinho.dev