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 hầm ngục được hỗ trợ bởi Agentic AI với @aws/nx-plugin. Hướng dẫn này không yêu cầu kiến thức sẵn có 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 bằng TypeScript,
sử dụng Tanstack router để tạo các trang mới,
sử dụng Tanstack query để gọi các API backend, và
tạo và triển khai cơ sở hạ tầng CDK.

Bạn đang xây dựng cái gì?

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

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

Kiến trúc ứng dụng

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

Website frontend React/Vite sử dụng:
- Amazon Cognito/Identity Pools cho các cuộc gọi API bảo mật.
- Tanstack router hỗ trợ định tuyến dựa trên tệp 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.
MCP Server TypeScript đượ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.

Yêu cầu trước

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 bạn nên sử dụng công cụ như NVM để quản lý các phiên bản node)
- xác minh bằng cách chạy node --version
PNPM >= 10 (bạn cũng có thể sử dụng Yarn >= 4, Bun >= 1, hoặc NPM >= 10 nếu bạn muốn)
- xác minh bằng cách chạy pnpm --version, yarn --version, bun --version hoặc npm --version
UV >= 0.5.29
1. cài đặt Python 3.12 bằng cách chạy: uv python install 3.12.0
2. xác minh bằng uv python list --only-installed
AWS Credentials được cấu hình cho tài khoản AWS đích của bạn (nơi ứng dụng của bạn sẽ được triển khai)

Docker là bắt buộc để xây dựng các thành phần AgentCore