属性记忆

编辑属性记忆实例

编辑属性记忆实例，支持新增字段、更新字段值、删除字段、锁定字段不被算法自动更新。只影响当前实例，不修改模板也不影响其他实例。

POST

edit

profile

import os
import requests
import json

# 替换成你的 API Key
os.environ["MEMOS_API_KEY"] = "YOUR_API_KEY"
os.environ["MEMOS_BASE_URL"] = "https://memos.memtensor.cn/api/openmem/v1"

data = {
  "user_id": "memos_user_123",
  "profile_template_id": "tpl_user_001",
  "metadata": {
    "基础信息": {
      "居住地": {
        "value": "上海",
        "algorithm_updatable": False
      }
    }
  }
}
headers = {
  "Content-Type": "application/json",
  "Authorization": f"Token {os.environ['MEMOS_API_KEY']}"
}
url = f"{os.environ['MEMOS_BASE_URL']}/edit/profile"

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

print(f"result: {res.json()}")

# 请确保已安装 MemOS (pip install MemoryOS -U)
from memos.api.client import MemOSClient

client = MemOSClient(api_key="YOUR_API_KEY")

res = client.edit_profile(
    user_id="memos_user_123",
    profile_template_id="tpl_user_001",
    metadata={
        "基础信息": {
            "居住地": {
                "value": "上海",
                "algorithm_updatable": False
            }
        }
    }
)
print(f"result: {res}")

curl --request POST \
  --url https://memos.memtensor.cn/api/openmem/v1/edit/profile \
  --header 'Authorization: Token YOUR_API_KEY' \
  --header 'Content-Type: application/json' \
  --data '{
    "user_id": "memos_user_123",
    "profile_template_id": "tpl_user_001",
    "metadata": {
      "基础信息": {
        "居住地": {
          "value": "上海",
          "algorithm_updatable": false
        }
      }
    }
  }'

{
  "code": 0,
  "data": {
    "success": true
  },
  "message": "ok"
}

Authorizations

Authorization

string

header

required

Token API_key，可在 API 控制台>接口密钥中查看

请求体

application/json

user_id

string

用户 ID，与 agent_id 二选一。单视角项目必传。

agent_id

string

Agent ID，仅开启「为 Agent 创建独立记忆」时可用，与 user_id 二选一。

profile_template_id

string

required

目标属性记忆模板 ID。

metadata

object

要更新的字段。传入已有字段则更新值；传入新字段则添加到当前实例。

展示属性

remove_fields

string[]

要删除的字段路径列表，如 ["基础信息.职业"]。

响应体

application/json

Successful Response

code

number

required

接口状态码。

Example: 0

data

object

展示属性

message

string

required

接口提示信息。

Example: "ok"

import os
import requests
import json

# 替换成你的 API Key
os.environ["MEMOS_API_KEY"] = "YOUR_API_KEY"
os.environ["MEMOS_BASE_URL"] = "https://memos.memtensor.cn/api/openmem/v1"

data = {
  "user_id": "memos_user_123",
  "profile_template_id": "tpl_user_001",
  "metadata": {
    "基础信息": {
      "居住地": {
        "value": "上海",
        "algorithm_updatable": False
      }
    }
  }
}
headers = {
  "Content-Type": "application/json",
  "Authorization": f"Token {os.environ['MEMOS_API_KEY']}"
}
url = f"{os.environ['MEMOS_BASE_URL']}/edit/profile"

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

print(f"result: {res.json()}")

# 请确保已安装 MemOS (pip install MemoryOS -U)
from memos.api.client import MemOSClient

client = MemOSClient(api_key="YOUR_API_KEY")

res = client.edit_profile(
    user_id="memos_user_123",
    profile_template_id="tpl_user_001",
    metadata={
        "基础信息": {
            "居住地": {
                "value": "上海",
                "algorithm_updatable": False
            }
        }
    }
)
print(f"result: {res}")

curl --request POST \
  --url https://memos.memtensor.cn/api/openmem/v1/edit/profile \
  --header 'Authorization: Token YOUR_API_KEY' \
  --header 'Content-Type: application/json' \
  --data '{
    "user_id": "memos_user_123",
    "profile_template_id": "tpl_user_001",
    "metadata": {
      "基础信息": {
        "居住地": {
          "value": "上海",
          "algorithm_updatable": false
        }
      }
    }
  }'

{
  "code": 0,
  "data": {
    "success": true
  },
  "message": "ok"
}

Bind Profile Template

Delete Profile