面向 Amazon Bedrock AgentCore 的全栈解决方案模板,提供开箱即用的前后端应用、安全认证体系和 CDK 基础设施,支持 Strands/LangGraph 等 Agent 框架,加速生产级 Agent 应用开发。
项目概述#
Fullstack Solution Template for AgentCore (FAST) 是由 AWS Labs 官方维护的全栈解决方案模板,旨在加速 Amazon Bedrock AgentCore 上的生产级 Agent 应用部署。当前版本 0.3.1,采用 Apache-2.0 许可证。
核心特性#
- 全栈开箱即用:React 前端 + AgentCore Runtime 后端 + CDK 基础设施
- 安全认证体系:四层 Amazon Cognito 认证(前端登录、Runtime 访问、Gateway 访问、API Gateway)
- Agent 模式支持:strands-single-agent(默认)、langgraph-single-agent
- 内置工具:Gateway Tools(Lambda 驱动)、Code Interpreter(隔离沙箱 Python 执行)
- Vibe-Coding 友好:支持 Amazon Q、Kiro、Cline、Claude Code 等 AI 编码助手
架构说明#
项目结构#
fullstack-agentcore-solution-template/
├── frontend/ # React 前端应用
├── infra-cdk/ # CDK 基础设施代码
├── patterns/ # Agent 模式实现
├── tools/ # 可复用工具(框架无关)
├── gateway/ # Gateway 工具和实用程序
├── scripts/ # 部署和测试脚本
├── vibe-context/ # AI 编码助手上下文
└── docker/ # 本地开发 Docker 配置
关键机制#
- AgentCore Memory:存储对话历史,支持多轮对话上下文
- AgentCore Gateway:通过 MCP 提供工具访问
- Code Interpreter:隔离沙箱执行,预装常用 Python 库
安装部署#
前置条件#
- Node.js 20+
- Python 3.11+
- AWS CLI 已配置凭证
- AWS CDK CLI
- Docker(必需)
快速部署#
cd infra-cdk
npm install
cdk bootstrap # 首次部署时执行
cdk deploy
cd ..
python scripts/deploy-frontend.py
配置示例#
stack_name_base: your-project-name # 最大 35 字符
admin_user_email: null # 可选
backend:
pattern: strands-single-agent # 可选: strands-single-agent, langgraph
deployment_type: docker # 可选: docker (默认), zip
适用场景#
- 需要多轮对话的 Agent 应用
- 需要工具调用的 Agent 系统
- 生产级安全部署需求
- 交付科学家和工程师快速验证 AgentCore 方案
注意事项#
- 项目文档声明为 "proof-of-value",用户需自行实施安全控制
- 当前仅支持 Single-Agent 模式,Multi-Agent 待后续版本
- 非 ARM 机器部署需配置 QEMU 和 Docker buildx