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

文档中心

立即注册

导航

向量数据库VikingDB

批量删除事件记忆-BatchDeleteEvent

最近更新时间：2025.11.18 15:59:36首次发布时间：2025.11.07 14:07:19

概述

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

请求接口

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 time
from vikingdb.memory import VikingMem
from vikingdb import APIKey

API_KEY = os.getenv("MEMORY_API_KEY", "your_key")

client = VikingMem(
    host = "api-knowledgebase.mlp.cn-beijing.volces.com",
    region = "cn-beijing",
    auth= APIKey(api_key=API_KEY),
    scheme="http",
)

# 获取记忆库集合
collection = client.get_collection(
    collection_name="my_first_memory_collection",  # 用您的记忆库名称替代
    project_name="default"
)

# 批量删除事件
result = collection.batch_delete_event(
    filter = {
        "user_id": "user1",
        "event_type": "sys_event_v1"
    },
    delete_type = "full"  
)

print("\n=== 格式化结果 ===")
print(json.dumps(result, indent=2, ensure_ascii=False))

响应消息

执行成功返回

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