【背景与目标】各位vivo互联网项目团队围绕三大业务场景笔记、知识库、项目管理统一了一套可组合的AI Agent能力。本文聚焦一期「Chat模式」落地强调Runtime Adapter的“协议无关、面向任意后端流”特性。业务诉求方面笔记、知识库、项目管理三类场景都需要“对话式”AI能力并逐步演进到多轮、工具调用、上下文增强与可追溯。统一入口上不希望每条业务线重复造轮子期待用同一套可组合Hook即插即用。一期范围是先完成Chat模式打底但保留可扩展的“多消息一回合”“工具调用”“历史/检查点”能力。在产品体验上遵循主流Agent设计范式结合过往实现风格将复杂性交由“消息模型 运行时适配 前端编排”三段式来解耦。【设计原则】设计原则有四点。一是“消息即协议”把后端回传的事件统一解码为前端消息模型UI只消费消息不关心来源细节。二是“运行时可插拔”只要后端能以“流”的形式输出Adapter都会转为相同的AgentStreamEvent前端逻辑零差异。三是“前端可编排”用Hook/Context管理上下文、工具、重试/变体、回调形成稳定的胶水层。四是“渐进增强”一期只做Chat但保留threadId/runId为“历史/检查点/回放/评测”留出Agent能力口。【架构总览】只列出Chat模式强相关的核心模块。①统一消息模型覆盖UserMessage、AssistantMessage、Thinking - Message、ActionExecution - Message、ResultMessage等类型含status与可选parentMessageId可扩展图片、状态消息。②Runtime Adapter接口generateResponse(params) / retry(params)返回ReadableStreamsendFeedback统一正/负反馈可对接多种后端“流”无论来源如何都会标准化为AgentStreamEvent。③前端编排OrchestrationAgentKit作为Provider暴露上下文统一注入runtime、actions、上下文树、消息与加载状态、重载完成回调等useAgentChat组合useChat提供append - Message、reloadMessages、stop - Generation、threadId、runId等能力useChat串接Runtime流式事件处理工具调用与Agent循环并维护AbortController。④Vue UI组件Chat容器封装输入/消息区/操作/建议项借助useCopilotChatLogic与Core同步。【事件流与消息模型把一切都还原成消息】后端返回的是“事件”前端消费的是“消息”把差异收敛在Adapter层。一是“增量累加”把分片token聚合为Thinking - Message / AssistantMessage。二是“工具事件”tool_call → ActionExecution - Messagetool_result → ResultMessage。三是“统一标识”维护threadId会话与runId本轮loop为历史/检查点铺路。四是“精确收束”依据服务端“回合结束”信号或本地规则准确结束本轮流。上层只看到标准的AgentStreamEventUI组件无须关心消息从哪里来只负责渲染消息序列。【Agent回合循环loop与工具调用tools】Chat模式不仅是“生成一条回复”而是“一轮内可能包含多条消息”。把“回合循环”放在useChat中集中处理串接流式事件按顺序追加消息捕获ActionExecutionMessage触发前端工具handler并把结果回注为ResultMessage当一轮结束返回最终AssistantMessage并可进入下一轮在“重载/变体”场景中保留既有候选并追加新候选形成多变体集合。与传输方式无关只要后端发出等价事件Adapter统一映射工具消息即可完整往返。工具调用的前端形态是useAgentAction它可描述name/description/parameters处理时handler(args)返回值会被打包成ResultMessage回注对话可选渲染可将工具调用或结果以内嵌卡片形式展示同一执行ID只会触发一次handlerAdapter负责把后端的工具事件统一映射为前端消息UI不需要关注具体协议与传输方式。【UI交互与建议Suggestions】Chat作为容器暴露了消息渲染插槽与输入区控制默认行为是渲染Thinking、Assistant、User、Error等消息类型支持复制、停止、重新生成、建议点击useCopilotChatLogic负责把Core能力useAgentChat与UI事件连起来并提供节流后的建议刷新入口。【最小上手3步把Chat接入到任一页面】第一步在根组件用AgentKit包裹并选择Runtime。第二步页面里直接用Chat或自定义渲染。第三步可选注册工具供模型调用。【与业务的契合】笔记/知识库/项目管理方面前端可把当前选中文段/标签/页面结构通过addContext合并入agentArgs无需更改Runtime。知识库agent文档/集成流程智能Agent未来规划方面把检索与聚合能力抽象为FrontendAction回注ResultMessage让Agent循环自动推进。【面向知识库问答与集成流程智能的演进设想】一是知识库问答AgentRAG支持互联网检索结合站内知识完成回答提供关键字检索、内容获取与语义检索向量后续将支持直接帮你编辑、新增文档等操作让AI准确看到你正在关注的内容与你的上下文保持一致帮助你更高效地思考、写作与创造。二是集成流程自动配置添加节点配置节点验证节点一句话帮你完成流程配置面向非开发同学解决流程编排困难和语法复杂的问题支持从自然语言自动生成流程与节点参数节点配置表单化参数智能补全与校验自动化验证每一步并给出修复建议支持逐步验证与仿真运行输出日志与每步结果检查。【下一步需完善】一是历史记录当前未做持久化回放已通过threadId预埋会话键后续可依此查询并复原消息序列。二是检查点runId用于标记本轮loop未来可以支持检查点能力在“继续/撤回/回滚”中复用是Agent交互中必不可少的能力。三是工具事件实现HumanInTheLoop能力工具调用需要用户确认或者需要用户填写表单等内容与Agent协同。【结语】用“消息模型 Runtime Adapter 前端编排”的方式把Chat模式做成了可以“拼”的底座UI只面向消息不关心来源运行时可替换协议差异被屏蔽工具/上下文/重试等交互都在编排层实现threadId/runId为历史/检查点打好地基。这让三类业务都能在同一套基建上继续演进。接下来会补齐历史与工具事件、完善多变体交互并把“回合对齐/评测”纳入流水线。