# 输出节点 低代码工作流的输出节点用于在低代码工作流执行过程中输出指定的消息内容,例如 "正在执行中"等 Loading 状态展示或安抚语。 ## 节点说明 通常情况下,工作流会在执行完毕后通过结束节点输出最终的执行结果。当工作流处理流程较长、运行时间较久时,开发者可以在工作流中添加输出节点,临时输出一段消息,避免用户等待时间过长、放弃对话。例如提示用户任务正在执行中,建议用户耐心等待。 输出节点支持流式和非流式两种模式,同时支持绑定卡片,展示丰富的交互效果,提升对话过程的用户体验。 ![Image](https://p9-arcosite.byteimg.com/tos-cn-i-goo7wpa0wc/1ddc87134863447db6f774691c94c094~tplv-goo7wpa0wc-image.image) ## 配置输出节点 在输出节点中,工作流会在执行的同时输出一条中间消息,消息内容为指定的输出内容,其中可引用已定义的输出变量。输出节点支持流式输出,即打印机效果。 ### **输出变量** 输出变量用于定义输出内容中可引用的变量,支持添加多个变量。每个变量均需要设置参数名和参数值,其中参数值可指定为某个固定值,或引用上游节点的输出变量。 输出变量也可以在输出节点绑定的卡片中使用。 ### **输出内容** 在工作流运行过程中,智能体将直接使用这里指定的内容回复对话。你可以使用`{{变量名}}`的方式引用**输出变量**中定义的变量。 在输出内容右侧单击配置图标,还可以调整流式输出等高级配置。 ![Image](https://p9-arcosite.byteimg.com/tos-cn-i-goo7wpa0wc/5378943b24524779bb48dac94d976cf1~tplv-goo7wpa0wc-image.image) 通话中转语音、音色和会话历史写入设置仅对话流可设置,工作流输出节点不支持此配置。 #### **流式输出** 流式输出表示输出节点配置的输出内容会逐字地显示在对话中,类似于打字机的效果。流式输出适用于输出文本较长或需要工作流即时反馈的场景,呈现实时对话的交互效果,用户无需等待一大段文字一次性加载,可显著提高对话过程中的用户体验。 输出节点默认采用非流式输出,待接收到全部消息内容后,再一次性输出全部消息内容。 * 输出节点只有在大模型节点之后才能开启流式响应。 * 如果输出节点绑定了消息卡片,即使开启流式输出,输出的卡片也是非流式的,卡片会等待所有回复内容加载完毕后一次性展示在对话中。 * 当在一个工作流中配置了多个输出节点并开启了流式返回时,输出节点的执行遵循工作流的执行顺序,先执行的输出节点优先输出消息。 #### 通话中转语音 仅在视频通话时生效,用于指定通话时是否朗读输出节点配置的消息内容。关闭**通话中转语音**表示不朗读。输出节点如果展示 Loading 状态、卡片效果、自定义指令等与对话本身无关的内容,通常无需开启**通话中转语音**。 开启通话中转语音后,音视频通话时朗读输出消息会产生语音转文本的费用,具体资费和朗读时选择的音色类型有关,详细说明可参考[音视频费用](https://docs.coze.cn/api/open/docs/coze_pro/asr_tts_fee)。 #### 音色 为输出节点配置音色,支持配置自定义的复刻音色或系统预设音色。配置后,如果开启了通话中转语音,智能体会在音视频通话中以指定音色朗读输出节点配置的消息内容。未配置音色时,输出节点沿用智能体或对话流角色配置的音色。 扣子编程的系统预设音色支持多情感音色,即一个音色中包括多种情感,例如开心、悲伤等。你可以指定其中一种情感并设置情绪值,来控制输出节点音色的情绪类型。指定的情感将应用于该输出节点的所有内容,不会根据每句话动态调整。具体配置说明如下表所示。 试听音色时,扣子编程将根据音色类型(复刻音色/系统音色)及对应规则收取语音合成费用。费用详细说明请参见[音视频费用](https://docs.coze.cn/api/open/docs/coze_pro/asr_tts_fee)。 ![Image](https://p9-arcosite.byteimg.com/tos-cn-i-goo7wpa0wc/e525f25fdc5549199b76a2ad28e4f375~tplv-goo7wpa0wc-image.image) | **参数** | **说明** | | --- | --- | | 情感 | 情感参数用于指定输出节点音色的情绪类型,例如开心、悲伤等。你可以从下拉列表中选择该音色对应的情感。不同音色支持的情感范围不同。 | | 情绪值 | 情绪值用于量化情感的强度。数值越高,情感表达越强烈,例如: “开心” 的情绪值 5 比 1 更显兴奋。
取值范围:1.0~5.0,默认值:4.0。 | #### 会话历史写入 输出节点配置的消息内容是否自动写入对话流的会话历史。支持设置为: * 写入:(默认)输出消息写入对话流的会话历史。模型会将输出节点的消息内容作为上下文传递给大模型,以便大模型更好地理解用户意图,生成更连贯、自然、准确的回复。同时由于增加了模型输入的 Token,也会一定程度上影响模型响应耗时。 * **不写入**:输出消息不写入会话历史,仅在执行会话流时展示。例如输出节点配置的 Loading 状态展示、安抚语、自定义指令等和对话本身无关的信息通常无需写入会话历史,否则会影响模型的输出。
工作流: ![Image](https://p9-arcosite.byteimg.com/tos-cn-i-goo7wpa0wc/efda265e1c844be69b5b70e7ffa0086b~tplv-goo7wpa0wc-image.image)
对话流: ![Image](https://p9-arcosite.byteimg.com/tos-cn-i-goo7wpa0wc/7b1369ed9e064acf87ffbc3ae10f4157~tplv-goo7wpa0wc-image.image)
## 示例 如果工作流的输出内容较长,可以使用输出节点拆分消息内容,一部分通过输出节点输出,一部分通过结束节点输出,同时开启流式输出。 以好书解析智能体为例,通过大模型节点生成书籍的介绍,指定输出为两个段落,通过文本处理节点将两个段落拆开,一段通过输出节点输出,一段通过结束节点输出。 ![Image](https://p9-arcosite.byteimg.com/tos-cn-i-goo7wpa0wc/e1103be31a104ff9b63b739ac1537bfa~tplv-goo7wpa0wc-image.image) 核心节点配置说明如下: | **节点类型** | **配置说明** | **示例** | | --- | --- | --- | | 大模型节点 | 引用开始节点的变量,获取用户需要查询的书籍名称。
用户提示词中需要指定输出格式,例如指定输出为两个段落。 | ![Image](https://p9-arcosite.byteimg.com/tos-cn-i-goo7wpa0wc/b07df505d3ec44bbb65bc9abaa37f36c~tplv-goo7wpa0wc-image.image)
| | 文本处理节点 | 使用字符串分隔模式,通过换行符将大模型节点的输出内容转为数组格式,每个段落是数组的一个元素。 | ![Image](https://p9-arcosite.byteimg.com/tos-cn-i-goo7wpa0wc/5eaafb71d12f4a80a4428c4b7bcacbba~tplv-goo7wpa0wc-image.image) | | 输出节点 | 引用文本处理节点的输出,注意这里只引用数组的第一个元素,也就是书籍简介的第一个段落。 | ![Image](https://p9-arcosite.byteimg.com/tos-cn-i-goo7wpa0wc/241d72d708d045f480ed081c14fd0fbd~tplv-goo7wpa0wc-image.image) | | 结束节点 | 引用文本处理节点的输出,这里只引用第二个段落即可。 | ![Image](https://p9-arcosite.byteimg.com/tos-cn-i-goo7wpa0wc/a2b0d0764eec40fcbf86bbee8b214546~tplv-goo7wpa0wc-image.image) | 在智能体中的体验效果如下: ![Image](https://p9-arcosite.byteimg.com/tos-cn-i-goo7wpa0wc/99c79661e5cc4723a2069ddfbd9aec51~tplv-goo7wpa0wc-image.image)