Guida al lorebook di Janitor AI: cosa devi sapere

Un lorebook di Janitor AI è una base di conoscenza strutturata che si collega alla tua chat di roleplay. Immaginalo come un documento di riferimento condiviso: definisci voci per personaggi, luoghi, oggetti o regole della storia, e l'AI legge queste voci come contesto durante ogni messaggio. Ogni voce ha un titolo, un corpo (in genere 200-500 caratteri) e parole chiave opzionali che attivano l'inserimento della voce quando quei termini compaiono nella conversazione.

Il sistema è ispirato alle informazioni sul mondo di AI Dungeon e al formato lorebook di SillyTavern. Janitor AI carica fino a 200 voci di lorebook per chat, anche se le prestazioni dipendono dal backend LLM che scegli. Le voci sono archiviate lato server nel database di Janitor, ma l'elaborazione effettiva avviene sull'LLM a cui ti connetti — OpenAI, Claude tramite proxy o un'istanza locale di KoboldCPP.

Una limitazione: Janitor AI non aggiorna automaticamente i lorebook durante la chat. Se un personaggio scopre qualcosa di nuovo o un luogo cambia, devi modificare manualmente la voce. Non c'è decadimento della memoria né riscrittura dinamica. Va bene per ambientazioni statiche, ma rompe l'immersione per narrazioni in evoluzione. Piattaforme come [Nomi AI](https://www.nomi.ai) e AIAngels usano una memoria persistente che si aggiorna automaticamente, mentre i lorebook di Janitor sono puramente manuali e richiedono una scrittura attiva da parte dell'utente.

Creare una voce di lorebook su Janitor AI è semplice, ma ci sono diversi campi che devi capire. Prima vai alla pagina del personaggio o della chat a cui vuoi associare il lorebook. Clicca sulla scheda 'Lorebook' — di solito è nella barra laterale vicino alla finestra della chat. Poi clicca su 'Add Entry'.

Il modulo della voce ha quattro campi: Titolo, Descrizione, Parole chiave e Contenuto. Il titolo è un'etichetta breve come 'Re Aldric di Valdoria'. La descrizione è un riassunto di 1-2 frasi visibile nell'elenco del lorebook. Le parole chiave sono termini separati da virgole che attivano la voce — per Re Aldric potresti aggiungere 're, Aldric, Valdoria, trono'. Il contenuto è il contesto completo, massimo 200-500 caratteri, scritto in italiano semplice. Descrivi la personalità del re, l'aspetto, le motivazioni e la situazione attuale.

Un errore comune è scrivere contenuti troppo lunghi o troppo vaghi. La finestra di contesto di Janitor AI è condivisa tra la cronologia della chat e il lorebook. Ogni voce attiva consuma circa 300-500 token. Se hai 30 voci attive, sono 9.000-15.000 token prima ancora di scrivere un messaggio. Attieniti all'essenziale: un paragrafo per voce, niente prosa fiorita. Quella conservala per la chat stessa.

Una volta salvata, la voce resta passiva finché una parola chiave non la attiva. L'AI allora inserisce l'intero contenuto nel contesto per la risposta successiva. Fai una prova scrivendo un messaggio che include una parola chiave e vedi se l'AI fa riferimento al lorebook in modo accurato. Se non lo fa, controlla la lista di parole chiave — parole chiave scritte male o vaghe sono la causa principale di attivazioni fallite.

La funzione lorebook di Janitor AI ha limiti rigidi che incidono direttamente sulla qualità del tuo roleplay. La piattaforma consente fino a 200 voci per chat, ma ti scontrerai con i vincoli della finestra di contesto molto prima di quel numero. La maggior parte degli LLM usati con Janitor (GPT-3.5 di OpenAI, GPT-4 o Claude) ha finestre di contesto tra 4.000 e 8.000 token. La cronologia della chat consuma circa 2.000-4.000 token dopo 50 messaggi. Restano 2.000-6.000 token per le voci del lorebook.

Ogni voce di lorebook consuma in media 300-500 token quando è completamente caricata. Se hai 10 voci attive, sono 3.000-5.000 token — potenzialmente tutto il tuo budget rimanente. All'AI non resta spazio per risposte dettagliate o per ricordare gli ultimi 5 messaggi. Il budget di token è il costo nascosto dei lorebook di Janitor.

Regola pratica: tieni le voci attive sotto 10 per GPT-3.5, sotto 15 per GPT-4. Usa l'interruttore 'Required' per forzare certe voci (come il tuo personaggio principale o la scena attuale) a caricarsi sempre, e imposta le altre solo su parola chiave così appaiono solo quando sono pertinenti. Disattiva le voci per luoghi o personaggi non coinvolti al momento. È una gestione manuale; nessuna automazione della piattaforma ti aiuta qui.

Confrontalo con AIAngels, dove la memoria è gestita per te: qualsiasi account con accesso mantiene gli ultimi 50 messaggi e fino a 500 fatti salvati per personaggio. Non conti mai i token né attivi e disattivi voci. Ma su Janitor sei tu il tuo gestore della memoria.

Una volta capite le basi, puoi spingere oltre il sistema di lorebook di Janitor AI con tecniche avanzate. Un metodo potente sono le 'voci dinamiche' — voci che descrivono una relazione o un evento in corso invece di un personaggio statico. Per esempio, una voce intitolata 'Missione attuale: recuperare la Pietra del Sole' con parole chiave 'missione, pietra del sole, recuperare, obiettivo, scopo'. Il contenuto delinea l'obiettivo del gruppo, gli indizi noti e le reazioni degli PNG. Man mano che la missione procede, modifichi la voce per riflettere i nuovi sviluppi.

L'ottimizzazione delle attivazioni è un altro livello. Le parole chiave non distinguono maiuscole e minuscole ma devono corrispondere esattamente. Usa le radici delle parole: 'ladro' si attiverà se l'AI dice 'ladri' o 'ladrocinio', ma solo se la tua lista di parole chiave include 'ladro'. Aggiungi sinonimi comuni e forme plurali. Per i nomi dei personaggi, includi nome, cognome, titolo e soprannomi. Per i luoghi, includi il nome e varianti come 'il castello', 'il castello di Aldric', 'palazzo reale'.

Puoi anche creare voci 'anti-attivazione' usando parole chiave negative — anche se Janitor non supporta l'esclusione nativa. Soluzione alternativa: metti una parola comune come 'il' come parola chiave, poi scrivi un contenuto che dice 'IGNORA QUESTA VOCE A MENO CHE...' — ma così sprechi token. Meglio disattivare semplicemente le voci quando non servono.

Un ultimo trucco: usa le voci del lorebook per imporre le regole del genere. Crea una voce intitolata 'Regole del mondo' con parole chiave 'regola, magia, tecnologia, società'. Contenuto: 'Questo mondo è low-fantasy. La magia è rara e pericolosa. La tecnologia è medievale. Niente polvere da sparo né steampunk.' Questo vincola sottilmente l'AI senza prompt di sistema espliciti, che Janitor non supporta nativamente.

Anche con un setup perfetto, i lorebook di Janitor AI falliscono in modi prevedibili. La lamentela più comune: "L'AI ignora il mio lorebook". Di solito significa una di tre cose. Primo, mancata corrispondenza delle parole chiave — l'AI ha usato un sinonimo non presente nella tua lista. Secondo, overflow di token — la voce è stata caricata ma tagliata o l'AI non aveva spazio per referenziarla. Terzo, limiti del backend — alcuni proxy LLM gratuiti troncano il contesto in modo aggressivo. Soluzione: riduci le voci attive a 5, verifica le parole chiave con i log di chat reali e passa a un'API a pagamento come OpenAI se possibile.

Un altro problema frequente: le voci del lorebook si contraddicono a vicenda. Se due voci definiscono lo stesso personaggio in modo diverso, l'AI può fonderle in modo imprevedibile. Janitor AI carica le voci in ordine di creazione, ma non esiste un sistema di priorità. Tieni una sola voce "personaggio principale" per persona ed evita definizioni duplicate.

Anche il degrado delle prestazioni nel tempo è comune. Dopo oltre 100 messaggi, anche con lorebook minimali, le risposte dell'AI diventano generiche. È un limite della finestra di contesto, non un bug del lorebook. L'unico rimedio è iniziare una nuova chat e copiare le voci del lorebook, perdendo la cronologia della conversazione. Piattaforme come AIAngels evitano questo con una memoria persistente che comprime la cronologia in modo intelligente, ma Janitor non offre nulla del genere.

Infine, gli utenti mobile segnalano che l'editor del lorebook a volte non riesce a salvare le voci. Aggiorna la pagina prima di modificare e copia sempre il testo in un blocco note prima di premere salva. La sincronizzazione lato server non è affidabile nel piano gratuito di Janitor.

Il sistema di lorebook di Janitor AI è potente ma manuale. Se sei stanco di modificare voci, tenere traccia dei budget di token o risolvere problemi di trigger ignorati, considera le piattaforme che gestiscono la memoria automaticamente. AIAngels, per esempio, conserva una memoria permanente dei fatti salvati che si aggiorna mentre chatti, senza bisogno di modificare alcun lorebook. Qualsiasi account con accesso mantiene gli ultimi 50 messaggi e fino a 500 fatti salvati per personaggio, così i dettagli dei personaggi, la storia della relazione e i punti della trama proseguono tra una sessione e l'altra.

Altre alternative includono Nomi AI, che offre una funzione "note" simile ai lorebook ma con aggiornamenti automatici, e Kindroid, che usa un sistema di "backstory" che l'AI mantiene attivamente. Replika non ha un equivalente del lorebook — la sua memoria è limitata ai fatti che le insegni esplicitamente, che spesso vanno persi. Character.AI ha le "definizioni dei personaggi" ma nessun lorebook per chat.

Per gli utenti che vogliono il controllo del sistema manuale di Janitor AI ma con prestazioni migliori, SillyTavern resta lo standard di riferimento per la gestione dei lorebook. Supporta voci annidate, trigger condizionali e un'interfaccia più pulita. Ma SillyTavern richiede un setup locale. Janitor AI è la via di mezzo basata sul web — comoda ma limitata.

Se dai valore a una memoria senza configurazione, AIAngels dà agli account gratuiti e Premium la stessa memoria. Nessun lorebook da modificare, nessuna chiave API e nessun calcolo della finestra di contesto. Basta chattare, e l'AI tiene traccia. Quella semplicità è il compromesso rispetto al sistema flessibile ma laborioso di Janitor.