콘텐츠로 이동

에이전트형 AI 던전 게임

이 튜토리얼에서는 에이전트 기반 AI 파워 던전 어드벤처 게임을 구축하게 됩니다. 본 튜토리얼은 @aws/nx-plugin 또는 관련 기술에 대한 사전 지식을 전제로 하지 않습니다. 여기서 배우게 될 기술들은 모든 @aws/nx-plugin 기반 애플리케이션 구축에 필수적인 핵심 내용이며, 튜토리얼을 완전히 이해하면 @aws/nx-plugin에 대한 깊은 이해와 NX 사용법의 기초를 습득할 수 있습니다.

튜토리얼을 완료한 사용자는 다음을 수행할 수 있는 지식을 얻을 수 있습니다:

  • @aws/nx-plugin을 사용해 새로운 애플리케이션 생성
  • NX를 이용한 코드베이스 관리/빌드
  • tRPC를 사용한 API 구축
  • Strands를 이용한 에이전트 개발
  • TypeScript로 MCP 서버 구축
  • Tanstack router를 활용한 새 페이지 생성
  • Tanstack query를 이용한 백엔드 API 호출
  • CDK 인프라 생성 및 배포

이 튜토리얼에서는 @aws/nx-plugin을 사용해 에이전트 기반 AI 파워 던전 어드벤처 게임을 구축하게 됩니다.

최종 결과물은 아래에서 확인할 수 있습니다:

game-select.png
game-conversation.png

에이전트 기반 AI 던전 어드벤처 게임은 다음 구성 요소 아키텍처를 사용해 구축됩니다:

dungeon-game-architecture.png
  • React/Vite 프론트엔드 웹사이트:
    • 안전한 API 호출을 위한 Amazon Cognito/Identity Pools 활용
    • 타입 안전 파일 기반 라우팅을 지원하는 Tanstack router
    • 게임 API 호출을 위한 생성된 SDK
  • 게임 상태 관리를 위해 ElectroDB/DynamoDB를 사용하는 tRPC API
  • 게임 실행을 위해 Amazon Bedrock AgentCore에 호스팅된 Strands 에이전트
  • 플레이어 인벤토리 관리를 위한 TypeScript MCP 서버 (Amazon Bedrock AgentCore 호스팅)
  • 애플리케이션 배포를 위한 CDK 인프라

진행 전 다음 전역 종속성이 필요합니다:

  • Git
  • Node >= 22 (NVM 같은 도구로 Node 버전 관리 권장)
    • node --version 실행하여 버전 확인
  • PNPM >= 10 (선호한다면 Yarn >= 4, Bun >= 1, NPM >= 10 사용 가능)
    • pnpm --version, yarn --version, bun --version 또는 npm --version 실행하여 버전 확인
  • UV >= 0.5.29
    1. uv python install 3.12.0 실행하여 Python 3.12 설치
    2. uv python list --only-installed 실행하여 확인
  • 애플리케이션을 배포할 대상 AWS 계정에 구성된 AWS Credentials
  • 에이전트코어 컴포넌트 빌드를 위해 Docker 필요
  • 대상 리전에서 Strands 기본 모델에 대한 접근 권한이 AWS 계정에 활성화되어 있어야 함 (가이드 참조). 현재 기준 Anthropic Claude Sonnet 4 모델