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:


Componenti dell’applicazione
L’architettura del gioco utilizza i seguenti componenti:

- 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
- verifica eseguendo
- PNPM >= 10 (puoi usare anche Yarn >= 4, Bun >= 1 o NPM >= 10 se preferisci)
- verifica eseguendo
pnpm --version
,yarn --version
,bun --version
onpm --version
- verifica eseguendo
- UV >= 0.5.29
- installa Python 3.12 eseguendo:
uv python install 3.12.0
- verifica con
uv python list --only-installed
- installa Python 3.12 eseguendo:
- 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.