PolarDB 长期记忆Mem0

添加记忆

curl -X POST http://my-endpoint:8080/v1/memories \
  -H "Content-Type: application/json" \
  -H "Authorization: Token <your-api-key>" \
  -d '{
        "messages": [
            {
              "role": "user",
              "content": "我喜欢吃辣，特别是川菜。"
            },
            {
              "role": "assistant",
              "content": "好的，已经记下您的口味偏好。"
            }
        ],
        "user_id": "user_002",
        "agent_id": "food-assistant",
        "run_id": "user_002_run_id",
        "metadata": {
            "additionalProp1": {}
        }
    }'

预期返回结果：

{
    "results": [
        {
            "id": "32155c0a-xxxx-xxxx-xxxx-804e119bb965",
            "event": "ADD",
            "data": {
                "memory": "喜欢吃辣"
            }
        },
        {
            "id": "9188deee-xxxx-xxxx-xxxx-3073ef826b42",
            "event": "ADD",
            "data": {
                "memory": "特别喜欢川菜"
            }
        }
    ]
}

搜索记忆

curl -X POST http://my-endpoint:8080/v2/memories/search \
  -H "Content-Type: application/json" \
  -H "Authorization: Token <your-api-key>" \
  -d '{
        "query": "我喜欢什么菜",
        "agent_id": "food-assistant",
        "filters": {
            "user_id": "user_002",
            "run_id": "user_002_run_id",
            "additionalProp1": {}
        }
    }'

预期返回结果：

{
    "results": [
        {
            "id": "9188deee-xxxx-xxxx-xxxx-3073ef826b42",
            "memory": "特别喜欢川菜",
            "hash": "a826fbf3c3844024633e84d04875ee45",
            "metadata": {
                "additionalProp1": {

                }
            },
            "score": 0.681654033365126,
            "created_at": "2026-03-05T23:59:36.038217-08:00",
            "updated_at": null,
            "user_id": "user_002",
            "agent_id": "food-assistant",
            "run_id": "user_002_run_id"
        },
        {
            "id": "32155c0a-xxxx-xxxx-xxxx-804e119bb965",
            "memory": "喜欢吃辣",
            "hash": "b2882aaf96654a9e16f45f363022010a",
            "metadata": {
                "additionalProp1": {

                }
            },
            "score": 0.582298149788604,
            "created_at": "2026-03-05T23:59:36.023417-08:00",
            "updated_at": null,
            "user_id": "user_002",
            "agent_id": "food-assistant",
            "run_id": "user_002_run_id"
        }
    ]
}

获取记忆

  curl -X POST http://my-endpoint:8080/v2/memories \
  -H "Content-Type: application/json" \
  -H "Authorization: Token <your-api-key>" \
  -d '{
        "filters": {
            "user_id": "user_002",
            "run_id": "user_002_run_id",
            "agent_id": "food-assistant"
        }
    }'

预期返回结果：

{
    "results": [
        {
            "id": "39b06e97-xxxx-xxx-xxxx-4223818bc04e",
            "memory": "喜欢吃辣",
            "hash": "b2882aaf96654a9e16f45f363022010a",
            "metadata": {
                "additionalProp1": {

                }
            },
            "created_at": "2026-03-06T00:12:45.109789-08:00",
            "updated_at": null,
            "user_id": "user_002",
            "agent_id": "food-assistant",
            "run_id": "user_002_run_id"
        },
        {
            "id": "482def46-xxxx-xxxx-xxxx-ff4886a1047c",
            "memory": "特别喜欢川菜",
            "hash": "a826fbf3c3844024633e84d04875ee45",
            "metadata": {
                "additionalProp1": {

                }
            },
            "created_at": "2026-03-06T00:12:45.121585-08:00",
            "updated_at": null,
            "user_id": "user_002",
            "agent_id": "food-assistant",
            "run_id": "user_002_run_id"
        }
    ]
}

创建记忆（Create Memories）

存储新的记忆。服务会自动对messages内容进行分析，生成会话摘要和语义记忆。

• 请求地址：POST /v1/memories

• 请求体：

  messages array（必选） 对话消息列表，遵循OpenAI格式。 属性 role String（必选） 消息发送者角色，如user或assistant。 content String（必选） 消息内容。	curl curl -X POST http://my-endpoint:8080/v1/memories \ -H "Content-Type: application/json" \ -H "Authorization: Token <your-api-key>" \ -d '{ "messages": [ { "role": "user", "content": "我喜欢吃辣，特别是川菜。" }, { "role": "assistant", "content": "好的，已经记下您的口味偏好。" } ], "user_id": "user_002", "agent_id": "food-assistant", "run_id": "user_002_run_id", "metadata": { "additionalProp1": {} } }' Python import requests import json payload = { "messages": [ {"role": "user", "content": "我喜欢吃辣，特别是川菜。"}, {"role": "assistant", "content": "好的，已经记下您的口味偏好。"} ], "user_id": "user-002", "agent_id": "food-assistant", "run_id": "user_002_run_id" } response = requests.post( "http://<your-endpoint>:8080/v1/memories", headers={"Authorization": "Token <your-api-key>", "Content-Type": "application/json"}, data=json.dumps(payload) ) print(response.json())
  user_id String（必选） 用户的唯一标识符。
  agent_id String（可选） 智能体的唯一标识符，用于在同一用户下隔离不同应用的记忆。
  run_id String（可选） 单次执行或会话的唯一标识符。
  metadata Object（可选） 附加的元数据，会与记忆一同存储。

搜索记忆（Search Memories）

根据查询字符串，搜索最相关的记忆。

• 请求地址：POST /v2/memories/search

• 请求体：

  query String（必选） 用于搜索的查询文本，例如用户的新问题。	curl curl -X POST http://my-endpoint:8080/v2/memories/search \ -H "Content-Type: application/json" \ -H "Authorization: Token <your-api-key>" \ -d '{ "query": "我喜欢什么菜", "agent_id": "food-assistant", "filters": { "user_id": "user_002", "run_id": "user_002_run_id", "additionalProp1": {} } }' Python import requests import json payload = { "query": "我喜欢什么菜", "agent_id": "food-assistant", "filters": { "user_id": "user_002", "run_id": "user_002_run_id" } } response = requests.post( "http://<your-endpoint>:8080/v2/memories/search", headers={"Authorization": "Token <your-api-key>", "Content-Type": "application/json"}, data=json.dumps(payload) ) print(json.dumps(response.json(), indent=2, ensure_ascii=False))
  agent_id String（可选） 限定在指定智能体下搜索。
  filters String（必选） 基于元数据的过滤条件。 属性 user_id String（必选） 用户的唯一标识符。 run_id String（可选） 限定在指定会话下搜索。

获取记忆（Get Memories）

获取指定范围内的所有原始记忆。

• 请求地址：POST /v2/memories

• 请求体：

  filters String（必选） 基于元数据的过滤条件。 属性 user_id String（必选） 用户的唯一标识符。 agent_id String（可选） 限定获取指定智能体的记忆。 run_id String（可选） 限定在指定会话下搜索。

  curl curl -X POST http://my-endpoint:8080/v2/memories \ -H "Content-Type: application/json" \ -H "Authorization: Token <your-api-key>" \ -d '{ "filters": { "user_id": "user_002", "run_id": "user_002_run_id", "agent_id": "food-assistant" } }' Python import requests import json payload = { "filters": { "user_id": "user_002", "run_id": "user_002_run_id", "agent_id": "food-assistant", } } response = requests.post( "http://<your-endpoint>:8080/v2/memories", headers={"Authorization": "Token <your-api-key>", "Content-Type": "application/json"}, data=json.dumps(payload) ) print(json.dumps(response.json(), indent=2, ensure_ascii=False))

删除记忆（Delete Memories）

删除指定范围内的所有记忆。

• 请求地址：DELETE /v1/memories

• 请求体：

  user_id String（必选） 用户的唯一标识符。	curl curl -X DELETE 'http://<your-endpoint>:8080/v1/memories?user_id=user_002&agent_id=food-assistant' \ -H 'accept: application/json' \ -H 'Authorization: Token <your-api-key>' Python import requests import json # 限制搜索范围 current_user_id = "user_002" current_agent_id = "food-assistant" # 准备API请求的URL和数据 api_url = f"http://<your-endpoint>:8080/v1/memories?user_id={current_user_id}&agent_id={current_agent_id}" response = requests.delete( api_url, headers={"Authorization": "Token <your-api-key>"}, ) print(json.dumps(response.json(), indent=2, ensure_ascii=False))
  agent_id String（可选） 如果提供，则仅删除该智能体的记忆。
  run_id String（可选） 如果提供，则仅删除该会话的记忆。