Aller au contenu
@aws/nx-plugin
Blog

Jeu de Donjon IA

Aperçu

Au cours de ce tutoriel, vous allez construire un jeu d’aventure donjon alimenté par l’IA. Ce tutoriel ne nécessite aucune connaissance préalable du @aws/nx-plugin ou des technologies associées. Les techniques que vous apprendrez sont fondamentales pour construire toute application basée sur @aws/nx-plugin, et leur compréhension complète vous donnera une maîtrise approfondie du @aws/nx-plugin ainsi qu’une connaissance de base de NX.

À l’issue de ce tutoriel, les utilisateurs auront acquis 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 et FastAPI
  • utiliser Tanstack router pour créer de nouvelles pages
  • utiliser Tanstack query pour appeler des APIs backend
  • modifier du code généré pour l’adapter à des besoins spécifiques
  • créer et déployer une infrastructure CDK

Que allez-vous construire ?

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

Vous pouvez visualiser le résultat final ici :

Sélection du jeu
Conversation dans le jeu

Composants de l’application

Le jeu sera construit selon l’architecture suivante :

Architecture du jeu donjon
  • Une API tRPC utilisant ElectroDB/DynamoDB pour la gestion de l’état du jeu
  • Une fonction Lambda Python/FastAPI avec des réponses en streaming pour la génération d’histoire (alimentée par Amazon Bedrock)
  • Un frontend React/Vite utilisant :
    • Amazon Cognito/Identity Pools pour les appels API sécurisés
    • Tanstack router avec routage basé sur les fichiers et typage strict
    • Des SDK générés pour appeler les APIs de jeu et d’histoire (utilisant Tanstack query)
  • Une infrastructure CDK pour le déploiement

Prérequis

Les dépendances globales suivantes sont nécessaires :

  • 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
  • Identifiants AWS configurés pour votre compte AWS cible (où votre application sera déployée)
  • Si vous utilisez VSCode, nous recommandons d’installer le Nx Console VSCode Plugin.
  • Vérifiez que votre compte AWS a activé l’accès au modèle Anthropic Claude 3.5 Sonnet v2 dans Bedrock pour votre région cible en suivant les étapes décrites dans ce guide.