Salta ai contenuti
@aws/nx-plugin
Blog

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 anche usare 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 target (dove verrà distribuita l’applicazione)
  • Se utilizzi VSCode, consigliamo di installare l’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.