Chat com IA
Pergunte a Kaer Morhen
Chat com Inteligência Artificial ambientado no universo de The Witcher: escolha entre Vesemir, Triss, Yennefer ou Dandelion e pergunte sobre lore, quests, builds e alquimia. Inclui um bestiário com fraquezas de cada monstro.
ver detalhes técnicos
Fãs de The Witcher 3 vivem pulando entre wikis e vídeos para descobrir como vencer um monstro ou qual build usar. A ideia era ter um lugar só, com a cara do jogo, onde dá para perguntar em português e receber a resposta na voz de um personagem.
No ar em oraculodolobo.lotmhub.com.br, aberto a qualquer pessoa sem cadastro, com 4 personagens, 4 temas e um bestiário de 20 criaturas. O código tem testes automatizados de componentes, hook de chat, exportação e da rota da API.
// por dentro
Aplicação Next.js 16 (App Router) com React 19 e TypeScript, sem banco de dados e sem login. O front fala com uma única Route Handler (/api/chat) que valida o corpo, aplica rate limit por IP e chama o Google Gemini pelo SDK @google/generative-ai, com system instruction por persona e histórico convertido para o formato de turnos do Gemini. A resiliência fica no servidor: retry com backoff exponencial e uma cadeia de modelos de fallback quando a cota estoura. Conversas, tema e persona ficam no localStorage; o bestiário é estático e filtrado no cliente. Testado com Jest 30 e Testing Library, hospedado na Vercel com Vercel Analytics.
IA
Cada pergunta tenta o Gemini com retry e backoff exponencial (limitado a 8 s) e, se o modelo continuar sem cota, passa para o próximo de uma cadeia de modelos Flash. Só quando todos falham a API devolve 429 com o cabeçalho Retry-After calculado a partir da dica do próprio erro do Gemini. Uma variável de ambiente fixa um modelo e desliga a cadeia.
IA
Cada personagem é um objeto tipado com saudação, cor, perguntas sugeridas e um system prompt próprio, enviado como systemInstruction do Gemini. O histórico do chat é convertido para os papéis user/model e enviado com startChat, então a persona se mantém ao longo da conversa sem repetir instruções nas mensagens.
Segurança
A rota /api/chat tem rate limit por IP em janela deslizante (30 requisições por minuto), com limpeza periódica do mapa em memória, e valida o formato do corpo com type guards antes de chamar o modelo. A chave do Gemini fica só no servidor e os erros chegam ao usuário como mensagens temáticas, sem detalhes internos. O limite é por instância, um controle de melhor esforço adequado a um projeto gratuito.
Segurança
As respostas da IA passam por um parser de Markdown próprio que gera elementos React (títulos, listas, código, links com noopener), em vez de injetar HTML. Isso evita uma dependência extra e impede que texto vindo do modelo vire HTML executável na página.
Dados
As conversas são persistidas no localStorage com validação de formato na leitura (dados corrompidos são descartados), limite de 50 conversas mantendo as mais recentes e tolerância a erro de cota ou navegação privada. O título da conversa é gerado da primeira pergunta e a conversa pode ser exportada em texto ou Markdown.
Qualidade
São 95 casos de teste com Jest 30 e Testing Library cobrindo componentes do chat, o renderer de Markdown, o hook useChat, a exportação e a rota /api/chat. Os temas trocam CSS custom properties no elemento html, sem recarregar a página.
Conte o que você precisa e receba uma proposta sem compromisso.