- 文档首页
记忆库 Mem0
用户指南
记忆检索
记忆检索能力概述
记忆检索能力概述
自 2026 年 07 月起,记忆库 Mem0 新实例采用全新架构,在已有向量检索的基础上,新增全文检索和混合检索能力,为您提供更灵活的检索方案选择。本文介绍相关功能及使用建议。
在长期记忆场景中,您可能需要从大量历史对话里快速定位某条具体信息,例如“Caroline 的生日是什么时候”或“John 的学位是什么”。全文检索正是为此而设计,它不依赖语义理解,直接通过关键词匹配,帮您精准找到包含特定词语的相关记忆。
为帮助您更好地理解全文检索的能力边界,下面将全文检索与向量检索、混合检索进行对比。
可以通过字段 search_mode 的取值来切换检索模式。支持的检索方式包括全文检索、向量检索以及混合检索。
- 混合检索:当 search_mode取值为 mix_vector_fts时,为混合检索模式。混合检索综合了向量检索和全文检索的优势,在大多数场景下表现更稳定,建议作为默认选项。混合检索的 rrf_k 默认值为 60。
- 全文检索:当 search_mode取值为 full_text时,为全文检索模式。全文检索适合问题中包含明确关键词的场景。如果您的问题比较概括,建议改用向量检索或混合检索。
- 向量检索:当 search_mode取值为 vector或不传入参数时,为向量检索模式。向量检索适合语义类问答场景,能够理解您的意图而非仅仅匹配文字。
以下 API 示例以调用混合检索模式为例。
注意
- 请将示例中的 {data_base_url} 替换为目标记忆项目的数据面服务地址;将 {project_id}替换为目标记忆的项目 ID;将 {api_key} 替换为可访问该项目的 API Key。
- Native HTTP API 使用 Authorization: Bearer {api_key},Mem0 HTTP API 使用 Authorization: Token {api_key}。
响应中的 data.items 为命中记忆,混合检索中 similarity_score 是 RRF (倒数排名融合)分数。
/v1/search/ 与 /v2/memories/search/ 为兼容入口,可使用相同请求体。响应使用 mem0 兼容结构,主要字段为 results[].id、results[].memory 与 results[].score。
说明
Native HTTP API 与 mem0 HTTP API 为两套独立入口,根据您的接入方式选择其一即可。
最近更新时间:2026.10.28 17:08:20