에이전트형 AI 던전 게임

이 튜토리얼을 통해 @aws/nx-plugin을 사용하여 에이전트 기반 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

AgentCore 컴포넌트 빌드를 위해 Docker 필요