Bỏ qua để đến nội dung

Trò chơi Dungeon AI Agentic

Sử dụng hướng dẫn này, bạn sẽ xây dựng một trò chơi phiêu lưu dungeon được hỗ trợ bởi AI Agentic với @aws/nx-plugin. Hướng dẫn này không yêu cầu bất kỳ kiến thức nào về @aws/nx-plugin hoặc các công nghệ liên quan. Các kỹ thuật bạn sẽ học trong hướng dẫn này sẽ giúp:

  • Xây dựng bất kỳ ứng dụng nào dựa trên @aws/nx-plugin,
  • Cung cấp hiểu biết sâu sắc về @aws/nx-plugin, và
  • Có được hiểu biết cơ bản về cách sử dụng framework NX.

Khi kết thúc hướng dẫn, bạn sẽ có được kiến thức để:

  • sử dụng @aws/nx-plugin để tạo các ứng dụng mới,
  • sử dụng NX để quản lý/xây dựng codebase của họ,
  • xây dựng API sử dụng tRPC,
  • xây dựng Agent sử dụng Strands,
  • xây dựng MCP server trong TypeScript,
  • sử dụng Tanstack router để tạo các trang mới,
  • sử dụng Tanstack query để gọi các API backend,
  • mô hình hóa dữ liệu trong DynamoDB và phát triển cục bộ với DynamoDB Local, và
  • tạo và triển khai cơ sở hạ tầng CDK.

Trong hướng dẫn này, bạn sẽ xây dựng một trò chơi phiêu lưu dungeon được hỗ trợ bởi AI Agentic với @aws/nx-plugin.

Giao diện trò chơi sẽ giống như sơ đồ này:

game-select.png
game-conversation.png

Trò chơi phiêu lưu dungeon được hỗ trợ bởi AI Agentic được xây dựng sử dụng kiến trúc sau:

Web BrowserCognito / IAMCloudFrontStatic Assets(S3)API Gateway(Game API)tRPC API(Lambda)Story Agent(AgentCore)Inventory MCP(AgentCore)Game State(DynamoDB)Story Sessions(S3) Sign in Read transcripts AG-UI stream Persist turns Tool calls
  • Website frontend React/Vite sử dụng:
    • Amazon Cognito/Identity Pools cho các lời gọi API an toàn.
    • Tanstack router hỗ trợ định tuyến dựa trên file với type-safe.
    • SDK được tạo tự động để gọi Game API.
  • API tRPC sử dụng ElectroDB/DynamoDB để quản lý trạng thái trò chơi.
  • Agent Strands được lưu trữ trên Amazon Bedrock AgentCore để chạy trò chơi.
  • TypeScript MCP Server được lưu trữ trên Amazon Bedrock AgentCore để agent quản lý kho đồ của người chơi.
  • Cơ sở hạ tầng CDK để triển khai ứng dụng.

Trước khi tiếp tục, bạn sẽ cần các phụ thuộc toàn cục sau:

  • Git
  • Node >= 22 (Chúng tôi khuyến nghị sử dụng công cụ như NVM để quản lý các phiên bản node của bạn)
    • xác minh bằng cách chạy node --version
  • UV >= 0.5.29
    1. cài đặt Python 3.14 bằng cách chạy: uv python install 3.14.0
    2. xác minh với uv python list --only-installed
  • AWS Credentials được cấu hình cho tài khoản AWS mục tiêu của bạn, vì hướng dẫn này triển khai ứng dụng và gọi Amazon Bedrock
  • Docker (hoặc Finch) là bắt buộc cho phát triển DynamoDB cục bộ và để xây dựng các thành phần AgentCore