AIダンジョンゲーム

概要

このチュートリアルではAI搭載のダンジョンアドベンチャーゲームを構築します。@aws/nx-pluginや関連技術に関する前提知識は必要ありません。ここで学ぶテクニックは@aws/nx-pluginベースのアプリケーション構築の基礎となるもので、このチュートリアルを完全に理解することでNXの基本的な使い方と@aws/nx-pluginの深い知識が得られます。

Note

このチュートリアルは、実践を通じて学ぶことを好み、具体的なものを素早く作りたい人向けに設計されています。各概念を段階的に学びたい場合は、個別のコンポーネントガイドを参照してください

このチュートリアルを完了すると、以下の知識が身に付きます：

• @aws/nx-pluginを使用して新しいアプリケーションを作成する
• NXを使用してコードベースを管理/ビルドする
• tRPCとFastAPIの両方を使用してAPIを構築する
• Tanstack routerで新しいページを作成する
• Tanstack queryでバックエンドAPIを呼び出す
• 生成されたコードを目的に合わせて修正する
• CDKインフラストラクチャを作成してデプロイする

構築するもの

このチュートリアルでは@aws/nx-pluginを使用して、AI搭載のダンジョンアドベンチャーゲームを構築します。

完成形は以下のようになります：

アプリケーションの構成要素

AI搭載ダンジョンアドベンチャーゲームは以下のコンポーネントアーキテクチャで構築されます：

• tRPC API（ゲーム状態管理にElectroDB/DynamoDBを使用）
• ストーリー生成用のPython/FastAPI Lambda関数（ストリーミングレスポンス対応、Amazon Bedrockで駆動）
• React/Viteフロントエンドウェブサイト：
  • 安全なAPI呼び出しのためのAmazon Cognito/Identity Pools
  • タイプセーフなファイルベースルーティングをサポートするTanstack router
  • ゲームAPI/ストーリーAPI呼び出し用生成SDK（Tanstack query活用）
• アプリケーションをデプロイするCDKインフラストラクチャ

前提条件

始める前に以下のグローバル依存関係が必要です：

• Git
• Node >= 22（Nodeバージョン管理にはNVMの使用を推奨）
  • node --version を実行して確認
• PNPM >= 10（代替としてYarn >= 4、Bun >= 1、NPM >= 10も使用可能）
  • pnpm --version、yarn --version、bun --version または npm --version で確認
• UV >= 0.5.29
  1. Python 3.12をインストール: uv python install 3.12.0
  2. uv python list --only-installed で確認
• デプロイ先AWSアカウント用に設定されたAWS Credentials
• VSCodeを使用する場合、Nx Console VSCode Pluginのインストールを推奨

Tip

Amazon Q Developer、Cursor、Claude Code、ClineなどのAIアシスタントを使用する場合は、Nx Plugin for AWS MCP serverのインストールも推奨します。

• AWSアカウントで対象リージョンのBedrockにおいてAnthropic Claude 3.5 Sonnet v2モデルへのアクセスが有効化されていることを確認してください（設定手順はこのガイドを参照）。