DOCS / INDEX
AI NPC 메모리를 출하하기 위한 문서 허브
NPC retrieval 호출에서 시작하고, 엔티티, 이벤트, context budget, 엔진 플러그인 순으로 내려가면 됩니다.
문서는 게임 뒤의 메모리 그래프 기준으로 정리했습니다. 대화 엔진은 그대로 두고, Seizn은 지속 엔티티, 관계, witness 로그, 다음 턴 회수를 맡습니다.
Quickstart: NPC 생성, 이벤트 기록, 컨텍스트 회수
새 그래프에서 메모리 인지형 NPC 턴까지 가는 가장 짧은 경로입니다. 공개 graph API만 사용합니다.
curl -X POST https://seizn.com/api/v1/graph/$GRAPH_ID/entities \
-H "Authorization: Bearer $SEIZN_API_KEY" \
-H "Content-Type: application/json" \
-d '{"type":"character","name":"Mira","external_id":"npc_mira"}'
curl -X POST https://seizn.com/api/v1/graph/$GRAPH_ID/extract \
-H "Authorization: Bearer $SEIZN_API_KEY" \
-H "Content-Type: application/json" \
-d '{"text":"Mira saw the player leave the old gate at dusk."}'
curl -X POST https://seizn.com/api/v1/graph/$GRAPH_ID/context \
-H "Authorization: Bearer $SEIZN_API_KEY" \
-H "Content-Type: application/json" \
-d '{"query":"What does Mira know about the player right now?","max_entities":8,"max_depth":2}'NPC 엔티티 + 관계
서사 설계가 이미 생각하는 방식대로 그래프를 모델링합니다. 캐릭터, 팩션, 가문, 장소, 그리고 이를 잇는 관계를 노드와 엣지로 둡니다.
이벤트 + witness
월드 변화를 한 번만 기록하고, Seizn이 그 이벤트에서 엔티티와 관계를 추출해 그래프를 갱신하도록 둡니다.
회수 + context budget
다음 턴을 설명하는 최소 그래프 조각만 가져옵니다. 관련 엔티티, 그 관계, 최근 이벤트 체인만 회수합니다.
컨텍스트 구성
응답 생성 전 max entities, depth, 관계 포함 여부로 recall을 제한하는 graph context endpoint를 사용합니다.
컨텍스트 API 보기엔진 플러그인
엔진이 달라도 출발점은 같습니다. NPC 노드를 만들고, 이벤트를 기록하고, 다음 턴에 recall을 요청합니다.
API reference
정확한 요청 형식, 인증, 한도, 실패 모드를 확인해야 할 때는 허브에서 reference 페이지로 바로 이동하면 됩니다.