> ## Documentation Index
> Fetch the complete documentation index at: https://docs.coze.cn/llms.txt
> Use this file to discover all available pages before exploring further.

低代码工作流中的查询消息列表节点用于查看指定会话中的所有历史消息。
## 节点说明 {#15a7357a}
每个对话流都需要绑定一个会话作为开始节点的默认会话，执行对话流时产生的消息都会自动写入到这个会话中，包括用户输入的消息和对话流输出的消息。查询消息节点可以展示指定会话中已记录的所有历史消息，在低代码工作流或对话流中添加这个节点并绑定一个列表组件，你可以在用户界面中实时展示对话消息列表。
:::tip 说明
消息在服务端的保存时长为180天，期满后，消息将自动从会话的消息记录中删除。
:::
## 配置查询消息列表节点 {#ac664c64}
### 输入 {#acc16ced}
消息列表节点预置了多个输入参数，且不支持手动调整参数名称。
默认按时间倒序查看最近的 100 条消息，支持通过 limit 参数翻页。如果会话中消息较多，你可以先查看部分消息，获取消息列表中返回的 first_id、last_id，再通过 beforeId 或 afterId 从指定位置开始查看消息。
输入参数的详细说明如下：
<!-- @cols-width: 200,661 -->
| | | \
|**参数** |**说明** |
|---|---|
| | | \
|conversationName |待查看消息列表的会话名称。必选，String 类型，可以指定为一个固定值，或引用上游节点的输出参数。 |
| | | \
|limit |返回的最大消息数量。必选，Integer 类型，默认为 100，取值范围为 1~100。 |\
| |可以指定为一个固定值，或引用上游节点的输出参数。 |
| | | \
|beforeId |查看指定位置之前的消息。必选，String 类型，可以指定为一个固定值，或引用上游节点的输出参数。 |\
| | |\
| |* 传入空字符串，表示不指定位置。 |\
| |* 如需向前翻页，则指定为输出参数中的 firstId。 |
| | | \
|afterId |查看指定位置之后的消息。必选，String 类型，可以指定为一个固定值，或引用上游节点的输出参数。 |\
| | |\
| |* 传入空字符串，表示不指定位置。 |\
| |* 如需向后翻页，则指定为输出参数中的 lastId。 |

### 输出 {#3bda157d}
创建会话节点的输出参数用于返回执行结果和消息列表。参数固定如下：
<!-- @cols-width: 175,175,512 -->
| | | | \
|**参数** |**类型** |**说明** |
|---|---|---|
| | | | \
|messageList |Array<Object> |指定会话中的消息列表。 |
| | | | \
|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：已返回全部消息。 |

## 试运行查询消息列表节点 {#83d75f3d}
对于资源库中的工作流或对话流，试运行查询消息列表节点时，需要关联智能体或应用，表示查看指定智能体或应用的指定会话。
![Image=451x337](https://p9-arcosite.byteimg.com/tos-cn-i-goo7wpa0wc/c398eb8cb0aa4f6fa577abe7e3933234~tplv-goo7wpa0wc-image.image)
试运行此节点，得到的消息列表如下：

::::cols
@col 50
试运行结果：
![Image=252x384](https://p9-arcosite.byteimg.com/tos-cn-i-goo7wpa0wc/d964d928776a4c498ada73f321013bbe~tplv-goo7wpa0wc-image.image)


@col 50
对应的消息列表：
![Image=1788x601](https://p9-arcosite.byteimg.com/tos-cn-i-goo7wpa0wc/f0340c0c90ab4437b7e9bbce95a8b9a6~tplv-goo7wpa0wc-image.image)


::::