agents-build 用于给已有的 AgentCore 智能体项目添加能力，不负责创建新项目、连接外部工具或部署。
适用场景：为智能体添加跨会话记忆；从 Web、移动端或后端服务调用已部署的智能体；为 RDS、内网 API 等私有资源配置 VPC；构建编排者/专家式多智能体系统；把已有 Bedrock Agent 迁移到 AgentCore；添加浏览器工具、代码解释器（沙箱执行代码）以及 AgentCore Payments（为 x402 或 MPP 保护的内容付费）；删除项目资源或拆除部署。
不适用：通过 Gateway 连接外部工具/API（应使用 agents-connect）、搭建新项目（agents-get-started）、部署（agents-deploy）。
使用方式：输入 $ARGUMENTS 可为能力关键词（memory、integrate、vpc、multi-agent、migrate、browser、code-interpreter、payments、teardown），也可为自然语言描述，留空则由上下文推断工作流。流程先运行 agentcore --version 校验，需 v0.9.0 或以上，过旧则提示运行 agentcore update。随后读取 agentcore/agentcore.json 了解框架与现有资源；若找不到，会检查上级目录（最多 3 层），仍无项目则询问想添加的能力，并提供先创建项目再继续，或切换到已有项目目录两条路径。之后按意图加载对应参考文件（memory.md、integrate.md、vpc.md、multi-agent.md、request-headers.md、migrate.md、browser.md、code-interpreter.md、payments.md、teardown.md），本地与已部署环境差异加载 local-vs-deployed.md。若涉及外部 API、Lambda、OpenAPI、网关、凭据、MCP 或策略，转 agents-connect；若为功能故障排查，转 agents-debug。
修改模型：编辑 app/<AgentName>/model/load.py 中 BedrockModel() 构造器的 model_id，例如 global.anthropic.claude-sonnet-4-5-20250929-v1:0、us.anthropic.claude-3-5-haiku-20241022-v1:0 或 amazon.nova-lite-v1:0；跨区域前缀（us.、eu.、apac.、global.）决定推理位置，并非所有模型支持全部前缀。改后需在 Amazon Bedrock 中启用模型访问，跨区域档案需在目标区域启用，如使用 agents-harden 还需更新 IAM 策略，然后运行 agentcore dev 本地测试、agentcore deploy 更新部署，无需改 agentcore.json。
限制：生成 agentcore add <resource> --name <something> 前需先校验名称，Agent 及 memory、gateway 等资源名最长 48 字符，只允许字母数字和下划线且以字母开头，项目名（agentcore create --name）限制更严为 23 字符且不允许下划线。具体输出依所加载参考文件而定。