Gioco Dungeon con AI Agentica

Utilizzando questo tutorial, costruirai un gioco d’avventura dungeon alimentato da AI Agentica con @aws/nx-plugin. Questo tutorial non presuppone alcuna conoscenza pregressa di @aws/nx-plugin o delle tecnologie correlate. Le tecniche che imparerai in questo tutorial ti aiuteranno a:

• Costruire qualsiasi applicazione basata su @aws/nx-plugin,
• Fornire una comprensione approfondita di @aws/nx-plugin, e
• Ottenere una comprensione di base su come utilizzare il framework NX.

Apprendimento Pratico

Questo tutorial è progettato per persone che preferiscono imparare facendo e vogliono provare rapidamente a creare qualcosa di tangibile. Se preferisci imparare ogni concetto passo dopo passo, fai riferimento alle guide dei singoli componenti utilizzando la navigazione a sinistra.

Alla fine del tutorial, avrai acquisito le conoscenze per:

• utilizzare @aws/nx-plugin per creare nuove applicazioni,
• utilizzare NX per gestire/costruire la loro codebase,
• costruire API utilizzando tRPC,
• costruire Agenti utilizzando Strands,
• costruire server MCP in TypeScript,
• utilizzare Tanstack router per creare nuove pagine,
• utilizzare Tanstack query per chiamare API backend,
• modellare dati in DynamoDB e sviluppare localmente con DynamoDB Local, e
• creare e distribuire infrastruttura CDK.

Cosa stai costruendo?

In questo tutorial, costruirai un gioco d’avventura dungeon alimentato da AI Agentica con @aws/nx-plugin.

L’interfaccia del gioco assomiglierà a qualcosa come questo diagramma:

Architettura dell’applicazione

Il gioco d’avventura dungeon alimentato da AI Agentica è costruito utilizzando la seguente architettura:

• Sito web frontend React/Vite che utilizza:
  • Amazon Cognito/Identity Pools per chiamate API sicure.
  • Tanstack router che supporta il routing basato su file type-safe.
  • SDK generati per chiamare la Game API.
• API tRPC che utilizza ElectroDB/DynamoDB per gestire lo stato del gioco.
• Agente Strands ospitato su Amazon Bedrock AgentCore per eseguire il gioco.
• Server MCP TypeScript ospitato su Amazon Bedrock AgentCore per consentire all’agente di gestire l’inventario del giocatore.
• Infrastruttura CDK per distribuire l’applicazione.

Prerequisiti

Prima di procedere, avrai bisogno delle seguenti dipendenze globali:

• Git
• Node >= 22 (Consigliamo di utilizzare qualcosa come NVM per gestire le versioni di node)
  • verifica eseguendo node --version
• UV >= 0.5.29
  1. installa Python 3.14 eseguendo: uv python install 3.14.0
  2. verifica con uv python list --only-installed

• AWS Credentials configurate per il tuo account AWS di destinazione, poiché questo tutorial distribuisce l’applicazione e invoca Amazon Bedrock
• Docker (o Finch) è richiesto per lo sviluppo locale di DynamoDB e per la costruzione dei componenti AgentCore

Configurazione Assistente AI

Se utilizzi un Assistente AI come Kiro, Kiro CLI, Cursor, Claude Code o Cline, fai riferimento alla pagina installa il server MCP Nx Plugin for AWS.