Public Help
Caratteristiche

Libri di tradizioni

Guida completa per creare, importare, gestire e collegare i Lorebooks ai personaggi AI su Public.

Libri di tradizioni (spesso chiamati Informazioni sul mondo) sono raccolte autonome di tradizioni, fatti di ambientazione, dettagli di fazioni, sistemi magici e conoscenze di riferimento a cui puoi collegarti Personaggi dell'IA. Quando chatti con un personaggio, le voci rilevanti dal libro delle conoscenze collegato vengono recuperate dinamicamente e inserite direttamente nel prompt del modello.

A differenza della personalità principale di un personaggio, un libro del sapere è completamente modulare: puoi collegare lo stesso libro del sapere a più personaggi (ad esempio, collegando un libro del sapere condiviso Starfall Academy a Mira, Tobin, Professor Vale e Lord Ashgrave), o scambiare libri del sapere senza alterare la voce del personaggio.

Concetti fondamentali

Per ottenere il massimo dai libri di conoscenze, è utile capire come si adattano agli altri strumenti di gioco di ruolo su Public:

  • Personalità del personaggio: definisce chi è il personaggio: il suo stile di parola, il suo retroscena, le sue peculiarità e le sue linee guida comportamentali.
  • Chat personas: definisce chi sei: il tuo nome, aspetto e identità nella conversazione. Vedi Chat personaggi.
  • Libri di tradizioni: definisce il mondo intorno a te: eventi storici, fazioni, luoghi, incantesimi, regole tecnologiche e tradizioni relazionali.

Libri di sapere privati e pubblici

VisibilitàChi può collegarlo a un personaggioChi può modificarlo o eliminarlo
PrivatoSolo tuSolo tu (il creatore)
PublicQualsiasi creatore su Public può collegarlo durante la creazione o la modifica dei propri personaggiSolo tu (il creatore)

Solo il proprietario può modificare o eliminare un libro di conoscenze. Se elimini un libro del sapere, tutti i personaggi ad esso collegati perderanno il collegamento in modo sicuro senza perdere la cronologia delle conversazioni o la personalità.


Come funziona l'iniezione di contesto

Quando invii un messaggio in una chat di personaggi, il backend esegue una rapida pipeline di assemblaggio del contesto prima di generare la risposta dell'IA:

1. Destinazioni di testo scansionate

Il motore del contesto verifica le voci corrispondenti nell'intero contesto della conversazione attiva:

  • L'ultimo messaggio in arrivo dell'utente
  • Cronologia chat delle conversazioni recenti
  • Riepilogo della conversazione continua
  • Ricordi dei personaggi appuntati ed estratti automaticamente
  • Il saluto originale del personaggio

2. Tipi di corrispondenza delle voci

Ogni voce in un libro di conoscenze ha uno dei due comportamenti trigger:

  • Attivato da parole chiave (constant: false) — La voce definisce un elenco di parole chiave (ad es. ["emberwing", "house of the phoenix"]). Se una parola chiave appare in qualsiasi punto del testo della conversazione scansionata (corrispondenza della sottostringa senza distinzione tra maiuscole e minuscole), la voce si attiva.
  • Costante (constant: true) — La voce è sempre inclusa in ogni singolo scambio di messaggi, ignorando completamente le parole chiave. Ideale per scenari di base globali (ad esempio, "L'anno è il 1204 e il Velo nasconde Starfall Academy dal mondo esterno").

3. Gestione delle priorità e del budget

I modelli hanno finestre di contesto dei prompt finite. Per mantenere le risposte rapide, coerenti ed economicamente vantaggiose, Public impone un budget di iniezione:

  • Limite budget caratteri: Fino a 1.800 caratteri (LOREBOOK_INJECT_MAX_CHARS) di contenuto del libro di conoscenze può essere inserito per messaggio.
  • Ordinamento per priorità: tutte le voci corrispondenti (sia costanti che attivate da parole chiave) vengono ordinate per Priorità in ordine decrescente (100 prima 50, prima 0).
  • Adattamento al budget: le voci vengono aggiunte una per una a partire dalla priorità più alta fino al raggiungimento del budget di 1.800 caratteri. Se una voce supera il budget rimanente, viene omessa (o adattata se è la prima voce).

4. Formato del blocco di iniezione

Le voci attivate vengono formattate in un blocco pulito e passate al prompt di sistema del personaggio:

Relevant world info:
- Universal setting: Magic is taught only at Starfall Academy, and the outside world believes it is a myth.
- Emberwing House values courage and loyalty. Founded by Aria Emberwing; its colors are copper and black.
- Dueling spells: Flare blinds an opponent; Binding Thread slows them; Mirror Ward reflects minor curses.

Specifiche e limiti del campo

Metadati del libro di conoscenze

CampoDigitareObbligatorioLimiti e descrizione
nameStringaObbligatorioMassimo 120 caratteri. Nome del mondo o dell'ambientazione.
descriptionStringaFacoltativoMassimo 500 caratteri. Breve riassunto dell'impostazione.
visibilityStringaFacoltativo"private" (predefinito) o "public". Public I libri di conoscenze appaiono nella ricerca e nella scoperta.
tagsMatriceFacoltativoFino a 20 tag. I tag vengono tagliati e minuscoli.
entriesMatriceFacoltativoFino a 100 voci per libro di conoscenze.

Metadati della voce

CampoDigitareObbligatorioLimiti e descrizione
contentStringaObbligatorioMassimo 1.000 caratteri. Il testo informativo del mondo reale inserito nel modello.
constantBooleanoFacoltativoPredefinito false. Se true, questa voce è sempre attiva in ogni scambio di messaggi.
keysMatriceObbligatorio se non costanteFino a 20 chiavi, massimo 64 caratteri ciascuna. Attiva parole o frasi. Ignorato se constant: true.
enabledBooleanoFacoltativoPredefinito true. Disattivare per disabilitare temporaneamente una voce senza eliminarla.
priorityNumeroFacoltativoPredefinito 0. I numeri più alti vengono inseriti per primi quando lo spazio del contesto è limitato (ad es. 100, 85, 50).

Formati JSON supportati

Puoi importare, incollare ed esportare libri di conoscenze utilizzando tre formati standardizzati:

1. Schema del lorebook nativo Public (consigliato)

Questo è lo schema JSON nativo di Public. Supporta direttamente tutti i campi:

{
  "name": "Starfall Academy",
  "description": "Comprehensive lorebook covering Starfall Academy's houses, spells, lore, and magical laws.",
  "visibility": "public",
  "tags": [
    "fantasy",
    "starfall",
    "academy",
    "magic",
    "spells"
  ],
  "entries": [
    {
      "keys": [],
      "content": "Universal setting: Magic is taught only at Starfall Academy, and the outside world believes it is a myth. Magic is channeled through focus crystals.",
      "enabled": true,
      "constant": true,
      "priority": 100
    },
    {
      "keys": [
        "emberwing",
        "aria emberwing",
        "house of the phoenix"
      ],
      "content": "Emberwing House values courage and loyalty. Founded by Aria Emberwing; its colors are copper and black. Its common room is at the top of the Ember Tower.",
      "enabled": true,
      "constant": false,
      "priority": 85
    },
    {
      "keys": [
        "focus crystal",
        "crystal lore",
        "crystal vault"
      ],
      "content": "Every student bonds with one focus crystal. Crystals are grown from rare minerals and hold a single element such as flame, tide, or storm. A bond breaks only by choice.",
      "enabled": true,
      "constant": false,
      "priority": 80
    },
    {
      "keys": [
        "flare",
        "binding thread",
        "mirror ward"
      ],
      "content": "Dueling spells: Flare (blinds an opponent), Binding Thread (slows them), and Mirror Ward (creates a shield that reflects minor curses).",
      "enabled": true,
      "constant": false,
      "priority": 75
    }
  ]
}

2. Esportazione delle informazioni sul mondo di SillyTavern

L'importatore rileva automaticamente le esportazioni autonome di SillyTavern dove entries è codificato come dizionario oggetti:

{
  "name": "Starfall World Info",
  "description": "SillyTavern export",
  "entries": {
    "0": {
      "uid": 0,
      "key": ["the veil", "magic"],
      "content": "The Veil hides Starfall Academy from the outside world.",
      "constant": true,
      "disable": false,
      "order": 100
    },
    "1": {
      "uid": 1,
      "key": ["starfall academy", "castle"],
      "content": "Starfall Academy stands on a floating island above the Silver Sea.",
      "constant": false,
      "disable": false,
      "order": 50
    }
  }
}

3. Carta Personaggio Taverna Sciocco (character_book)

Puoi anche importare carte personaggio (carte specifiche V2 o V3) che raggruppano a character_book oggetto:

{
  "spec": "chara_card_v2",
  "spec_version": "2.0",
  "data": {
    "name": "Mira Vale",
    "tags": ["fantasy", "magic"],
    "character_book": {
      "name": "Starfall Library Lore",
      "description": "Magical theory and reference entries",
      "entries": [
        {
          "keys": ["silverkey", "unlocking charm"],
          "content": "The Silverkey charm unlocks standard doors and windows.",
          "enabled": true,
          "constant": false,
          "insertion_order": 10
        }
      ]
    }
  }
}

Crea e gestisci libri di conoscenze

Sul web

Vai a /lorebooks nel tuo browser o seleziona Lorebooks dal menu della barra laterale.

Creazione da zero

  1. Vai a /lorebooks/create.
  2. Dai al tuo libro di conoscenze un Nome descrittivo e una Descrizione/Tag facoltativi.
  3. Scegli la visibilità Privata o Public.
  4. Fare clic su Aggiungi voce per creare regole. Specifica le parole chiave dell'attivatore o seleziona Sempre attivo (costante).
  5. Fare clic su Crea libro di conoscenze per salvare.

Importazione di libri di conoscenze esistenti

Hai due modi rapidi per caricare le informazioni sul mondo esistente:

  1. Importa file: fai clic su Importa file nella barra delle azioni in alto per caricarne uno qualsiasi .json libro di tradizioni o file di carte dei personaggi dal tuo computer.
  2. Incolla JSON: fai clic su Incolla JSON per aprire la finestra di dialogo di analisi:
  • Fai clic su Incolla dagli appunti per estrarre il testo JSON copiato da un'altra app.
  • Fai clic su Carica esempio per controllare un modello Starfall Academy precompilato.
  • Fai clic su Analizza e importa per compilare immediatamente il modulo.

Esportazione e copia

  • In qualsiasi schermata di creazione, modifica o dettaglio di un libro di conoscenze, fare clic su Copia JSON.
  • L'intero libro di conoscenze è serializzato in Public JSON standardizzato e copiato direttamente negli appunti.

Collegamento a un personaggio AI

Una volta creato il tuo libro di conoscenze:

  1. Apri /characters/add (o fai clic su Modifica su qualsiasi personaggio che hai creato).
  2. Scorri fino al selettore Libro delle conoscenze (facoltativo).
  3. Seleziona il tuo libro del sapere o scegli tra i libri del sapere pubblici più popolari creati dalla comunità.
  4. Salva il tuo personaggio. Qualsiasi chat successiva con questo personaggio verrà automaticamente attinta dal libro del sapere.

Limiti e sblocco del piano

PianoLibri di conoscenze che puoi creareVoci per libro di conoscenze
Gratis3Fino a 100
Base10Fino a 100
Creatore/ProfessionistaIllimitatoFino a 100

La creazione del libro del sapere richiede lo sblocco dei Libri del sapere del personaggio (nello stesso livello di progressione dei personaggi della chat personalizzati). Vedi Abbonamenti e Ludicizzazione.


Best practice per i creatori

  • Utilizza parole chiave descrittive e specifiche: utilizza nomi e frasi composte come ["aria emberwing", "house of the phoenix"] piuttosto che parole brevi comuni come ["the", "is", "he"].
  • Riserva voci costanti per regole universali: Mantieni constant: true voci limitate a 1-2 regole di base (ad esempio sequenza temporale attuale, fisica del mondo centrale) in modo da non consumare l'intero budget di 1.800 caratteri.
  • Mantieni concisi i contenuti delle voci: voci di grande impatto composte da 1-3 frasi chiare consentono di inserire più voci pertinenti contemporaneamente nella finestra di contesto.
  • Utilizza i punteggi di priorità: assegna alle conoscenze fondamentali punteggi di priorità più alti (100–80) e fatti decorativi minori abbassano i punteggi (40–10) in modo che sia garantito che il contesto più critico venga iniettato per primo.

Domande frequenti

Perché la voce del mio libro di conoscenze non si attivava nella chat?

Controllare quanto segue:

  1. La voce è impostata su Abilitata?
  2. È apparsa qualcuna delle parole chiave esatte nella chat recente o nell'ultimo messaggio dell'utente? (Le corrispondenze sono corrispondenze di sottostringhe senza distinzione tra maiuscole e minuscole).
  3. Le voci con priorità più alta hanno riempito prima il budget di 1.800 caratteri? Prova ad aumentare il punteggio Priorità della voce.

Posso collegare più di un libro di conoscenze a un singolo personaggio?

Attualmente, ogni personaggio può essere collegato a un libro di conoscenze alla volta. Se hai bisogno di contenuti da più libri del sapere, combina le loro voci in un unico libro del sapere utilizzando Incolla JSON o gli strumenti di esportazione.

Cosa succede se elimino un libro del sapere?

I personaggi che hanno collegato quel libro del sapere vedranno semplicemente cancellato il riferimento al libro del sapere. Le loro conversazioni, ambientazioni e ricordi rimangono completamente intatti.

Posso modificare un libro del sapere pubblico creato da qualcun altro?

No. Solo il creatore originale può modificare un libro del sapere. Se desideri personalizzare un libro del sapere pubblico, visualizza il libro del sapere, fai clic su Copia JSON, crea un nuovo libro del sapere e incolla il JSON nella tua copia privata.

È disponibile la gestione mobile del libro di conoscenze?

La creazione e la modifica completa del libro di conoscenze è attualmente disponibile sull'app Web. Tutti i libri di conoscenze collegati ai personaggi sul web funzioneranno automaticamente nella chat su tutte le piattaforme, incluse Android e iOS.


Documentazione correlata

In questa pagina