Juego de Mazmorra con IA Agéntica
Usando este tutorial, construirás un juego de aventuras de mazmorra impulsado por IA Agéntica con @aws/nx-plugin. Este tutorial no asume ningún conocimiento previo de @aws/nx-plugin o tecnologías relacionadas.
Las técnicas que aprenderás en este tutorial te ayudarán a:
- Construir cualquier aplicación basada en
@aws/nx-plugin, - Proporcionar una comprensión profunda de
@aws/nx-plugin, y - Obtener una comprensión básica de cómo usar el framework NX.
Al final del tutorial, te irás con el conocimiento para:
- usar
@aws/nx-pluginpara crear nuevas aplicaciones, - usar NX para administrar/construir su base de código,
- construir APIs usando tRPC,
- construir Agentes usando Strands,
- construir servidores MCP en TypeScript,
- usar Tanstack router para crear nuevas páginas,
- usar Tanstack query para llamar APIs de backend,
- modelar datos en DynamoDB y desarrollar localmente contra DynamoDB Local, y
- crear y desplegar infraestructura CDK.
¿Qué estás construyendo?
Sección titulada «¿Qué estás construyendo?»En este tutorial, construirás un juego de aventuras de mazmorra impulsado por IA Agéntica con @aws/nx-plugin.
La interfaz del juego se parecerá a algo como este diagrama:
Arquitectura de la aplicación
Sección titulada «Arquitectura de la aplicación»El juego de aventuras de mazmorra impulsado por IA Agéntica se construye usando la siguiente arquitectura:
- Sitio web frontend React/Vite que utiliza:
- Amazon Cognito/Identity Pools para llamadas API seguras.
- Tanstack router que soporta enrutamiento basado en archivos con seguridad de tipos.
- SDKs generados para llamar a la Game API.
- API tRPC que usa ElectroDB/DynamoDB para administrar el estado del juego.
- Agente Strands alojado en Amazon Bedrock AgentCore para ejecutar el juego.
- Servidor MCP de TypeScript alojado en Amazon Bedrock AgentCore para que el agente administre el inventario del jugador.
- Infraestructura CDK para desplegar la aplicación.
Requisitos previos
Sección titulada «Requisitos previos»Antes de continuar, necesitarás las siguientes dependencias globales:
- Git
- Node >= 22 (Recomendamos usar algo como NVM para gestionar tus versiones de node)
- verifica ejecutando
node --version
- verifica ejecutando
- UV >= 0.5.29
- instala Python 3.14 ejecutando:
uv python install 3.14.0 - verifica con
uv python list --only-installed
- instala Python 3.14 ejecutando:
- AWS Credentials configuradas para tu cuenta AWS de destino, ya que este tutorial despliega la aplicación e invoca Amazon Bedrock
- Docker (o Finch) es requerido para el desarrollo local de DynamoDB y para construir los componentes de AgentCore