HermesAgent跨服务数据共享需按场景选择五种方案：一、ACP协议透传会话级元数据；二、MCP服务器桥接实现多智能体协同；三、Orleans Grain共享内存映射；四、CLI环境变量全局注入；五、前端executorTypeAdapter动态契约注入。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
如果您在使用 HermesAgent 过程中需要实现跨服务、跨平台的数据共享，但发现模型上下文隔离、会话状态无法同步或工具调用结果不可复用，则可能是由于 Protocol 层未正确集成或契约未对齐。以下是解决此问题的步骤：
一、ACP 协议会话级数据透传配置
ACP（Agent Communication Protocol）是 HermesAgent 的核心通信协议，支持在 session/new 与 session/prompt 调用中携带自定义元数据字段，从而实现会话粒度的数据共享。该方式适用于前后端需共享用户身份、项目上下文、临时凭证等轻量结构化信息的场景。
1、在客户端发起 session/new 请求时，在 JSON payload 中添加 context 字段，其值为 Base64 编码的 Map 结构（如 {"project_id":"prj-789","user_role":"admin"}）。
2、HermesCliProvider 接收请求后，将 context 解码并注入 StdioAcpTransport 的子进程启动环境变量中，键名为 HERMES_SESSION_CONTEXT。
3、在 ACP 子进程中，通过读取环境变量解析 context，并在后续所有 tool call 的 input 参数中自动注入该上下文对象。
二、MCP 服务器桥接式共享
MCP（Model Control Protocol）作为外部扩展协议，允许 HermesAgent 将数据写入统一 MCP 服务端，供其他 Agent 或系统订阅消费。该方式适用于多智能体协同、跨模型任务编排等强一致性要求场景。
1、部署独立 MCP 服务（如 mcp-server-go），确保其监听地址可被 HermesAgent 所在节点访问，且启用 /notify 和 /subscribe 端点。
2、在 HermesAgent 配置文件 ~/.hermes/config.yaml 中启用 mcp 模块，设置 mcp.server_url: "http://mcp-svc:3000" 与 mcp.enabled: true。
3、在 tool 实现中调用 HermesGrain 提供的 McpClient.Publish() 方法，以命名空间（如 "hagi-code/file-cache"）为 key 发布序列化数据。
三、Orleans Grain 共享内存映射
当 HermesAgent 部署于 Orleans 分布式集群时，可通过 CliAcpSessionPool 托管的 Grain 实例共享只读内存视图。该方式适用于高频低延迟读取共享配置、白名单、缓存索引等静态或半静态数据。
1、定义 ISharedDataGrain 接口，继承 IGrainWithIntegerKey，暴露 GetSnapshotAsync() 与 RefreshAsync() 方法。
2、在 HermesGrain 初始化阶段，通过 Orleans 客户端获取 GrainFactory.GetGrain<ISharedDataGrain>(1) 实例，并将其注入会话执行上下文。
3、所有 ACP 子进程在执行 prompt 时，可通过 RPC 调用该 Grain 的 GetSnapshotAsync() 获取最新共享数据快照，无需本地持久化或网络轮询。
四、CLI 环境变量全局注入
对于本地开发或单机部署场景，可通过操作系统级环境变量向所有 Hermes 子进程注入共享参数。该方式适用于密钥、调试开关、基础 API 地址等全局配置项。
1、在启动 HermesAgent 前，执行 export HERMES_SHARED_TOKEN="tkn-abc123" 与 export HERMES_TOOL_BASE_URL="https://api.example.com/v1"。
2、确保 hermes CLI 启动脚本未显式清除环境变量（即不使用 env -i 或类似 clean 启动模式）。
3、在任意 tool 实现中，直接通过 os.Getenv("HERMES_SHARED_TOKEN") 读取对应值，无需额外配置或初始化逻辑。
五、前端 executorTypeAdapter 动态契约注入
在 HagiCode 等前端平台中，可通过 executorTypeAdapter 映射逻辑，在请求发出前动态注入共享字段。该方式适用于需按用户、工作区、会话类型差异化共享数据的场景。
1、在前端代码中定位 executorTypeAdapter.ts 文件，找到 Hermes 类型的适配器分支。
2、在 buildRequest() 方法内，从当前 React Context 或 Redux Store 中提取 workspaceContext 对象，并将其序列化后附加至 request.body 的 shared_payload 字段。
3、后端 HermesCliProvider 在反序列化请求时，自动将 shared_payload 解析为 Map 并合并进本次会话的 execution context。
