Gioco di Dungeon con IA Agentiva
Panoramica
Sezione intitolata “Panoramica”Durante questo tutorial costruirai un gioco di avventura in stile dungeon potenziato da Agentic AI. Questo tutorial non richiede 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 piena comprensione ti darà una conoscenza approfondita del plugin e una comprensione di base dell’utilizzo di NX.
Gli utenti che completeranno questo tutorial acquisiranno le conoscenze per:
- utilizzare
@aws/nx-plugin
per creare nuove applicazioni - usare NX per gestire/costruire la codebase
- costruire API con tRPC
- sviluppare Agent con Strands
- implementare server MCP in TypeScript
- utilizzare Tanstack router per creare nuove pagine
- usare Tanstack query per chiamare API backend
- creare e distribuire infrastrutture CDK
Cosa costruirai?
Sezione intitolata “Cosa costruirai?”In questo tutorial costruirai un gioco di avventura in stile dungeon potenziato da Agentic AI utilizzando @aws/nx-plugin
.
Puoi vedere come apparirà una volta completato qui:


Componenti dell’applicazione
Sezione intitolata “Componenti dell’applicazione”Il gioco sarà costruito utilizzando la seguente architettura a componenti:

- Frontend React/Vite che utilizza:
- Amazon Cognito/Identity Pools per chiamate API sicure
- Tanstack router con supporto al routing basato su file type-safe
- SDK generati per interagire con la Game API
- API tRPC che usa ElectroDB/DynamoDB per gestire lo stato del gioco
- Agent Strands ospitato su Amazon Bedrock AgentCore per eseguire il gioco
- Server MCP TypeScript ospitato su Amazon Bedrock AgentCore per gestire l’inventario del giocatore
- Infrastruttura CDK per il deployment dell’applicazione
Prerequisiti
Sezione intitolata “Prerequisiti”Sono necessarie le seguenti dipendenze globali prima di procedere:
- Git
- Node >= 22 (Consigliamo di utilizzare strumenti come NVM per gestire le versioni di Node)
- verifica eseguendo
node --version
- verifica eseguendo
- PNPM >= 10 (puoi anche usare 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)
- Docker è richiesto per la costruzione dei componenti AgentCore
- Assicurati che il tuo account AWS abbia abilitato l’accesso al modello predefinito di Strands in Bedrock per la tua regione target seguendo i passaggi della guida ufficiale. Al momento della stesura si tratta di Anthropic Claude Sonnet 4.