📅 2025.11 ~ 2026.01 (2개월) | 👥 6명 🧑‍💻 역할: USER↔NPC/NPC↔NPC 대화 AI Agent 설계·구현, TTS 구현, Supabase DB 구축, 팀장, DeepEval 평가, langfuse 추적 🏆 언리얼×AI 융합 프로젝트 최우수상 (1위) [ ▶ 상세 보기 (클릭) 협업스킬&위기극복]

LangGraph LangChain Redis Grok-4.1 GPT-5 Mini Docker CI/CD Eval Pipeline (GitHub Actions) DeepEval LangFuse SQL

🔗 GitHub 🔗시연영상 YOUTUBE

</aside>

2. 기획 의도(WHY THIS PROJECT)

<aside>

🔍 왜 이 프로젝트를 만들었는가

기존 서브컬처 게임은 선택지가 한정되어 있고, 로그라이크 게임은 콘텐츠가 패턴화되어 반복 플레이 시 신선함이 사라진다. AI Agent를 게임의 '부가 기능'이 아닌 '핵심 메커니즘'으로 설계하여 두 장르의 근본적 한계를 동시에 돌파하고자 했다.

문제 정의

서브컬처: 한정된 선택지 → 틀 없는 자유 대화로 높은 몰입감
로그라이크: 패턴화된 콘텐츠 → AI 자동 생성으로 매번 새로운 경험
제작 비용의 한계 → 자동생성으로 효율적 개발

타겟 유저

히로인과 정서적 유대감을 원하는 유저
끝없는 선택지와 자유도를 원하는 유저
매 플레이마다 새로운 경험을 원하는 유저

스토리

히로인들은 “암네시아 사건”으로 기억을 잃은 상태이다. 주인공은 특별한 능력으로 “기억의 조각”을 소모해 기억을 찾아주는 멘토 역할을 하고 있다. 그래서 히로인들은 “기억의 던전”으로 가서 탐험하며 기억의 조각을 수집해오고 주인공인 멘토와 상담을 통해 기억을 되찾고 있다.

히로인: 레티아, 로코, 루파메스(기억을 잃은 자들)
대현자: 사트라(주인공의 scenario level에 따라 이 세계의 비밀을 알려주는 역할)

사용자 시나리오

</aside>

3. 아키텍처 + 기술 선택 근거 (WHY THIS STACK - 시스템 레벨)

<aside>

1. 데이터 흐름 아키텍처

2. USER-NPC/NPC-NPC AI Agent 대화 아키텍처

LLM-Driven NPC InterACTION-2026-02-18-075852.png

1. User-NPC API: 실시간 상호작용

유저의 입력(텍스트/음성)에 따라 NPC가 의도를 분류하고 응답하는 핵심 프로세스.

단계	처리 노드	내용	특징
1. 입력 (Input)	복합 입력	유저 TEXT/VOICE + 히로인 상태	멀티모달 입력 수용
2. 의도 분류	GROK-4.1-FAST	일상대화, NPC-NPC 대화, 시나리오, USER-NPC 기억	유저 요청의 목적 파악
3. DB 참조	외부 데이터베이스	각 분류에 맞는 DB(NPC-NPC 대화 DB, 시나리오 DB, 장기기억 DB) 조회	상황에 맞는 근거 데이터 확보
4. 응답 생성	GROK-4.1-FAST	최종 응답 텍스트 생성	확보된 정보를 바탕으로 답변 구성
5. 출력 (Output)	최종 결과물	TEXT, 감정, 감정 정도, audio_base	TTS 변환을 거친 최종 응답

2. NPC-NPC API: 멀티턴 대화 생성

NPC들끼리 대화를 나눌 때 사용하는 시스템 구조.

단계	요소	내용	특징
1. 입력 (Input)	컨텍스트	페르소나, 최근 대화, 상황 기억 진척도, 최근 해금된 기억, 관계	NPC 성격 및 과거 데이터 로드
2. 추론 (Model)	GROK-4.1-FAST	멀티턴 대화 생성	맥락에 맞는 연속 대화 생성
3. 후처리	TTS	텍스트를 음성 데이터로 변환	오디오 기반 데이터 생성
4. 출력 (Output)	데이터 패키지	TEXT, 감정, 감정 정도, audio_base	대사 및 감정 메타데이터 포함

3. interrupt API: NPC-NPC 대화 중 User 개입시 삭제

NPC 간 대화 중 유저가 N턴에서 개입시 그 이후를 삭제하는 데이터 처리 흐름.

단계	처리 대상	내용	특징
1. 입력 (Input)	유저 인터페이스	유저가 멈춘 시점(N턴) 정보	특정 과거 시점 지정
2. 데이터 삭제	DB/캐시	N턴 이후의 체크포인트, 장기기억, 세션 버퍼	지정된 턴 이후의 모든 기록 무효화
3. 출력 (Output)	시스템 상태	멈춘 N턴 및 업데이트된 턴 수	상태 복구 및 동기화 완료

2. NPC Memory 아키텍처

</aside>

<aside>

</aside>

4. 본질 정의 → 기술적 해결 (WHY THIS WAY - 기능 레벨)

<aside>

</aside>