Salta ai contenuti
@aws/nx-plugin
Blog

Gioco di Dungeon con IA Agentiva

Utilizzando questo tutorial, costruirai un gioco di avventura in stile dungeon potenziato da Agentic AI con @aws/nx-plugin. Questo tutorial non richiede alcuna conoscenza pregressa di @aws/nx-plugin o tecnologie correlate. Le tecniche che apprenderai in questo tutorial ti aiuteranno a:

  • Costruire qualsiasi applicazione basata su @aws/nx-plugin,
  • Ottenere una comprensione approfondita di @aws/nx-plugin, e
  • Acquisire una comprensione di base su come utilizzare il framework NX.

Al termine del tutorial, acquisirai 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, e
  • 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.

L’interfaccia del gioco assomiglierà a qualcosa di simile a questo diagramma:

game-select.png
game-conversation.png

Architettura dell’applicazione

Sezione intitolata “Architettura dell’applicazione”

Il gioco di avventura in stile dungeon potenziato da Agentic AI è costruito utilizzando la seguente architettura:

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 chiamare 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 consentire all’agent di gestire l’inventario del giocatore.
  • Infrastruttura CDK per il deployment dell’applicazione.

Prerequisiti

Sezione intitolata “Prerequisiti”

Prima di procedere, avrai bisogno delle 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 di destinazione (dove verrà distribuita la tua applicazione)
  • Docker è richiesto per la costruzione dei componenti AgentCore