实战：接入 AWS Bedrock | Easy Understand Hermes Agent

这篇教程将带你一步步把 Hermes Agent 接入亚马逊的 Bedrock 服务，让你能用上 Claude、Nova 等顶级大模型。

准备工作：像办银行卡一样简单

想象一下，使用 Bedrock 就像去银行办业务——AWS 凭证就是你的身份证。好消息是，Hermes 支持多种“身份证”：

如果你在 AWS 的服务器（EC2、ECS、Lambda）上运行，什么都不用做，系统自动识别身份
本地开发可以用 aws configure 命令配置，或者设置环境变量 AWS_ACCESS_KEY_ID 和 AWS_SECRET_ACCESS_KEY

另外，需要安装 boto3 这个“翻译官”：

cd ~/.hermes/hermes-agent && uv pip install -e ".[bedrock]"

第 1 步：选择 Bedrock 作为你的模型供应商

运行以下命令，就像打开一个“模型超市”：

hermes model

在菜单中选择 “More providers…” → “AWS Bedrock”，然后选择你所在的区域（比如 us-east-2）和心仪的模型。

第 2 步：确认配置

选好后，Hermes 会自动生成配置文件（~/.hermes/config.yaml），就像自动填好的表单：

model:
  default: us.anthropic.claude-sonnet-4-6
  provider: bedrock
  base_url: https://bedrock-runtime.us-east-2.amazonaws.com

bedrock:
  region: us-east-2

第 3 步：开始聊天

hermes chat

就这么简单！现在你可以和 Claude 对话了。

进阶技巧：让模型更聪明、更省钱

🔒 内容安全护栏（Guardrails）：如果你想让模型不回答敏感话题，可以在配置里加上：

bedrock:
  guardrail:
    guardrail_identifier: "abc123def456"  # 在 Bedrock 控制台获取
    guardrail_version: "1"

⚡ 提示词缓存：Hermes 会自动在系统提示词、工具定义和最新消息后插入缓存标记，重复内容不再重复计费，省钱又提速。无需额外配置！

🔄 会话中切换模型：聊到一半想换个模型？直接输入：

/model us.amazon.nova-pro-v1:0
/model deepseek.v3.2

常见问题排查

“No API key found”：检查凭证是否配置正确，运行 aws configure 或给服务器挂上 IAM 角色。

“on-demand throughput isn’t supported”：记得使用带 us. 或 global. 前缀的推理配置文件 ID，而不是裸的模型 ID。比如用 us.anthropic.claude-sonnet-4-6 而不是 anthropic.claude-sonnet-4-6。

“ThrottlingException”：请求太频繁触发了限流。Hermes 会自动重试，也可以去 AWS 控制台申请提高配额。

总结

接入 Bedrock 只需三步：安装依赖 → 选择供应商 → 开始聊天。AWS 凭证是唯一的门槛，其余交给 Hermes 自动处理。Bedrock 的优势在于生态完整：IAM 安全认证、跨区域容灾、护栏机制，以及丰富的模型选择——从 Anthropic 的 Claude 到 Meta 的 Llama，再到亚马逊自家的 Nova，总有一款适合你。

下篇预告：接入只是开始，下一篇我们将深入实战——用 Hermes Agent 构建一个自动处理邮件的智能助手，看看这个框架如何帮我们解放双手！