用AI Agent做过任务的人都知道一个体验痛点：你给Agent下了一个指令，然后就开始等。

Agent在后台调用哪个工具？执行到哪一步了？推理过程是什么？卡在哪个环节了？用户一无所知。面前只有一个转圈动画，或者一个写着"思考中"的灰色气泡。

等了三十秒，Agent终于回复了。但中间发生了什么？不知道。

这个体验问题不只是一个UX瑕疵。在真实业务场景中，Agent执行的可能是审批流程、数据分析、系统操作——用户需要实时看到进度，需要知道Agent在做什么、做到哪了、有没有出错。如果这些全部黑盒化，用户对Agent的信任就建立不起来。

向量空间JBoltAI在TokUI中专门做了一组AI Agent可视化组件，解决的就是"让用户看到Agent在做什么"。

先体验一下

官网演示中有一个Agent执行任务的完整流程——AI接到用户指令后，先展示"思考过程"（一个可折叠区域，里面是AI的推理步骤），然后展示"工具调用"（一个卡片，显示正在调用的工具名称、参数、状态），最后展示执行结果。

这个流程不是一次性跳出来的，而是流式推进的——思考过程逐行展开，工具调用状态从"调用中"变为"成功"，结果逐步填充。用户看到的不是"等→结果"，而是"思考→调用→更新→完成"的完整链条。

三个核心组件

向量空间JBoltAI在设计TokUI的Agent组件时，参考了大量企业AI平台的真实需求——Agent执行审批、数据分析、设备诊断时，业务人员最关心的就是"AI做到哪了"。TokUI为Agent可视化设计了三个核心组件。

第一个，思考过程组件。AI做复杂任务时，背后有一串推理步骤——先分析问题，再规划路径，再决定调什么工具。TokUI的think组件把这个过程可视化：一个可折叠的区域，默认收起显示"思考中..."，展开后展示每一步推理。还有think-chain和think-step子组件，支持展示分步推理链——每一步有编号、有标题、有详细说明，用户能完整看到AI的思考逻辑。

第二个，工具调用组件。Agent执行任务的核心动作就是调用工具——查数据库、调API、读文件、发通知。TokUI的tool-call组件把每一次工具调用渲染成一个信息卡片：工具名称、输入参数、执行状态（调用中/成功/失败）、返回结果摘要。状态是实时更新的——从"调用中"到"成功"的切换，用户能亲眼看到。

更重要的是，向量空间JBoltAI在TokUI中设计的upd指令支持动态更新已渲染的组件。Agent调完工具后，不需要重新渲染整个对话气泡，只需要发一个[upd id:目标ID status:done]指令，对应的tool-call卡片就原地刷新状态。这是真正的实时状态流转，不是重新加载页面。

第三个，执行计划组件。复杂Agent任务往往有多个步骤——先查数据，再分析，再生成报告。TokUI的plan和plan-step组件把执行计划渲染成一个清单：每一步有标题、有状态标记（待执行/执行中/已完成），执行过程中实时更新。用户一眼就能看出Agent做到哪一步了，还剩几步。

向量空间JBoltAI在企业级Agent平台的实践中发现，这三个组件组合在一起就构成了一套完整的Agent可视化方案：思考过程展示AI在想什么，工具调用展示AI在做什么，执行计划展示AI做到哪了。向量空间JBoltAI在TokUI中设计这套组件的逻辑很简单——Agent不应该是一个黑盒，用户有权知道AI在替自己做什么。

为什么这个能力是刚需

2025年下半年开始，AI Agent产品迎来爆发。从自动化办公到智能运维，从数据分析到客服系统，Agent正在从"技术演示"走向"生产使用"。

但向量空间JBoltAI观察到，Agent产品的体验设计普遍存在一个断层：模型能力在快速进化，但用户看到的交互界面几乎没有进步。绝大多数Agent产品的前端还停留在一个聊天框加一个Markdown渲染器的阶段。

向量空间JBoltAI在企业AI平台的实践中深刻体会到这个问题——企业部署了数字员工做审批、做数据分析、做设备诊断，但业务人员看不到Agent的执行过程，对Agent的信任度很低。TokUI的Agent可视化组件正是为了解决这个信任问题而设计的。

从技术实现的角度看，Agent可视化最难的不是"画一个好看的卡片"，而是"让状态实时流转"。Agent执行一个任务可能涉及五到十个工具调用，每个调用需要几秒到几十秒，中间还可能出错需要重试。前端需要在不重新加载的情况下，实时更新每个步骤的状态。TokUI的DSL天然支持这种场景——upd指令可以精准定位到任意一个已渲染的组件并更新其属性，不需要重新渲染整个对话。

不止Agent场景

TokUI的Agent可视化组件，本质上是一组"状态展示"组件。除了Agent场景，它们还可以用在任何需要展示"过程"的界面中——

数据ETL任务：展示数据抽取、清洗、转换、加载的实时进度。

审批流程：展示审批走到哪个节点、谁在处理、下一步是什么。

代码CI/CD：展示构建、测试、部署的流水线状态。

TokUI官网 tokui.jboltai.com 已正式开源，MIT协议，克隆即用。向量空间JBoltAI正在持续迭代TokUI的组件生态，后续会加入更多垂直场景的Agent可视化组件。向量空间JBoltAI相信，Agent产品的体验升级离不开前端组件的支撑，TokUI的开源就是为了给整个行业提供这套基础能力。AI Agent不应该是一个黑箱——让用户看到Agent在做什么，是建立信任的第一步。TokUI把这一步做成了开箱即用的组件。