← 文章 / AI技术
GitHub Blog 3小时前 · 2026-11-18 03:13:39 · 3 阅读

打造 Agent Host Protocol:让智能体会话跨设备无缝延续

模型现在已经足够强大,能够独立工作数小时甚至数天。你无需盯着它的每一个动作,但无论身处何地,你都需要随时查看进度。智能体不能只活在单一应用里。即使关闭窗口或切换设备,工作也应继续。

在 GitHub Copilot 中,你可以在一处启动智能体会话,并在另一处继续。这种会话连续性基于 Agent Host Protocol (AHP),这是一套开放标准,最初在 VS Code 中构建,随后被 GitHub 广泛采用。下文将介绍其工作原理、我们在构建过程中的经验教训,以及你如何利用它将智能体引入自己的应用和工作流。

为什么“每个客户端单独集成”的模式行不通了

GitHub Copilot 最初是在 VS Code 中构建的,作为一个自带运行框架的扩展。这让你在 VS Code 中能够访问智能体,但其生命周期被绑定在编辑器上。扩展依附于单个 VS Code 窗口。关闭该窗口,智能体即终止。更新 VS Code,应用重启时所有智能体都会停止。连接远程机器时,你会得到一个与当前 VS Code 工作台版本锁定且完全独立的新扩展宿主。

与此同时,Copilot 应用也在开发中,与现有的 iOS 和 Android 版 GitHub 移动应用并行。各产品都在针对云端智能体进行独立的集成,以实现会话连续性。

这些集成各自解决了单一产品的问题,但开发者也希望能将智能体引入自己的工作流——无论是编辑器、终端、手机还是自制的工具。如果每个客户端都需要定制化的独立集成,这便无法实现。因此,开发者需要一套协议:一种跨 VS Code、GitHub Copilot 应用、移动应用及其他任何可能托管智能体的客户端的标准语言,且独立于版本更新。共享协议意味着所有客户端都能看到相同的智能体、历史记录和状态,无需定制集成,也不会被某款应用对“智能体会话”的定义所束缚。

为覆盖所有客户端的智能体设计协议

协议需要支持多个客户端无缝地操作同一组 agent:比如在手机上于云端发起一个会话,之后在笔记本电脑上接着继续。它还要能应对网络中断、重连以及多客户端并发修改,并且功能足够完整,让你在任何一个客户端上都能真正干活。

与此同时,协议不应干涉 agent 的行为。与催生了 Language Server Protocol 和 Debug Adapter Protocol 的那些领域不同,agent 领域正在快速演进。因此 AHP 刻意不去规定 agent 如何运作,只专注于你希望如何与它们交互。

此外,协议还得足够简单,让你能在自己的客户端或服务端上自行实现。虽然完整功能集必然很庞大,但核心协议必须保持精简。

综合这些需求,就有了 Agent Host Protocol(AHP)。它围绕以 URI 标识的“channel”(通道)来组织,channel 是协议中最粗粒度的功能单元。每个服务端都必须实现 root、session 和 chat 这几个 channel,同时也可以实现更多 channel 来提供终端支持、MCP 扩展或 OTel 上报等能力。

每个 channel 内部都有一个基于 reducer 的状态对象,客户端的大部分逻辑都由它驱动。服务端是状态的仲裁者,每个客户端发送一系列 action,这些 action 要么修改状态,要么触发副作用(比如发送一条聊天消息)。这带来了几个非常好的性质:在恶劣网络环境下,重连和重放很容易实现——客户端把排队的 action 全部发出,展示合适的“加载中”状态,等服务端核对并确认这些 action 后再最终落实。客户端和服务端都易于调试。基于 reducer 的状态还能与 React 等主流 UI 框架很好地配合。

三个客户端(VS Code、Copilot 应用和手机)向 agent host 发送 dispatchAction 消息,并接收 action 消息作为响应。在 host 内部,必需的 root、session 和 chat 通道各自持有基于 reducer 的状态;chat 通道有序的动作日志通过 reducer 生成下一个状态。可选的 terminal、MCP 和 telemetry 通道位于旁边。

交付五个客户端和两个 host

要在 VS Code 中采用 Agent Host Protocol,需要在其底层构建全新的 harness 和 agentic 栈。此前,负责提供 VS Code 所有 AI 和 agentic 能力的 Copilot Chat 扩展已持续开发三年多,代码量超过 40 万行 TypeScript(不含测试)。但作为 VS Code 扩展,其架构围绕 VS Code 窗口生命周期设计,完全依赖 VS Code 扩展 API。而独立 agent host 进程中既不具备这种生命周期,也无法使用这些 API。

2026 年初,随着 Agent Host Protocol 开发启动,Copilot SDK 也在同步开发,顺势将其作为新 agentic 栈的基础是合理的选择。这是一次重大转型。构建一个能打招呼、能编辑文件的 harness 实现很简单——在开发初期几周里,我们就在用 agent host 开发 agent host 本身——但要覆盖开发者对 Copilot Chat 习以为常的长尾功能,则完全是另一回事。

2023 年以来非测试代码行数折线图。Copilot Chat 稳步增长至约 41.5 万行 TypeScript,期间于 2025 年年中从 microsoft/vscode-copilot 迁移到 microsoft/vscode-copilot-chat,并于 2026 年 4 月并入 microsoft/vscode。从 2026 年春季开始,VS Code agent host 增长到约 36.9 万行 TypeScript,GitHub agent host 增长到约 30.5 万行 Rust。

GitHub 推出 Copilot 云端 agent 已经有几年了,开发者可以在任意设备上把任务丢到云端运行。在 VS Code 默默打磨 Agent Host Protocol 的同时,GitHub 也希望把这种能力扩展出去,通过 Copilot 应用协调运行在你自己设备上的会话,或在云端沙箱中运行。这正是 AHP 专为解决的 N:M 问题,所以采用同一套技术再自然不过。

从一开始,GitHub Agent Host 的需求就与 VS Code 的实现不同。VS Code 在本地运行 host,还可以通过 SSH、容器、WSL 或 Dev Tunnels 把 host 丢到其他算力上,它实际上也是 VS Code Server 套件的一部分。而 GitHub Agent Host 需要在云端运行,面对的基础设施、环境和安全约束也要多样得多。

正是这些不同的需求,让两者成为用不同语言编写的独立实现:VS Code 用 TypeScript,GitHub 用 Rust。目前来看,同时维护两个 agent host 恰好是对协议本身的一次 acid test:当两个完全不同的团队、各自的 agent 独立实现同一套协议时,它到底好不好用?

效果确实不错。与 MCP 类似,Agent Host Protocol 也提供了逃生通道:消费端可通过自定义方法和对象上的 _meta 数据进行带外信号传递。在各自实现埋头推进数月后,迈向统一的第一步是盘点各实现方对协议的扩展方式。许多扩展合理地保留了 GitHub 特性,例如 GitHub Agent Host 利用元数据链接到项目看板。但在其他场景中,差异暴露了协议的空缺;早期版本例如无法准确表示未由 PTY 支持的 shell 类型工具输出。还有些是错误假设,比如 VS Code 客户端假定从 agent host 接收的会话 URI 具有特定结构。只有单一实现的协议算不上真正可移植;在让客户端和服务器相互通信的过程中,AHP 在实践中实现了可移植性,而非仅停留在理论层面。

一个名为“修复不稳定的登录测试”的会话,在一个 agent host 上连续运行。该会话于上午 9:02 从 Copilot 应用启动,上午 9:40 在手机上批准了一次工具调用,上午 11:15 在 VS Code 中审查了 diff,上午 11:32 由云端 agent 合并了 pull request。

如今,Agent Host Protocol 在所有 VS Code 和 GitHub 界面上都提供了同样的连续性。在 GitHub Copilot 应用本地、云端沙箱以及 VS Code 中运行的 agent 会话,共享相同的底层协议。要了解其实际用法,请阅读关于如何通过全新的互联 Copilot 云端体验1从任何地点工作的介绍。

使用 Agent Host Protocol

AHP 的设计目标就是让客户端和服务端都能轻松使用。Agent Host Protocol 提供了 Rust、TypeScript、Kotlin、Swift、.NET 和 Go 的库,开发者几乎不需要引导就能构建客户端和服务端。我的桌上放着一个宏键盘,可以实时显示我的 agent 状态;还有人基于这个协议做出了智能手表应用、看板式任务管理工具等各种东西。无论你想为自己的 agent 做个配套应用、把 agent 会话接入团队工具,还是想在自己的编辑器或 agent 中支持 AHP,这个开放协议都欢迎你来构建。

你可以在 Copilot 应用(开启 Experimental > Direct Connections,然后进入 Environments > Add Agent Host Protocol Host)和 VS Code(在 Agents 窗口中选择 Add Remote Agent Host)中连接你自建的 agent host。在终端运行 code agent host 可以启动一个独立版本的 VS Code agent host,运行 code agent endpoints 可以查看编辑器中 agent host 的端点,示例代码可以帮你和你的 agent 快速上手。

Agent Host Protocol 是一个开放标准,欢迎在 GitHub 上提出问题和建议。

祝编程愉快!

原始来源: GitHub Blog

评论 (0)