Salta ai contenuti
@aws/nx-plugin
Blog

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:

game-select.png
game-conversation.png

Componenti dell’applicazione

Sezione intitolata “Componenti dell’applicazione”

Il gioco sarà costruito utilizzando la seguente architettura a componenti:

dungeon-game-architecture.png
  • 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
  • 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 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.