Saltearse al contenido
@aws/nx-plugin
Blog

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

game-select.png
game-conversation.png

Componentes de la aplicación

Sección titulada «Componentes de la aplicación»

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

dungeon-game-architecture.png
  • 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
  • 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
  • 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.