A IA entende. O código comanda.
O falai é o nosso framework open source de agentes conversacionais em TypeScript. Conversas tipadas, determinísticas e em produção — com a IA usada só onde realmente importa.
Quatro peças, todo o controle
Agent
O objeto principal: schema, provedor, fluxos, ferramentas e sessão. Um agente atende muitas conversas.
Flows
Objetivos feitos de passos ordenados. Cada passo declara os campos que precisa coletar.
Steps
O caminho da conversa. O fluxo termina quando todos os campos necessários são preenchidos.
Tools
Funções tipadas que executam código real e podem redirecionar a conversa, com contexto de sessão.
Do nosso GitHub para o seu package.json
SDKs e utilitários que mantemos no dia a dia — WhatsApp, pagamentos, assinaturas digitais e dados do Brasil.
// um agente completo em poucas linhasimport { Agent, gemini } from "@falai/agent"; const support = new Agent<State>({ provider: gemini({ model: "gemini-2.0" }), schema,}); support.flow("refund", (f) => { f.step("identify", { needs: ["orderId"] }); f.tool("processRefund", processRefund);}); const reply = await support.send(sessionId, message);Feito para conversas de verdade
Tipado de verdade
TypeScript de ponta a ponta. Autocomplete, segurança e refactors sem medo.
Código no controle
O modelo entende a linguagem; o seu código decide o que acontece a seguir.
Multi-provedor
Gemini, OpenAI, Anthropic, OpenRouter, DeepSeek. Troque sem reescrever.
Node & Bun
Roda onde você já roda. Node 18+ ou Bun 1.0+, zero mágica.
Curtiu a filosofia?
O falai é MIT e está no GitHub. Use, contribua, faça um fork.