记忆库 Mem0
记忆库 Mem0
文档指南
请输入
- 文档首页
记忆库 Mem0用户指南高级特性图文记忆概述
复制全文
下载 pdf图文记忆概述
文档反馈
问问助手自 2026 年 07 月起，记忆库 Mem0 新实例采用全新架构。基于该架构的图文记忆功能也已同步上线，可在对话中同时处理文本与图片，检索时一并返回记忆内容及关联图片。本文为您介绍图文记忆的相关功能。
功能介绍
智能对话场景中，关键信息往往不只存在于文本里。您可能发送商品截图咨询购买建议，上传宠物照片询问养护事项，或分享旅行照片规划行程。这些图片承载了文字难以完整表达的信息。
这些场景中的关键信息，都需要纳入长期记忆才能发挥持续价值。图文记忆服务正是为此而设计。
其核心特性包括：
- 图文混排输入：在一次请求中同时提交文本与图片链接，系统自动解析内容结构，您无需额外预处理。
- 自动提取图文记忆：系统将同一轮输入中的文本和图片联合理解，提取适合长期保存的记忆信息，而非将图片单独转成文字描述再处理。
- 图片作为附件保留：图片链接随记忆一同存储。检索命中时，图片和文字一并返回，您可以直接使用。
- 两种图片关联方式：
- 通过 extract_multimodal_attachments 参数控制。
- 默认关联（extract_multimodal_attachments=False）：您一次提交多张图片时，系统将所有图片关联到本次对话产生的每条记忆上，不区分每条记忆具体对应哪张图片。因为无需系统额外判断图片与记忆的对应关系，此模式处理速度快，推荐大多数场景使用。
- 精细关联（extract_multimodal_attachments=True）：系统判断每条记忆对应的具体图片，每条记忆仅关联直接相关的图片。适用于需要明确图片来源（如商品截图与参数记忆绑定）的场景。开启后，系统仅返回本次输入中实际提供的图片，不会生成新的图片来源。
说明
- 默认关联将图片关联到整段对话记录，精细关联将图片关联到单条记忆。默认关联下，图片与记忆的关联效率更高、成功率也更高。使用时，建议将同一话题的多轮对话放在一起提交，关联效果会更好。
- 两种方式下，图片内容都会被系统理解并转成文字描述，存入记忆库，检索时通过文字匹配就能找到。图片原文件会作为附件保留，您可以根据返回的图片地址决定是否展示原图。
注意事项
- 只有通过对话或记录写入的图文内容，系统才会理解并关联图片。通过 SDK 直接新增单条记忆时，不会触发图文理解。
- 提交图文内容后，记忆生成有数秒延迟。
- 更新已有记忆时，系统会保留原有的图片附件。
使用示例
以下示例展示了通过对话记录写入图文内容。
提交时，图文内容通过 content 字段传递。content 可以是纯文本，也可以同时包含文本和图片。示例如下：
{
"role": "user",
"content": [
{"type": "text", "text": "这是我家的猫，叫小橘"},
{"type": "image_url", "image_url": {"url": "https://example.com/cat.jpg"}}
]
}
了解提交格式后，我们来看具体的调用代码。目前支持 Python SDK 和 Go SDK，以下示例中开启了精细关联（extract_multimodal_attachments=True），让图片只关联到直接相关的记忆。如不需要精细关联，删除该参数即可使用默认关联方式。
client.add(
messages=[
{
"role": "user",
"content": [
{"type": "text", "text": "这是我家的猫，叫小橘"},
{"type": "image_url", "image_url": {"url": "https://example.com/cat.jpg"}},
],
},
],
user_id="u_123",
extract_multimodal_attachments=True,
)
results = client.search(query="我的猫", user_id="u_123")
# results 中每条记忆携带 multimodal_attachments 字段
extract := true
req := MemoryCreate{
UserId: &userID,
ExtractMultimodalAttachments: &extract,
Messages: []Message{{
Role: "user",
Content: []MessageContentPart{
{Type: "text", Text: strPtr("这是我家的猫，叫小橘")},
{Type: "image_url", ImageUrl: &MessageImageURL{Url: "https://example.com/cat.jpg"}},
},
}},
}
// 通过写入记忆接口发送 req，检索结果中的每条 memory 会带回 MultimodalAttachment
最近更新时间：2026.07.10 19:00:56
这个页面对您有帮助吗？
有用
有用
无用
无用