删除历史会话记录

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

本文介绍删除历史会话记录的 API。

接口描述

根据设备 ID，删除 AI 智能体角色的历史会话记录。

接口地址

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

请求参数

参数名	类型	参数位置	是否必填	说明
device_id	String	path	true	设备 ID
bind_role_type	Integer	query	false	绑定角色类型 `0`：自定义角色 `1`：模板角色 `2`：单角色（即无角色，数据在智能体维度上) 当 `role_id` 传递时，此值必须传递
role_id	String	query	false	角色 ID
clear_all_history	Boolean	query	true	是否清除所有历史记录
request_ids	String	query	false	请求 ID 列表，用逗号分隔（每次最多 20 个）

返回参数

参数名	类型	说明
result	boolean	操作是否成功

请求示例

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

{
  "device_id": "6c3585ebfe301b40a8u***",
  "bind_role_type": 1,
  "role_id": "94300***",
  "clear_all_history": false,
  "request_ids": "0ed72c5a-11e4-47f3-a08f-b1d4-42767***,c487de49-d08e-4fb5-a0f0-e181-***"
}

返回示例

{
    "tid": "6fa034fc1a6d11f0a8212220de940dcb",
    "result": true,
    "t": 1744771778112,
    "success": true
}

错误码

参考错误码。