Juego de Mazmorra de IA Agéntica
Descripción general
Sección titulada «Descripción general»Durante este tutorial construirás un juego de aventuras tipo mazmorra potenciado por IA Agéntica. Este tutorial no asume conocimiento previo del @aws/nx-plugin
ni 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.
Los usuarios que completen este tutorial adquirirán el conocimiento para:
- Usar el
@aws/nx-plugin
para crear nuevas aplicaciones - Usar NX para gestionar/construir su base de código
- Construir APIs usando tRPC
- Crear Agentes usando Strands
- Construir servidores MCP en TypeScript
- Usar Tanstack router para crear nuevas páginas
- Usar Tanstack query para llamar a APIs backend
- Crear e implementar infraestructura CDK
¿Qué vas a construir?
Sección titulada «¿Qué vas a construir?»En este tutorial construirás un juego de aventuras tipo mazmorra potenciado por IA Agéntica usando @aws/nx-plugin
.
Puedes ver cómo se verá al finalizar aquí:


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

- Frontend React/Vite utilizando:
- Amazon Cognito/Identity Pools para llamadas API seguras
- Tanstack router con enrutamiento basado en archivos y tipado seguro
- SDKs generados para interactuar con la Game API
- API tRPC usando ElectroDB/DynamoDB para gestionar el estado del juego
- Agente Strands alojado en Amazon Bedrock AgentCore para ejecutar el juego
- Servidor MCP TypeScript en Amazon Bedrock AgentCore para gestionar el inventario del jugador
- Infraestructura CDK para implementar la aplicación
Prerrequisitos
Sección titulada «Prerrequisitos»Se necesitan las siguientes dependencias globales antes de continuar:
- Git (instalación de Git)
- Node >= 22 (Recomendamos usar algo 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:
- Credenciales de AWS configuradas para tu cuenta de AWS de destino (donde se desplegará tu aplicación)
- Docker requerido para construir componentes de AgentCore
- Asegúrate que tu cuenta AWS tenga acceso habilitado al modelo por defecto de Strands en Bedrock para tu región objetivo siguiendo esta guía. Al momento de escribir esto es Anthropic Claude Sonnet 4.