(Interface)

画的就是跑的

Agent 可视化编排与实时调试:所见即所得如何降低多模块多模型的心智负担。

编排画布与运行态示意
Intro

开发者脑里一张图,配置里一张图,运行时又是一张图。

多模块、多模型的 Agent 流程,结构写在配置里,行为发生在黑盒里。开发者被迫同时维护三张图:自己以为的流程、配置声明的流程、运行时真实发生的流程。三张图彼此漂移,出了问题只能靠推断对齐——心智负担不在单个节点的复杂度,在图与图之间的换算。

方案是把三张图压成一张:画布不是流程的插画,它就是流程本身。分支、循环、工具调用、模型切换都以节点长在明面上,编辑画布就是编辑运行时,不存在「画的是一回事、跑的是另一回事」的缝隙。这是「所见即所得」在 Agent 场景下的准确含义——不是编辑器的排版口号,是画布与运行时共用同一份结构。

调试在原位发生

失败藏在中间步骤:检索到了什么、模型看到了什么上下文、工具返回了什么。传统做法是去另一个页面翻日志,把「流程的样子」和「流程的行为」再次拆成两张图。这里的选择是让每个节点在运行时把输入输出摊开在原位——画布的编辑态与运行态是同一张画布的两种状态,而不是两个功能区。看哪个节点出错,就在那个节点上看到它的现场。

从推断到核对

改一个节点,立刻在原位重跑验证,反馈回路短到不值得切换页面。心智负担的降低机制可以说得很具体:过去开发者要「记住」结构、「推断」行为,现在只需要「看见」结构、「核对」行为。记忆和推断是昂贵的认知操作,看见和核对是廉价的——界面的工作就是把前者换成后者。

业务在营,真实界面与数据不外带,图为重绘示意。但结构与判断是真的——「画的就是跑的」这条原则,放进哪个业务都成立。

来源项目