Hermes 如何通过 x-team-id、x-agent-id、x-task-id 请求头接入 TencentDB Agent Memory Proxy【免费下载链接】TencentDB-Agent-MemoryTencentDB Agent Memory is a team-level memory hub for AI Agents — turning conversations, docs, and code into four reusable memory assets (Chat Memory, Skill, LLM-Wiki, Code-Graph) that are governed, shared, and equipped across agents and frameworks.项目地址: https://gitcode.com/GitHub_Trending/te/TencentDB-Agent-MemoryTencentDB Agent Memory 中的 MemoryProxy 是一个透明的 LLM 请求代理把对话请求先转发到它再由它注入团队记忆、Skill 与知识最后转给上游 LLM。Hermes 是开源的 AI Agent 框架无法响应 Proxy 的交互式会话选择表单因此接入时必须通过x-team-id、x-agent-id、x-task-id这几个请求头告诉 Proxy 本次会话绑定哪个团队、哪个 Agent、哪个 Task。本文的目标是完成这一接入让 Hermes 的对话请求走 Proxy并真正生效记忆注入与对话回流。前置条件接入前需要满足以下条件均见 INSTALL.mdProxy 已随 Memory Core Memory Hub Proxy 三合一栈启动默认监听8096端口。使用deploy/global-images下的脚本一次性启动# 1) 获取脚本 git clone https://github.com/TencentCloud/TencentDB-Agent-Memory.git cd TencentDB-Agent-Memory/deploy/global-images # 2) 准备 .env填写真实 LLM 值 cp .env.example .env # MEMORY_LLM_BASE_URL / MEMORY_LLM_API_KEY / MEMORY_LLM_MODEL ← memory hub 内部使用 # PROXY_UPSTREAM_URL / PROXY_UPSTREAM_API_KEY / PROXY_UPSTREAM_MODEL ← Proxy 转发的上游 # 3) 可选dry-run 校验加 --skip-llm 跳过在线 LLM 探测 ./verify.sh # 4) 一键启动 ./start-all.sh在管理面板默认http://localhost:8125首次访问用start-all.sh输出的 adminuser_key中已创建好Team、Agent、Task三类业务资产。注意x-task-id在当前版本是必填项所以 Task 必须提前创建好并记下task_id这一步是 Hermes 接入区别于 Claude Code / CodeBuddy 的关键差异。已从面板 API Key 页拿到用户的user_keysk-mem-...。配置 Hermes 的 extra headers编辑 Hermes 的~/.hermes/config.yaml把base_url指向 Proxy 的/hermes/spaceId路径并在extra_headers中带上三个身份请求头model: default: gpt-5.5 provider: custom base_url: http://proxy-host:port/hermes/spaceId api_key: API Key from admin panel extra_headers: x-team-id: team_id from admin panel x-agent-id: agent_id from admin panel x-task-id: task_id from admin panel x-conversation-id: user-defined session identifier各字段的含义与来源均来自 INSTALL.md 的 Using Proxy with Hermes 一节base_urlProxy 地址 /hermes/spaceId路径。spaceId是记忆实例 ID管理面板中查看本地部署通常为default。proxy-host/port按实际 Proxy 地址替换本地部署即127.0.0.1:8096。api_key用户的user_key取自管理面板 API Key 页。Proxy 用它在 MemoryCore 侧校验身份并解析user_id。x-team-id/x-agent-id从管理面板获取与 CodeBuddy / Claude Code 使用同一套资产。x-task-id从管理面板 Task Management 页获取当前版本必填。x-conversation-id用户自定义的会话标识用于在 Hermes 侧维持会话边界限制见下文。请求头是如何被 Proxy 使用的MemoryProxy 支持 header 自动预选当请求携带x-team-id等头时Proxy 会把这些值与该用户实际可见的 team / agent / task 列表逐一校验全部匹配则跳过交互式选择表单直接完成会话注册机制见 MemoryProxy README 与源码 preset.ts。只有用户自己租户范围内存在的值才会被信任对不上的值视为不匹配不会盲信。这正是 Hermes 接入的关键路径Claude Code / CodeBuddy 的首轮请求靠交互式表单选 Team → Agent → Task而 Hermes / OpenClaw 无法响应表单所以三头必须齐全。缺x-task-id时Proxy 会回退到交互式表单流程Hermes 无法响应结果是session bypass——记忆注入和对话回流都不生效。会话注册成功后Proxy 的完整流水线为auth校验 user_key→sessionInit本次由请求头直接完成→injection把 L2/L3 记忆、Skill、知识注入 system prompt→ 转发上游 LLM → 每轮结束后异步回流对话与 L0 记忆。验证接入是否生效Proxy 存活启动后检查健康检查接口来自 MemoryProxy README 的 Quick startcurl http://127.0.0.1:8096/health返回示例文档示例字段值随部署不同{ status: ok, version: 0.2.0, upstream: https://tokenhub.example.com/v1, storage: { enabled: false, requested: sqlite, effective: sqlite, degraded: false } }发起对话在 Hermes 中选择刚配置的自定义 model 正常聊天。接入成功时不会出现交互式选择提示Proxy 直接按请求头注册会话对话内容会被写入团队记忆。面板确认在面板http://localhost:8125左侧Memory→ Chat Memory 查看 L0 对话是否按场景切片入库Agent 详情页 Profile 会随对话累积 L2 场景与 L3 画像。也可查看 Memory-core 的 pipeline 是否在干活curl -s http://localhost:8420/health | jq .services.pipelineWorker预期tasksConsumed/tasksCompleted随对话增长。当前版本的两个已知限制x-task-id必填用户在面板预先创建 Task 并获取task_id会增加接入成本切换 Task 需要手动修改config.yaml。官方说明下一版本会将其变为可选未提供时自动选择 agent 默认 task 或跳过 task 绑定。x-conversation-id需静态指定与 Claude Code / CodeBuddy 由 SDK 自动管理会话 ID 不同Hermes 的会话 ID 写死在配置文件里带来三点约束——共享同一 conversation ID 的请求都属于同一会话开启新对话必须手动更换该 ID否则沿用旧会话状态部分客户端在 tool-call 后续请求中可能不再携带 extra headers导致这些轮次跳过记忆注入与对话回流。下一版本 Proxy 计划支持自动生成与管理 conversation ID。小结Hermes 接入 MemoryProxy 的主路径是启动三合一栈 → 面板创建 Team / Agent / Task 并获取user_key→ 在~/.hermes/config.yaml配置base_url/hermes/spaceId与x-team-id/x-agent-id/x-task-id/x-conversation-id四个请求头 → 用/health与面板 Memory 页验证。唯一必须牢记的是当前版本x-task-id缺失即 session bypass接入前先把 Task 建好新会话记得更换x-conversation-id否则记忆仍绑在旧会话上。【免费下载链接】TencentDB-Agent-MemoryTencentDB Agent Memory is a team-level memory hub for AI Agents — turning conversations, docs, and code into four reusable memory assets (Chat Memory, Skill, LLM-Wiki, Code-Graph) that are governed, shared, and equipped across agents and frameworks.项目地址: https://gitcode.com/GitHub_Trending/te/TencentDB-Agent-Memory创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考 Hermes 如何通过 x-team-id、x-agent-id、x-task-id 请求头接入 TencentDB Agent Memory Proxy
Hermes 如何通过 x-team-id、x-agent-id、x-task-id 请求头接入 TencentDB Agent Memory Proxy【免费下载链接】TencentDB-Agent-MemoryTencentDB Agent Memory is a team-level memory hub for AI Agents — turning conversations, docs, and code into four reusable memory assets (Chat Memory, Skill, LLM-Wiki, Code-Graph) that are governed, shared, and equipped across agents and frameworks.项目地址: https://gitcode.com/GitHub_Trending/te/TencentDB-Agent-MemoryTencentDB Agent Memory 中的 MemoryProxy 是一个透明的 LLM 请求代理把对话请求先转发到它再由它注入团队记忆、Skill 与知识最后转给上游 LLM。Hermes 是开源的 AI Agent 框架无法响应 Proxy 的交互式会话选择表单因此接入时必须通过x-team-id、x-agent-id、x-task-id这几个请求头告诉 Proxy 本次会话绑定哪个团队、哪个 Agent、哪个 Task。本文的目标是完成这一接入让 Hermes 的对话请求走 Proxy并真正生效记忆注入与对话回流。前置条件接入前需要满足以下条件均见 INSTALL.mdProxy 已随 Memory Core Memory Hub Proxy 三合一栈启动默认监听8096端口。使用deploy/global-images下的脚本一次性启动# 1) 获取脚本 git clone https://github.com/TencentCloud/TencentDB-Agent-Memory.git cd TencentDB-Agent-Memory/deploy/global-images # 2) 准备 .env填写真实 LLM 值 cp .env.example .env # MEMORY_LLM_BASE_URL / MEMORY_LLM_API_KEY / MEMORY_LLM_MODEL ← memory hub 内部使用 # PROXY_UPSTREAM_URL / PROXY_UPSTREAM_API_KEY / PROXY_UPSTREAM_MODEL ← Proxy 转发的上游 # 3) 可选dry-run 校验加 --skip-llm 跳过在线 LLM 探测 ./verify.sh # 4) 一键启动 ./start-all.sh在管理面板默认http://localhost:8125首次访问用start-all.sh输出的 adminuser_key中已创建好Team、Agent、Task三类业务资产。注意x-task-id在当前版本是必填项所以 Task 必须提前创建好并记下task_id这一步是 Hermes 接入区别于 Claude Code / CodeBuddy 的关键差异。已从面板 API Key 页拿到用户的user_keysk-mem-...。配置 Hermes 的 extra headers编辑 Hermes 的~/.hermes/config.yaml把base_url指向 Proxy 的/hermes/spaceId路径并在extra_headers中带上三个身份请求头model: default: gpt-5.5 provider: custom base_url: http://proxy-host:port/hermes/spaceId api_key: API Key from admin panel extra_headers: x-team-id: team_id from admin panel x-agent-id: agent_id from admin panel x-task-id: task_id from admin panel x-conversation-id: user-defined session identifier各字段的含义与来源均来自 INSTALL.md 的 Using Proxy with Hermes 一节base_urlProxy 地址 /hermes/spaceId路径。spaceId是记忆实例 ID管理面板中查看本地部署通常为default。proxy-host/port按实际 Proxy 地址替换本地部署即127.0.0.1:8096。api_key用户的user_key取自管理面板 API Key 页。Proxy 用它在 MemoryCore 侧校验身份并解析user_id。x-team-id/x-agent-id从管理面板获取与 CodeBuddy / Claude Code 使用同一套资产。x-task-id从管理面板 Task Management 页获取当前版本必填。x-conversation-id用户自定义的会话标识用于在 Hermes 侧维持会话边界限制见下文。请求头是如何被 Proxy 使用的MemoryProxy 支持 header 自动预选当请求携带x-team-id等头时Proxy 会把这些值与该用户实际可见的 team / agent / task 列表逐一校验全部匹配则跳过交互式选择表单直接完成会话注册机制见 MemoryProxy README 与源码 preset.ts。只有用户自己租户范围内存在的值才会被信任对不上的值视为不匹配不会盲信。这正是 Hermes 接入的关键路径Claude Code / CodeBuddy 的首轮请求靠交互式表单选 Team → Agent → Task而 Hermes / OpenClaw 无法响应表单所以三头必须齐全。缺x-task-id时Proxy 会回退到交互式表单流程Hermes 无法响应结果是session bypass——记忆注入和对话回流都不生效。会话注册成功后Proxy 的完整流水线为auth校验 user_key→sessionInit本次由请求头直接完成→injection把 L2/L3 记忆、Skill、知识注入 system prompt→ 转发上游 LLM → 每轮结束后异步回流对话与 L0 记忆。验证接入是否生效Proxy 存活启动后检查健康检查接口来自 MemoryProxy README 的 Quick startcurl http://127.0.0.1:8096/health返回示例文档示例字段值随部署不同{ status: ok, version: 0.2.0, upstream: https://tokenhub.example.com/v1, storage: { enabled: false, requested: sqlite, effective: sqlite, degraded: false } }发起对话在 Hermes 中选择刚配置的自定义 model 正常聊天。接入成功时不会出现交互式选择提示Proxy 直接按请求头注册会话对话内容会被写入团队记忆。面板确认在面板http://localhost:8125左侧Memory→ Chat Memory 查看 L0 对话是否按场景切片入库Agent 详情页 Profile 会随对话累积 L2 场景与 L3 画像。也可查看 Memory-core 的 pipeline 是否在干活curl -s http://localhost:8420/health | jq .services.pipelineWorker预期tasksConsumed/tasksCompleted随对话增长。当前版本的两个已知限制x-task-id必填用户在面板预先创建 Task 并获取task_id会增加接入成本切换 Task 需要手动修改config.yaml。官方说明下一版本会将其变为可选未提供时自动选择 agent 默认 task 或跳过 task 绑定。x-conversation-id需静态指定与 Claude Code / CodeBuddy 由 SDK 自动管理会话 ID 不同Hermes 的会话 ID 写死在配置文件里带来三点约束——共享同一 conversation ID 的请求都属于同一会话开启新对话必须手动更换该 ID否则沿用旧会话状态部分客户端在 tool-call 后续请求中可能不再携带 extra headers导致这些轮次跳过记忆注入与对话回流。下一版本 Proxy 计划支持自动生成与管理 conversation ID。小结Hermes 接入 MemoryProxy 的主路径是启动三合一栈 → 面板创建 Team / Agent / Task 并获取user_key→ 在~/.hermes/config.yaml配置base_url/hermes/spaceId与x-team-id/x-agent-id/x-task-id/x-conversation-id四个请求头 → 用/health与面板 Memory 页验证。唯一必须牢记的是当前版本x-task-id缺失即 session bypass接入前先把 Task 建好新会话记得更换x-conversation-id否则记忆仍绑在旧会话上。【免费下载链接】TencentDB-Agent-MemoryTencentDB Agent Memory is a team-level memory hub for AI Agents — turning conversations, docs, and code into four reusable memory assets (Chat Memory, Skill, LLM-Wiki, Code-Graph) that are governed, shared, and equipped across agents and frameworks.项目地址: https://gitcode.com/GitHub_Trending/te/TencentDB-Agent-Memory创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考