Saltearse al contenido

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í:

game-select.png
game-conversation.png

Componentes de la aplicación

El juego se construirá usando la siguiente arquitectura de componentes:

dungeon-game-architecture.png
  • 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
  • PNPM >= 10 (también puedes usar Yarn >= 4, Bun >= 1 o NPM >= 10 si lo prefieres)
    • Verifica ejecutando pnpm --version, yarn --version, bun --version o npm --version
  • UV >= 0.5.29
    1. Instala Python 3.12 ejecutando: uv python install 3.12.0
    2. Verifica con uv python list --only-installed
  • 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.