本文由 亚马逊云站代理商『翼龙云/TG @Yilongcloud 撰写』如需转载请注明！
在出海业务中，利用 AI 智能体（AI Agent）完成多步推理、工具调用、第三方 API 访问，能够显著提升业务自动化能力。Amazon Bedrock Agent 是全托管智能体构建能力，可在云原生合规框架下对接主流大模型，适合跨境客服、订单自动处理、多语种业务场景。
重要前置提示：
- 草稿 (Draft) 仅用于控制台测试；正式业务调用必须发布 Agent 版本并创建别名 (Alias)，不能直接使用草稿 ID 做线上调用。
- Bedrock Agent 调用 Lambda，除 Lambda 执行角色之外，必须给 Lambda 配置资源策略，允许 Bedrock 服务主体调用，否则会报访问拒绝，这是最高频配置错误。
- Action Group 使用 OpenAPI Schema 强制要求版本为openapi:3.0.0，1 及以上版本不兼容，会直接构建失败AWS。
- Agent 整体最大执行超时为 5 分钟，绑定的 Lambda 超时时间不能超过该上限。
- 新账号 Bedrock 默认令牌配额较低，Claude 等模型需要提交业务场景表单审核开通权限，并非开启 Model access 即可直接使用。
一、前置条件与准备工作核验
部署前确认云环境、权限、模型访问全部就绪：
- AWS 国际站账号：持有 AWS 国际站账号。渠道合作伙伴翼龙云（Yilongcloud）可协助出海企业梳理开户准备事项，提供开户流程咨询以及对公转账、外币支付等方案咨询，降低前期准入门槛。
- 模型访问权限：进入 Bedrock 控制台 Model access 页面，提交业务申请，获取 Anthropic Claude 等基础模型调用权限。部分模型需要填写业务场景表单完成审核。
- IAM 角色授权
- Bedrock Agent 服务角色：授予模型调用bedrock:InvokeModel、知识库检索bedrock:Retrieve权限，权限遵循最小权限原则。
- Lambda 执行角色：Action Group 对应的 Lambda 函数，授予访问下游业务资源的权限。
- Lambda 资源策略：额外配置资源型策略，允许 Bedrock 服务调用该 Lambda 函数。
二、核心架构组成
生产级 Bedrock 智能体由四大核心组件构成：
- Agent（智能体核心）：接收用户输入，完成任务拆解、思维链 CoT 推理，调度知识库与工具。
- Knowledge Base（知识库 RAG）：对接企业私有文档，实现私有知识检索增强；知识库自身拥有独立 IAM 角色，Agent 服务角色还需要额外授予检索权限。
- Action Group（操作组）：工具调用层，支持两种模式：
- OpenAPI Schema：完整 API 接口描述，适合复杂第三方接口；
- Function Schema：简化函数参数定义，适合轻量工具调用。 通过绑定 AWS Lambda 实现外部业务 API、联网查询、订单查询等能力。
- Guardrails（安全护栏）：生产环境建议配置，用于输出约束、敏感内容拦截，适配 GDPR 等海外合规要求。
三、配置框架：创建基础 Agent
创建 Agent 时定义身份、行为边界、会话策略，核心配置项：
| 参数名称 | 功能说明 | 配置建议 |
| Agent Name | 唯一标识符 | 规范命名，例如 CSSearchBotProd |
| Idle session TTL | 会话闲置超时 | 默认 30 分钟；客服业务按需调整，超时会话上下文会被清空 |
| User Input elicitation | 是否向用户追问补全参数 | 复杂业务排障场景开启，用于收集缺失入参 |
| Instruction | 系统提示词 | 明确 Agent 角色、业务目标、多语言输出、合规边界，限制越界回答 |
| Action Groups | 外部工具集合 | 绑定 Function/OpenAPI Schema 与对应 Lambda |
| Knowledge Bases | RAG 私有数据源 | 绑定知识库，校验 Agent 角色具备 KB 检索权限 |
| Guardrails | 安全护栏 | 生产环境绑定，管控敏感输出、多语种风控 |
配置完成后，必须准备 (Prepare) Agent 草稿，修改配置后需要重新 Prepare 才会生效；上线前发布版本，创建 Agent Alias 别名用于业务调用。
四、配置框架：联网与 Action Group 集成
Action Group 是 Agent 执行外部业务逻辑的核心，强依赖 AWS Lambda。
- Lambda 职责：Agent 判定需要调用工具时，触发 Lambda 执行业务逻辑，例如查询订单、调用第三方物流、汇率接口。
- Schema 定义：
- OpenAPI 模式：必须使用openapi:3.0.0版本 JSON/YAML；可以控制台内联填写，也可以引用 S3 存储的 schema 文件AWS。
- Function Schema 模式：轻量场景，直接定义函数名称、入参、描述，无需完整 OpenAPI 文档。
- 权限双层校验：
- Lambda 执行角色：Lambda 内部访问其他云资源的权限；
- Lambda 资源策略：授权 Bedrock 服务主体可以调用本 Lambda，缺少此配置会直接 AccessDenied。
代码与 Schema 模板参考 AWS 官方开发者指南。
五、验证与资源清理
- Trace 追踪验证：测试控制台打开 Trace，完整查看 Agent 思考过程 Rationale、知识库检索结果、Action Group 入参返回值，定位工具调用失败原因。
- 资源清理（实验环境务必完整清理，避免持续计费） 按顺序删除：Agent 别名 → Agent Action Group → Agent 草稿 → Lambda 函数 → IAM 角色； 如使用 Knowledge Base，同步清理知识库、向量存储资源。
常见问题与排障 (FAQ)：
Q1：AWS Bedrock Agent 是什么，适合哪些出海业务场景？ A：全托管 AI 智能体构建服务，自动完成任务拆解、工具编排、RAG 检索。适合多语种智能客服、跨境电商订单查询、对接物流 / 汇率等外部数据的自动化业务流程。
Q2：如何在 AWS Bedrock 中配置联网搜索与外部 API 调用？ A：通过 Action Group 实现。编写业务逻辑部署到 Lambda，选择 OpenAPI Schema 或 Function Schema 描述工具入参出参，在 Agent 中绑定 Action Group；注意配置 Lambda 资源调用权限。具体路径请以 AWS 最新官方文档为准。
Q3：调用 Lambda Action Group 一直报 AccessDenied？ A：分两层排查：
- Lambda 执行角色是否拥有 Lambda 内部业务逻辑需要的权限；
- 检查 Lambda 资源策略，是否允许 Bedrock 服务主体调用该 Lambda，这是最常见的配置遗漏点；
- 检查 Lambda 超时时间，不能超过 5 分钟上限。
Q4：计费模式与成本优化建议？ A：成本由模型 Token 消耗、Lambda 执行费用、知识库向量检索费用共同组成。优化 System Prompt 减少无效 Token；合理设置 Lambda 内存、超时；业务闲时做好资源清理。实际预算请核对 AWS 官网最新定价矩阵。
Q5：Knowledge Base 控制台测试正常，绑定 Agent 之后检索不到内容？ A：确认 Bedrock Agent 服务角色拥有对应知识库的bedrock:Retrieve权限；确认 Agent 已经执行 Prepare 更新配置；打开 Trace 查看 Agent 实际检索请求日志。
Q6：Agent 控制台测试正常，SDK 调用报错？ A：线上调用必须使用Agent Alias（别名）ARN，不能直接使用草稿 Agent ID。