查询消息列表节点用于查看指定会话中的所有历史消息。 ## 节点说明 每个对话流都需要绑定一个会话作为开始节点的默认会话，执行对话流时产生的消息都会自动写入到这个会话中，包括用户输入的消息和对话流输出的消息。查询消息节点可以展示指定会话中已记录的所有历史消息，在工作流或对话流中添加这个节点并绑定一个列表组件，你可以在用户界面中实时展示对话消息列表。 消息在服务端的保存时长为180天，期满后，消息将自动从会话的消息记录中删除。 ## 配置查询消息列表节点 ### 输入 消息列表节点预置了多个输入参数，且不支持手动调整参数名称。 默认按时间倒序查看最近的 50 条消息，支持通过 limit 参数翻页。如果会话中消息较多，你可以先查看部分消息，获取消息列表中返回的 first\_id、last\_id，再通过 beforeId 或 afterId 从指定位置开始查看消息。 输入参数的详细说明如下： | **参数** | **说明** | | ---------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | conversationName | 待查看消息列表的会话名称。必选，String 类型，可以指定为一个固定值，或引用上游节点的输出参数。 | | limit | 返回的最大消息数量。必选，Integer类型，默认为 50，取值范围为 1\~50。可以指定为一个固定值，或引用上游节点的输出参数。 | | 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：已返回全部消息。 | ## 试运行查询消息列表节点 对于资源库中的工作流或对话流，试运行查询消息列表节点时，需要关联智能体或应用，表示查看指定智能体或应用的指定会话。  试运行此节点，得到的消息列表如下： 试运行结果：  对应的消息列表：