설화집
Public에서 Lorebook을 AI 캐릭터에 생성, 가져오기, 관리 및 연결하는 방법에 대한 종합 가이드입니다.
지식집(세계 정보라고도 함)은 연결 가능한 지식, 설정 사실, 진영 세부정보, 마법 시스템 및 참조 지식을 담은 독립형 모음입니다. AI 캐릭터. 캐릭터와 채팅할 때 연결된 지식 책의 관련 항목이 동적으로 검색되어 모델 프롬프트에 직접 삽입됩니다.
캐릭터의 핵심 성격과 달리 지식 책은 완전히 모듈식입니다. 동일한 지식 책을 여러 캐릭터에 연결하거나(예: 공유된 Starfall Academy 지식 책을 미라, 토빈, 베일 교수, 애쉬그레이브 경에 연결) 캐릭터의 목소리를 변경하지 않고 지식 책을 교환할 수 있습니다.
핵심 개념
전설책을 최대한 활용하려면 Public의 다른 역할극 도구와 어떻게 어울리는지 이해하는 것이 도움이 됩니다.
- 캐릭터 성격 — 캐릭터가 누구인지 정의합니다: 말하는 스타일, 배경 이야기, 특이한 점, 행동 지침.
- 채팅 페르소나 — 당신이 누구인지 정의합니다: 이름, 외모, 대화에서의 신원. 참조 채팅 페르소나.
- Lorebooks — 역사적 사건, 세력, 위치, 주문, 기술 규칙, 관계 지식 등 주변 세계를 정의합니다.
비공개 및 공개 설화집
| 가시성 | 캐릭터에 연결할 수 있는 사람 | 편집하거나 삭제할 수 있는 사람 |
|---|---|---|
| 비공개 | 너만 | 오직 당신(창조자) |
| Public | Public의 모든 창작자는 캐릭터를 생성하거나 편집할 때 이를 연결할 수 있습니다. | 오직 당신(창조자) |
설화집은 소유자만이 수정하거나 삭제할 수 있습니다. 설화집을 삭제하면 그에 연결된 모든 캐릭터는 대화 기록이나 성격을 잃지 않고 안전하게 링크를 잃게 됩니다.
컨텍스트 주입이 작동하는 방식
문자 채팅으로 메시지를 보내면 백엔드는 AI의 응답을 생성하기 전에 빠른 컨텍스트 조립 파이프라인을 실행합니다.
1. 스캔된 텍스트 대상
컨텍스트 엔진은 전체 활성 대화 컨텍스트에서 일치하는 항목을 확인합니다.
- 사용자의 최근 수신 메시지
- 최근 대화 채팅 기록
- 롤링 대화 요약
- 고정 및 자동 추출된 캐릭터 메모리
- 캐릭터의 오리지널 인사말
2. 항목 매칭 유형
전설책의 모든 항목에는 두 가지 트리거 동작 중 하나가 있습니다.
- 키워드에 의해 실행됨(
constant: false) — 항목은 키워드 목록을 정의합니다(예:["emberwing", "house of the phoenix"]). 스캔한 대화 텍스트의 아무 곳에나 키워드가 나타나면(대소문자를 구분하지 않는 하위 문자열 일치) 항목이 트리거됩니다. - 상수(
constant: true) — 항목은 키워드를 완전히 무시하고 모든 메시지 교환에 항상 포함됩니다. 글로벌 시나리오 기준에 이상적입니다(예: "1204년이고 베일이 Starfall Academy를 외부 세계로부터 가리고 있습니다").
3. 우선순위 및 예산관리
모델에는 유한한 프롬프트 컨텍스트 창이 있습니다. 응답을 빠르고 일관적이며 비용 효율적으로 유지하기 위해 Public는 주입 예산을 시행합니다.
- 글자 예산 제한: 최대 1,800자(
LOREBOOK_INJECT_MAX_CHARS)의 전설책 콘텐츠가 메시지별로 삽입될 수 있습니다. - 우선순위: 일치하는 모든 항목(상수 항목 및 키워드에 의해 실행된 항목 모두)이 우선순위를 기준으로 내림차순으로 정렬됩니다(
100전에50, 전에0). - 예산 조정: 1,800자 예산에 도달할 때까지 가장 높은 우선순위부터 시작하여 항목이 하나씩 추가됩니다. 항목이 남은 예산을 초과하는 경우 생략됩니다(또는 첫 번째 항목인 경우 적합).
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 | 문자열 | 필수 | 최대 1,000자. 모델에 주입된 실제 세계 정보 텍스트입니다. |
constant | 부울 | 선택사항 | 기본값 false. 만약에 true, 이 항목은 모든 메시지 교환에서 항상 활성화됩니다. |
keys | 배열 | 필수 상수가 아닌 경우 | 최대 20개 키, 각각 최대 64자. 단어나 문구를 트리거합니다. 다음 경우에는 무시됩니다. constant: true. |
enabled | 부울 | 선택사항 | 기본값 true. 항목을 삭제하지 않고 일시적으로 비활성화하려면 끄기로 전환하세요. |
priority | 번호 | 선택사항 | 기본값 0. 컨텍스트 공간이 제한될 때 더 높은 숫자가 먼저 주입됩니다(예: 100, 85, 50). |
지원되는 JSON 형식
세 가지 표준화된 형식을 사용하여 전설책을 가져오고, 붙여넣고, 내보낼 수 있습니다.
1. 네이티브 Public 설화집 스키마(권장)
이는 Public의 기본 JSON 스키마입니다. 모든 필드를 직접 지원합니다.
{
"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 세계 정보 내보내기
가져오기 도구는 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. 실리태번 캐릭터 카드 (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를 선택하세요.
처음부터 만들기
- 로 이동
/lorebooks/create. - 설명이 포함된 이름과 선택적으로 설명 / 태그를 지정하세요.
- 비공개 또는 Public 공개 여부를 선택하세요.
- 항목 추가를 클릭하여 규칙을 만듭니다. 트리거 키워드를 지정하거나 **항상 활성(일정)**을 선택하세요.
- 전승서 만들기를 클릭하여 저장하세요.
기존 설화집 가져오기
기존 세계 정보를 로드하는 두 가지 빠른 방법이 있습니다.
- 파일 가져오기 — 상단 작업 표시줄에서 파일 가져오기를 클릭하여 파일을 업로드합니다.
.json컴퓨터의 설화집이나 캐릭터 카드 파일. - JSON 붙여넣기 — JSON 붙여넣기를 클릭하여 구문 분석 대화 상자를 엽니다.
- 다른 앱에서 복사한 JSON 텍스트를 가져오려면 클립보드에서 붙여넣기를 클릭하세요.
- 미리 채워진 Starfall Academy 템플릿을 검사하려면 예제 로드를 클릭하세요.
- 양식을 즉시 채우려면 분석 및 가져오기를 클릭하세요.
내보내기 및 복사
- 설화집 생성, 편집, 세부정보 화면에서 JSON 복사를 클릭하세요.
- 전체 설화집은 표준화된 Public JSON으로 직렬화되어 클립보드에 직접 복사됩니다.
AI 캐릭터에 연결하기
지식북이 생성되면:
- 오픈
/characters/add(또는 생성한 캐릭터에서 수정을 클릭하세요) - Lorebook(선택 사항) 선택기로 스크롤합니다.
- 전설책을 선택하거나 커뮤니티에서 만든 인기 있는 공개 전설책 중에서 선택하세요.
- 캐릭터를 저장하세요. 이 캐릭터와의 이후 채팅은 자동으로 전설 책에서 가져옵니다.
요금제 한도 및 잠금 해제
| 계획 | 당신이 만들 수 있는 로어북 | 설화집당 항목 |
|---|---|---|
| 무료 | 3 | 최대 100 |
| 기본 | 10 | 최대 100 |
| 크리에이터/프로 | 무제한 | 최대 100 |
로어북을 생성하려면 캐릭터 로어북 잠금 해제가 필요합니다(사용자 정의 채팅 페르소나와 동일한 진행 단계). 참조 구독 그리고 게임화.
제작자를 위한 모범 사례
- 설명적이고 구체적인 키워드를 사용하세요. 이름과 다음과 같은 복합 문구를 사용하세요.
["aria emberwing", "house of the phoenix"]처럼 흔한 짧은 단어보다는["the", "is", "he"]. - 범용 규칙에 대한 상수 항목 예약: 유지
constant: true항목은 1~2개의 기본 규칙(예: 현재 타임라인, 핵심 세계 물리학)으로 제한되므로 전체 1,800자 예산을 소비하지 않습니다. - 입력 내용을 간결하게 유지: 1~3개의 명확한 문장으로 이루어진 효과적인 항목을 사용하면 여러 관련 항목을 컨텍스트 창에 한 번에 맞출 수 있습니다.
- 우선순위 점수 활용: 기본 지식에 더 높은 우선순위 점수를 부여합니다(
100–80) 및 사소한 장식적 사실은 점수를 낮춥니다(40–10) 따라서 가장 중요한 컨텍스트가 먼저 주입되도록 보장됩니다.
자주 묻는 질문
채팅에서 내 전설책 항목이 실행되지 않는 이유는 무엇인가요?
다음을 확인하세요.
- 항목이 활성화로 전환되어 있습니까?
- 최근 채팅이나 최신 사용자 프롬프트에 정확한 키워드가 나타납니까? (일치는 대소문자를 구분하지 않는 하위 문자열 일치입니다.)
- 우선순위가 높은 항목이 1,800자 예산을 먼저 채웠나요? 항목의 우선순위 점수를 높여보세요.
하나의 캐릭터에 두 개 이상의 전설책을 연결할 수 있나요?
현재 각 캐릭터는 한 번에 하나의 전설책에 연결할 수 있습니다. 여러 전설책의 콘텐츠가 필요한 경우 JSON 붙여넣기 또는 내보내기 도구를 사용하여 해당 항목을 단일 전설책으로 결합하세요.
설화집을 삭제하면 어떻게 되나요?
해당 지식 책을 연결한 캐릭터는 단순히 지식 책 참조가 지워집니다. 그들의 대화, 설정 및 기억은 그대로 유지됩니다.
다른 사람이 만든 공개 설화집을 편집할 수 있나요?
아니요. 원작자만이 설화집을 편집할 수 있습니다. 공개 설화집을 맞춤설정하려면 전승서를 보고 JSON 복사를 클릭한 다음 새 설화집을 만들고 JSON을 개인 사본에 붙여넣으세요.
모바일 설화집 관리도 가능한가요?
전체 설화집 생성 및 편집은 현재 웹 앱에서 가능합니다. 웹상의 캐릭터에 연결된 모든 전설책은 Android 및 iOS를 포함한 모든 플랫폼의 채팅에서 자동으로 작동합니다.