获取历史消息列表
更新时间：2026-04-14
POST
https://qianfan.baidubce.com/v2/app/memory/messages/list
获取指定对话下的历史消息记录列表。
权限说明
调用本文API，需使用API Key鉴权方式。使用API Key鉴权调用API流程，具体调用流程，请查看认证鉴权。
请求参数
Headers 参数
除公共头域外，无其它特殊头域
Body 参数
conversation_id
string
对话ID。
必选
agent_code
string
支持以下Agent：
code_interpreter：代码解释器browser_use：浏览器使用deepresearch：深度研究ai_assistant：AI助手
注：agent_code 必须与初始创建会话时的类型一致，不允许跨 Agent 调用。
必选
user_id
string
用户ID，可通过官方Agent对话接口返回获取。
可选
end_user_id
string
终端用户 ID，用于隔离不同用户的对话上下文和历史记录。
用户自定义上传，长度限制为 6～63 字符。
若未传入或传空时，系统将根据 API Key 对应的账号 ID 自动生成一个默认的终端用户 ID。
可选
start_time
string
开始时间。格式：ISO 8601 (如 2026-01-10T15:30:45+08:00)。
仅支持查询最近 7天内 的记录。
可选
end_time
string
结束时间格式：ISO 8601 (如 2026-01-15T15:30:45+08:00)。
结束时间不得早于开始时间。
可选
status
string
消息传输状态。
枚举值：
* completed: 消息传输成功
* failed: 消息传输失败
* running: 消息传输中
* cancelled: 消息取消传输
可选
turn_id
string
对话轮次ID，用于标识“一问一答”的对话轮次。
同一轮次内的 User 消息和 Assistant 消息共用同一个 turn_id，该 ID 通常与 Assistant 的消息ID 一致。
可选
source
string
消息来源标识。
枚举值：
* web: 网页端
* app: 移动端
* open_api: API调用
可选
page
integer
页码，默认值为1。
可选
limit
integer
每页返回个数，默认值为10。
可选
请求结构
POST /v2/app/memory/messages/list HTTP/1.1
HOST: qianfan.baidubce.com
Authorization: Bearer <API Key>
Content-Type: application/json
{
"conversation_id": "d848919c-****-4449-b14f-d0cadb9dd500",
"agent_code": "deepresearch"
}示例代码
请求示例
curl --location 'https://qianfan.baidubce.com/v2/app/memory/messages/list' \
--header 'Authorization: Bearer bce-v3/ALTAK-h3HW*****koq/5fe76a06b6c27aa3bc51a82507075435269f681a' \
--header 'Content-Type: application/json' \
--data '{
"conversation_id": "ce7e7280-****-40e2-a2a7-2d8f67ffc4b4",
"agent_code":"code_interpreter"
}
'返回响应
Headers 参数
除公共头域外，无其它特殊头域
返回参数
code
string
响应状态码。
可选
message
string
响应消息。
可选
request_id
string
请求 ID。
可选
result
object {2}
可选
显示子属性
隐藏子属性
data
array
消息列表数据。
可选
显示子属性
隐藏子属性
items
object {20}
显示子属性
隐藏子属性
id
string
消息 ID。
可选
turn_id
string
轮次 ID。同一轮次内的 User 消息和 Assistant 消息共用同一个 turn_id。
可选
request_id
string
消息的请求 ID。
可选
app_id
string
应用 ID。
可选
conversation_id
string
对话 ID。
可选
user_id
string
用户 ID。
可选
role
string
消息发送者的角色
可选
mime
string
文件类型
可选
text
string
role=user 时为用户提问文本；role=assistant 时为 Agent 回答文本
可选
source
string
消息来源
可选
app_type
string
应用类型
可选
status
string
消息传输状态
可选
created_at
string
创建时间。格式：ISO 8601（如 2026-04-13T15:40:38.178+08:00）。
可选
updated_at
string
更新时间。格式：ISO 8601（如 2026-04-13T15:40:38.178+08:00）。
可选
metadata
object
消息元信息。
可选
显示子属性
隐藏子属性
attachments
array
文件 ID 集合。
可选
显示子属性
隐藏子属性
items
string
tool_choice
object
工具选择。仅自主规划 Agent 生效。
可选
显示子属性
隐藏子属性
tools
array
工具列表。role=user 时出现，仅自主规划 Agent 生效。
可选
显示子属性
隐藏子属性
items
string
tool_outputs
array
本地工具执行结果。role=user 时出现，仅自主规划 Agent 生效。
可选
显示子属性
隐藏子属性
items
string
content
array
主要内容
可选
显示子属性
隐藏子属性
items
oneOf {2}
多选一且必需“只能”符合其中一个
显示子属性
隐藏子属性
items
object {2}
role=user 时的内容结构。
显示子属性
隐藏子属性
text
string
用户输入的文本内容。
可选
tool_outputs
string
工具输出结果。
可选
items
object {7}
role=assistant 或 role=tool 时的内容结构。
显示子属性
隐藏子属性
role
string
角色标识。
枚举值：
- assistant: 助手
- tool: 工具
可选
status
string
该内容片段的处理状态。
可选
conversation_id
string
对话 ID。
可选
message_id
string
消息 ID。
可选
trace_id
string
追踪 ID。
可选
user_id
string
用户 ID。
可选
content
array
内容返回片段列表。role=tool 且为结束帧时为空数组。
可选
显示子属性
隐藏子属性
items
object {9}
显示子属性
隐藏子属性
type
string
内容片段类型。
可选
name
string
片段业务标识名称。
可选
visible_scope
string
内容可见范围。
可选
text
object {0}
片段的具体内容。结构因 type 不同而不同。
可选
显示子属性
隐藏子属性
暂无参数
event
object {3}
事件元数据。
可选
显示子属性
隐藏子属性
id
string
事件 ID。
可选
name
string
事件名称。
可选
status
string
事件执行状态。
枚举值：
- preparing: 准备中
- running: 执行中
- done: 已完成
可选
render
object {2}
渲染信息。
可选
显示子属性
隐藏子属性
answer
string
最终回答文本。
可选
component_detail
object {6}
组件详情。
可选
显示子属性
隐藏子属性
is_workflow
boolean
是否为工作流组件。
可选
name
string
组件英文名。
可选
name_cn
string
组件中文名。
可选
thought
string
模型在调用该组件前的思考过程文本。
可选
path
array
事件调用链路。
可选
显示子属性
隐藏子属性
items
object {2}
显示子属性
隐藏子属性
event_id
string
当前节点的事件 ID。
可选
parents_id
array
父节点的事件 ID 列表。
可选
显示子属性
隐藏子属性
items
string
arguments
object {2}
工具调用的入参。
可选
显示子属性
隐藏子属性
upload_files_selected
array
用户上传的文件列表。
可选
显示子属性
隐藏子属性
items
string
upstream_files_selected
array
上游节点输出的文件列表。
可选
显示子属性
隐藏子属性
items
string
metrics
object {2}
性能指标。
可选
显示子属性
隐藏子属性
begin_time_stamp
number
节点开始执行的时间戳（Unix 时间戳，毫秒级浮点数）。
可选
current_time_stamp
number
当前片段生成时的时间戳（Unix 时间戳，毫秒级浮点数）。
可选
usage
object {5}
Token 消耗信息。
可选
显示子属性
隐藏子属性
type
string
调用类型。如 chat。
可选
name
string
使用的模型名称。如 deepseek-v3.1-250821。
可选
prompt_tokens
integer
输入 Token 数量。
可选
completion_tokens
integer
输出 Token 数量。
可选
total_tokens
integer
总 Token 数量。
可选
raw_data
object {2}
原始数据。不同节点类型下结构不同。
可选
显示子属性
隐藏子属性
event_status
string
工具执行状态标识。代码执行完成时值为 done。
可选
completion_details
object {3}
Chat 节点的补充详情。
可选
显示子属性
隐藏子属性
flag
integer
标志位。
可选
ban_round
object
封禁轮次信息。
可选
显示子属性
隐藏子属性
need_clear_history
object
是否需要清除历史记录。
可选
显示子属性
隐藏子属性
has_more
boolean
是否还有下一页数据
可选
响应示例
{
"code": "success",
"message": "",
"request_id": "bf9bb742-3329-4280-a3b9-2eb145385b62",
"result": {
"data": [
{
"id": "8734dced-0902-4820-ad66-297465e28a06",
"turn_id": "8734dced-0902-4820-ad66-297465e28a06",
"request_id": "08aba90c-1c5e-4f3f-b115-1945e59f6713",
"app_id": "69a72b3f-a18c-2f02-9ba0-007beb95b315",
"conversation_id": "d848919c-3794-4449-b14f-d0cadb9dd500",
"user_id": "581a3fe1-3690-49b0-8775-5b3a1a56a537",
"role": "assistant",
"mime": "",
"content": [
{
"content": [
{
"event": {
"create": 0,
"create_at": "",
"id": "132cafcf-1722-41fc-880e-d2cf1ea7c347",
"is_end": false,
"is_stop": false,
"name": "/chat/chat_agent",
"parent_task_id": "",
"status": "done",
"step_id": "",
"task_id": "",
"task_name": ""
},
"metrics": {},
"name": "content",
"raw_data": {},
"text": {
"info": "好的，我们来细化一下奶茶店市场调研的需求。为了更好地聚焦报告内容，请您提供一些具体的信息：\n\n1. **调研目的**：这份报告是用于**潜在加盟商的投资参考**，还是用于**现有品牌的市场竞争分析**，或是其他目的？\n2. **重点品类**：您是希望重点关注**高端新式茶饮**（如喜茶、奈雪的茶），还是**性价比品牌**（如蜜雪冰城、沪上阿姨），或是涵盖所有类型？\n3. **地理范围**：是需要一个**全国性**的宏观市场概览，还是聚焦于**特定城市或区域**（如一线城市、新一线城市）的分析？\n4. **核心维度**：您最关心哪些方面？例如，**消费者偏好趋势**、**门店盈利模型**、**供应链成本分析**，还是**新兴品牌的发展策略**？\n5. **时间跨度**：是否需要分析近一年的最新动态，还是看近3-5年的市场演变？\n\n????您也可以直接输入“跳过”进入大纲生成步骤~"
},
"type": "text",
"usage": {}
}
],
"conversation_id": "d848919c-3794-4449-b14f-d0cadb9dd500",
"message_id": "8734dced-0902-4820-ad66-297465e28a06",
"role": "assistant",
"status": "done",
"trace_id": "89c336cd718221489c93d4611f55990b",
"user_id": "4121fcd138434a1580eeb0b675450b91"
},
{
"content": [
{
"event": {
"create": 1768825553533,
"create_at": "",
"id": "038607a1-6bf9-4633-8e8e-51ad8b01b446",
"is_end": false,
"is_stop": false,
"name": "/toolcall/interrupt",
"parent_task_id": "",
"status": "interrupt",
"step_id": "",
"task_id": "",
"task_name": ""
},
"metrics": {},
"name": "",
"raw_data": {},
"text": {
"data": "{\"interrupt_id\":\"c1de25a0-922a-45bd-88ce-1b5405f99b51\",\"interrupt_type\":\"deep_research_coordinator\",\"wait_for\":[\"query\"]}"
},
"type": "json",
"usage": {}
}
],
"conversation_id": "d848919c-3794-4449-b14f-d0cadb9dd500",
"message_id": "8734dced-0902-4820-ad66-297465e28a06",
"role": "tool",
"status": "interrupt",
"trace_id": "89c336cd718221489c93d4611f55990b",
"user_id": "4121fcd138434a1580eeb0b675450b91"
}
],
"text": "好的，我们来细化一下奶茶店市场调研的需求。为了更好地聚焦报告内容，请您提供一些具体的信息：\n\n1. **调研目的**：这份报告是用于**潜在加盟商的投资参考**，还是用于**现有品牌的市场竞争分析**，或是其他目的？\n2. **重点品类**：您是希望重点关注**高端新式茶饮**（如喜茶、奈雪的茶），还是**性价比品牌**（如蜜雪冰城、沪上阿姨），或是涵盖所有类型？\n3. **地理范围**：是需要一个**全国性**的宏观市场概览，还是聚焦于**特定城市或区域**（如一线城市、新一线城市）的分析？\n4. **核心维度**：您最关心哪些方面？例如，**消费者偏好趋势**、**门店盈利模型**、**供应链成本分析**，还是**新兴品牌的发展策略**？\n5. **时间跨度**：是否需要分析近一年的最新动态，还是看近3-5年的市场演变？\n\n????您也可以直接输入“跳过”进入大纲生成步骤~",
"source": "open_api",
"app_type": "deepResearch",
"status": "completed",
"created_at": "2026-01-19T20:25:53.565+08:00",
"updated_at": "2026-01-19T20:25:53.565+08:00",
"metadata": {},
"attachments": [],
"tool_choice": {},
"tools": [],
"tool_outputs": []
},
{
"id": "3307b669-fac0-44b9-986d-b1fb7adab65f",
"turn_id": "8734dced-0902-4820-ad66-297465e28a06",
"request_id": "08aba90c-1c5e-4f3f-b115-1945e59f6713",
"app_id": "69a72b3f-a18c-2f02-9ba0-007beb95b315",
"conversation_id": "d848919c-3794-4449-b14f-d0cadb9dd500",
"user_id": "581a3fe1-3690-49b0-8775-5b3a1a56a537",
"role": "user",
"mime": "",
"content": [
{
"text": "调研国内奶茶店市场",
"tool_outputs": ""
}
],
"text": "调研国内奶茶店市场",
"source": "open_api",
"app_type": "deepResearch",
"status": "completed",
"created_at": "2026-01-19T20:25:44.1+08:00",
"updated_at": "2026-01-19T20:25:44.1+08:00",
"metadata": {},
"attachments": [],
"tool_choice": {},
"tools": [],
"tool_outputs": []
}
],
"has_more": false
}
}评价此篇文章