AI 助手
扣子 AI 帮助与支持
你好,我是 扣子 文档问答助手 🎉 你在阅读当前文档的过程中,无论对文档概念的解释,还是文档内容方面的疑问,都可以随时向我提问,我会全力为你解答
推荐问题
扣子 3.0 都有什么新特性?
扣子和扣子编程有什么区别?
扣子如何收费?
文档反馈
低代码项目
动态
快速开始
智能体
应用
资源
发布
模型
多人协作
开发工具
推广与变现

查询消息列表节点

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

节点说明

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

说明

  • 在团队版和企业版中,企业超级管理员可以通过功能访问控制​空间资源可见性,控制成员可见的功能入口和空间资源范围。如果你未看到预期的功能和资源,请联系企业超级管理员确认。更多信息,请参考功能访问控制空间资源访问控制
  • 消息在服务端的保存时长为180天,期满后,消息将自动从会话的消息记录中删除。

配置查询消息列表节点

输入

消息列表节点预置了多个输入参数,且不支持手动调整参数名称。

默认按时间倒序查看最近的 100 条消息,支持通过 limit 参数翻页。如果会话中消息较多,你可以先查看部分消息,获取消息列表中返回的 firstId、lastId,再通过 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