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

Ключи лорбука: как писать триггеры, которые срабатывают

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

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

TL;DR

  • Ключ — это подстрока: запись срабатывает, если ключ встречается в недавних сообщениях. «Шрам» ловит и «шрамы», и «шрама».
  • Живой ключ — слово, которое реально прозвучит в чате. Мёртвый — красивое название, которое никто не произнесёт.
  • На запись можно повесить до 32 ключей. Два-шесть точных — рабочая норма.
  • Вторичные ключи требуют совпадения двух условий сразу — это фильтр от ложных срабатываний.
  • Регулярные выражения — для сложных правил, но только на первом ключе и с ограничениями.

Как платформа ищет ключ

Перед каждым ответом платформа собирает окно просмотра — текст последних сообщений (по умолчанию четыре). Дальше для каждой записи проверяет: встречается ли хоть один её ключ в этом тексте.

Проверка идёт по подстроке, без учёта регистра (если не включено обратное). Из этого следуют четыре свойства, которые определяют всё искусство ключей:

  1. Ключ ловит свои формы. «Шрам» сработает на «шрамы», «шрама», «шрамом». Не нужно перечислять словоформы.
  2. Ключ ловит себя внутри других слов. «Кот» сработает на «котлете» и «скотче». Короткие ключи опасны.
  3. Регистр по умолчанию не важен. «Шрам» и «Шрам» равны. Включайте учёт регистра только когда это действительно смысловая разница.
  4. Ключ ищется в тексте, а не в смысле. Синонимы не срабатывают: запись про «эспрессо» не включится от слова «кофе» — добавьте оба как ключи.

Живые и мёртвые ключи

Живой ключ — слово, которое реально прозвучит в чате. Проверка простая: представьте сцену и спросите, произнёс бы кто-нибудь это слово вслух или написал бы в сообщении.

Мёртвый ключ — запись с ним никогда не включится. Типичные мертвецы:

  • названия-ярлыки. «Тайна западной башни» — так никто не скажет. Живой вариант: «башня», «западная», «тайна»;
  • плейсхолдеры. «Слово из реплики», «синоним», «пример» — остатки шаблона. Платформа распознаёт их и считает запись пустой;
  • слишком общие слова. «Жизнь», «чувства», «вопрос» — сработают почти в любом сообщении. Запись станет постоянной, только неуправляемой;
  • слова не из лексикона чата. Если персонаж говорит «кофе», ключ «эспрессо» может не встретиться никогда;
  • длинные фразы. Ключ на пять слов сработает, только если вся фраза прозвучит дословно. Это почти никогда не происходит.

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


Сколько ключей ставить

На запись можно повесить до 32 ключей, но рабочая норма — два-шесть.

Логика такая:

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

Что стоит добавлять в ключи:

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

Что не стоит: словоформы (подстрока их ловит сама), предлоги и местоимения (сработают везде), слова из названия записи (название модель не видит).


Вторичные ключи

Обычная запись срабатывает, если найден хоть один ключ. Выборочное совпадение меняет правило: нужен основной ключ и хотя бы один вторичный.

Для чего это нужно — фильтр ложных срабатываний. Пример:

  • запись о том, как персонаж реагирует на свою бывшую;
  • основной ключ: «Лера» (имя);
  • вторичные: «встретил», «позвонила», «написала».

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

Когда вторичные ключи оправданы:

  • имя или термин встречается в разных контекстах, а запись нужна для одного;
  • тема широкая, а реакция нужна на конкретный её поворот.

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


Учёт регистра

По умолчанию регистр не учитывается: «Шрам», «шрам» и «ШРАМ» равны. Это правильно для 95% случаев.

Включать учёт регистра стоит, когда регистр несёт смысл:

  • имена собственные, совпадающие с обычными словами. «Луна» (имя персонажа) против «луна» (объект на небе);
  • аббревиатуры. «МИР» как организация против «мир» как понятие;
  • начало предложения как маркер. Редкий случай, но бывает.

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


Регулярные выражения

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

Примеры того, что решает regex:

  • шрам[ыауом]* — все формы слова «шрам» одним шаблоном;
  • (Лера|Валерия|Лерка) — имя во всех вариантах;
  • \bкот\b — слово «кот» целиком, без «котлет» и «скотча».

Ограничения, о которых нужно знать:

  • regex — только на первом ключе. Остальные ключи записи при этом игнорируются;
  • длина шаблона — до 200 символов;
  • шаблон проверяется на безопасность. Конструкции, которые могут подвесить поиск — обратные ссылки, вложенные квантификаторы — отклоняются. Неверный шаблон просто не срабатывает;
  • при regex вторичные ключи не используются.

Когда regex оправдан: сложные словоформы, чередования, границы слов. Когда нет: во всех остальных случаях обычные ключи проще и надёжнее. Если можно решить двумя-тремя ключами — не берите regex.


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

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

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

Ключ срабатывает на часть слова — это баг? Нет, это свойство подстроки. Если оно мешает — либо удлините ключ («котёл» вместо «кот»), либо используйте regex с границами слова (\bкот\b).

Сколько ключей оптимально? Два-шесть живых. Больше — только если у темы действительно много синонимов, которые реально прозвучат.

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

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


Что дальше

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

Собираете лорбук с нуля? Конструктор пишет записи с живыми ключами — возьмите их как образец.