跳转到内容

AI地牢游戏

在本教程中,您将构建一个由AI驱动的地牢冒险游戏。本教程不要求预先具备任何@aws/nx-plugin或相关技术的知识。您将在此学习的技巧是构建任何基于@aws/nx-plugin应用程序的基础,深入理解本教程将使您掌握@aws/nx-plugin的核心知识,并对如何使用NX有基本认知。

完成本教程的用户将获得以下技能:

  • 使用@aws/nx-plugin创建新应用
  • 使用NX管理/构建代码库
  • 使用tRPC和FastAPI构建API
  • 使用Tanstack router创建新页面
  • 使用Tanstack query调用后端API
  • 修改生成代码以适应特定需求
  • 创建和部署CDK基础设施

在本教程中,您将使用@aws/nx-plugin构建一个由AI驱动的地牢冒险游戏。

以下是完成后的效果预览:

game-select.png
game-conversation.png

AI驱动的地牢冒险游戏将采用以下组件架构:

dungeon-game-architecture.png
  • 使用ElectroDB/DynamoDB管理游戏状态的tRPC API
  • 支持流式响应的Python/FastAPI Lambda函数(基于Amazon Bedrock实现故事生成)
  • React/Vite前端网站包含:
    • 使用Amazon Cognito/Identity Pools实现安全的API调用
    • 支持类型安全文件路由的Tanstack router
    • 调用游戏和故事API的生成SDK(利用Tanstack query
  • 部署应用的CDK基础设施

开始前需确保已安装以下全局依赖:

  • Git
  • Node >= 22(推荐使用NVM管理Node版本)
    • 验证命令:node --version
  • PNPM >= 10(也可使用Yarn >= 4Bun >= 1NPM >= 10
    • 验证命令:pnpm --versionyarn --versionbun --versionnpm --version
  • UV >= 0.5.29
    1. 安装Python 3.12:uv python install 3.12.0
    2. 验证安装:uv python list --only-installed
  • 配置到目标AWS账户的AWS凭证(应用将部署至该账户)
  • 根据本指南步骤,确保目标区域的AWS账号已在Bedrock中启用Anthropic Claude 3.5 Sonnet v2模型的访问权限。