로어북 항목: 키, 위치, 타이밍

항목은 로어북에 담긴 사실 하나와, Marinara가 그 사실을 프롬프트에 넣을 시점을 정하는 규칙으로 이루어집니다. 이 가이드에서는 항목을 추가하는 방법, 키와 항목 유형을 고르는 방법, 항목이 들어갈 자리를 정하는 방법, 타이밍을 설명합니다.

시작하기 전에: 로어북을 만들고 여세요. 로어북 개요를 참고하세요.

Entries 탭

Lorebooks(로어북) 패널에서 로어북을 여세요. 편집기에는 Overview(개요)와 Entries(항목) 두 탭이 있습니다. Entries를 클릭하면 목록이 보입니다. 탭의 배지는 항목 수를 나타냅니다.

도구 모음에는 다음 컨트롤이 있습니다.

• Search entries…는 이름, 키, 내용으로 목록을 걸러 냅니다.
• 정렬 메뉴에서는 Order(순서), Entries, Name A→Z, Name Z→A, Tokens ↓, Keys ↓, Fired ↓, Newest, Oldest 중에서 고릅니다. ↓가 붙은 옵션은 큰 값부터 작은 값 순으로 정렬합니다.
• Select(선택)는 다중 선택을 켭니다. 여러 항목을 복사, 이동, 삭제할 수 있습니다.
• Add Folder(폴더 추가)는 폴더를 만듭니다(항목 폴더 참고).
• Add Entry(항목 추가)는 빈 항목을 맨 위에 추가합니다.

도구 모음 아래 줄에는 항목 수, 폴더 수, 전체 항목 내용의 예상 토큰 합계가 표시됩니다.

항목 추가와 편집

1. Add Entry를 클릭하세요. 새 행이 나타납니다.
2. 행에 이름을 입력하세요. 모든 항목에는 이름이 필요합니다. 이름은 AI가 아니라 직접 찾아볼 때와 검색을 위한 것입니다.
3. 행이나 행의 화살표를 클릭하세요. 행 아래에 모든 필드가 담긴 패널이 열립니다.
4. Primary Keys(주요 키워드)에 키를 입력하고 <kbd>Enter</kbd>를 누르세요. 그런 다음 Content(내용)에 AI에게 보낼 글을 쓰세요. 내용과 키를 참고하세요.

편집한 내용은 자동으로 저장됩니다. 드로어에 Autosaving…, Saving…, Saved automatically가 차례로 표시됩니다. 저장에 실패해도 입력한 글은 그대로 남고, 다음에 편집할 때 Marinara가 다시 시도합니다.

항목을 복사하려면 행의 Duplicate entry(항목 복제)를 클릭하세요. 삭제하려면 Delete entry(항목 삭제)를 클릭하고 확인하세요. 컴퓨터에서는 행 위에 마우스를 올리면 이 버튼이 나타납니다.

내용과 키

키가 10개를 넘으면 처음 10개만 표시됩니다. 나머지를 보려면 Show N more(N개 더 보기)를 클릭하고, 다시 숨기려면 Collapse(접기)를 클릭하세요. 숨겨진 키도 그대로 일치 여부를 검사합니다.

예를 들어 이름이 Silverhaven이고 키가 Silverhaven과 the capital이며 내용이 Silverhaven is the mountain capital. Its people mine blue crystal and distrust outsiders.인 항목은, 최근 채팅에 두 키 중 하나가 나올 때마다 AI에 전달됩니다.

일치 규칙

기본적으로 키는 최근 채팅 어디에든 나오면 일치하며, 대소문자는 구분하지 않습니다. 이 동작을 바꾸는 컨트롤은 세 가지입니다.

• Whole Words(전체 일치): 항목 패널에 있고 기본값은 꺼짐입니다. 키가 단어 전체로 일치해야 합니다. Ash는 "Ash"에는 일치하지만 "cash"에는 일치하지 않습니다.
• Case Sensitive(대소문자 구분): 항목 패널에 있고 기본값은 꺼짐입니다. 대소문자까지 일치해야 합니다. IT는 "IT"에는 일치하지만 "it"에는 일치하지 않습니다.
• Regex(정규식): 행에 있는 아이콘으로, 툴팁은 Enable regex key matching(정규식 키 일치 활성화)이고 기본값은 꺼짐입니다. 각 키를 글에서 패턴을 찾는 표기법인 정규식으로 다룹니다. 켜면 아이콘이 주황색으로 바뀝니다.

Regex는 정규식을 알 때만 쓰세요. 각 패턴은 짧은 시간 제한 안에서 실행되고, 너무 오래 걸리는 패턴은 일치하지 않은 것으로 처리되므로 패턴은 단순하게 유지하세요. 예를 들어 \bVlad(?:'s)?\b는 "Vlad"와 "Vlad's"에 일치합니다.

항목 유형 고르기

행의 색점을 클릭하면 유형 메뉴가 열립니다.

• Normal(초록 점, 기본값): 주요 키워드가 일치하면 활성화됩니다. 사람, 장소, 물건 등 대부분의 항목에 쓰세요. 항목마다 구체적인 키를 3개에서 8개까지 넣으세요.
• Constant(노란 점): 로어북이 활성 상태이면 키 없이 매번 활성화됩니다. 연도나 분위기처럼 항상 들어가야 하는 몇 안 되는 사실에 쓰세요. 타이밍, 확률, 필터는 그대로 적용됩니다.
• Selective(빨간 점): 주요 키워드가 일치하고 보조 키워드 논리까지 통과하면 활성화됩니다. 흔한 키가 엉뚱한 장면에서 작동할 때 쓰세요.

Constant 항목은 메시지마다 토큰을 쓰므로 개수를 적게 유지하세요.

Selective 항목에는 Secondary Keys를 추가하고 Logic(논리) 버튼을 고르세요.

예를 들어 주요 키워드가 king, 보조 키워드가 Silverhaven이고 AND Any인 항목은 채팅에 둘 다 언급될 때만 작동합니다.

작동하지 않는 경우: 키가 없는 Normal 항목은 일치할 대상이 없습니다. 키를 추가하거나 Constant로 만드세요. 키가 없는 항목도 의미로 찾을 수는 있지만, 시맨틱 검색이 완전히 설정되어 있을 때만 가능합니다.

위치, 깊이, 순서

이 컨트롤은 활성화된 항목이 프롬프트의 어디에 들어갈지 정합니다. 넓은 화면에서는 간략한 행에 있습니다. 좁은 화면에서는 행의 Entry quick controls(항목 빠른 제어) 버튼을 누르세요.

Role(역할)은 빠른 제어가 아니라 펼친 항목 패널에 있습니다. 주입되는 글에 System, User, Assistant 중 하나를 붙이며, @ Depth에서만 의미가 있고 기본값은 System입니다.

항목에 꼭 필요한 경우가 아니면 이 값들은 기본값으로 두세요. @ Depth는 아껴 쓰세요. 글이 최근 메시지 사이에 끼어든 말처럼 들어가므로, 모델이 자꾸 잊는 규칙이나 방금 바뀐 사실에만 쓰세요. 예를 들어 "이제 여관에 불이 났다."를 @ Depth 1에 둡니다.

Outlet

Outlet 항목은 매크로를 넣은 자리에만 나타납니다.

1. Position을 Outlet으로 설정하세요. Outlet name(아웃렛 이름) 입력란이 나타납니다.
2. character_rules처럼 대소문자까지 정확한 이름을 입력하세요.
3. 프리셋의 프롬프트 섹션에 {{outlet::character_rules}}를 넣으세요.

이름이 같은 항목은 Order 순서대로 이어지고, 줄바꿈으로 구분됩니다. Outlet 매크로는 Conversation(대화), Roleplay(롤플레이), Game(게임) 채팅의 프롬프트 섹션에서 작동합니다. 이번 답변에서 활성화된 항목만 나타납니다. 이 항목도 키, 확률, 필터, 타이밍, Entry Limit(항목 제한), Token Budget(토큰 예산)을 그대로 따릅니다. 활성화된 항목이 없으면 매크로는 아무것도 추가하지 않습니다. Outlet 항목은 다른 Outlet 매크로를 호출할 수 없습니다. 이 매크로는 매크로를 참고하세요.

확률과 타이밍

Probability(확률)는 키가 일치했을 때 항목이 작동할 확률입니다. 기본값은 100%입니다. 25%로 설정하면 매번 네 번에 한 번꼴로 작동합니다.

Timing(타이밍) 필드는 여러 메시지에 걸친 동작을 정합니다. 네 필드 모두 처음에는 설정되어 있지 않으며, 이는 꺼짐을 뜻합니다.

Sticky, Cooldown, Delay는 메시지 수를 셉니다. Ephemeral은 활성화 횟수를 셉니다.

Decision 활성화

Decision(결정) 필드를 쓰면 예/아니요 질문에 답하는 작은 모델인 Decision 모델이 항목의 적용 여부를 판단합니다. In the latest message, a dragon is physically present처럼 최근 채팅에 관한 문장을 쓰고 모드를 고르세요.

문장에는 {{user}}, {{char}} 같은 매크로를 쓸 수 있습니다.

시작하기 전에: Connections(연결) 패널의 Decision model(결정 모델)에서 Decision 모델을 고르세요. Decision 모델이 없거나 답이 없으면 문장은 아니요로 처리됩니다. 설정된 모델이 없으면 편집기가 경고합니다.

• 이때 Require는 새 항목을 통과시키지 않지만, 기존 Sticky 유지로 항목이 계속 활성 상태일 수는 있습니다.
• Trigger는 활성화 경로를 추가하지 않으며, 항목은 여전히 키로 활성화될 수 있습니다.

중요한 항목에는 일반 경로도 주고, Require는 선택적인 로어를 거르는 데만 쓰세요.

Require는 키, 의미 일치, Constant, 지도 장소로 이미 자격을 갖춘 항목만 확인하고, 문장까지 참일 때만 통과시킵니다. Constant 항목에 쓰면 항목이 상황에 따라 들어가게 됩니다. 예를 들어 전투 규칙에 A fight is happening in the latest message를 씁니다. 쓰지 않는 항목을 모두 스캔하지는 않습니다.

판정문은 모델 요청을 늘리고 Decision statements per turn(턴당 판단문 수) 제한을 함께 씁니다. 표현 요령, 제한, 비용, 답 재사용은 판정문 작성하기, 제한과 비용, 답 재사용을 참고하세요. 모델 설정은 Decision 모델을 참고하세요.

세부 사항은 다음과 같습니다.

• sticky 항목은 유지 기간 동안 다시 묻지 않고, 쿨다운 중인 항목은 아예 묻지 않습니다.
• 활성 로어북 목록에는 Trigger 문장이 활성화한 항목에 decision(결정)이 표시됩니다.
• Peek Prompt(프롬프트 미리보기)는 절대 묻지 않습니다. 그 턴에 이미 있는 답을 보여 줍니다.
• Decision 활성화는 채팅 턴에만 적용됩니다. Game 설정과 에이전트가 스스로 실행하는 스캔에서는 Decision 항목을 아니요로 읽습니다.
• 항목 내용 안의 {{#if decision:"..."}}는 다릅니다. 이미 활성화된 항목의 글을 줄입니다.

그룹, 필터와 기타 옵션

펼친 드로어에는 필드가 더 있습니다.

Context filters & matching sources(컨텍스트 필터 및 일치 소스) 섹션은 항목을 특정 캐릭터, 캐릭터 태그, 생성 유형으로 제한합니다. 캐릭터 설명 같은 추가 카드 필드에서도 항목의 키를 찾게 할 수 있습니다. Individual(개별) 모드의 그룹 채팅에서는 답변마다 그 답변을 쓰는 캐릭터만 따지므로, 캐릭터 필터를 걸면 다른 캐릭터의 답변에는 항목이 들어가지 않습니다. Merged (Narrator)(병합, 나레이터) 답변에서는 채팅에 있는 모든 캐릭터를 따지므로, 필터를 건 캐릭터 중 하나라도 채팅에 있으면 항목이 들어갑니다. 한 캐릭터만 아는 비밀에 쓰세요.

사실에 맞는 설정 고르기

AI가 그 사실을 언제 봐야 하는지 먼저 생각한 다음, 이 표를 참고하세요.

로어북을 작게 유지하는 습관은 다음과 같습니다.

• 구체적인 키를 쓰세요. he나 the city 같은 키는 거의 모든 메시지에 일치해서 예산을 낭비합니다.
• Knowledge Router가 골라 넣을 것으로 예상하는 항목에는 Description을 채우세요. 이 에이전트는 내용이 아니라 설명을 읽습니다.
• 큰 세계관은 트리 구조로 짜세요. 구성원마다 항목을 두고, 그 옆에 집단을 설명하는 허브 항목을 추가하세요. 예를 들어 The Empire를 설명하면서 구성원을 나열하는 항목입니다.
• 허브 항목에서는 Recursion을 꺼 두세요. 그러지 않으면 집단 이름 하나에 구성원 전원의 항목 전문이 한꺼번에 프롬프트로 들어옵니다.

예를 들어 AI가 잊기 쉬운, 악당을 죽이는 방법에 관한 규칙을 생각해 보세요. 이 항목을 AND Any를 쓰는 Selective로 만들고, Whole Words를 켜고, Order를 10으로 두세요. 주요 키워드는 weakness, kill, destroy, stake, 보조 키워드는 Vlad, the count입니다. 보조 키워드 덕분에 파티가 늑대를 잡을 때는 항목이 조용히 있습니다. Whole Words는 stake가 "mistake"에 일치하지 않게 막습니다. 순서 값이 작으므로 항목이 많이 몰린 장면에서도 잘려 나가지 않습니다.

로어북이 어디에 있느냐에 따라 어떤 채팅에서 볼 수 있는지가 정해집니다. 전역, 연결, 내장 로어북은 로어북 개요와 로어북을 캐릭터와 페르소나에 연결하기를 참고하세요.

항목 내용에서 매크로 쓰기

Content는 전송되기 전에 다른 프롬프트 텍스트처럼 펼쳐집니다. 쓸모 있는 매크로는 다음과 같습니다.

• {{char}}와 {{user}}는 이름을 넣어 주므로, 함께 쓰는 항목이 어느 채팅에서나 자연스럽게 읽힙니다.
• {{roll:1d6}}는 주사위를 굴립니다. {{setvar::mood::angry}}는 이 채팅에 값을 저장하고, {{getvar::mood}}는 그 값을 다시 읽습니다.
• {{random::a::b::c}}는 선택지 하나를 고릅니다. {{random::common@3::rare@1}}처럼 가중치를 붙일 수 있습니다. 낮은 Probability와 함께 쓰면 인카운터 표 전체를 항목 하나에 접어 넣을 수 있습니다.
• {{include::Entry name}}은 같은 로어북에 있는 다른 항목의 글을 넣습니다. 꺼 둔 항목도 넣을 수 있습니다. 로어북 Include 매크로를 참고하세요.
• {{// note}}는 주석입니다. AI가 보기 전에, 그리고 재귀 스캔 전에 지워지므로 아무것도 작동시킬 수 없습니다.

전체 목록은 프롬프트 매크로를 참고하세요.

Recursive(재귀 활성화)를 켜면 Marinara가 활성화된 항목의 펼쳐진 내용을 다시 스캔합니다. 매크로가 만들어 낸 글이 다른 항목을 작동시킬 수 있습니다.

Keyword test 도구

Entries 탭 위쪽의 Keyword test(키워드 테스트) 패널을 쓰면 채팅 없이 키를 확인할 수 있습니다.

1. Keyword test를 펼치세요.
2. 입력란에 예시 문단이나 메시지 몇 개를 붙여넣으세요.

일치할 항목에는 초록색 강조와 Would activate(활성화 예정) 칩이 붙습니다. Constant 항목에는 Always active(항상 활성화) 칩이 붙습니다. 개수 줄에는 켜진 항목 중 몇 개가 활성화될지 표시됩니다. Include other lorebooks(다른 로어북 포함) 스위치를 켜면 다른 로어북의 켜진 항목도 확인합니다.

이 테스트는 타이밍, 확률, 캐릭터 필터와 페르소나 필터, 의미 기반 일치를 무시하므로 실제 채팅에서는 결과가 다를 수 있습니다.

항목 폴더

폴더는 로어북 하나 안에서 항목을 묶습니다. Lorebooks 패널의 라이브러리 폴더와는 별개입니다.

• Add Folder를 클릭한 다음, 그 자리에서 폴더 이름을 바꾸세요.
• 항목을 폴더로 끌어다 놓거나, 항목의 Folder(폴더) 선택기를 쓰세요(탭으로도 됩니다).
• 폴더를 다른 폴더로 끌어다 놓으면 그 안에 들어가고, 맨 위 영역으로 끌어다 놓으면 다시 밖으로 나옵니다.
• 폴더마다 켜기 스위치가 있습니다(툴팁 "Folder enabled"). 스위치를 끄면 그 안의 모든 항목이 활성화되지 않습니다.
• Clone folder(폴더 복제)는 폴더를 그 안의 모든 항목, 하위 폴더와 함께 복사합니다.
• Delete folder(폴더 삭제)는 폴더만 지웁니다. 안에 있던 내용은 최상위로 올라갑니다.

폴더가 묶음으로 표시되는 것은 검색 없이 Order로 정렬했을 때뿐입니다. 그 밖의 경우에는 평평한 목록과 함께 Folder view paused (clear search and sort by Order)(폴더 보기가 일시 중지됨(검색을 지우고 순서를 기준으로 정렬하세요)) 안내가 표시됩니다.

문제 해결

관련 가이드

• 로어북 개요
• Decision 모델
• 로어북 토큰 예산과 재귀
• 로어북 시맨틱 검색
• 지식 소스: Retrieval 에이전트와 Router 에이전트