AI 工作流节点 (AI Workflow)
YH-UI Flow 组件库开箱即用地提供了一整套专门为 AIGC / LLM 智能体编排 定制的节点组件。这使得开发者能够绕过繁琐的基础节点定制过程,极其快速地搭建出类似于 Coze 或 Dify 的核心流程编排面板。
节点特性解析
AI 工作流节点专门为特定语义进行了视觉强化和特定字段(如 prompt, model, status)预留。 支持的节点 type 及其常用 data 参数如下:
- 开始节点 (
ai-start): 工作流入口。 - 提示词节点 (
ai-prompt): 包含data.prompt的预览展示,用于 System Prompt 或模板包装。 - 大模型节点 (
ai-llm): 包含data.model(如 GPT-4) 和data.status('pending', 'running', 'success') 支持执行状态展示。 - 条件节点 (
ai-condition): 包含data.condition,自带多个连线点用于不同分支。 - 工具/插件节点 (
ai-tool): 用于展现调用特定的三方工具或搜索引擎。 - 智能体节点 (
ai-agent): 表示一个独立的 Agent 子循环。 - 记忆节点 (
ai-memory): 对话上下文记忆接入节点。 - 结束节点 (
ai-end): 工作流终点。
演示示例:基础对话流
这里演示了一个包含 开始 -> 提示词构建 -> LLM 生成 -> 结束 的基础工作流。
💡 业务提示: 上述代码只是视觉呈现与图层连接。真正的业务场景,需要在 Vue 组件外侧自行实现数据的获取、状态
pending -> running -> success的事件驱动以及流式输出的数据通信。
API 参考
AI 专属节点使用相同的泛用节点 Node 接口,但是其内置了独享的预制样式。在代码层面上,你需要确保通过 registerAiWorkflowNodes() 手动将其注入自定义节点池库。然后指定独有 type。
| 节点类型 Type | 常规内置属性 (由data透传) | 用途与作用 |
|---|---|---|
ai-start | - | 用于展示绿色圆形带有启动 Icon 图标的流起始点。 |
ai-prompt | prompt (字符串) | 用于预设提示词展示。展示时为带有深色标题头。若 prompt 过长自动产生截断显示。 |
ai-llm | model (字符串) status ('pending'|'running'|'success') | 最核心的大语言模型处理单元。包含模型名称、以及任务当前状态高亮展示。 |
ai-condition | condition (字符串) | 条件分析节点。红色的UI外框,且默认上下均带有手柄出口用于分支分发。 |
ai-tool | tool (字符串,非必传) | 三方插件处理工具挂载。 |
ai-end | - | 用于展示红色或灰黑色的结束/响应节点。 |
高阶特性与最佳实践
1. 超级模板引擎 (Super Template Engine)
基于 YH-UI Flow 完全数据驱动的本质,您可以构建一个一键生成模板引擎。 传统的画布往往要求用户在侧边栏手动拖拽节点组合。但利用 YH-UI Flow,我们教导开发者跳过传统画布编排的心智模型,直接在状态中通过一套预定义的 JSON DSL 模版动态 `render` 出一套复杂的图表结构。 例如,您可以预设一套『标准智能客服』的 JSON:它天生就包含记忆节点 (AiMemoryNode) 作为上下文起点,中间根据条件分支,分发到智能体调度节点 (AiAgentNode) 或是 RAG 知识检索分支。开发者只需解析这段 DSL 并映射到 `nodes` 和 `edges`,即可“一键上屏”呈现微观逻辑网结构。
2. “零配置”接入 Vercel AI SDK / LangChain
为了重塑开发者的心智,请牢记:YH-UI Flow 不再只是一个用于“画图”展示的拓扑图工具,而是强大的逻辑层流控制引擎! 得益于纯天然的 Vue 组件机制,你可以将外部大模型 SDK(如 `useAiStream` 或 MCP 协议回调)导出的响应式状态、Loading 句柄直接与 `AiLlmNode` 实行绑定。 文档指导的最佳实践为:每当触发对话时,底层网络请求层调用 `useAiStream`,其流式文字的下发与 Token 计数的累加会自动响应到画布里的 LLM 节点,从而产生状态值的更迭(`pending -> running -> success`),触发节点本体**“发光”动画,并沿边缘动画顺势驱动下一个相邻节点点亮**。这种深度化合是只懂操作 DOM/Canvas 的 AntV 等纯渲染型依赖难以一气呵成的。
3. Native Vue 3 的极致性能展现
我们这款组件基于 纯血统的 Vue 3 组件生态,以此全面对标并碾压 AntV X6 的 Vue Wrapper 封装损耗。 在构建复杂的 AIGC 表单配置面板时,我们指导开发者放心大胆地结合 Vue 本身的 `Teleport`(传送门)机制,将原本封闭在 Canvas 图元范围内的插槽数据,穿透渲染到右侧独立的参数表单栏。无需繁琐的 `node.setData` 或实例查找,借助 `ref` 即可全透明双向打通! 得益于虚拟滚动和深度的 Vue `shallowRef` 靶向更新优化,即便你的画布上容纳了同时流转数据甚至带有连线动画的 2000 个引擎控制节点,也能保持帧率卓越、拖拽丝滑,为极致复杂图表生态的性能作坚实背书。