xiaoping 学习笔记

UHP
技术积累

UHP:给 Agent 运行时定一个统一接口

h2导语/h2 p过去一年,Agent 领域的协议讨论集中在三个名字上:MCP 连接工具,A2A 连接智能体,AG-UI 连接界面。三者各管一段,却共同留下一个空白——strong产品如何驱动一个完整的 Agent 运行时/strong。UHP(Unified Harness Protocol)补的正是这一层:它的交换单位不是一次模型补全,而是一个 task。/p p本文依据 HarnessRouter 开源仓库的协议原文(版本 2026-10-19)撰写,回答四个问题:它补的是哪一层、它真正解决什么、成本数字应当如何引用、什么情况下不该用它。/p h2一、协议谱系:边界各不相同/h2 table thead tr th协议/th th连接的两端/th th交换单位/th th职责边界/th /tr /thead tbody tr tdMCP/td td智能体 ↔ 工具与数据/td td一次工具调用/td td描述智能体能够访问或调用什么/td /tr tr tdA2A/td td智能体 ↔ 智能体/td td一次委派/td td描述智能体之间的协作/td /tr tr tdACP/td td编辑器 ↔ 编码智能体/td td一次编码会话/td td描述编辑器与编码会话的交互/td /tr tr tdAG-UI/td td智能体 ↔ 前端/td td一串事件/td td描述面向用户的交互边界/td /tr tr tdstrongUHP/strong/td tdstrong产品 ↔ 完整运行时/strong/td tdstrong一个 task/strong/td tdstrong描述任务提交、进度、产物回收与会话延续/strong/td /tr /tbody /table p一个容易混淆的细节需要先澄清:市面上存在两个同名协议。本文讨论的是 strongUnified/strong Harness Protocol(HarnessRouter,Apache-2.0);另有一家的 strongUniversal/strong Harness Protocol 是本地进程间通信协议,不是 HTTP 契约。引用时必须写明全称。/p h2二、一个 task 的生命周期/h2 table thead tr th阶段/th th客户端动作/th th服务端行为/th /tr /thead tbody tr td发现能力/td td读取发现文档/td td声明协议版本与一致性等级(Core / Extended / Full)/td /tr tr td选择运行时/td td取得以 chrn_ 开头的运行时标识/td td返回基础运行时与其配置(模型、系统提示、工具限制、技能、MCP、预算)/td /tr tr td提交任务/td td发送任务请求/td td起一次执行,返回以 resp_ 开头的响应标识/td /tr tr td跟随进度/td td接收服务端推送事件/td td按事件词表流式输出,最后一个事件携带完整结果/td /tr tr td回收产物/td td从容器中取文件/td td文件落在会话的文件命名空间中/td /tr tr td延续会话/td td携带上一次响应标识再次请求/td td在同一会话内保持上下文/td /tr tr td取消或失败/td td发送取消请求/td td按失败分类返回,并支持幂等重试/td /tr /tbody /table p一个值得注意的工程决策:任务接口刻意做成与 OpenAI Responses API 同形。这是兼容取舍,使既有 SDK、流解析器与界面组件无需改动即可接入。UHP 新增的是模型接口没有概念的部分——由哪个运行时执行、执行时可用哪些工具、跨任务存活的会话、以及产出的文件。/p h2三、它真正解决什么/h2 table thead tr th维度/th th没有统一协议/th th有统一协议/th /tr /thead tbody tr td集成工作量/td td每个产品 × 每个运行时各写一套适配层,即 N×M/td td只对接协议,降至 N+M/td /tr tr td更换运行时/td td修改产品代码、重新联调与回归/td td改一个运行时标识/td /tr tr td新增运行时/td td所有下游产品各改一次/td td服务端增加一个基础运行时,客户端零改动/td /tr tr td语义一致性/td td取消、取产物、判失败各自实现一遍/td td一次定义,多处复用/td /tr /tbody /table p真正的收益在架构层面:strong模型可以更换而运行时不变,运行时可以更换而模型不变/strong。缺少这层解耦,任何"哪个运行时更好"的对比都不成立,因为无法区分是模型差异还是运行时差异。/p h2四、七类对象与一种寻址方式/h2 p协议定义了七类对象,每类对象都带有区分类型的标识前缀,使标识本身不含歧义。/p table thead tr th对象/th th标识前缀/th th生命周期/th /tr /thead tbody tr td运行时/td tdchrn_/td td直到删除/td /tr tr td响应/td tdresp_/td td按服务端保留策略/td /tr tr td会话/td tdhsess/td td直到删除/td /tr tr td容器/td tdcntr_/td td随会话/td /tr tr td文件/td tdfile_/td td随容器/td /tr tr td环境/td tdhenv_/td td直到删除,只读挂载/td /tr tr td记忆/td tdhmem_/td td直到删除,跨会话存活/td /tr /tbody /table p响应是原子工作单位,会话是响应的链与工作目录,容器是会话的文件命名空间,环境是只读的项目依赖快照,记忆按节点授权并向下继承。/p h2五、成本数字:三个口径不能混用/h2 p关于这套协议,流传最广的说法是"同一任务下最贵与最便宜的配置相差 99.8%"。这个数字需要拆开看。/p table thead tr th数字/th th真实含义/th th能否归因于协议/th /tr /thead tbody tr td约 475 倍(99.8% 跨度)/td td运行时与模型strong组合/strong之间的总成本跨度/td td不能,跨度主要来自模型档位差异/td /tr tr td25%–64%/td tdstrong模型固定、仅更换运行时/strong时的成本降幅/td td可以,这才是运行时层面的贡献/td /tr tr td3.2 倍/td td跨配置的延迟跨度/td td只能说明配置影响显著/td /tr…

2026年11月11日 3点热度 0人点赞 阅读全文
最新文档分类
  • AI-study
  • Aigc-agent
  • B端产品
  • 产品工具篇
  • 产品生命周期
  • 好好学习
  • 技术积累
  • 日常攻略
  • 行业信息
  • 随笔记录
最新 热点 随机
最新 热点 随机
UHP:给 Agent 运行时定一个统一接口 达尔文三要素:变异、遗传与选择——对团队、招人与业务的启发 做产品的三重境界:从定制交付到平台编排 Jev:当 AI 不再生成文本,而是做决策 从场景穷举到能力抽象:Agent 平台产品的设计方法 如何准确的找到工具:万级 Skill 路由生产级方案
图片处理工具大全:9款不错的图片压缩与转换工具 ‌Harness 工程:火山引擎 ArkClaw 架构与运行机制研究 Hermes 的多 Agents 是一套边界清晰的三层架构记录 大模型从理论到落地:Agent Skills 概念介绍 类 Manus 智能体的商业前景分析报告 反内耗记录
关于邮件发送与通知体系建设思考 智能体Agent 等级的深度思考与案例 LLM 模型多维度路由调度 产品设计-不应该用户提出的解决方案当做需求 产品经理一定要懂的产品思维模型 前言篇:为什么学习ComfyUI?
标签聚合
技术架构 大模型智能体 AI框架 大模型应用 AI技术对比 智能决策 智能体分级 智能体交互

COPYRIGHT © 2026 75live.com. ALL RIGHTS RESERVED.

Theme Kratos Made By Seaton Jiang