使用工作流

通过本文你可以了解如何创建、发布、复制工作流，以及如何在 Bot 中添加工作流。

使用工作流的顺序如下：

步骤一：创建工作流

🎈

清晰明确的工作流名称和描述，有助于大语言模型更好的理解工作流的功能。

创建后页面会自动跳转至工作流的编辑页面，初始状态下工作流包含 Start 节点和 End 节点。

创建工作流后，你可以通过拖拽的方式将节点添加到画布内，并按照任务执行顺序连接节点。

工作流提供了基础节点供你使用，除此之外，你还可以添加插件节点来执行特定任务。

开始节点用于开启触发一个工作流，而结束节点用于输出工作流的结果。

开始节点支持配置以下数据类型的参数：

String：字符串类型，用于表示文本。例如：Name = "张三"。
Number：数值类型，包括整数和浮点数。例如：Number = 42.3。
Integer：数值类型，表示整数。例如：Interger=42。
Boolean：布尔类型，包含 true 和 false 两个值。例如：isAdult = true。
Object：对象类型，JavaScript的标准数据类型之一，一个对象可以看做是一个无序的键/值对的集合。例如： student = {name: "李四", age: 18}。
Array：整数数组类型，例如：numbers = [1, 2, 3, 4, 5]。

🎈

Object 最多支持 3 层嵌套。

LLM 节点是扣子提供的基础节点之一，你可以使用该节点的大语言模型处理文本生成任务。节点配置说明：

配置示例，参考使用 LLM 处理问题。

你可以在 Code 节点内使用 IDE 工具，通过 AI 自动生成代码或编写自定义代码逻辑，来处理输入参数并返回响应结果。

配置示例，参考生成随机数。

该节点支持 JavaScript、Python 运行时。在编码时你需要注意：

运行时	注意事项
JavaScript	JavaScript 支持 TypeScript，提供静态语言编码体验。 JavaScript 中，仅内置了dayjs（版本 1.8.36）和 lodash（版本 4.17.20）两个三方依赖库。 `//only dayjs and lodash are allowed import dayjs from 'dayjs'; import _ from 'lodash'; async function main({ params }: Args): Promise<Output> { // get input params by this way return { content: params.name }; }` JavaScript 运行时遵循 WinterCG 规范，支持 Minimum Common Web Platform API 列举的大多数 API，具体可用的 API 你可以在 IDE 内编码时参考代码提示。
Python	Python 中，仅内置了 requests_async 和 numpy 两个三方依赖库，requests_async 依赖库与 requests 类似，但需要 await。 🎈 Python 运行时暂不支持 Http.client 方式的请求。 `import requests_async as requests async def main(args: Args) -> Output: # you can get url by this way url = args.params['url'] response = await requests.get(url) ret = { 'code': response.status_code, 'res': response.text, } return ret`

在节点内的 Code 区域单击 Edit in IDE 可通过 IDE 编辑和调试代码。

具体使用说明如下：

使用 AI 生成代码
你可以在 IDE 底部单击尝试 AI，并输入自然语言设定代码逻辑，AI 将自动生成代码。你也可以选中代码片段，通过快捷键（macOS 为 CommandI、Windows 为 Ctrl + I）唤起 AI，并输入自然语言让 AI 帮助你修改代码。
补全代码

如果你已经为 Code 节点配置好了输入参数，则编辑时支持自动补全参数。

单击测试代码，在测试面板以 JSON 格式输入参数进行测试。支持使用 AI 自动生成模拟数据进行测试。

设置输入参数后，单击运行，你可以在输出区域查看运行结果。在页面底部单击更新 Schema，可将结果同步到 Code 节点的输出值。

知识库节点可以根据输入参数从指定知识库内召回匹配的信息。节点配置说明：

设置输入参数，节点会根据参数值召回关键内容。
设置知识库，你需要使用的知识库。
- 最大召回数量：从知识库召回的最大段落数，数值越大返回的内容越多。
- 最小匹配度：知识库会根据设置的匹配度召回段落，低于匹配度的内容将不会被召回。

该节点是一个 if-else 节点，用于设计工作流内的分支流程。

当向该节点输入参数时，节点会判断是否符合如果区域的条件，符合则执行如果对应的工作流分支，否则执行否则对应的工作流分支。

每个分支条件支持添加多个判断条件（且/或），同时支持添加多个条件分支，可通过拖拽分支条件配置面板来设定分支条件的优先级。

消息节点支持在工作流执行过程中返回响应内容，可解决当回复消息内容非常多或工作流长导致用户无法及时收到响应的问题。消息节点支持流式和非流式两种消息模式。

一个消息节点包含以下配置：

输出变量：配置输出变量，你可以将这些变量添加到下方的回答内容区域中，这样 Bot 在调用工作流时只会回复你设定的"回答内容"。此外，这些变量也可以在配置卡片时使用。
回答内容：在工作流运行过程中，Bot 将直接用这里指定的内容回复回复对话。可以使用{{变量名}}的方式引用输出参数中的变量。
流式输出：
- 默认关闭，即采用非流式输出，待接收到全部消息内容后，再一次性输出全部消息内容。
- 开启流式输出后，上一节点一边生成回复内容，一边通过消息节点进行输出，不需要等待全部内容都加载完后再返回。流式输出类似于打字机的效果。