低代码工作流中的查询消息列表节点用于查看指定会话中的所有历史消息。
每个对话流都需要绑定一个会话作为开始节点的默认会话,执行对话流时产生的消息都会自动写入到这个会话中,包括用户输入的消息和对话流输出的消息。查询消息节点可以展示指定会话中已记录的所有历史消息,在低代码工作流或对话流中添加这个节点并绑定一个列表组件,你可以在用户界面中实时展示对话消息列表。
说明
消息在服务端的保存时长为180天,期满后,消息将自动从会话的消息记录中删除。
消息列表节点预置了多个输入参数,且不支持手动调整参数名称。
默认按时间倒序查看最近的 100 条消息,支持通过 limit 参数翻页。如果会话中消息较多,你可以先查看部分消息,获取消息列表中返回的 first_id、last_id,再通过 beforeId 或 afterId 从指定位置开始查看消息。
输入参数的详细说明如下:
|
参数 |
说明 |
|---|---|
|
conversationName |
待查看消息列表的会话名称。必选,String 类型,可以指定为一个固定值,或引用上游节点的输出参数。 |
|
limit |
返回的最大消息数量。必选,Integer 类型,默认为 100,取值范围为 1~100。 |
|
beforeId |
查看指定位置之前的消息。必选,String 类型,可以指定为一个固定值,或引用上游节点的输出参数。
|
|
afterId |
查看指定位置之后的消息。必选,String 类型,可以指定为一个固定值,或引用上游节点的输出参数。
|
创建会话节点的输出参数用于返回执行结果和消息列表。参数固定如下:
|
参数 |
类型 |
说明 |
|---|---|---|
|
messageList |
Array |
指定会话中的消息列表。 |
|
messageList.messageId |
String |
Message ID,即消息的唯一标识。 |
|
messageList.role |
String |
发送这条消息的实体。取值:
|
|
messageList.contentType |
String |
消息内容的类型,取值包括:
|
|
messageList.content |
String |
消息的内容,支持纯文本、多模态等多种类型的内容。 |
|
firstId |
String |
返回的消息列表中,第一条消息的 Message ID。 |
|
lastId |
String |
返回的消息列表中,最后一条消息的 Message ID。 |
|
hasMore |
Boolean |
是否已返回全部消息。
|
对于资源库中的工作流或对话流,试运行查询消息列表节点时,需要关联智能体或应用,表示查看指定智能体或应用的指定会话。
试运行此节点,得到的消息列表如下:
试运行结果:
对应的消息列表: