에이전트형 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 파워 던전 어드벤처 게임을 구축하게 됩니다.

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

애플리케이션 구성 요소

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

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 모델