книги знаний
Подробное руководство по созданию, импорту, управлению и связыванию книг знаний с ИИ-персонажами на Public.
Книги знаний (часто называемые Мировая информация) — это отдельные сборники знаний, фактов о событиях, подробностей о фракциях, магических системах и справочных знаний, на которые вы можете ссылаться. ИИ-персонажи. Когда вы общаетесь с персонажем, соответствующие записи из связанной книги знаний динамически извлекаются и вводятся непосредственно в подсказку модели.
В отличие от основной личности персонажа, книга знаний полностью модульна: вы можете связать одну и ту же книгу знаний с несколькими персонажами (например, связать общую книгу знаний Starfall Academy с Мирой, Тобином, профессором Вейлом и лордом Эшгрейвом) или поменять местами книги знаний, не меняя голос персонажа.
Основные понятия
Чтобы получить максимальную отдачу от лорбуков, полезно понять, как они сочетаются с другими инструментами ролевой игры на Public:
- Личность персонажа — определяет кем является персонаж: его стиль речи, предысторию, причуды и правила поведения.
- Персонажи чата — определяют кто вы: ваше имя, внешний вид и личность в разговоре. См. Персонажи чата.
- Книги знаний — определяют мир вокруг вас: исторические события, фракции, локации, заклинания, технологические правила и знания взаимоотношений.
Частные и публичные книги знаний
| Видимость | Кто может связать это с персонажем | Кто может редактировать или удалять его |
|---|---|---|
| Частный | Только ты | Только ты (создатель) |
| Public | Любой создатель на Public может связать его при создании или редактировании своих персонажей. | Только ты (создатель) |
Только владелец может редактировать или удалять книгу знаний. Если вы удалите книгу знаний, все персонажи, связанные с ней, благополучно потеряют ссылку, не потеряв при этом свою историю разговоров или личности.
Как работает внедрение контекста
Когда вы отправляете сообщение в текстовом чате, серверная часть запускает быстрый конвейер сборки контекста, прежде чем генерировать ответ ИИ:
1. Сканированные текстовые объекты
Механизм контекста проверяет соответствие записей во всем активном контексте разговора:
- Последнее входящее сообщение пользователя
- История последних разговоров в чате
- Прокручивающееся резюме разговора
- Закрепленные и автоматически извлеченные воспоминания персонажей.
- Оригинальное приветствие персонажа
2. Типы соответствия записей
Каждая запись в лорбуке имеет одно из двух триггеров поведения:
- По ключевому слову (
constant: false) — Запись определяет список ключевых слов (например,["emberwing", "house of the phoenix"]). Если какое-либо ключевое слово появляется где-либо в отсканированном тексте разговора (совпадение подстроки без учета регистра), запись срабатывает. - Постоянная (
constant: true) — Запись всегда включается в каждый обмен сообщениями, полностью игнорируя ключевые слова. Идеально подходит для глобальных базовых сценариев (например, "1204 год, Завеса скрывает Starfall Academy от внешнего мира").
3. Управление приоритетами и бюджетом
Модели имеют ограниченное количество контекстных окон подсказок. Чтобы обеспечить быстроту, согласованность и экономичность реагирования, Public устанавливает бюджет внедрения:
- Ограничение бюджета на количество символов: до 1800 символов (
LOREBOOK_INJECT_MAX_CHARS) содержимого книги знаний можно вводить в каждое сообщение. – Приоритетный порядок. Все совпадающие записи (как постоянные, так и связанные с ключевыми словами) сортируются по Приоритету в порядке убывания (100раньше50, прежде чем0). – Соответствие бюджету. Записи добавляются одна за другой, начиная с самого высокого приоритета, пока не будет достигнут бюджет в 1800 символов. Если запись превышает оставшийся бюджет, она опускается (или добавляется, если это первая запись).
4. Формат блока впрыска
Триггерные записи форматируются в чистый блок и передаются в системную подсказку персонажа:
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.Спецификации и ограничения полей
Метаданные книги знаний
| Поле | Тип | Требуется | Ограничения и описание |
|---|---|---|---|
name | Строка | Обязательно | Макс. 120 символов. Название мира или сеттинга. |
description | Строка | Необязательно | Макс. 500 символов. Краткое описание сеттинга. |
visibility | Строка | Необязательно | "private" (по умолчанию) или "public". Public книги знаний появляются в поиске и открытии. |
tags | Массив | Необязательно | До 20 тегов. Теги обрезаны и переведены в нижний регистр. |
entries | Массив | Необязательно | До 100 записей в книге знаний. |
Метаданные записи
| Поле | Тип | Требуется | Ограничения и описание |
|---|---|---|---|
content | Строка | Обязательно | Максимум 1000 символов. Фактический текст мировой информации, введенный в модель. |
constant | логическое значение | Необязательно | По умолчанию false. Если true, эта запись всегда активна при каждом обмене сообщениями. |
keys | Массив | Обязательно, если не постоянно | До 20 клавиш, максимум 64 символа каждая. Триггерные слова или фразы. Игнорируется, если constant: true. |
enabled | логическое значение | Необязательно | По умолчанию true. Выключите, чтобы временно отключить запись, не удаляя ее. |
priority | Номер | Необязательно | По умолчанию 0. Более высокие числа вводятся первыми, когда контекстное пространство ограничено (например, 100, 85, 50). |
Поддерживаемые форматы JSON
Вы можете импортировать, вставлять и экспортировать книги знаний, используя три стандартизированных формата:
1. Собственная схема книги знаний Public (рекомендуется)
Это собственная схема JSON Public. Он поддерживает все поля напрямую:
{
"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. Экспорт информации о SillyTavern World
Импортер автоматически определяет автономный экспорт SillyTavern, в котором entries используется как словарь объектов:
{
"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. Карта персонажа SillyTavern (character_book)
Вы также можете импортировать карты персонажей (карты спецификаций V2 или V3), которые включают в себя character_book объект:
{
"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
}
]
}
}
}Создавайте и управляйте книгами знаний
В сети
Перейдите к /lorebooks в браузере или выберите Книги знаний в меню боковой панели.
Создание с нуля
- Перейти к
/lorebooks/create. - Дайте вашей книге знаний описательное Имя и необязательное Описание/Теги.
- Выберите видимость Частный или Public.
- Нажмите Добавить запись, чтобы создать правила. Укажите ключевые слова триггера или установите флажок Всегда активен (постоянный).
- Нажмите Создать книгу знаний, чтобы сохранить.
Импорт существующих книг знаний
У вас есть два быстрых способа загрузить существующую информацию о мире:
- Импортировать файл — нажмите Импортировать файл в верхней панели действий, чтобы загрузить любой файл.
.jsonкнига знаний или файл карты персонажа с вашего компьютера. - Вставить JSON — нажмите Вставить JSON, чтобы открыть диалоговое окно анализа: – Нажмите Вставить из буфера обмена, чтобы получить текст JSON, скопированный из другого приложения. – Нажмите Загрузить пример, чтобы просмотреть предварительно заполненный шаблон Starfall Academy. – Нажмите Разобрать и импортировать, чтобы мгновенно заполнить форму.
Экспорт и копирование
- На любом экране создания, редактирования или подробного описания книги знаний нажмите Копировать JSON.
- Вся книга знаний преобразуется в стандартизированный формат Public JSON и копируется прямо в буфер обмена.
Привязка к ИИ-персонажу
После создания лорбука:
- Открыть
/characters/add(или нажмите Редактировать на любом созданном вами персонаже). - Прокрутите список до пункта выбора Книга знаний (необязательно).
- Выберите свою книгу знаний или одну из популярных общедоступных книг знаний, созданных сообществом.
- Сохраните своего персонажа. Любые последующие чаты с этим персонажем будут автоматически взяты из книги знаний.
Ограничения плана и разблокировка
| План | Лорбуки, которые вы можете создать | Записей в лорбуке |
|---|---|---|
| Бесплатно | 3 | До 100 |
| Базовый | 10 | До 100 |
| Автор/Профессионал | Безлимитный | До 100 |
Для создания книги знаний требуется разблокировка книги истории персонажей (на том же уровне развития, что и пользовательские персонажи в чате). См. Подписки и Геймификация.
Рекомендации для авторов
– Используйте описательные, конкретные ключевые слова. Используйте имена и сложные фразы, например ["aria emberwing", "house of the phoenix"] а не обычные короткие слова, такие как ["the", "is", "he"].
- Зарезервируйте постоянные записи для универсальных правил: Сохранить
constant: trueзаписи ограничены 1–2 базовыми правилами (например, текущая временная шкала, основная физика мира), поэтому они не занимают весь бюджет в 1800 символов. – Содержание записей должно быть кратким. Эффектные записи, состоящие из 1–3 понятных предложений, позволяют одновременно разместить несколько релевантных записей в контекстном окне. - Используйте оценки приоритета: Дайте фундаментальным знаниям более высокий приоритет (
100–80) и незначительные декоративные элементы получают более низкие баллы (40–10), поэтому наиболее критический контекст гарантированно будет внедрен первым.
Часто задаваемые вопросы
Почему моя запись в лоребуке не сработала в чате?
Проверьте следующее:
- Установлен ли для записи статус Включен?
- Появлялись ли какие-либо точные ключевые слова в недавнем чате или последнем приглашении пользователя? (Совпадения — это совпадения подстрок без учета регистра).
- Заполнили ли записи с более высоким приоритетом бюджет в 1800 символов первыми? Попробуйте повысить оценку Приоритета записи.
Могу ли я связать более одной книги знаний с одним персонажем?
В настоящее время каждый персонаж может быть связан с одной книгой знаний одновременно. Если вам нужен контент из нескольких книг знаний, объедините их записи в одну книгу знаний с помощью Вставить JSON или инструментов экспорта.
Что произойдет, если я удалю книгу знаний?
У персонажей, которые связали эту книгу знаний, ссылка на книгу знаний будет просто удалена. Их разговоры, обстановка и воспоминания остаются полностью нетронутыми.
Могу ли я редактировать общедоступную книгу знаний, созданную кем-то другим?
Нет. Только оригинальный создатель может редактировать лорбук. Если вы хотите настроить общедоступную книгу знаний, просмотрите ее, нажмите Копировать JSON, создайте новую книгу знаний и вставьте JSON в свою личную копию.
Доступно ли управление мобильной книгой истории?
Полное создание и редактирование книги знаний в настоящее время доступно в веб-приложении. Любые книги знаний, связанные с персонажами в сети, будут автоматически работать в чате на всех платформах, включая Android и iOS.
Сопутствующая документация
- ИИ-персонажи — создавайте собственных персонажей и связывайте книги знаний
- Персонажи чата — определите, кто вы в ролевой игре
- Подписки — планируйте квоты и разблокировку функций
- Веб-обзор — веб-навигация и функции