获取历史对话列表
更新时间：2026-04-14
POST
https://qianfan.baidubce.com/v2/app/memory/conversations/list
本接口获取指定官方Agent下的历史对话列表，返回对话记录信息。
权限说明
调用本文API，需使用API Key鉴权方式。使用API Key鉴权调用API流程，具体调用流程，请查看认证鉴权。
请求参数
Headers 参数
除公共头域外，无其它特殊头域
Body 参数
agent_code
string
支持以下Agent：
code_interpreter：代码解释器browser_use：浏览器使用deepresearch：深度研究ai_assistant：AI助手
必选
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-10T15:30:45+08:00）。
可选
page
integer
页码，默认值为 1。
可选
limit
integer
每页返回个数，默认值为 10。
可选
请求结构
POST /v2/app/memory/conversations/list HTTP/1.1
HOST: qianfan.baidubce.com
Authorization: Bearer <API Key>
Content-Type: application/json
{
"agent_code": "code_interpreter",
"end_user_id": "user_001",
"start_time": "2026-01-10T15:30:45+08:00",
"end_time": "2026-01-24T15:30:45+08:00",
"page": 1,
"limit": 10
}示例代码
请求示例
curl -X POST "https://qianfan.baidubce.com/v2/app/memory/conversations/list" \
-H "Authorization: Bearer bce-v3/ALTAK-******ZftZDTn7/125eeb1c5e9ddc8cf3edf18ef6d03f1517ec9408" \
-H "Content-Type: application/json" \
-d '{
"agent_code": "code_interpreter",
"start_time": "2026-01-10T15:30:45+08:00",
"end_time": "2026-01-24T15:30:45+08:00",
"page": 1,
"limit": 10
}'返回响应
Headers 参数
除公共头域外，无其它特殊头域
返回参数
code
string
响应状态码。
可选
message
string
响应消息。
可选
request_id
string
请求 ID。
可选
result
object {2}
返回数据结果。
可选
显示子属性
隐藏子属性
data
array
对话列表数据。
可选
显示子属性
隐藏子属性
items
object {11}
显示子属性
隐藏子属性
id
string
对话 ID。
可选
user_id
string
用户 ID。
可选
app_id
string
应用 ID。
可选
request_id
string
请求 ID。
可选
title
string
对话标题。
可选
external_session_id
string
会话 ID。
可选
source
string
对话来源。
可选
status
string
对话状态。
可选
created_at
string
创建时间，格式为 ISO 8601，时区为 UTC。
可选
updated_at
string
更新时间，格式为 ISO 8601，时区为 UTC。
可选
metadata
object {0}
对话元信息。
可选
显示子属性
隐藏子属性
暂无参数
has_more
boolean
是否还有下一页数据。
可选
成功示例
{
"code": "success",
"message": "",
"request_id": "87865686-ed56-4cc7-9696-f64f8be4d943",
"result": {
"data": [
{
"id": "d27c8f63-8be2-4c1d-9365-d6f142957e4c",
"app_id": "7d4b5193-b038-41aa-82bf-1ebb075095a0",
"request_id": "bd238dae-3cc9-48d6-add0-c4a0be5cbebd",
"user_id": "a00dd7b8-70ec-4312-9e23-29c8e1a11f4f",
"title": "随便写一段代码",
"external_session_id": "",
"source": "web",
"status": "completed",
"created_at": "2026-01-16T11:43:48.456+08:00",
"updated_at": "2026-01-16T16:09:39.04+08:00",
"metadata": {}
}
],
"has_more": false
}
}评价此篇文章