Ir al contenido
@aws/nx-plugin
Blog

Juego de Mazmorra de IA Agéntica

Usando este tutorial, construirás un juego de aventuras tipo mazmorra potenciado por IA Agéntica con @aws/nx-plugin. Este tutorial no asume conocimiento previo del @aws/nx-plugin ni 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 un conocimiento profundo del @aws/nx-plugin, y
  • Obtener una comprensión básica de cómo usar el framework NX.

Al final del tutorial, adquirirás 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, y
  • 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 con @aws/nx-plugin.

La interfaz del juego se parecerá a algo como este diagrama:

game-select.png
game-conversation.png

Arquitectura de la aplicación

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

El juego de aventuras tipo mazmorra potenciado por IA Agéntica se construye usando la siguiente arquitectura:

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 llamar a la Game API.
  • API tRPC que usa ElectroDB/DynamoDB para gestionar el estado del juego.
  • Agente Strands alojado en Amazon Bedrock AgentCore para ejecutar el juego.
  • Servidor MCP TypeScript alojado en Amazon Bedrock AgentCore para que el agente gestione el inventario del jugador.
  • Infraestructura CDK para implementar la aplicación.

Prerrequisitos

Sección titulada «Prerrequisitos»

Antes de continuar, necesitarás las siguientes dependencias globales:

  • 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 es requerido para construir los componentes de AgentCore