文档中心

记忆库 Mem0

记忆项目管理

CreateMemoryProject

调用 CreateMemoryProject 接口创建记忆项目。

请求类型

异步请求。

请求参数

RegionId String 必选示例值：cn-beijing

Mem0 记忆项目所在的地域 ID。

说明

更多关于记忆库 Mem0 支持的地域详情，请参见服务地址。

MemoryProjectType String 必选示例值：LongTermMemory

记忆项目类型。当前仅支持长期记忆（LongTermMemory）。

ChargeType String 必选示例值：PostPaid

计费类型。当前仅支持按量计费（PostPaid ）。

MemoryProjectName String 可选示例值：test_memory

Mem0 记忆项目的名称。名称需同时满足如下条件：

不能以数字、中划线（-）开头。

只能包含中文、字母、数字、下划线（_）和中划线（-）。

长度需为 1~128 个字符。

说明

若该参数留空，默认将记忆项目的 ID 作为记忆项目的名称。

Description String 可选示例值：test_memory

Mem0 记忆项目的备注信息，长度需为 0~200 个字符。

说明

若该参数留空，默认不为新建的记忆项目设置任何备注。

ProjectName String 可选示例值：default

Mem0 记忆项目所属的火山引擎项目资源名称。

说明

若该参数留空，新建 Mem0 记忆项目会加入默认（即default）资源项目。

资源项目是一个虚拟的概念，包括一组资源、用户和角色。通过资源项目可以对一组资源进行统一的查看和管理，并且控制资源项目内用户和角色对这些资源的权限。更多详情，请参见资源管理。

EnableVPC Boolean 可选示例值：true

是否为新建 Mem0 记忆项目开启 VPC 访问。取值范围：

true：开启。

false（默认值）：关闭。

VpcId String 可选示例值：vpc-rs5811nceqyov0x58x458x4

设置 Mem0 记忆项目的私有网络 ID。

说明

当开启 VPC 访问时（即 EnableVPC 为 true ）时，该参数必填。

建议 Mem0 记忆项目与需要连接的 ECS 实例在同一私有网络，否则它们无法通过内网互通来实现最佳性能。您可以调用 CreateVpc 接口创建私有网络。

您可以调用 DescribeVpcs 接口查询符合指定条件的私有网络信息，包括私有网络 ID。

SubnetId String 可选示例值：subnet-1g15j13jtzgu88ibuxwqp58x4

设置 Mem0 记忆项目的子网 ID。

说明

当开启 VPC 访问时（即 EnableVPC 为 true ）时，该参数必填。

子网具有可用区属性，必须选择目标私有网络中与 Mem0 记忆项目属于同一可用区下的子网。

子网是私有网络内的 IP 地址块私有网络中的所有云资源都必须部署在子网内，子网为云资源分配私网 IP 地址，您可以调用 CreateSubnet 接口创建子网。

您可以调用 DescribeSubnets 接口查询指定可用区内的所有子网列表信息，包括子网 ID。

LongTermMemoryStrategies Object[] 可选示例值：

设置长期记忆提取策略。

说明

需至少为 Mem0 记忆项目设置 1 个长期记忆提取策略。

一个记忆项目中最多可添加 50 个长期记忆提取策略。

关于策略类型的更多详情，请参见长期记忆提取策略。

Source String 可选示例值：System

策略来源。取值范围如下：

System：系统策略。

Custom：自定义策略。

StrategyType String 可选示例值：SummaryMemoryStrategy

策略类型。取值范围如下：

SummaryMemoryStrategy：总结类记忆。

UserPreferenceMemoryStrategy：用户偏好类记忆。

SemanticMemoryStrategy：语义类记忆。

StrategyName String 可选示例值：test_name

策略名称。名称需同时满足如下条件：

长度为 1~128 个字符。

只能包含中文、英文、数字、下划线（_）及中划线（-）。

说明

在同一记忆项目中，所有长期记忆提取策略（包括系统策略与用户自定义策略）的名称必须保持唯一，不可重复。

Prompt String 可选示例值：test_prompt

策略 Prompt，长度不可超过 2000 个字符。

说明

仅当策略来源为自定义策略（即 Source 为 Custom）时，该参数必填。

Description String 可选示例值：SummaryMemoryStrategy

策略备注信息。

说明

若该参数留空，默认使用策略类型（StrategyType）作为备注信息。

Tags Object[] 可选示例值：

需要绑定的标签键和标签值数组对象。

说明

若该参数留空，新建 Mem0 记忆项目默认不绑定任何标签。

Key String 可选示例值：department

需要绑定标签所对应的标签键。

说明

该参数留空表示新建 Mem0 记忆项目不绑定任何标签。当需要为 Mem0 记忆项目绑定标签时，标签键（Key）必填，标签值（Value）可不填，不填标签值表示对应标签键的标签值为空。

支持一次传入多组标签键值对象，多组标签键值对象间用英文逗号（,）分隔。最多同时传入 20 组标签键值对。

单个 Mem0 记忆项目最多可绑定 50 个标签。标签键需满足设置规则，具体规则请参见标签设置规则。

Value String 可选示例值：game

需要绑定标签所对应的标签值。

说明

当需要为 Mem0 记忆项目绑定标签时，标签键（Key）必填，标签值（Value）可不填，不填标签值表示对应标签键的标签值为空。

支持一次传入多组标签键值对象，多组标签键值对象间用英文逗号（,）分隔。最多同时传入 20 组标签键值对。

单个 Mem0 记忆项目最多可绑定 50 个标签。标签键需满足设置规则，具体规则请参见标签设置规则。

ClientToken String 可选示例值：WbiAlPqJM6tMoSOYhT****

用于保证请求的幂等性，防止重复提交请求。由客户端生成该参数值，要保证在不同请求间唯一，大小写敏感且不超过 127 个 ASCII 字符。

返回参数

OrderNO String 示例值：Order702856788643751****

订单号。

MemoryProjectId String 示例值：mp-cnlfclcu4qc2jck9a8p9758o8qk

Mem0 记忆项目的 ID。

错误码

更多详情，请参见错误码。

输入示例 1

输入示例

POST /?Action=CreateMemoryProject&Version=2025-10-10 HTTP/1.1
Host: mem0.cn-beijing.volcengineapi.com
Content-Type: application/json; charset=utf-8
X-Date: 20251008T104027Z
Authorization: HMAC-SHA256 Credential=AK****/20251008/cn-beijing/Mem0/request,SignedHeaders=content-type;host;x-date,Signature=****

{
    "MemoryProjectName": "test_memory",
    "LongTermMemoryStrategies": [
        {
            "Source": "System",
            "Description": "SummaryMemoryStrategy",
            "StrategyName": "test_name",
            "StrategyType": "SummaryMemoryStrategy"
        }
    ],
    "MemoryProjectType": "LongTermMemory",
    "Description": "test_memory",
    "ProjectName": "default",
    "RegionId": "cn-beijing",
    "ChargeType": "PostPaid",
    "EnableVPC": true,
    "VpcId": "vpc-rs5811nceqyov0x58x4****",
    "SubnetId": "subnet-1g15j13jtzgu88ibuxwqp****",
    "Tags": [
        {
            "Key": "department",
            "Value": "game"
        }
    ]
}

输出示例

{
    "ResponseMetadata": {
        "RequestId": "20230604110420****100232280022D31",
        "Action": "CreateMemoryProject",
        "Version": "2025-10-10",
        "Service": "mem0",
        "Region": "cn-beijing"
    },
    "Result": {
        "MemoryProjectId": "mp-cnlfclcu4qc2jck9a8p9758o8qk",
        "OrderNO": "Order702856788643751****"
    }
}

最近更新时间：2026.01.20 17:44:56

这个页面对您有帮助吗？

有用

无用