Agent Toolkit for AWS完整指南:如何将AI编码助手5分钟变成AWS官方云工程师
Agent Toolkit for AWS完整指南:如何将AI编码助手5分钟变成AWS官方云工程师
Agent Toolkit for AWS 是 AWS 官方推出的 AI 代理工具包:它把 AWS MCP Server、数百个经过评测的官方 Skills 和 5 大插件打包在一起,让 Claude Code、Codex、Cursor、Kiro、fx 等 AI 编码助手获得调用 300+ AWS 服务 API、实时搜索最新文档、沙箱执行脚本的完整能力。装好之后,你只需一句话,AI 就能按照 AWS 官方最佳实践帮你构建、部署和管理云上应用——整个过程最快 5 分钟。🚀
一、什么是 Agent Toolkit for AWS:给 AI 编码助手装上"官方云大脑"
过去用 AI 写 AWS 代码,常见三个痛点:
- ❌ AI 凭"记忆"编造过时的 API 参数和 IAM 策略
- ❌ 不知道如何安全地让 AI 真正调用你的 AWS 账户
- ❌ 缺少官方运维经验,部署出来不符合最佳实践
Agent Toolkit for AWS 一次性解决这些问题,它包含 4 类核心组件:
| 组件 | 作用 | 位置 |
|---|---|---|
| AWS MCP Server | 托管式协议服务器:call_aws 调用 300+ 服务 API、search_documentation 实时搜文档、run_script 沙箱执行 Python、retrieve_skill 按需加载技能 |
plugins/aws-core/mcp.json |
| Agent Skills | 数百个官方精选"技能包"(指令 + 参考资料),按需加载、不占上下文 | skills/README.md |
| Plugins | 一键安装包,把 MCP 配置 + Skills 打给编码助手 | plugins/ |
| Rules 文件 | 告诉 AI"先查技能再动手、用 IaC、核实文档"等工作守则 | rules/aws-agent-rules.md |
💡 它还是 AWS Labs 早期 MCP 工具集的官方继任者,并增加了三大企业级能力:区分"AI 操作"与"人工操作"的 IAM 条件键、每个请求的 CloudWatch 指标与 CloudTrail 审计日志、经过端到端评测的 Skills。
二、一键安装:5 分钟快速上手步骤
方式 1:AWS CLI 引导安装(推荐新手)🥇
一条命令启动交互式向导,自动完成:检测系统 → 安装 AWS CLI → 浏览器登录 → 配置 MCP Server → 安装默认 Skills → 验证:
aws configure agent-toolkit
安装完成后用这条命令验证,应返回技能目录的 JSON 列表:
aws agent-toolkit list-available-skills --region us-east-1
完整 7 步引导流程(含每一步的失败排查入口)见 setup-instructions/setup.md,排错手册见 setup-instructions/setup-troubleshooting.md。
方式 2:Claude Code 插件安装(最快)
插件已上架 Anthropic 官方市场,在 Claude Code 中直接执行:
/plugin install aws-core@claude-plugins-official
若提示 Plugin not found,先更新本地市场索引:/plugin marketplace update claude-plugins-official。
方式 3:其他编码助手
| 助手 | 安装方式 |
|---|---|
| Codex | 终端执行 codex plugin marketplace add aws/agent-toolkit-for-aws,再运行 /plugins 安装 aws-core |
| Cursor | Settings → Plugins → Team Marketplaces → Import from Repo,指向 aws/agent-toolkit-for-aws,然后在 Plugins 面板安装 aws-core |
| Kiro / fx | 在 MCP 配置中写入 uvx mcp-proxy-for-aws-cli@latest https://aws-mcp.us-east-1.api.aws/mcp --metadata AWS_REGION=你的区域,再执行 npx skills add aws/agent-toolkit-for-aws/skills 安装技能 |
| 其他助手 | 先配置 AWS MCP Server,再 npx skills add aws/agent-toolkit-for-aws/skills;也可先克隆仓库浏览:git clone https://gitcode.com/GitHub_Trending/ag/agent-toolkit-for-aws |
📌 前提:已安装 uv(Kiro/fx 路径需要);调用 AWS API 需要本地配置好 AWS 凭据,但搜索文档和发现技能不需要认证。
三、五大官方插件:按角色精准选配 🔧
| 插件 | 一句话定位 | 适合谁 |
|---|---|---|
| aws-core | 服务选型、CDK/CloudFormation、Serverless、容器、存储、可观测性、计费、SDK、部署——新人从这里开始 | 所有开发者 |
| aws-agents | 基于 Amazon Bedrock 和 AgentCore 构建 AI Agent 的全生命周期技能(搭建、记忆、网关、部署、调优、加固、Agent 自主支付) | AI Agent 开发者 |
| aws-data-analytics | S3 Tables、Glue、Athena、Redshift、MWAA、MSK、Flink、OpenSearch 全数据链路 16 个技能 | 数据工程师 |
| aws-agents-for-devsecops | 故障调查、发布就绪审查、UAT 测试、漏洞扫描、渗透测试 | DevSecOps 团队 |
| aws-startup-advisor | 创业公司架构/成本/安全建议、Azure/GCP/Heroku 迁移、OpenAI/Gemini 调用迁移到 Bedrock | 创业团队 |
各插件详情:aws-core · aws-agents · aws-data-analytics · aws-agents-for-devsecops · aws-startup-advisor
aws-core 自带 14 个默认技能,涵盖 Bedrock、CDK、CloudFormation、IAM、计费优化、CloudWatch、AWS Blocks 全栈开发等——详见 plugins/aws-core/README.md 的技能清单。
四、装好之后,第一句 Prompt 说什么?
官方推荐的试手提示词(来自引导流程的结尾):
"Please make a single page webapp game and deploy it to AWS."
也可以试试这些真实场景:
- 🔍 "帮我在 AWS 上查一下现在有哪些数据库服务适合存用户画像"
- 💰 "分析我账户这个月的花费,哪里能省钱"
- 🚨 "线上服务 5xx 报警了,帮我调查根因"(devsecops 插件)
- 📊 "把我们的 PostgreSQL 销售数据导入数据湖"(data-analytics 插件)
- 🤖 "我要给 Agent 加上记忆,跨会话记住上下文"(agents 插件)
AI 会先通过 retrieve_skill 找到对应官方技能,再按技能里的 SOP 一步步执行——而不是自由发挥。
五、避坑指南:新手最常踩的 3 个配置问题 ⚠️
- 区域写死:Agent Toolkit 服务目前仅在
us-east-1提供,aws configure agent-toolkit和aws agent-toolkit ...命令里请固定用--region us-east-1,不要替换成你的业务区域。 - Profile 不匹配:如果你用非
defaultprofile 登录,需在每个 MCP 配置文件的aws-mcp条目中加上"env": {"AWS_MCP_PROXY_PROFILES": "你的profile名"},否则会报JSON-RPC error: -32602。 - 凭据有效期:
aws login的浏览器登录凭据有效期为 12 小时,之后可在 90 天内直接续期,无需再次浏览器认证。
六、常见问题(FAQ)
Q1:AI 会不会乱动我的云资源? 不会失控。Agent Toolkit 支持"仅限 AI 只读"的 IAM 策略(条件键区分代理/人工操作),且每个请求都有 CloudWatch 指标 + CloudTrail 审计日志。
Q2:Skills 会不会撑爆 AI 的上下文?
不会。Skills 是按需加载的:AI 先检索(retrieve_skill),命中任务才拉取对应技能的参考资料。
Q3:和 AWS Labs 里的旧 MCP 服务器有什么区别? Agent Toolkit 是官方继任者,新增代理专属 IAM 条件键、全量审计日志和经过端到端评测的技能,官方建议优先使用它。
Q4:文档和技能在哪里继续查? 项目总览见 README.md,技能目录(核心 + 专业两类,覆盖分析、数据库、网络、Serverless、存储、量子计算等 16 个分类)见 skills/README.md。
总结:Agent Toolkit for AWS 是 AWS 官方为 AI 编码时代准备的"云工程师外挂"——一条 aws configure agent-toolkit 或一个 /plugin install 命令,你的 AI 助手就从"会背文档的学生"变成"能操作云、且操作全程可审计的工程师"。5 分钟安装,一句话开工,现在就试试吧!🎯