文档中心

向量数据库VikingDB

请输入

事件记忆

添加事件记忆-AddEvent

概述

用于添加事件记忆。

请求接口

URL	/api/memory/event/add	统一资源标识符
请求方法	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作为记忆库的唯一标识。
event_type	String	是	事件类型。
memory_info	Object	是	事件记忆的内容。对于内置事件sys_event_v1，只有summary；对于自定义事件，按照自定义的属性字段展示。需要注意的是，其格式必须遵循在记忆库中已定义的格式。
time	Integer	否	记忆生成的时间戳（毫秒）。不传将以请求时间作为记忆生成时间。
update_profiles	Array of Object	否	需要更新的画像信息列表。
user_id	String	否	事件关联的用户ID。和assistant_id至少填写一个。
assistant_id	String	否	事件关联的助手ID。和user_id至少填写一个。
group_id	String	否	群组ID。用于隔离不同的会话或场景。
ttl_absolute	Integer	否	事件记忆的过期时间，绝对时间，填写时间戳，精确到毫秒级。相对时间和绝对时间填写其一即可。都填写时，取绝对时间；都不填写时，取记忆库的过期配置。 • 限制: ttl_absolute - metadata.time ∈ (0, 315576000 * 1000] • 限制: 如果messages中的time不为空，ttl_absolute - message.time ∈ (0, 315576000 * 1000]
ttl_relative	Integer	否	事件记忆的过期时间，相对时间，单位为秒。限制: (0, 315576000]

响应消息

参数	类型	参数说明
code	Integer	状态码，0表示成功，其他表示错误。
message	String	返回信息，成功时通常为 "success"。
data	Object	返回的详细数据。
usage	Object	事件记忆写入消耗的token。
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/add"

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

data = {
    "collection_name": "my_first_memory_collection",
    "event_type": "sys_event_v1",
    "memory_info": {
        "summary": "小明向助手分享了今年校庆打算和朋友回校重走校园路线、重温美食的计划，还提及朋友曾送的小夜灯，两人回忆起大学室友情。助手提议帮小明整理回忆成一篇名为《403的黄光》的小文送给阿强，小明表示同意并打算拍摄龟背竹新叶续写。最后，两人约定等小明整理好照片后一起把403时间线做成一张长图。"
    },
    "user_id": "user001"
}

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

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

响应消息

执行成功返回

{
     'code': 0, 
     'data': {
         'event_id': 'xxxxxxxxxfc4461e36a16_0', 
         'event_type': 'sys_event_v1', 
         'memory_info': {'summary': '小明向助手分享了今年校庆打算和朋友回校重走校园路线、重温美食的计划，还提及朋友曾送的小夜灯，两人回忆起大学室友情。助手提议帮小明整理回忆成一篇名为《403的黄光》的小文送给阿强，小明表示同意并打算拍摄龟背竹新叶续写。最后，两人约定等小明整理好照片后一起把“403时间线”做成一张长图。'}, 
         'usage': {
         'embedding_tokens': 226
         }
     }, 
     'message': 'success', 
     'request_id': 'xxxxxxxxxxf73ed50'
 }

最近更新时间：2026.07.02 17:09:15

这个页面对您有帮助吗？

有用

无用

向量数据库VikingDB

请求消息 #

Python请求 #

响应消息 #

执行成功返回 #

请求消息

Python请求

响应消息

执行成功返回