Ключи лорбука: как писать триггеры, которые срабатывают
Ключ — это слово, которое включает запись лорбука. Как подбирать живые ключи, сколько их делать, когда нужны вторичные ключи и регулярные выражения.
- Автор
- Scenly
- Опубликовано
TL;DR
- Ключ — это подстрока: запись срабатывает, если ключ встречается в недавних сообщениях. «Шрам» ловит и «шрамы», и «шрама».
- Живой ключ — слово, которое реально прозвучит в чате. Мёртвый — красивое название, которое никто не произнесёт.
- На запись можно повесить до 32 ключей. Два-шесть точных — рабочая норма.
- Вторичные ключи требуют совпадения двух условий сразу — это фильтр от ложных срабатываний.
- Регулярные выражения — для сложных правил, но только на первом ключе и с ограничениями.
Как платформа ищет ключ
Перед каждым ответом платформа собирает окно просмотра — текст последних сообщений (по умолчанию четыре). Дальше для каждой записи проверяет: встречается ли хоть один её ключ в этом тексте.
Проверка идёт по подстроке, без учёта регистра (если не включено обратное). Из этого следуют четыре свойства, которые определяют всё искусство ключей:
- Ключ ловит свои формы. «Шрам» сработает на «шрамы», «шрама», «шрамом». Не нужно перечислять словоформы.
- Ключ ловит себя внутри других слов. «Кот» сработает на «котлете» и «скотче». Короткие ключи опасны.
- Регистр по умолчанию не важен. «Шрам» и «Шрам» равны. Включайте учёт регистра только когда это действительно смысловая разница.
- Ключ ищется в тексте, а не в смысле. Синонимы не срабатывают: запись про «эспрессо» не включится от слова «кофе» — добавьте оба как ключи.
Живые и мёртвые ключи
Живой ключ — слово, которое реально прозвучит в чате. Проверка простая: представьте сцену и спросите, произнёс бы кто-нибудь это слово вслух или написал бы в сообщении.
Мёртвый ключ — запись с ним никогда не включится. Типичные мертвецы:
- названия-ярлыки. «Тайна западной башни» — так никто не скажет. Живой вариант: «башня», «западная», «тайна»;
- плейсхолдеры. «Слово из реплики», «синоним», «пример» — остатки шаблона. Платформа распознаёт их и считает запись пустой;
- слишком общие слова. «Жизнь», «чувства», «вопрос» — сработают почти в любом сообщении. Запись станет постоянной, только неуправляемой;
- слова не из лексикона чата. Если персонаж говорит «кофе», ключ «эспрессо» может не встретиться никогда;
- длинные фразы. Ключ на пять слов сработает, только если вся фраза прозвучит дословно. Это почти никогда не происходит.
Быстрый тест на живость: ключ из одного-двух слов, конкретный, из речи персонажа или собеседника — живой. Ключ-название, ключ-фраза, ключ-абстракция — мёртвый.
Сколько ключей ставить
На запись можно повесить до 32 ключей, но рабочая норма — два-шесть.
Логика такая:
- один ключ — хрупко. Если собеседник выразит тему другим словом, запись промолчит;
- два-шесть — покрытие синонимов и форм: «шрам», «шрамы», «рубец», «шрамирование»;
- больше шести — обычно размывает: половина ключей мёртвые, а поддерживать список тяжело.
Что стоит добавлять в ключи:
- синонимы, которыми тема может прозвучать: «прошлое», «былое», «тогда»;
- прямые и эвфемистичные формулировки для деликатных тем: и «секс», и «близость»;
- имена собственные, если запись о конкретном человеке или месте;
- глаголы действия, если запись о поступке: «поцеловать», «обнять» — а не только «поцелуй».
Что не стоит: словоформы (подстрока их ловит сама), предлоги и местоимения (сработают везде), слова из названия записи (название модель не видит).
Вторичные ключи
Обычная запись срабатывает, если найден хоть один ключ. Выборочное совпадение меняет правило: нужен основной ключ и хотя бы один вторичный.
Для чего это нужно — фильтр ложных срабатываний. Пример:
- запись о том, как персонаж реагирует на свою бывшую;
- основной ключ: «Лера» (имя);
- вторичные: «встретил», «позвонила», «написала».
Без вторичных запись сработает на любое упоминание имени — даже в постороннем разговоре. С ними — только когда имя прозвучало рядом с действием, то есть тема реально всплыла.
Когда вторичные ключи оправданы:
- имя или термин встречается в разных контекстах, а запись нужна для одного;
- тема широкая, а реакция нужна на конкретный её поворот.
Когда не нужны: если ключ и так достаточно специфичен. Вторичные ключи на запись с ключом «полуночный колокол» — перестраховка, которая только снижает шансы срабатывания.
Учёт регистра
По умолчанию регистр не учитывается: «Шрам», «шрам» и «ШРАМ» равны. Это правильно для 95% случаев.
Включать учёт регистра стоит, когда регистр несёт смысл:
- имена собственные, совпадающие с обычными словами. «Луна» (имя персонажа) против «луна» (объект на небе);
- аббревиатуры. «МИР» как организация против «мир» как понятие;
- начало предложения как маркер. Редкий случай, но бывает.
Побочный эффект: с включённым регистром запись пропустит «шрам» в начале предложения, если ключ задан как «Шрам». Поэтому включайте осознанно и проверяйте в чате.
Регулярные выражения
Если ключей-подстрок не хватает, первый ключ записи можно сделать регулярным выражением — шаблоном, который описывает сразу класс слов.
Примеры того, что решает regex:
шрам[ыауом]*— все формы слова «шрам» одним шаблоном;(Лера|Валерия|Лерка)— имя во всех вариантах;\bкот\b— слово «кот» целиком, без «котлет» и «скотча».
Ограничения, о которых нужно знать:
- regex — только на первом ключе. Остальные ключи записи при этом игнорируются;
- длина шаблона — до 200 символов;
- шаблон проверяется на безопасность. Конструкции, которые могут подвесить поиск — обратные ссылки, вложенные квантификаторы — отклоняются. Неверный шаблон просто не срабатывает;
- при regex вторичные ключи не используются.
Когда regex оправдан: сложные словоформы, чередования, границы слов. Когда нет: во всех остальных случаях обычные ключи проще и надёжнее. Если можно решить двумя-тремя ключами — не берите regex.
Частые вопросы
Ключи на русском или английском? На языке чата. Платформа ищет подстроку в тексте сообщений — если чат на русском, английский ключ не сработает.
Можно ли использовать один ключ в нескольких записях? Да. Сработают все записи с этим ключом — в порядке вставки, пока хватает бюджета.
Ключ срабатывает на часть слова — это баг?
Нет, это свойство подстроки. Если оно мешает — либо удлините ключ («котёл» вместо «кот»), либо используйте regex с границами слова (\bкот\b).
Сколько ключей оптимально? Два-шесть живых. Больше — только если у темы действительно много синонимов, которые реально прозвучат.
Почему запись не сработала, хотя ключ был в чате? Проверьте: включена ли запись; не ушла ли тема дальше глубины просмотра (по умолчанию 4 сообщения); не выкинули ли запись по бюджету; не включён ли учёт регистра с несовпадающим регистром.
Можно ли тестировать ключи без чата? Прямого тестера в редакторе нет. Практический способ: начните чат, произнесите ключ, посмотрите на поведение персонажа — сработавшая запись меняет его знание о теме.
Что дальше
- Лорбук персонажа: факты, которые включаются по ключам — общее устройство книги и записей.
- 7 ошибок, из-за которых персонаж получается плоским — мёртвые ключи как ошибка номер семь.
- Описание персонажа: короткое досье вместо биографии — что не должно попадать в лорбук.
Собираете лорбук с нуля? Конструктор пишет записи с живыми ключами — возьмите их как образец.