协议概览:让多个客户端共享会话

协议概览:让多个客户端共享会话

Agent Host Protocol(AHP)把 Agent 会话放到独立的 host 上,让不同客户端连接同一个会话并同步状态。桌面编辑器、终端与其他界面可以呈现同一段工作,而不必各自维护一套互相冲突的记录。

本文依据官方规范 v1.1.0。SDK 各自使用独立版本号,安装某个 SDK 的 v1.1.0 不代表它与规范版本一一对应。

先确定三个角色

角色负责什么实施时要回答的问题
Host托管会话,裁决动作,维护权威状态会话在哪里持久化、何时恢复?
Client呈现状态、派发用户动作、接收广播断线后如何对账?
Agent在 host 管理的会话中推进工作哪些能力允许暴露给客户端?

客户端不是直接把自己的整份状态覆盖到 host。它提交动作,host 决定接受、拒绝或协调,并把结果同步给参与者。状态变化的逻辑集中在 reducer 中,便于重放和比较。

一个适用场景

用户在桌面端启动任务,随后用另一个客户端查看进展。第二个客户端需要得到会话状态,再持续接收变化。两个客户端同时操作时,最终结果应以 host 裁决为准,而不是由最后刷新页面的人决定。

这也是选型边界:如果需求只是让模型调用一个后台工具,可先评估工具协议;如果需要把同一个 Agent 会话呈现在多个前端,AHP 才直接涉及这个问题。不同协议可以处在同一系统的不同层。

阅读路径

先读状态与动作,再设计接入步骤,最后用重连与并发清单检查失败路径。字段与方法以官方规范为准。

最后更新于