Лорбук7 минут чтения

Лорбук персонажа: факты, которые включаются по ключам

Лорбук — память персонажа, которая работает по триггерам: запись попадает в ответ только когда в чате звучит её ключ. Как это устроено и чем лорбук отличается от описания.

Автор
Scenly
Опубликовано

TL;DR

  • Лорбук — это набор заметок, которые попадают в ответ модели только тогда, когда в недавних сообщениях звучит их ключ.
  • Главное отличие от описания: описание работает всегда, лорбук — по триггеру. Поэтому лорбук не тратит контекст, когда не нужен.
  • В лорбук складывают то, что верно «иногда»: внешность в деталях, хобби, хронологию прошлого, факты мира.
  • Ключи — это слова, которые реально прозвучат в чате. Мёртвый ключ — запись, которая никогда не сработает.
  • В Scenly лорбук — четвёртая вкладка редактора персонажа, и он полностью переносится при импорте и экспорте карточки.

Зачем нужен лорбук

У любой карточки есть естественный предел: описание, характер и сценарий читаются моделью в каждом ответе. Положите туда биографию на 2000 символов — и она будет тратить место в каждой реплике, даже когда речь идёт о завтраке.

Лорбук решает это иначе. Каждая его запись спит до тех пор, пока в чате не прозвучит её ключ. Написали про шрам — включилась запись о шраме. Заговорили о прошлом — включилась запись о прошлом. Не трогаете эти темы — записи не тратят ничего.

Это и есть разделение труда:

  • описание — то, что верно всегда: кто персонаж, как относится к собеседнику;
  • лорбук — то, что верно иногда: детали, которые всплывают по теме.

Персонаж с большим миром, историей и приметами без лорбука либо теряет эти детали, либо раздувает описание до бесполезности. С лорбуком — держит всё и тратит только по необходимости.


Как работает срабатывание

Механика простая, и её полезно понимать, чтобы писать ключи правильно.

Перед каждым ответом платформа смотрит на недавние сообщения чата — по умолчанию последние четыре. Весь этот текст склеивается в одно «окно просмотра».

Дальше для каждой записи лорбука проверяется: есть ли в окне её ключ? Проверка идёт по подстроке — ключ «шрам» сработает и на «шрам», и на «шрамы», и на «шрама».

Сработавшие записи собираются и вставляются в запрос к модели — рядом с описанием и характером, в зависимости от настроек записи. Не сработавшие — не вставляются никуда.

Три следствия из этой механики:

  1. Ключ должен звучать в репликах. Не «в мире персонажа», а в тексте сообщений. Если никто никогда не скажет «полуночный колокол западной башни» — запись мертва.
  2. Слишком общий ключ — тоже плохо. Ключ «жизнь» сработает почти в любом сообщении, и запись станет постоянной, только неуправляемой.
  3. Глубина просмотра ограничивает память. Если тема всплыла десять сообщений назад, а глубина — четыре, запись уже не сработает. Для долгих тем поднимайте глубину или повторяйте ключевые слова.

Из чего состоит лорбук

Лорбук — это книга с настройками и записи внутри.

Настройки книги:

  • Название и описание — для вас, модель их не видит;
  • Глубина просмотра — сколько последних сообщений проверять на ключи. По умолчанию 4, максимум 100;
  • Бюджет — сколько токенов лорбук может занять в ответе. По умолчанию 2 048, максимум 24 000;
  • Рекурсия — искать ли ключи также в тексте уже включённых записей. Полезно для цепочек: запись о «доме» включает запись о «подвале дома».

Каждая запись:

  • Ключи — до 32 слов, каждое до 200 символов. Срабатывание идёт по любому из них;
  • Текст — сам факт, который попадёт в модель;
  • Включено — выключенная запись не срабатывает, но и не удаляется;
  • Название и комментарий — служебные пометки для вас;
  • Постоянная запись — включается всегда, без ключей;
  • Учитывать регистр — по умолчанию выключено: «Шрам» и «шрам» равны;
  • Регулярное выражение — первый ключ трактуется как шаблон;
  • Выборочное совпадение — требовать вместе с ключом ещё и вторичный;
  • Позиция — вставить до или после текста персонажа;
  • Порядок вставки — в каком порядке записи идут внутри промпта;
  • Приоритет — кого выкидывать первым, если записи не влезли в бюджет.

Что складывать в лорбук

Правило из статьи про описание: в лорбук — то, что верно иногда. Практический список:

Внешность в деталях. Цвет глаз, длина волос, шрамы, татуировки, любимый наряд. В описании — только то, что влияет на поведение; всё остальное — сюда.

Хобби и привычки. «Залипает в РПГ-игры до утра», «тайно рисует портреты собеседника». Всплывут, когда тема коснётся.

Хронология прошлого. Биография по фактам: где учился, где работал, что пережил. Каждая веха — отдельная запись со своими ключами.

Факты мира. Если у персонажа есть сеттинг — правила мира, названия мест, второстепенные персонажи, история отношений.

Темы-табу. О чём персонаж не говорит и почему. Запись сработает, когда собеседник случайно затронет больную тему — и модель будет знать, как реагировать.

Чего в лорбуке быть не должно: того, что верно всегда. «Персонаж не доверяет людям» — это описание или характер, а не запись по ключу.


Постоянные записи

Обычная запись ждёт ключа. Постоянная (constant: true) — включается всегда, без условий.

Для чего она годится:

  • один базовый факт сеттинга, без которого сцена не читается: «действие происходит в городе, где запрещена магия»;
  • ключевое правило отношений: «персонаж и собеседник связаны контрактом».

Но у постоянной записи есть цена: она занимает контекст в каждой реплике, как описание. Поэтому правило платформы жёсткое — постоянная может быть только одна, и она должна быть короткой.

Если вам хочется сделать постоянными пять записей — скорее всего, это материал для описания или характера, а не для лорбука.


Бюджет и приоритет

Бюджет — это потолок: сколько символов лорбука может попасть в один ответ. По умолчанию 2 048 токенов — при кириллице это примерно 4 000 символов текста записей.

Что происходит, когда сработавших записей больше, чем влезает в бюджет: платформа начинает выкидывать лишние. Первыми уходят записи без приоритета, среди них — с меньшим порядком вставки.

Практический вывод:

  • не пишите простыни. Запись на 200 символов — норма. Запись на 2 000 — это статья, а не заметка;
  • приоритет — для важного. Если какая-то запись критична для персонажа, задайте ей приоритет — её выкинут последней;
  • много записей — поднимайте бюджет. Но помните: всё, что включилось, уходит в ответ. Бюджет 24 000 — это уже половина контекста чата.

Лорбук в редакторе Scenly

Лорбук — четвёртая вкладка редактора персонажа, рядом с «Персонажем», «Промптом» и «Приветствиями».

Что там есть:

  • счётчик «Включено N из M» — сколько записей активны;
  • поиск по записям — полезно, когда их много;
  • настройки книги — название, описание, глубина, бюджет, рекурсия;
  • список записей с открытием каждой в отдельной панели;
  • лимит — до 500 записей на книгу.

На странице персонажа лорбука нет: как и остальные промпт-поля, он видит только модель. Публично видны имя, описание для людей, метки и первое сообщение.

При импорте и экспорте карточки лорбук переносится целиком — со всеми записями, ключами и настройками. Формат карточек хранит его внутри, отдельного файла не требуется: и в JSON, и в PNG, и в CHARX лорбук едет вместе с карточкой.


Частые вопросы

Обязателен ли лорбук? Нет. Большинство персонажей обходится без него. Лорбук нужен, когда фактов много и они не должны звучать в каждой реплике.

Сколько записей делать? Столько, сколько нужно, до 500. Но каждая запись — это потенциальный контекст в ответе. Пять точных записей лучше тридцати расплывчатых.

Ключи на русском или английском? На том языке, на котором будет чат. Если чат на русском — ключи русские. Модель проверяет текст сообщений, а не «смысл».

Можно ли использовать один ключ в нескольких записях? Да, сработают все записи с этим ключом — в порядке вставки, пока хватает бюджета.

Что если запись не срабатывает, хотя ключ звучит? Проверьте четыре вещи: включена ли запись; не превышен ли бюджет (запись могли выкинуть); не стоит ли «учитывать регистр» с несовпадающим регистром; не вытеснило ли окно просмотра — тема могла уйти дальше глубины.

Лорбук виден другим людям? Нет. Как и все промпт-поля, он видит только модель. На странице персонажа его нет.

Лорбук переносится в другие сервисы? Формат карточек хранит лорбук внутри файла, и большинство площадок его читают. Но набор поддерживаемых настроек у всех разный — часть полей может не подхватиться.


Что дальше

  1. Описание персонажа: короткое досье вместо биографии — что остаётся в описании, а что переезжает в лорбук.
  2. Все поля карточки персонажа — место лорбука среди остальных полей.
  3. 7 ошибок, из-за которых персонаж получается плоским — ошибка 7 как раз про мёртвые ключи.

Хотите собрать персонажа с готовым лорбуком? Конструктор пишет записи с живыми ключами — а вы дополните своими.