bedrock-chat

环境要求

• 已安装 Docker 的环境
• Node.js 运行环境（含 npm / npx）
• 可用的 UNIX 环境（macOS / Linux / WSL）
• 具备 Bedrock 权限的 AWS 账户，且已在目标区域开通模型访问
• 本地磁盘空间充足（空间不足会导致 CDK bootstrap 失败）

安装与启动步骤

1. 1开通 Bedrock 模型

   在 us-east-1 区域打开 Bedrock 的 Model access 页面，点 Manage model access，勾选计划使用的模型后 Save changes。

2. 2克隆代码仓库

   把仓库克隆到本地，后续 CDK 命令都将在该目录及其 cdk 子目录中执行。

   git clone https://github.com/aws-samples/bedrock-chat

   复制

3. 3安装 npm 依赖

   进入仓库的 cdk 目录，用 npm ci 按锁文件安装依赖，保证版本与项目一致。

   cd bedrock-chat
   cd cdk
   npm ci

   复制

4. 4按需修改配置

   编辑 cdk/cdk.json，按需调整 bedrockRegion、允许访问的 IP 段、是否启用 SnapStart 等项。

5. 5执行 CDK Bootstrap

   首次往目标区域部署前必须引导一次，用于创建 CDK 所需的基础资源。

   npx cdk bootstrap

   复制

6. 6部署全部资源

   部署前后端及基础设施，过程会持续一段时间，完成后终端会打印各资源输出。

   npx cdk deploy --require-approval never --all

   复制

7. 7访问 Web 应用

   在部署输出中找到 BedrockChatStack.FrontendURL，用浏览器打开这个 CloudFront 地址即可使用。

关键配置

如何确认成功

部署输出中出现 BedrockChatStack.FrontendURL，浏览器打开该 CloudFront 地址能进入聊天界面即成功。

常见问题

注意事项

• Bedrock 目前尚未覆盖所有区域，选择 bedrockRegion 前请确认目标区域支持所需模型。
• 模型 ID 以 frontend/src/constants/index.ts 中的完整列表为准。
• 同一 AWS 账号默认只能创建 100 个 Knowledge Base，可用多租户（shared）模式共享同一知识库。
• README 未提供脱离 AWS 本地运行的方式，部署依赖真实 AWS 账户与凭证。