DOCS / QUICKSTART
퀵스타트
SDK 설치부터 graph 생성, NPC 엔티티 생성, witness 이벤트 기록, 다음 대화 턴 컨텍스트 회수까지 5단계로 시작합니다.
여기서는 graph 객체가 눈에 보이도록 raw HTTP를 일부러 유지합니다. 루프가 맞으면 같은 호출을 Unity, Unreal, Godot, 또는 백엔드 런타임 래퍼 안으로 옮기면 됩니다.
01
SDK 설치
첫 통합이 raw HTTP 중심이어도 의존성 그래프에는 먼저 Seizn 패키지를 넣어두는 편이 좋습니다.
npm install seizn
pip install seizn02
graph 생성
이 NPC 메모리 루프가 들어갈 월드나 샤드 기준으로 graph를 하나 만듭니다. 반환된 graph id를 다음 네 호출에 그대로 사용합니다.
curl -X POST https://seizn.com/api/v1/graph \
-H "Authorization: Bearer $SEIZN_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"name": "smallgod-world",
"description": "first playable용 NPC memory graph"
}'03
NPC 엔티티 생성
나중에 기억을 회수할 화자를 먼저 만듭니다. 저장 데이터, 샤드, 엔진 세션을 넘어 같은 NPC를 가리키려면 안정적인 external id가 필요합니다.
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"
}'04
witness 이벤트 기록
대사나 이벤트 텍스트를 한 번 보내면 Seizn이 엔티티와 관계를 추출하고 witness 흔적을 graph에 저장합니다.
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.",
"max_entities": 8
}'05
다음 턴 컨텍스트 회수
다음 bark, dialogue node, quest branch 직전에 NPC 시점으로 질의합니다. 반환 graph context가 퍼지지 않도록 budget은 작게 시작하는 편이 좋습니다.
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
}'첫 루프가 맞으면
정확한 request schema는 API reference에서 확인하고, 같은 다섯 호출을 엔진 래퍼나 서버 권한 게임플레이 서비스 안으로 옮기면 됩니다.