Juego de Mazmorra con IA
Resumen
Durante este tutorial construirás un juego de aventura de mazmorras impulsado por IA. Este tutorial no asume ningún conocimiento previo del @aws/nx-plugin
o tecnologías relacionadas. Las técnicas que aprenderás son fundamentales para construir cualquier aplicación basada en @aws/nx-plugin
, y comprenderlo completamente te dará un conocimiento profundo de este plugin y una comprensión básica de cómo usar NX.
Al completar este tutorial, los usuarios podrán:
- Utilizar el
@aws/nx-plugin
para crear nuevas aplicaciones - Usar NX para gestionar/construir su base de código
- Construir APIs usando tanto tRPC como FastAPI
- Usar Tanstack router para crear nuevas páginas
- Emplear Tanstack query para llamar a APIs backend
- Modificar código generado para adaptarlo a propósitos específicos
- Crear e implementar infraestructura CDK
¿Qué vas a construir?
En este tutorial crearás un juego de aventura de mazmorras con IA usando @aws/nx-plugin
.
Puedes ver cómo quedará al finalizar aquí:


Componentes de la aplicación
El juego se construirá usando la siguiente arquitectura de componentes:

- API tRPC que usa ElectroDB/DynamoDB para gestionar el estado del juego
- Función Lambda en Python/FastAPI con respuestas en streaming para generación de historias (con tecnología de Amazon Bedrock)
- Frontend React/Vite que utiliza:
- Amazon Cognito/Identity Pools para llamadas API seguras
- Tanstack router con enrutamiento basado en archivos y tipos seguros
- SDKs generados para interactuar con las APIs del juego e historia (usando Tanstack query)
- Infraestructura CDK para implementar la aplicación
Requisitos previos
Se necesitan las siguientes dependencias globales antes de continuar:
- Git
- Node >= 22 (Recomendamos usar herramientas como NVM para gestionar tus versiones de Node)
- Verifica ejecutando
node --version
- Verifica ejecutando
- PNPM >= 10 (también puedes usar Yarn >= 4, Bun >= 1 o NPM >= 10 si lo prefieres)
- Verifica ejecutando
pnpm --version
,yarn --version
,bun --version
onpm --version
- Verifica ejecutando
- UV >= 0.5.29
- Instala Python 3.12 ejecutando:
uv python install 3.12.0
- Verifica con
uv python list --only-installed
- Instala Python 3.12 ejecutando:
- AWS Credentials configuradas para tu cuenta de AWS objetivo (donde se desplegará tu aplicación)
- Si usas VSCode, recomendamos instalar el Nx Console VSCode Plugin.
- Asegúrate que tu cuenta de AWS tiene acceso habilitado al modelo Anthropic Claude 3.5 Sonnet v2 en Bedrock para tu región objetivo, siguiendo los pasos de esta guía.