批量删除事件记忆-BatchDeleteEvent--向量数据库VikingDB-火山引擎

文档中心

立即注册

导航

向量数据库VikingDB

批量删除事件记忆-BatchDeleteEvent

最近更新时间：2025.11.18 15:59:35首次发布时间：2025.08.12 11:31:47

概述

用于批量删除已写入记忆库的事件记忆。

请求接口

URL	/api/memory/event/batch_delete	统一资源标识符
请求方法	POST	客户端对记忆库服务器请求的操作类型
请求头	Content-Type: application/json	请求消息类型
请求头	Authorization: HMAC-SHA256 ***	基于AK/SK生成的签名信息

请求参数

参数	类型	是否必须	参数说明
collection_name	String	否	目标记忆库的名称。
project_name	String	否	记忆库所属项目。
resource_id	String	否	记忆库唯一的资源 id。可选择直接传 resource_id，或同时传 collection_name 和 project_name 作为记忆库的唯一标识。
filter	Object	是	删除记忆的过滤条件。
user_id	String or Array of String	否	用户 ID，支持单个 ID 或 ID 列表。和 assistant_id 至少填写一个，也可以同时填写。
assistant_id	String or Array of String	否	助手 ID，支持单个 ID 或 ID 列表。和 user_id 至少填写一个，也可以同时填写。
event_type	String or Array of String	否	事件类型。
delete_type	String	是	记忆的删除方式。默认是full模式。 full：全局删除整条记忆

说明：

user_id 和 assistant_id 至少填写一个，也可以同时填写。

响应消息

参数	类型	参数说明
code	Integer	状态码，0表示成功，其他表示错误。
message	String	返回信息，成功时通常为 "success"。
request_id	String	标识每个请求的唯一ID。

完整示例

请求消息

Python请求

import os
import json
import requests

API_KEY = os.getenv("MEMORY_API_KEY", "your_key")
url = "https://api-knowledgebase.mlp.cn-beijing.volces.com/api/memory/event/batch_delete"

headers = {
    "Authorization": f"Bearer {API_KEY}",
    "Content-Type": "application/json"
}

data = {
    "collection_name": "my_first_memory_collection",
    "filter": {
        "user_id": "user1",
        "event_type": "sys_event_v1"
    },
    "delete_type": "full"
}

response = requests.post(url, headers=headers, data=json.dumps(data))

print("Status Code:", response.status_code)
print("Response:", response.text)

响应消息

执行成功返回

{
    "code":0,
    "message":"success",
    "data": {
        "resource_id": "kb-8349ef57441ab57"
    }，
    "request_id":"021695029537650fd001de666660000000000000000000230da93"
}