核心操作

Get Memory

该接口用于获取某个用户的记忆，包含事实记忆、偏好记忆与工具记忆。

POST
/
get
/
memory
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"
  }
headers = {
  "Content-Type": "application/json",
  "Authorization": f"Token {os.environ['MEMOS_API_KEY']}"
}
url = f"{os.environ['MEMOS_BASE_URL']}/get/memory"

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

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

{
  "code": 0,
  "data": {
    "memory_detail_list": [
      {
        "id": "<string>",
        "memory_key": "<string>",
        "memory_value": "<string>",
        "memory_type": "WorkingMemory",
        "create_time": "<string>",
        "conversation_id": "<string>",
        "status": "activated",
        "confidence": 0,
        "tags": [
          "<string>"
        ],
        "update_time": "<string>",
        "sources": [
          {}
        ],
        "info": {}
      }
    ],
    "preference_detail_list": [
      {
        "id": "<string>",
        "preference_type": "explicit_preference",
        "preference": "<string>",
        "reasoning": "<string>",
        "create_time": "<string>",
        "conversation_id": "<string>",
        "status": "activated",
        "update_time": "<string>",
        "sources": [
          {}
        ],
        "info": {}
      }
    ],
    "tool_memory_detail_list": [
      {
        "id": "<string>",
        "tool_type": "ToolTrajectoryMemory",
        "tool_value": "<string>",
        "tool_used_status": [
          {
            "used_tool": "<string>",
            "error_type": "<string>",
            "success_rate": 0,
            "tool_experience": "<string>"
          }
        ],
        "create_time": "<string>",
        "conversation_id": "<string>",
        "status": "activated",
        "update_time": "<string>",
        "experience": "<string>",
        "sources": [
          {}
        ],
        "info": {}
      }
    ],
    "total": 0,
    "size": 0,
    "current": 0,
    "pages": 0
  },
  "message": "<string>"
}

Authorizations

Authorization
string
header
required

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

请求体

application/json
user_id
string
required
获取的记忆所关联的用户唯一标识符。
page
number
default: 1
分页页码，用于在返回结果较多时进行分页控制。
size
number
default: 10
指定每一类记忆在当前页返回的条目数量，最大值为50。
filter
object
记忆过滤的条件，用于在获取记忆前精确限定记忆范围。可用字段包括："agent_id", "app_id", "create_time", "update_time"以及"info"中的字段。支持逻辑运算符（and，or）和比较运算符（gte、lte、gt、lt）。对于"info"字段，支持过滤传入的"business_type", "biz_id", "scene"和其他自定义字段。
Example:
"{"and": [{"create_time":{"gte":"..."}}]}"
include_preference
boolean
default: true
是否要返回偏好记忆。
include_tool_memory
boolean
default: true
是否要返回工具记忆。

响应体

application/json

Successful Response

code
number
required

接口状态码，更多内容可查阅错误码列表了解详情。

data
object
展示属性
message
string
required

接口提示信息。

Search Memory

Delete Memory