协议概览:让多个客户端共享会话
协议概览:让多个客户端共享会话
Agent Host Protocol(AHP)把 Agent 会话放到独立的 host 上,让不同客户端连接同一个会话并同步状态。桌面编辑器、终端与其他界面可以呈现同一段工作,而不必各自维护一套互相冲突的记录。
本文依据官方规范 v1.1.0。SDK 各自使用独立版本号,安装某个 SDK 的 v1.1.0 不代表它与规范版本一一对应。
先确定三个角色
| 角色 | 负责什么 | 实施时要回答的问题 |
|---|---|---|
| Host | 托管会话,裁决动作,维护权威状态 | 会话在哪里持久化、何时恢复? |
| Client | 呈现状态、派发用户动作、接收广播 | 断线后如何对账? |
| Agent | 在 host 管理的会话中推进工作 | 哪些能力允许暴露给客户端? |
客户端不是直接把自己的整份状态覆盖到 host。它提交动作,host 决定接受、拒绝或协调,并把结果同步给参与者。状态变化的逻辑集中在 reducer 中,便于重放和比较。
一个适用场景
用户在桌面端启动任务,随后用另一个客户端查看进展。第二个客户端需要得到会话状态,再持续接收变化。两个客户端同时操作时,最终结果应以 host 裁决为准,而不是由最后刷新页面的人决定。
这也是选型边界:如果需求只是让模型调用一个后台工具,可先评估工具协议;如果需要把同一个 Agent 会话呈现在多个前端,AHP 才直接涉及这个问题。不同协议可以处在同一系统的不同层。
阅读路径
最后更新于