Aller au contenu

Jeu de Donjon d'IA Agentique

Vous allez construire un jeu d’aventure en donjon alimenté par une IA agentique durant ce tutoriel. 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 sont fondamentales pour construire n’importe quelle application basée sur @aws/nx-plugin, et sa compréhension complète vous donnera une maîtrise approfondie du @aws/nx-plugin ainsi qu’une connaissance de base de NX.

Les utilisateurs ayant complété ce tutoriel pourront acquérir les connaissances nécessaires pour :

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

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

Vous pouvez voir le résultat final ici :

game-select.png
game-conversation.png

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

dungeon-game-architecture.png
  • Un frontend React/Vite utilisant :
    • Amazon Cognito/Identity Pools pour les appels API sécurisés
    • Tanstack router qui gère le routage basé sur les fichiers avec typage fort
    • Des SDKs générés pour interagir avec l’API du jeu
  • Une API tRPC utilisant 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 gérer l’inventaire du joueur
  • Une infrastructure CDK pour déployer l’application

Les dépendances globales suivantes sont nécessaires avant de continuer :

  • 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
  • Vérifiez que votre compte AWS a activé l’accès au modèle par défaut de Strands dans Bedrock pour votre région cible en suivant les étapes décrites dans ce guide. Au moment de la rédaction, il s’agit d’Anthropic Claude Sonnet 4.

Si vous utilisez un assistant IA comme Kiro, Amazon Q Developer, Cursor, Claude Code ou Cline, vous pouvez aussi installer le Nx Plugin pour le serveur MCP AWS.