Guia de Lorebook do SillyTavern: Um Caminho Mais Simples

Um lorebook no SillyTavern é um arquivo baseado em JSON contendo entradas — cada entrada tem um conjunto de palavras-chave, um nível de profundidade/prioridade e um bloco de texto descrevendo um personagem, local, item ou evento. Quando uma palavra-chave aparece no seu histórico de chat ou na sua última mensagem, o SillyTavern injeta a entrada correspondente na janela de contexto da IA (geralmente perto do fim do prompt, via o modo de inserção "post-history"). As entradas também podem ser definidas como "constant" para que sempre carreguem. O sistema suporta até 1000 entradas por lorebook, embora o limite prático dependa do tamanho do seu contexto (por exemplo, 4096 tokens para a maioria das APIs gratuitas). Cada entrada tem um campo de "secondary key" para gatilhos com várias palavras, e um controle deslizante de "probability" (0-100%) que controla se a entrada dispara sempre ou apenas às vezes — útil para encontros aleatórios. Você também pode atribuir um "role" (system, user, assistant ou character) para que a entrada seja formatada como diálogo. Os lorebooks são salvos como arquivos .json na pasta /data/default-user/lorebooks/. A principal vantagem é que os lorebooks tiram a memória da sua carta de personagem principal, mantendo a IA focada na cena atual sem esquecer os fatos estabelecidos.

Abra o SillyTavern e navegue até a aba "Lorebook" (o ícone de livro na barra lateral esquerda). Clique em "Import" para carregar um .json existente ou comece do zero com "Add Entry". Uma entrada em branco tem estes campos: Primary Keywords (separadas por vírgula, por exemplo, "tavern, inn, bar"), Secondary Keys (gatilhos alternativos, por exemplo, "The Drunken Dragon"), Content (o texto injetado quando acionado — mantenha abaixo de 300 tokens para eficiência), Depth (número inteiro de 0 a 50; profundidade maior significa que a entrada é colocada mais perto da atenção da IA — use 10 para fatos básicos, 30 para pontos críticos da trama), Probability (100% = dispara sempre, 50% = metade das vezes), Role ("system" para narração, "character" para diálogo no personagem), Group (para organizar várias entradas sob uma aba) e Is Constant (marque para sempre carregar a entrada, ignorando as palavras-chave). Para uma taverna, defina as palavras-chave como "tavern, inn, barkeep", o conteúdo como "The Rusty Nail Tavern has oak tables, a roaring fireplace, and a mute barkeep named Gregor who communicates via chalkboard." Depth 10, probability 100%, role system. Salve. Teste digitando "I enter the tavern" — a IA agora deve mencionar Gregor.

Além da simples correspondência de palavras-chave, os lorebooks do SillyTavern suportam gatilhos de regex por meio do campo "Secondary Keys" ao ativar o botão "Regex" por entrada. Use padrões como \bsword\b|\bblade\b para corresponder a ambas as palavras. Os controles deslizantes de probabilidade permitem criar um lore imprevisível: defina uma entrada de "hidden door" como 20% para que a IA só a mencione ocasionalmente, forçando a exploração. As tags de role (system, user, assistant, character) controlam como a entrada é formatada. As entradas com role "character" são injetadas como se a companheira as tivesse dito — útil para histórias de fundo de NPCs. As entradas com role "system" permanecem como fatos narrativos neutros. Você também pode usar o campo "Group" para organizar entradas em grupos recolhíveis (por exemplo, "NPCs", "Locations", "Quests") para facilitar a edição depois. Um truque poderoso: crie uma entrada com palavras-chave como "*" (curinga) e defina a probabilidade como 1% — isso injeta um detalhe ambiente aleatório (por exemplo, "the air smells of rain") em cada cena. A profundidade importa mais do que você imagina: entradas com profundidade > 30 são colocadas depois do prompt principal, mas antes da última mensagem do usuário, tornando-as mais influentes. Experimente profundidade 1-5 para fatos passivos do mundo que não devem sobrepor a cena ativa.

O SillyTavern permite anexar lorebooks a personagens individuais ou ativá-los globalmente. Lorebooks específicos de personagem são ideais para companheiras com histórias de fundo ou itens únicos (por exemplo, o grimório de um mago que só é acionado ao conversar com aquele mago). Para atribuir, abra o cartão do personagem, vá até a aba "Advanced" e selecione um lorebook no menu suspenso. Lorebooks de mundo carregam para qualquer personagem e são melhores para locais persistentes (uma taverna que aparece em várias aventuras) ou regras universais (sistemas de magia, geografia). A regra geral: se o lore se aplica a um personagem, torne-o específico do personagem; se se aplica ao cenário, use um lorebook de mundo. Você também pode empilhar até 5 lorebooks por personagem (pela aba "Lorebooks" no editor de personagem). Entradas sobrepostas entre lorebooks podem causar conflitos—a IA pode ficar confusa se duas entradas definirem o mesmo local de formas diferentes. Para evitar isso, use uma convenção de nomes hierárquica: "World_Tavern" versus "Character_Wizard_Spellbook". Em termos de desempenho, lorebooks de mundo escaneiam todas as palavras-chave a cada mensagem, então mantenha o total de entradas abaixo de 300 em todos os lorebooks ativos para evitar lentidão com janelas de contexto grandes.

O problema mais frequente é entradas que não disparam. Primeiro, verifique se as palavras-chave realmente aparecem no chat—não diferencia maiúsculas de minúsculas, mas exige correspondência exata (sem parciais, a menos que regex esteja ativado). Segundo, confirme que a probabilidade da entrada não está em 0%. Terceiro, garanta que o lorebook está ativado (alternância na aba Lorebook). Quarto, confirme que a profundidade da entrada não é tão baixa (por exemplo, profundidade 0) que ela seja cortada pelo tamanho do contexto—o SillyTavern prioriza entradas com maior profundidade quando a janela de contexto está cheia. Outra armadilha: sobrecarregar o contexto. Se você tem 50 entradas com profundidade 50, todas vão competir pelo espaço limitado de tokens. Use a profundidade com moderação (profundidade 1-10 para a maioria das entradas). Se a IA ignora o lore, abra o "Prompt Item Manager" (o ícone de cubo) para ver exatamente o que está sendo injetado. Procure sua entrada na seção "Lorebooks". Se ela estiver faltando, a palavra-chave não correspondeu ou a entrada estava profunda demais e foi cortada. Além disso, entradas longas (>200 tokens) costumam ser truncadas; mantenha cada entrada abaixo de 150 tokens. Por fim, evite palavras-chave duplicadas entre entradas—a primeira entrada correspondida (por profundidade, depois por ordem) tem precedência.

Lorebooks não são apenas enciclopédias estáticas—eles podem impulsionar narrativas em evolução. Crie uma entrada "Plot Hook" com palavras-chave como "quest, task, mission" e um conteúdo que gere um novo objetivo a cada vez (por exemplo, "Você ouve rumores de uma mina perdida nas montanhas."). Combine com probabilidade de 50% para que nem toda menção gere uma missão. Para eventos sensíveis ao tempo, use uma entrada "Constant" com uma data (por exemplo, "O festival da colheita começa em 3 dias") e atualize-a manualmente conforme os dias passam no jogo. Você também pode encadear lorebooks: uma entrada acionada pode incluir uma palavra-chave que dispara outra entrada (por exemplo, a entrada da taverna dispara "Gregor"). Isso exige um design cuidadoso de palavras-chave. Muitos usuários avançados armazenam inventários de personagens como lorebooks: cada item é uma entrada (palavras-chave: "potion, health potion") com conteúdo que o descreve. Quando o jogador diz "use potion", a entrada dispara e lembra a IA dos efeitos do item. Para mundos verdadeiramente dinâmicos, considere usar [SillyTavern's Extras](https://github.com/SillyTavern/SillyTavern-Extras) com integração de lorebook—embora isso exija configuração adicional. O teto é alto: alguns usuários rodam lorebooks com mais de 500 entradas para campanhas de RPG extensas.