构建应用/工作流/节点/工具
应用调用与工作流工具节点
在工作流中调用子应用（runApp），或配置工作流工具的自定义输入（pluginInput）、输出（pluginOutput）与工具参数（toolParams）。
FastGPT 支持将已发布的应用或工作流工具嵌入其他工作流中复用，实现模块化编排。本页涵盖子应用调用节点以及构建工作流工具专用的三个系统节点。
一、应用调用节点（appModule / runApp）
将团队内已有的对话 Agent、对话 Agent V2 或工作流作为当前画布上的一个步骤执行，或挂载到 工具调用节点 供模型按需调用。
输入、配置与输出
| 项目 | 类型 | 说明 |
|---|---|---|
| 选择应用 | 资源绑定 | 选择当前团队具有访问权限的目标应用；节点标题栏的版本选择器可选“保持最新版本”，或固定某个已发布版本 |
用户问题（userChatInput） | String | 传递给被调用应用的输入文本，可填写固定文本或引用上游变量 |
聊天记录（history） | ChatHistory | 传递给子应用的上下文轮次或上游聊天记录变量 |
文件链接（fileUrlList） | Array<string> | 传递给子应用处理的文件 URL 数组 |
| 子应用全局变量 | 动态字段 | 自动映射目标应用声明的必填与选填全局变量 |
AI 回复内容（answerText） | String | 子应用执行完成后返回的完整文本结果 |
新的上下文（history） | ChatHistory | 附加了子应用本轮问答后的更新上下文 |
节点输出区标题右侧提供 报错捕获 开关，开启后可将子应用的运行错误引导至容错分支，见调试与报错捕获。
二、工作流工具专用节点
当你在“工作台 → 我的工具”中通过列表的“新建”卡片创建工作流工具时，画布默认包含 插件开始（pluginInput）和 插件输出（pluginOutput）两个节点，替代普通工作流的开始节点；两个节点内分别为 自定义输入、自定义输出 分区，详见 创建与复用工作流工具。
1. 插件开始（pluginInput）
- 职责：声明调用方（父工作流、工具调用节点或 Agent）在调用该工作流工具时必须或可选传入的参数契约（JSON Schema）。
- 配置项：在“自定义输入”分区点击“新增”，配置字段名（
key）、显示标签（label）、数据类型（String、Number、Boolean、Object、强类型数组或选择知识库）、工具参数描述（供大模型理解如何填值）以及是否必填。 - 输出：每个声明的输入字段自动成为该节点的同名输出端口，供画布下游节点直接引用。
2. 插件输出（pluginOutput）
- 职责：汇总工作流工具内部节点的处理结果，按固定字段名返回给父级调用方或大模型。
- 配置项：在“自定义输出”分区点击“新增”，声明输出变量名、类型与说明，并通过变量选择器绑定画布内上游节点（如 HTTP 请求、代码运行、AI 对话）的输出值。
3. 自定义工具变量（toolParams）
- 职责：在通过工具连接线挂载到工具调用节点的子工作流中，额外声明需要大模型在运行期动态生成并注入的参数字段。
- 生效条件：仅在画布中存在工具调用节点或连接在
selectedTools工具连线路径上时可用；声明的字段会合并到工具调用的 Function Calling Schema 中，并在执行时作为该节点的输出供下游节点引用。
示例：封装并调用订单查询子流程
- 创建一个工作流工具
订单状态查询，在自定义输入中添加字符串字段orderId（描述：8 位订单编号）。 - 连接 HTTP 请求节点查询订单服务，再将返回的物流状态绑定到自定义输出的
statusText字段，点击发布。 - 在主工作流中添加该工作流工具节点，将上游提取出的订单号连接到
orderId输入端口，即可在下游引用statusText输出。
在 GitHub 上编辑
文件更新时间