查询历史会话记录

更新时间：2026-02-26 09:16:46LLM 副本以 Markdown 格式查看下载 PDF

本文介绍查询历史会话记录的 API。

接口描述

根据设备 ID，查询 AI 智能体的历史会话记录。

接口地址

GET: /v1.0/cloud/agent/ai/chat/b/devices/{device_id}/history

请求参数

参数名	类型	参数位置	是否必填	说明
device_id	String	path	true	设备 ID
bind_role_type	Integer	query	true	绑定角色类型 `0`：自定义角色 `1`：模板角色 `2`：单角色（即无角色，数据在智能体维度上) 当 `role_id` 传递时，此值必须传递
role_id	String	query	true	角色 ID
gmt_end	Long	query	true	聊天信息的截止时间戳。小于此时间的聊天信息会被返回
page_size	Integer	query	true	每页数量，每页最多返回 20 条

返回参数

参数名	类型	说明
result	List	会话记录列表

result 说明

参数名	类型	说明
gmt_create	Long	聊天时间（时间戳）
answer	List	回答内容列表
question	List	提问内容列表
request_id	String	会话记录 ID

question 说明

参数名	类型	说明
context	String	消息内容
type	String	消息类型

answer 说明

参数名	类型	说明
context	String	消息内容
type	String	消息类型

请求示例

GET: /v1.0/cloud/agent/ai/chat/b/devices/{device_id}/history

{
  "device_id": "6c50600a0e15d1fb78h***",
  "bind_role_type": 1,
  "role_id": "94300***",
  "gmt_end": 1753079987512,
  "page_size": 20
}

返回示例

{
    "result": [
        {
            "gmt_create": 1753344939913,
            "question": [
                {
                    "type": "text",
                    "context": "我的***"
                }
            ],
            "answer": [
                {
                    "type": "text",
                    "context": "你之前有跟我说过***"
                }
            ],
            "request_id": "ccbda733-e3d2-4ee3-bb19-d201-***"
        }
    ],
    "t": 1753707608368,
    "success": true
}

错误码

参考错误码。