创建记忆库-CreateCollection--向量数据库VikingDB-火山引擎

文档中心

导航

创建记忆库-CreateCollection

最近更新时间：2025.11.12 16:58:44首次发布时间：2025.11.12 16:58:44

接口概述

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

请求接口

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

请求参数

说明

注：

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

参数名	类型	是否必须	描述
CollectionName	String	是	记忆库的唯一名称。只能使用英文字母、数字、下划线，并以英文字母开头。
ProjectName	String	否	项目名称。默认为 default。
CollectionType	String	否	记忆库的类型。默认为旗舰版。 standard：标准版记忆库，适用于小量级场景。最高支持2000万条向量和30QPS。标准版采用资源共享模式，价格更便宜。 ultimate：旗舰版记忆库，适用于大量级场景。向量条数和QPS不限。支持配置高额计算资源，性能更优。
CpuQuota	Integer	否	选择旗舰版时必传。范围[1, 100]。不传则默认为1CU，即1核8G，可支撑100QPS和约400万条向量。CPU超额后将限流，内存超额后将自动扩容。
Description	String	否	记忆库的描述信息，最多 10000 个字符。
BuiltinEventTypes	Array of String	否	可选择内置提供的事件类型，可选值包括 "sys_event_v1"，会基于该内置模板生成自定义的事件类型。详细介绍见本节末尾。默认值为空。
BuiltinProfileTypes	Array of String	否	可选择内置提供的画像类型，可选值为 "sys_profile_v1"，会基于该内置模板生成自定义的画像类型。详细介绍见本节末尾。
CustomEventTypeSchemas	Array of EventTypeSchema	否	根据业务需求自定义的事件类型列表。
EventType	String	是	事件类型的唯一名称，例如 "customer_feedback", "learning_progress"。
Description	String	是	事件类型的详细描述，最多 10000 个字符。
Properties	Array of EventProperty	是	构成此事件类型的属性列表。
-PropertyName	String	是	属性名称，例如 score, total_interactions。
-PropertyValueType	String	是	属性值的类型，可选值包括 ["int64", "list", "string", "list", "float32", "bool"]
-Description	String	是	属性的详细描述，最多 10000 个字符。
Version	String	否	事件模式版本号，默认为 "1"。
ValidationExpression	String	否	可选的校验表达式，用于验证事件内容的有效性，例如 "field_a == '1'"。
CustomProfileTypeSchemas	Array of ProfileTypeSchema	否	用户自定义的画像类型模式列表。
ProfileType	String	是	画像类型的唯一名称，例如 user_profile, product_summary。
Description	String	是	画像类型的详细描述，最多 10000 个字符。
Properties	Array of ProfileProperty	是	构成此画像类型的属性列表。
-PropertyName	String	是	属性名称，例如 user_id, total_interactions。
-PropertyValueType	String	是	属性值的类型，可选值包括 ["int64", "list", "string", "list", "float32", "bool"]
-Description	String	是	属性的详细描述，最多 10000 个字符。
-AggregateExpression	AggregateExpression	否	聚合表达式，定义此属性如何从关联的事件中聚合计算而来。
--Op	String	否	聚合操作符，例如 SUM、MAX、AVG、COUNT、LLM_MERGE。
--EventType	String	否	参与聚合的事件类型名称。
--EventPropertyName	String	否	参与聚合的事件类型中的属性名称。
-IsPrimaryKey	Boolean	否	是否为画像的主键。默认为 false。
Version	String	否	画像模式版本号，默认为 "1"。
Tags	Array of Tag	否	标签，可用于资源管理和分账。
Key	String	是	标签的键。
Value	String	是	标签的值。

响应消息

字段	类型	描述
ResponseMetadata	Object	响应元数据信息。
Action	String	操作类型。
Region	String	服务区域，例如"cn-beijing"。
RequestId	String	请求唯一标识符
Service	String	服务名称，如"knowledge_base_server"。
Version	String	API版本号。
Result	Object	实际业务数据。
ResourceId	String	创建成功的记忆库资源 ID。

示例代码

Python 代码

import volcenginesdkcore
import volcenginesdkvikingdb
from volcenginesdkcore.rest import ApiException
from volcenginesdkvikingdb import CreateCollectionForMemoryRequest, CreateCollectionForMemoryResponse
host="vikingdb.cn-beijing.volcengineapi.com"
# 全局设置
configuration = volcenginesdkcore.Configuration()
configuration.ak =  "your_ak"
configuration.sk = "your_sk"
configuration.debug = True
configuration.host = host
configuration.region = "cn-beijing"
configuration.scheme="https"
configuration.client_side_validation = True
volcenginesdkcore.Configuration.set_default(configuration)
api_instance = volcenginesdkvikingdb.VIKINGDBApi()
try:
    body = CreateCollectionForMemoryRequest(
        collection_name="my_first_memory_collection",
        description="test description",
        builtin_event_types=["sys_event_v1"],
        builtin_profile_types=["sys_profile_v1"]
    )
    res:CreateCollectionForMemoryResponse = api_instance.create_collection_for_memory(body)
    print(res.to_dict())
except ApiException as e:
    print(f"API异常: {e}")
    pass

附：模板Event和Profile说明

sys_event_v1

sys_event_v1.py

未知大小

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

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

sys_profile_v1

sys_profile_v1.py

未知大小

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

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