文档中心

向量数据库VikingDB

请输入

记忆库

创建记忆库-CreateCollection

接口概述

创建一个新的记忆库，用于存储和管理特定场景下的记忆数据。支持用户自定义记忆库存储的事件类型和画像类型，用于匹配具体业务场景下的数据建模需求。每个记忆库都拥有独立的记忆结构，如果业务场景中的记忆抽象不同，应创建新的记忆库。

请求接口

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

说明

API Explorer
您可以通过API Explorer在线发起调用，无需关注签名生成过程，快速获取调用结果。去调试

请求参数

说明

原entity概念已替换为profile，建议统一替换为profile，原entity相关参数仍然兼容支持。
"sys_profile_collect_v1"不再需要配置，配置"sys_profile_v1"时，平台会默认进行该事件的抽取与相关画像的更新。

参数名称	参数类型	是否必须	参数说明
CollectionName	String	是	记忆库的唯一名称。只能使用英文字母、数字、下划线，并以英文字母开头。
ProjectName	String	否	项目名称。默认为 default。
CpuQuota	Integer	否	选择旗舰版时必传。范围[1, 100]。不传则默认为1CU，即1核8G，可支撑100QPS和约400万条向量。CPU超额后将限流，内存超额后将自动扩容。
Description	String	否	记忆库的描述信息，最多 10000 个字符。
TtlRelative	Integer	否	事件记忆的过期时间，单位为秒。不传则默认永不过期。为保证记忆的完整性，建议不要设置过低的值。范围: (0, 315576000]
BuiltinEventTypes	Array	否	可选择内置提供的事件类型，可选值包括 "sys_event_v1"，会基于该内置模板生成自定义的事件类型。详细介绍见本节末尾。默认值为空。
BuiltinProfileTypes	Array	否	可选择内置提供的画像类型，可选值为 "sys_profile_v1"，会基于该内置模板生成自定义的画像类型。详细介绍见本节末尾。
CustomEventTypeSchemas	Array	否	根据业务需求自定义的事件类型列表。
CustomProfileTypeSchemas	Array	否	用户自定义的画像类型模式列表。
Tags	Array	否	标签，可用于资源管理和分账。

响应消息

参数名称	参数类型	参数说明
ResponseMetadata	Object	响应元数据信息。
Result	Object	实际业务数据。

示例代码

Python 代码

import json
import requests
from volcengine.base.Request import Request
from volcengine.Credentials import Credentials
from volcengine.auth.SignerV4 import SignerV4

AK = "your AK" 
SK = "your SK" 
Domain = "api-knowledgebase.mlp.cn-beijing.volces.com"

def prepare_request(method, path, ak, sk, data=None):
  r = Request()
  r.set_shema("https")
  r.set_method(method)
  r.set_host(Domain)
  r.set_path(path)

  if data is not None:
    r.set_body(json.dumps(data))
  credentials = Credentials(ak, sk, 'air', 'cn-north-1')
  SignerV4.sign(r, credentials)
  return r

def internal_request(method, api, payload, params=None):

  req = prepare_request(
                        method = method,
                        path = api,
                        ak = AK,
                        sk = SK,
                        data = payload)

  r = requests.request(method=req.method,
          url="{}://{}{}".format(req.schema, req.host, req.path),
          headers=req.headers,
          data=req.body,
          params=params,
      )
  return r
  
path = '/api/memory/collection/create'
payload = {
    'CollectionName': "my_first_memory_collection",
    'Description': "test description",
    'BuiltinEventTypes': ["sys_event_v1",],
    'BuiltinProfileTypes': ["sys_profile_v1"],
}
rsp = internal_request('POST', path, payload)
print(rsp.json())

附：模板Event和Profile说明

sys_event_v1

sys_event_v1.py

未知大小

捕获对话中的所有重要事件。

属性名	数据类型	描述
summary	string	基于字段内容编写的完整事实描述。

sys_profile_v1

sys_profile_v1.py

未知大小

基于原始对话更新的用户画像信息。

字段名	数据类型	描述
user_profile	string	用户画像字段分为基础信息和兴趣偏好两类。基础信息包含生日、性别、年龄等 11 项内容，兴趣偏好涵盖人物、文学等 15 个领域。

最近更新时间：2026.09.08 20:33:13

这个页面对您有帮助吗？

有用

无用

向量数据库VikingDB

Python 代码 #

sys_event_v1 #

sys_profile_v1 #

Python 代码

sys_event_v1

sys_profile_v1