Guia de lorebook do Janitor AI: o que você precisa saber

Um lorebook do Janitor AI é uma base de conhecimento estruturada que se conecta ao seu chat de roleplay. Pense nele como um documento de referência compartilhado: você define entradas para personagens, lugares, itens ou regras da história, e a AI lê essas entradas como contexto a cada mensagem. Cada entrada tem um título, um corpo (normalmente de 200-500 caracteres) e palavras-chave opcionais que fazem a entrada ser injetada quando esses termos aparecem na conversa.

O sistema se inspira no world info do AI Dungeon e no formato de lorebook do SillyTavern. O Janitor AI carrega até 200 entradas de lorebook por chat, embora o desempenho dependa do backend de LLM escolhido. As entradas ficam guardadas no servidor, no banco de dados do Janitor, mas o processamento de fato acontece no LLM que você conectar — OpenAI, Claude via proxy ou uma instância local do KoboldCPP.

Uma limitação: o Janitor AI não atualiza os lorebooks automaticamente no meio do chat. Se uma personagem aprende algo novo ou um lugar muda, você precisa editar a entrada manualmente. Não há decaimento de memória nem reescrita dinâmica. Isso funciona para cenários estáticos, mas quebra a imersão em narrativas que evoluem. Plataformas como [Nomi AI](https://www.nomi.ai) e AIAngels usam memória persistente que se atualiza sozinha, mas os lorebooks do Janitor são totalmente manuais e exigem que o usuário escreva ativamente.

Criar uma entrada de lorebook no Janitor AI é simples, mas tem vários campos que você precisa entender. Primeiro, vá até a página da personagem ou do chat em que quer anexar o lorebook. Clique na aba 'Lorebook' — ela normalmente fica na barra lateral, perto da janela do chat. Depois clique em 'Add Entry'.

O formulário da entrada tem quatro campos: Título, Descrição, Palavras-chave e Conteúdo. O título é um rótulo curto, como 'Rei Aldric de Valdoria'. A descrição é um resumo de 1-2 frases visível na lista do lorebook. As palavras-chave são termos separados por vírgula que acionam a entrada — para o Rei Aldric, você poderia usar 'rei, Aldric, Valdoria, trono'. O conteúdo é o contexto completo, com no máximo 200-500 caracteres, escrito em linguagem simples. Descreva a personalidade, a aparência, as motivações e a situação atual do rei.

Um erro comum é escrever um conteúdo longo ou vago demais. A janela de contexto do Janitor AI é dividida entre o histórico do chat e o lorebook. Cada entrada ativa consome cerca de 300-500 tokens. Com 30 entradas ativas, são 9.000-15.000 tokens antes mesmo de você digitar uma mensagem. Fique no essencial: um parágrafo por entrada, sem floreios. Guarde isso para o próprio chat.

Depois de salva, a entrada fica passiva até uma palavra-chave acioná-la. A AI então injeta todo o conteúdo no contexto da próxima resposta. Teste digitando uma mensagem com uma palavra-chave e veja se a AI usa o lorebook corretamente. Se não usar, confira sua lista de palavras-chave — palavras-chave com erro de digitação ou vagas são a principal causa de gatilhos que falham.

O recurso de lorebook do Janitor AI tem limites rígidos que afetam diretamente a qualidade do seu roleplay. A plataforma permite até 200 entradas por chat, mas você vai esbarrar nas limitações da janela de contexto muito antes disso. A maioria dos LLMs usados com o Janitor (GPT-3.5, GPT-4 da OpenAI ou Claude) tem janelas de contexto entre 4.000 e 8.000 tokens. O histórico do chat consome cerca de 2.000-4.000 tokens depois de 50 mensagens. Sobram 2.000-6.000 tokens para as entradas do lorebook.

Cada entrada de lorebook ocupa em média 300-500 tokens quando carregada por completo. Com 10 entradas ativas, são 3.000-5.000 tokens — possivelmente todo o seu orçamento restante. A AI fica então sem espaço para respostas detalhadas ou para lembrar das últimas 5 mensagens. A economia de tokens é o custo escondido dos lorebooks.

Regra prática: mantenha menos de 10 entradas ativas no GPT-3.5 e menos de 15 no GPT-4. Use a opção 'Required' para forçar certas entradas (como sua personagem principal ou a cena atual) a sempre carregar, e deixe as outras apenas por palavra-chave, para que só apareçam quando forem relevantes. Desative entradas de lugares ou personagens que não estão envolvidos no momento. É uma arrumação manual; nenhuma automação da plataforma ajuda aqui.

Compare com o AIAngels, em que a memória é gerenciada no servidor, com um contexto de 8.000 tokens que prioriza automaticamente as informações recentes e relevantes. Sem contar tokens nem ligar e desligar entradas. Já no Janitor, você é o gerente da sua própria memória.

Depois de entender o básico, você pode levar o sistema de lorebook do Janitor AI mais longe com técnicas avançadas. Um método poderoso são as 'entradas dinâmicas' — entradas que descrevem uma relação ou um evento em andamento, em vez de uma personagem estática. Por exemplo, uma entrada chamada 'Missão atual: recuperar a Pedra do Sol' com as palavras-chave 'missão, pedra do sol, recuperar, objetivo, meta'. O conteúdo resume o objetivo do grupo, as pistas conhecidas e as reações dos NPCs. Conforme a missão avança, você edita a entrada para refletir as novidades.

Otimizar os gatilhos é outra camada. As palavras-chave não diferenciam maiúsculas de minúsculas, mas precisam bater exatamente. Use radicais: 'ladr' vai acionar se a AI disser 'ladrão' ou 'ladra', mas só se sua lista de palavras-chave incluir 'ladr'. Adicione sinônimos comuns e formas no plural. Para nomes de personagens, inclua nome, sobrenome, título e apelidos. Para lugares, inclua o nome e variações como 'o castelo', 'o castelo de Aldric', 'palácio real'.

Você também pode criar entradas 'antigatilho' usando palavras-chave negativas — embora o Janitor não suporte exclusão nativa. Gambiarra: coloque uma palavra comum como 'o' como palavra-chave e escreva no conteúdo 'IGNORE ESTA ENTRADA A MENOS QUE...' — mas isso desperdiça tokens. É melhor simplesmente desativar as entradas quando não forem necessárias.

Um último truque: use entradas de lorebook para impor as regras do gênero. Crie uma entrada chamada 'Regras do mundo' com as palavras-chave 'regra, magia, tecnologia, sociedade'. Conteúdo: 'Este mundo é de baixa fantasia. A magia é rara e perigosa. A tecnologia é medieval. Nada de pólvora ou steampunk.' Isso limita a AI de forma sutil sem prompts de sistema explícitos, que o Janitor não suporta nativamente.

Mesmo com a configuração perfeita, os lorebooks do Janitor AI falham de formas previsíveis. A reclamação mais comum: 'A AI ignora meu lorebook.' Isso normalmente significa uma de três coisas. Primeiro, palavras-chave que não batem — a AI usou um sinônimo que não está na sua lista. Segundo, excesso de tokens — a entrada carregou, mas foi cortada ou a AI não teve espaço para usá-la. Terceiro, limitações do backend — alguns proxies de LLM grátis cortam o contexto de forma agressiva. Solução: reduza as entradas ativas para 5, confira as palavras-chave com registros reais do chat e, se possível, mude para uma API paga como a da OpenAI.

Outro problema frequente: entradas do lorebook que se contradizem. Se duas entradas definem a mesma personagem de formas diferentes, a AI pode misturá-las de modo imprevisível. O Janitor AI carrega as entradas por ordem de criação, mas não há sistema de prioridade. Mantenha uma única entrada 'mestra' por personagem e evite definições duplicadas.

A queda de desempenho com o tempo também é comum. Depois de mais de 100 mensagens, mesmo com lorebooks mínimos, as respostas da AI ficam genéricas. É uma limitação da janela de contexto, não um bug do lorebook. A única solução é começar um novo chat e copiar as entradas do lorebook, perdendo o histórico da conversa. Plataformas como o AIAngels evitam isso com memória persistente que comprime o histórico de forma inteligente, mas o Janitor não oferece nada parecido.

Por fim, usuários de celular relatam que o editor de lorebook às vezes não salva as entradas. Atualize a página antes de editar e sempre copie seu texto para um bloco de notas antes de salvar. A sincronização com o servidor é instável no plano grátis do Janitor.

O sistema de lorebook do Janitor AI é poderoso, mas manual. Se você cansou de editar entradas, controlar orçamentos de tokens ou resolver gatilhos ignorados, considere plataformas que cuidam da memória automaticamente. O AIAngels, por exemplo, usa memória permanente que se atualiza a cada mensagem — sem editar lorebook. A AI lembra de detalhes das personagens, do histórico da relação e dos pontos da trama desde a primeira conversa. A memória não se desgasta nem é cortada depois de 90 dias, ao contrário da maioria dos concorrentes.

Outras alternativas incluem o Nomi AI, que oferece um recurso de 'notas' parecido com lorebooks, mas com atualizações automáticas, e o Kindroid, que usa um sistema de 'história de fundo' que a própria AI mantém. O Replika não tem nada equivalente a um lorebook — sua memória se limita a fatos que você ensina explicitamente, que muitas vezes se perdem. O Character.AI tem 'definições de personagem', mas nenhum lorebook por chat.

Para quem quer o controle do sistema manual do Janitor AI com desempenho melhor, o SillyTavern continua sendo a referência em gestão de lorebooks. Ele suporta entradas aninhadas, gatilhos condicionais e uma interface mais limpa. Mas o SillyTavern exige instalação local. O Janitor AI é o meio-termo na web — prático, mas limitado.

Se você valoriza memória sem configuração, o AIAngels oferece um plano grátis com chat de texto e a mesma memória permanente do premium. Sem lorebook, sem chaves de API, sem gerenciar tokens. É só conversar, e a AI lembra. Essa simplicidade é o contraponto ao sistema flexível, porém trabalhoso, do Janitor.