에이전틱 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 호출,
DynamoDB에서 데이터 모델링 및 DynamoDB Local에 대한 로컬 개발, 그리고
CDK 인프라 생성 및 배포.

무엇을 구축하나요?

이 튜토리얼에서는 @aws/nx-plugin으로 에이전틱 AI 기반 던전 어드벤처 게임을 구축합니다.

게임 인터페이스는 다음 다이어그램과 유사하게 보일 것입니다:

애플리케이션 아키텍처

에이전틱 AI 기반 던전 어드벤처 게임은 다음 아키텍처를 사용하여 구축됩니다:

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

사전 요구 사항

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

Git
Node >= 22 (NVM과 같은 도구를 사용하여 node 버전을 관리하는 것을 권장합니다)
- node --version을 실행하여 확인하세요
UV >= 0.5.29
1. uv python install 3.14.0을 실행하여 Python 3.14를 설치하세요
2. uv python list --only-installed로 확인하세요

이 튜토리얼은 애플리케이션을 배포하고 Amazon Bedrock을 호출하므로 대상 AWS 계정에 구성된 AWS Credentials
로컬 DynamoDB 개발 및 AgentCore 컴포넌트 빌드에 필요한 Docker (또는 Finch)