助手
扣子 AI 帮助与支持
你好,我是 扣子 文档问答助手 🎉 你在阅读当前文档的过程中,无论对文档概念的解释,还是文档内容方面的疑问,都可以随时向我提问,我会全力为你解答
推荐问题
如何快速了解这个空间的核心内容?
有哪些近期更新的重点文档?
我应该从哪些文档开始阅读?
文档反馈
低代码项目
快速开始
智能体
应用
资源
发布
模型
多人协作
开发工具
推广与变现

查询消息列表节点

更新于: 2026-06-24 15:44:40

低代码工作流中的查询消息列表节点用于查看指定会话中的所有历史消息。

节点说明

每个对话流都需要绑定一个会话作为开始节点的默认会话,执行对话流时产生的消息都会自动写入到这个会话中,包括用户输入的消息和对话流输出的消息。查询消息节点可以展示指定会话中已记录的所有历史消息,在低代码工作流或对话流中添加这个节点并绑定一个列表组件,你可以在用户界面中实时展示对话消息列表。

说明

消息在服务端的保存时长为180天,期满后,消息将自动从会话的消息记录中删除。

配置查询消息列表节点

输入

消息列表节点预置了多个输入参数,且不支持手动调整参数名称。
默认按时间倒序查看最近的 100 条消息,支持通过 limit 参数翻页。如果会话中消息较多,你可以先查看部分消息,获取消息列表中返回的 first_id、last_id,再通过 beforeId 或 afterId 从指定位置开始查看消息。
输入参数的详细说明如下:

参数

说明

conversationName

待查看消息列表的会话名称。必选,String 类型,可以指定为一个固定值,或引用上游节点的输出参数。

limit

返回的最大消息数量。必选,Integer 类型,默认为 100,取值范围为 1~100。
可以指定为一个固定值,或引用上游节点的输出参数。

beforeId

查看指定位置之前的消息。必选,String 类型,可以指定为一个固定值,或引用上游节点的输出参数。

  • 传入空字符串,表示不指定位置。
  • 如需向前翻页,则指定为输出参数中的 firstId。

afterId

查看指定位置之后的消息。必选,String 类型,可以指定为一个固定值,或引用上游节点的输出参数。

  • 传入空字符串,表示不指定位置。
  • 如需向后翻页,则指定为输出参数中的 lastId。

输出

创建会话节点的输出参数用于返回执行结果和消息列表。参数固定如下:

参数

类型

说明

messageList

Array

指定会话中的消息列表。

messageList.messageId

String

Message ID,即消息的唯一标识。

messageList.role

String

发送这条消息的实体。取值:

  • user:代表该条消息内容是用户发送的。
  • assistant:代表该条消息内容是智能体发送的。

messageList.contentType

String

消息内容的类型,取值包括:

  • 1:文本。
  • 2:多模态内容,文件、图片、语音等。

messageList.content

String

消息的内容,支持纯文本、多模态等多种类型的内容。

firstId

String

返回的消息列表中,第一条消息的 Message ID。

lastId

String

返回的消息列表中,最后一条消息的 Message ID。

hasMore

Boolean

是否已返回全部消息。

  • true:未返回全部消息,可再次调用此接口查看其他分页。
  • false:已返回全部消息。

试运行查询消息列表节点

对于资源库中的工作流或对话流,试运行查询消息列表节点时,需要关联智能体或应用,表示查看指定智能体或应用的指定会话。
Image
试运行此节点,得到的消息列表如下:

试运行结果:
Image

对应的消息列表:
Image