Newshot

为跨设备延续的会话构建 Agent Host Protocol

AI summary

模型如今已能自主连续工作数小时甚至数天,你无需时刻盯着它,但仍需要能随时随地查看进展;而智能体不能只活在一个应用里,即使关闭窗口或切换设备,工作也应继续。在 GitHub Copilot 中,你可以在一个地方开启智能体会话,再到另一个地方接着使用。这种会话连续性依托 Agent Host Protocol(AHP)——一个先在 VS Code 中构建、随后被 GitHub 全线采用的开放标准;本文介绍它的工作原理、构建过程中的经验,以及如何用它把智能体引入你自己的应用和工作流。

Translation(model translation, not the source's own text)

为跨设备延续的会话构建 Agent Host Protocol

模型现在已足够强大,可以连续数小时甚至数天自主工作。你不必盯着它们做的每件事,但仍需要无论身在何处都能随时查看进度。智能体不能只存在于一个应用里。即使你关闭窗口或切换设备,工作也应该继续。

在 GitHub Copilot 中,你可以在一个地方启动智能体会话,再到另一个地方接着处理。这种会话连续性运行在 Agent Host Protocol(AHP)之上——这是一个开放标准,最初在 VS Code 中构建,随后在 GitHub 全线采用。下面介绍它如何工作、我们在构建过程中学到了什么,以及你如何用它把智能体引入自己的应用和工作流。

为什么每个客户端各做一套集成不再可行

GitHub Copilot 最初是在 VS Code 中作为扩展构建的,并自带自己的 harness。这让你可以在 VS Code 中访问智能体,但也把它们的生命周期绑定到了编辑器上。扩展依附于单个 VS Code 窗口。关闭那个窗口,智能体就没了。更新 VS Code,应用重启时所有智能体都会停止。连接到远程机器时,你会得到一个全新的扩展宿主,它被锁定到你所使用的 VS Code 工作台版本对应的提交上。

与此同时,GitHub Copilot 应用也在开发中,并与面向 iOS 和 Android 的现有 GitHub 移动应用并行推进。每个产品都在与基于云的智能体做各自不同的集成,以努力实现会话连续性。

这些集成各自解决了一个产品的问题,但开发者仍然希望把智能体引入自己的工作流——无论是编辑器、终端、手机,还是自己构建的工具——而如果每个客户端都需要自己的一次性集成,他们就做不到这一点。这就是开发者需要协议的原因:一种标准、独立版本化的语言,贯穿 VS Code、GitHub Copilot 应用、移动应用以及任何其他可能承载智能体的客户端的不同版本。共享协议意味着每个客户端都能看到相同的智能体、历史和状态,而无需定制集成,你也不会被某个应用对“什么是智能体会话”的定义所束缚。

为每个客户端上的智能体设计协议

该协议需要允许多个客户端无缝地与同一组智能体交互。例如,从手机在云中启动一个会话,然后从笔记本电脑继续。它应当能容忍网络中断、重连以及客户端并发修改。并且它需要功能足够完整,让你能在每个客户端上完成真实工作。

同时,协议需要不介入智能体的行为。与催生 Language Server Protocol 和 Debug Adapter Protocol 的领域不同,智能体领域正在快速演进。这就是 AHP 避免把智能体的工作方式编码进协议,而聚焦于你希望如何与它们交互的原因。

你还需要协议足够简单,以便在自己的客户端或服务器上实现。虽然完整功能集必然会很广泛,但核心协议必须保持最小化。

这些需求的结果就是 Agent Host Protocol(AHP)。它围绕以 URI 标识的“通道”展开,通道是协议中最粗粒度的功能单元。每个服务器都必须实现根通道、会话通道和聊天通道,但也可以实现更多通道,例如提供终端支持、MCP 扩展或 OTel 上报。

每个通道内都有一个基于 reducer 的状态对象,它驱动客户端的大部分逻辑。服务器是状态的仲裁者,每个客户端发送一系列 action,这些 action 要么改变状态,要么触发副作用,比如发送聊天消息。这带来了一些非常好的特性。在网络状况不佳时,重连和重放很容易:客户端发送所有排队的 action,呈现正确的“loading”状态,并等待服务器协调并确认这些 action,然后再确认它们。客户端和服务器的调试很直接。基于 reducer 的状态也能与 React 等流行 UI 框架很好地配合。

三个客户端(VS Code、Copilot 应用和手机)向一个 agent host 发送 dispatchAction 消息,并收到返回的 action 消息。在 host 内部,必需的 root、session 和 chat 通道各自持有基于 reducer 的状态;chat 通道的有序 action 日志馈入一个 reducer,由它产生下一个状态。可选的 terminal、MCP 和 telemetry 通道并列存在。
三个客户端(VS Code、Copilot 应用和手机)向一个 agent host 发送 dispatchAction 消息,并收到返回的 action 消息。在 host 内部,必需的 root、session 和 chat 通道各自持有基于 reducer 的状态;chat 通道的有序 action 日志馈入一个 reducer,由它产生下一个状态。可选的 terminal、MCP 和 telemetry 通道并列存在。

交付五个客户端和两个 host

在 VS Code 中采用 Agent Host Protocol 需要在其下构建新的 harness 和 agentic 栈。Copilot Chat 扩展过去提供 VS Code 的全部 AI 和 agentic 能力,已经发展了三年多,达到超过 400,000 行 TypeScript(不计测试)。但作为 VS Code 扩展,它围绕 VS Code 窗口的生命周期构建,并且完全依赖 VS Code 扩展 API。那个生命周期和那些 API 在独立的 agent host 进程中都不会可用。

当我们在 2026 年初开始构建 Agent Host Protocol 时,Copilot SDK 也在开发中,将其作为新 agentic 栈的基础是合理的。这是一次重大转变。构建一个能打招呼并能编辑文件的 harness 实现很容易——头几周之后我们就在用 agent host 开发 agent host——但要构建一个覆盖开发者已习惯从 Copilot Chat 获得的全部长尾功能的实现则是另一回事。

![自 2023 年以来非测试代码行数的折线图。Copilot Chat 稳步增长到约 415,000 行 TypeScript,并在 2025 年中期从 microsoft/vscode-copilot 迁移到 microsoft/vscode-copilot-chat,又在 2026 年 4 月进入 microsoft/vscode。从 2026 年春季开始,VS Code agent host 增长到约 369,000 行 TypeScript,GitHub agent host 增长到约 305,000 行 Rust。](https://github.blog/wp-content/uploads/202

事实证明,相当不错。与 MCP 一样,Agent Host Protocol 通过自定义方法和对象上的 _metadata 提供出口,使用方可以借助它们进行带外信令。在各自埋头推进实现几个月后,我们迈向统一时的第一项任务,是盘点每个实现扩展协议的方式。其中许多扩展合理地保留为 GitHub 特有,例如 GitHub Agent Host 使用 metadata 链接到项目看板。另一些差异则表明协议存在缺口;例如早期版本无法准确表示并非由 PTY 支撑的 shell 类工具输出。还有一些则是错误假设,比如 VS Code 的客户端假定它从 agent host 收到的 session URI 具有某种特定结构。只有一种实现的协议并不是真正可移植的;当我们让客户端和服务器学会彼此通信时,AHP 在实践中而不仅是理论上变得可移植。

一个会话“修复不稳定的登录测试”在 agent host 上持续运行。它于上午 9:02 从 Copilot 应用启动,上午 9:40 从手机批准了一次工具调用,上午 11:15 在 VS Code 中审查了 diff,上午 11:32 一个云端 agent 合并了 pull request。
一个会话“修复不稳定的登录测试”在 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 云端体验随时随地工作。

使用 Agent Host Protocol

AHP 的设计目标是在客户端和服务器中易于使用。Agent Host Protocol 库提供 Rust、TypeScript、Kotlin、Swift、.NET 和 Go 版本,agent 只需很少提示就能构建客户端和服务器。我桌上有一个宏键盘,可以实时反映我的 agent 状态;其他人则基于该协议构建了从智能手表应用到看板式任务管理工具的各种东西。无论你是想为自己的 agent 构建配套应用、找到把 agent 会话引入团队工具的方法,还是想在你自己的编辑器或 agent 中支持 AHP,该协议都开放供你构建。

你可以连接到你在 Copilot 应用中实现的 agent host(启用 Experimental > Direct Connections,然后转到 Environments > Add Agent Host Protocol Host),以及在 VS Code 中实现的 agent host(通过 Agents 窗口中的 Add Remote Agent Host)。你可以在终端中运行 code agent host 来启动 VS Code agent host 的独立版本,或运行 code agent endpoints 查看编辑器中那个 agent host 的端点;示例可以帮助你和你的 agent 入门。

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

编码愉快!

在 GitHub 上探索 Agent Host Protocol >

标签:

  • GitHub Copilot

作者

首席软件工程师

The translation is machine-generated and individual terms may be off. Nothing is rewritten or cut; the original is authoritative.

Published by GitHub Blog
This site only summarises and aggregates; copyright stays with the original author. Headlines and summaries follow the source — where they differ, the original wins.
Read the original ↗