Salta ai contenuti

Gioco di Dungeon con IA

Panoramica

In questo tutorial costruirai un gioco di avventura in stile dungeon alimentato da IA. Questo tutorial non presuppone alcuna conoscenza pregressa di @aws/nx-plugin o tecnologie correlate. Le tecniche che apprenderai sono fondamentali per costruire qualsiasi applicazione basata su @aws/nx-plugin, e una comprensione completa ti darà una profonda conoscenza dello strumento insieme alle basi per utilizzare NX.

Gli utenti che completeranno questo tutorial acquisiranno le conoscenze per:

  • utilizzare @aws/nx-plugin per creare nuove applicazioni
  • usare NX per gestire/compilare il codice
  • costruire API usando sia tRPC che FastAPI
  • utilizzare Tanstack router per creare nuove pagine
  • usare Tanstack query per chiamare API backend
  • modificare il codice generato per adattarlo allo scopo
  • creare e distribuire infrastrutture CDK

Cosa costruirai?

In questo tutorial creerai un gioco di avventura in stile dungeon alimentato da IA utilizzando @aws/nx-plugin.

Ecco un’anteprima del risultato finale:

game-select.png
game-conversation.png

Componenti dell’applicazione

L’architettura del gioco utilizza i seguenti componenti:

dungeon-game-architecture.png
  • API tRPC che usa ElectroDB/DynamoDB per gestire lo stato del gioco
  • Funzione Lambda Python/FastAPI con risposte in streaming per la generazione della storia (basata su Amazon Bedrock)
  • Frontend React/Vite che utilizza:
    • Amazon Cognito/Identity Pools per chiamate API sicure
    • Tanstack router con routing basato su file e type safety
    • SDK generati per chiamare le API di Gioco e Storia (con Tanstack query)
  • Infrastruttura CDK per il deployment

Prerequisiti

Sono necessarie le seguenti dipendenze globali:

  • Git
  • Node >= 22 (Consigliamo di utilizzare strumenti come NVM per gestire le versioni di Node)
    • verifica eseguendo node --version
  • PNPM >= 10 (puoi usare anche Yarn >= 4, Bun >= 1 o NPM >= 10 se preferisci)
    • verifica eseguendo pnpm --version, yarn --version, bun --version o npm --version
  • UV >= 0.5.29
    1. installa Python 3.12 eseguendo: uv python install 3.12.0
    2. verifica con uv python list --only-installed
  • Credenziali AWS configurate per il tuo account AWS di destinazione (dove verrà distribuita la tua applicazione)
  • Se utilizzi VSCode, consigliamo di installare il Nx Console VSCode Plugin.
  • Assicurati che il tuo account AWS abbia abilitato l’accesso al modello Anthropic Claude 3.5 Sonnet v2 in Bedrock per la regione target seguendo i passaggi della questa guida.