文档中心

记忆库 Mem0

记忆管理

搜索记忆

POST https://<your_mem0_host>/v1/search/或POST https://<your_mem0_host>/v1/memories/search/

用于根据查询文本在记忆库中检索并返回最相关的记忆列表。本接口提供两个功能相同的路径，您可任选其一。

鉴权

本接口采用 API Key 鉴权。具体操作，请参见请求说明 - 鉴权。

请求参数

Body 参数

query String 必选示例值：北京出差有什么推荐的店？

待搜索的查询文本。

user_id String 可选示例值：user-12345

指定用户 ID，用于过滤搜索结果。

agent_id String 可选示例值：agent-001

指定智能体 ID，用于过滤搜索结果。

run_id String 可选示例值：run-abc123

指定运行 ID，用于过滤搜索结果。

top_k Integer 可选示例值：5

返回最相关的 top-k 条结果。取值范围为 1~1000。

enable_graph Boolean 可选示例值：false

是否在结果中返回关联的图谱信息，默认为 false。

filters Object[]可选示例值：{"source": "trip_planner_chat"}

元数据过滤条件，以键值对形式提供。当前仅支持时间范围（开始时间和结束时间）与策略两种过滤类型。

project_id String 可选示例值：prj_a1b2c3d4e5f67890

项目 ID。

说明

如果提供，将会与 API Key 所属的项目 ID 进行校验。

返回参数

results Array[MemoryItem]

返回的记忆项列表，按相关性得分从高到低排序。

id String 示例值：mem_0987654321fedcba

记忆 ID。

memory String 示例值：用户计划下周去北京出差，已为其推荐大董、四季民福和全聚德三家烤鸭店。

记忆内容。

hash String 示例值：xyz98765...

记忆内容哈希值。

metadata Object[] 示例值：{"source": "trip_planner_chat"}

记忆元数据。

created_at String 示例值：2026-01-07T10:00:00Z

创建时间，ISO 8601 格式。

updated_at String 示例值：2026-01-07T10:00:00Z

最后更新时间，ISO 8601 格式。

user_id String 示例值：user-12345

关联用户 ID。

agent_id String 示例值：agent-001

关联智能体 ID。

run_id String 示例值：run-abc123

关联运行 ID。

score Number 示例值：0.95

记忆与查询的相关性得分，值越高表示相关性越强。

relations Array[GraphItem]

记忆之间的关系图谱列表（如有）。当请求参数 enable_graph 为 true 时，返回关联的图谱信息。

source String 示例值：用户

关系图中源节点。

relationship String 示例值：计划前往

节点间的关系描述。

destination String 示例值：北京

关系图中目标节点。

错误码

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

输入示例 1

输入示例

curl -X POST 'https://<your_mem0_host>/v1/search/' \
-H 'Content-Type: application/json' \
-H 'Authorization: Token YOUR_PERSONAL_API_KEY' \
-d '{
  "query": "北京出差有什么推荐的店？",
  "user_id": "user-1xxxx",
  "top_k": 1
}'

输出示例

{
  "results": [
    {
      "id": "mem_0987654321fexxxx",
      "memory": "用户计划下周去北京出差，已为其推荐大董、四季民福和全聚德三家烤鸭店。",
      "hash": "xyz98765...",
      "metadata": {
        "source": "trip_planner_chat"
      },
      "score": 0.95,
      "created_at": "2026-01-07T10:05:00Z",
      "updated_at": "2026-01-07T10:05:00Z",
      "user_id": "user-1xxxx",
      "agent_id": null,
      "run_id": null
    }
  ],
  "relations": []
}

最近更新时间：2026.08.04 14:48:25

这个页面对您有帮助吗？

有用

无用