跳到正文
RadarAI· GitHub Blog·· 4 小时前AI 评分71

GitHub 工程师详解 Agent Host Protocol 如何让 agent 会话跨设备延续

AI 导读

GitHub 工程师 Connor Peet 介绍 Agent Host Protocol(AHP),这是 GitHub Copilot 跨设备会话连续性背后的开放标准,最初在 VS Code 中构建,现已用于 VS Code 与 GitHub 各端。

正文 · AI 翻译

GitHub Blog· Connor Peet·2026-11-18 02:20· 1 小时前AI 评分68

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

AI 导读

GitHub 工程师介绍 GitHub Copilot 跨设备会话连续性背后的 Agent Host Protocol(AHP),一个从 VS Code 起步、已在 GitHub 各端采用的开放标准。

正文 · 原文

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

在 GitHub Copilot 中,你可以在一个地方启动 agent 会话,然后在另一个地方继续。这种会话连续性依托于 Agent Host Protocol(AHP),这是一个最先在 VS Code 中构建、并已在 GitHub 各端采用的开放标准。下面介绍它的工作原理、我们在构建过程中的经验,以及你如何利用它把 agent 引入自己的应用和工作流。

为什么“每个客户端各做一套集成”行不通了

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

与此同时,Copilot 应用正在开发中,与现有的 iOS 和 Android 版 GitHub 移动应用并行推进。每个产品都在与云端 agent 做各自不同的集成,以努力实现会话连续性。

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

为每个客户端上的 agent 设计协议

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

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

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

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

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

Three clients (VS Code, the Copilot app, and a phone) send dispatchAction messages to an agent host and receive action messages back. Inside the host, required root, session, and chat channels each hold reducer-based state; the chat channel's ordered action log feeds a reducer that produces the next state. Optional terminal, MCP, and telemetry channels sit alongside.

交付五个客户端和两个主机

在 VS Code 中采用 Agent Host Protocol 需要在其下构建新的 harness 和 agentic 技术栈。Copilot Chat 扩展过去提供了 VS Code 所有的 AI 和 agentic 能力,它已经发展了三年多,达到超过 40 万行 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 中期望的长尾功能的实现则是另一回事。

Line chart of non-test lines of code since 2023. Copilot Chat grows steadily to about 415,000 lines of TypeScript as it moves from microsoft/vscode-copilot to microsoft/vscode-copilot-chat in mid-2025 and into microsoft/vscode in April 2026. Starting in spring 2026, the VS Code agent host grows to about 369,000 lines of TypeScript and the GitHub agent host to about 305,000 lines of Rust.

GitHub 已经拥有 Copilot 云代理 好几年了,允许开发者从任何设备在云端运行任务。当 VS Code 在悄悄开发 Agent Host Protocol 时,GitHub 正寻求将这一能力扩展,以协调通过 Copilot 应用在你自己的设备上或云沙箱中运行的会话。这正是 AHP 旨在解决的 N:M 问题,因此采用同样的技术完全合理。

从一开始,GitHub Agent Host 的需求就与 VS Code 的实现不同。VS Code 在本地运行主机,并可以通过 SSH、容器、WSL 或 Dev Tunnels 将其主机部署到其他计算资源上,而且它实际上作为 VS Code Server 捆绑包的一部分被包含在内。GitHub Agent Host 需要在云端运行,并跨越更多样化的基础设施、环境和安全约束。

这些不同的需求正是它们成为用不同语言编写的独立实现的原因:VS Code 的用 TypeScript,GitHub 的用 Rust。目前,拥有两个 agent host 对协议本身来说是一个很好的酸性测试。当两个完全不同的团队和代理集合独立实现同一协议时,它的效果如何?

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

A single session, "Fix the flaky login test," runs continuously on an agent host. It is started from the Copilot app at 9:02 AM, a tool call is approved from a phone at 9:40 AM, the diff is reviewed in VS Code at 11:15 AM, and a cloud agent lands the pull request at 11:32 AM.

如今,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 中连接(通过 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 >

文章为跨设备持续进行的会话构建 Agent Host Protocol首发于The GitHub Blog。

来源:GitHub Blog · github.blog

来源:RadarAI · aihot.news