自 2026 年 07 月起，记忆库 Mem0 新实例采用全新架构。基于该架构的图文记忆功能也已同步上线，可在对话中同时处理文本与图片，检索时一并返回记忆内容及关联图片。本文为您介绍图文记忆的相关功能。 # 功能介绍智能对话场景中，关键信息往往不只存在于文本里。您可能发送商品截图咨询购买建议，上传宠物照片询问养护事项，或分享旅行照片规划行程。这些图片承载了文字难以完整表达的信息。这些场景中的关键信息，都需要纳入长期记忆才能发挥持续价值。图文记忆服务正是为此而设计。其核心特性包括： * **图文混排输入**：在一次请求中同时提交文本与图片链接，系统自动解析内容结构，您无需额外预处理。 * **自动提取图文记忆**：系统将同一轮输入中的文本和图片联合理解，提取适合长期保存的记忆信息，而非将图片单独转成文字描述再处理。 * **图片作为附件保留**：图片链接随记忆一同存储。检索命中时，图片和文字一并返回，您可以直接使用。 * **两种图片关联方式**：通过 `extract_multimodal_attachments` 参数控制。 * **默认关联（** **`extract_multimodal_attachments=False`** **）** ：您一次提交多张图片时，系统将所有图片关联到本次对话产生的每条记忆上，不区分每条记忆具体对应哪张图片。因为无需系统额外判断图片与记忆的对应关系，此模式处理速度快，推荐大多数场景使用。 * **精细关联（** **`extract_multimodal_attachments=True`** **）** ：系统判断每条记忆对应的具体图片，每条记忆仅关联直接相关的图片。适用于需要明确图片来源（如商品截图与参数记忆绑定）的场景。开启后，系统仅返回本次输入中实际提供的图片，不会生成新的图片来源。

说明

默认关联将图片关联到整段对话记录，精细关联将图片关联到单条记忆。默认关联下，图片与记忆的关联效率更高、成功率也更高。使用时，建议将同一话题的多轮对话放在一起提交，关联效果会更好。

两种方式下，图片内容都会被系统理解并转成文字描述，存入记忆库，检索时通过文字匹配就能找到。图片原文件会作为附件保留，您可以根据返回的图片地址决定是否展示原图。

# 注意事项 * 只有通过对话或记录写入的图文内容，系统才会理解并关联图片。通过 SDK 直接新增单条记忆时，不会触发图文理解。 * 提交图文内容后，记忆生成有数秒延迟。 * 更新已有记忆时，系统会保留原有的图片附件。 # 使用示例以下示例展示了通过对话记录写入图文内容。提交时，图文内容通过 `content` 字段传递。`content` 可以是纯文本，也可以同时包含文本和图片。示例如下： ```JSON { "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`），让图片只关联到直接相关的记忆。如不需要精细关联，删除该参数即可使用默认关联方式。 Python SDK ```Python 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 字段 ``` Go SDK ```Go 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 ``` 如有疑问，请[提交工单](https://console.volcengine.com/workorder/create/)联系技术支持。