Aller au contenu
@aws/nx-plugin
Blog

Jeu de Donjon d'IA Agentique

Avec ce tutoriel, vous allez construire un jeu d’aventure en donjon alimenté par une IA agentique avec @aws/nx-plugin. Ce tutoriel ne nécessite aucune connaissance préalable du @aws/nx-plugin ou des technologies associées. Les techniques que vous apprendrez dans ce tutoriel vous aideront à :

  • Construire n’importe quelle application basée sur @aws/nx-plugin,
  • Acquérir une compréhension approfondie du @aws/nx-plugin, et
  • Obtenir une compréhension de base de l’utilisation du framework NX.

À la fin du tutoriel, vous aurez acquis les connaissances nécessaires pour :

  • utiliser le @aws/nx-plugin pour créer de nouvelles applications,
  • utiliser NX pour gérer/construire votre base de code,
  • construire des APIs avec tRPC,
  • développer des Agents avec Strands,
  • créer des serveurs MCP en TypeScript,
  • utiliser Tanstack router pour créer de nouvelles pages,
  • utiliser Tanstack query pour appeler des APIs backend, et
  • créer et déployer une infrastructure CDK.

Que allez-vous construire ?

Section intitulée « Que allez-vous construire ? »

Dans ce tutoriel, vous allez créer un jeu d’aventure en donjon alimenté par une IA agentique avec @aws/nx-plugin.

L’interface du jeu ressemblera à quelque chose comme ce diagramme :

game-select.png
game-conversation.png

Architecture de l’application

Section intitulée « Architecture de l’application »

Le jeu d’aventure en donjon alimenté par une IA agentique est construit avec l’architecture suivante :

dungeon-game-architecture.png
  • Un frontend React/Vite utilisant :
    • Amazon Cognito/Identity Pools pour les appels API sécurisés.
    • Tanstack router qui prend en charge le routage basé sur les fichiers avec typage fort.
    • Des SDKs générés pour appeler l’API du jeu.
  • Une API tRPC qui utilise ElectroDB/DynamoDB pour gérer l’état du jeu.
  • Un Agent Strands hébergé sur Amazon Bedrock AgentCore pour exécuter le jeu.
  • Un serveur MCP TypeScript hébergé sur Amazon Bedrock AgentCore pour que l’agent puisse gérer l’inventaire du joueur.
  • Une infrastructure CDK pour déployer l’application.

Prérequis

Section intitulée « Prérequis »

Avant de continuer, vous aurez besoin des dépendances globales suivantes :

  • Git
  • Node >= 22 (Nous recommandons d’utiliser un outil comme NVM pour gérer vos versions de Node)
    • vérifiez avec node --version
  • PNPM >= 10 (vous pouvez également utiliser Yarn >= 4, Bun >= 1 ou NPM >= 10 si vous préférez)
    • vérifiez avec pnpm --version, yarn --version, bun --version ou npm --version
  • UV >= 0.5.29
    1. installez Python 3.12 en exécutant : uv python install 3.12.0
    2. vérifiez avec uv python list --only-installed
  • AWS Credentials configurées pour votre compte AWS cible (où votre application sera déployée)
  • Docker est requis pour construire les composants AgentCore