Mem0 教程:AI Flowi Workflow 聊天记忆配置

Mem0 教程介绍 AI Flowi Workflow 为基于 Mem0 的对话提供的 Mem0 Chat Memory,用于检索和存储聊天消息。其接口将传入消息、搜索查询和用户标识符分开,并同时返回 Memory 对象和 JSON 搜索结果。

拟议写入与检索试验中的 Mem0 Chat Memory、Chat Input 和 Chat Output 已在组件目录中记录;Ai Flowi 尚未进行生产环境测试。本页依据 2026 年 10 月 9 日导出的 1.9.2 版本组件目录,其中的 Mem0 条目将其描述为使用 Mem0 记忆存储检索和保存聊天消息。

Mem0 Chat Memory 的全部八个输入

在小屏幕上,可横向滚动 Mem0 字段表,查看连接类型和配置说明。

Mem0 Chat Memory 字段参考
输入字段类型必填连接类型配置边界
existing_memoryother可选Memory已有的 Memory 连接;未提供合并或替换规则。
ingest_messagestr可选Message用于写入的 Message 输入;未记录重复内容的处理方式。
mem0_api_keystr可选空列表Mem0 凭据字段;需确定所选后端的身份验证要求。
mem0_configNestedDict可选Data, JSON接受 Data 或 JSON 的 NestedDict 配置;缺少键结构说明。
metadatadict可选未指定字典字段;未定义筛选语法或访问控制含义。
openai_api_keystr可选空列表单独命名的模型凭据;是否需要取决于有待核实的配置。
search_querystr可选Message兼容 Message 的查询输入;未导出排序和匹配规则。
user_idstr可选Message兼容 Message 的用户标识符;未描述授权规则。

全部八个 Mem0 输入的验证标记均为“可选”;这既不提供默认身份,也不意味着可以免身份验证。“空列表”表示连接元数据明确为空;“未指定”表示缺少可接受类型属性。两者都不能说明任意连接值均可使用。

写入消息与搜索查询各有用途

ingest_message 和 search_query 的字段类型均为 str,且都接受 Message 连接。应有意识地区分待存储的内容和用于检索的问题。不能因为两个字段接受相同连接类型,就误将问题存为记忆条目。

导出数据没有独立的操作选择器,也未说明两个输入均有值时,写入与搜索的执行顺序。设计“保存后立即回忆”的路径前,先检查此行为。重复提交写入请求也需要检查重复数据;接口没有提供幂等性约定。

用户身份、元数据与嵌套配置

user_id 是指定的身份输入,而 metadata 是字典。应从应用的身份记录中赋值给 user_id;生成文本不适合用来决定检索谁的 Mem0 记录。导出的字符串/Message 约定未说明如何对该标识符进行授权检查。除非经验证的后端约定赋予元数据标签筛选或权限作用,否则它应仅作为描述性值。

mem0_config 使用 NestedDict,接受 Data 和 JSON 连接。其嵌套键、存储选项和筛选表示法均未指定。填写此字段前,先获取 Mem0 服务支持的配置结构;即使对象看起来合理,也可能包含节点无法解释的键。

existing_memory 接受 Memory,与配置 JSON 和搜索结果 JSON 均不同。字段名暗示可提供已有的记忆对象,但未说明该对象与其他字段之间的优先级。首次写入/搜索试验应单独处理这一区别,不要引入该连接。

相关内容:Zep 记忆管理:AI Flowi Workflow 集成。

Memory 与搜索结果是不同的输出

Mem0 原生输出与独立连接器条目
条目输出接口明确的内容
Mem0 Chat Memorymemory / Mem0 Memory / Memory可复用的记忆句柄;请选择类型为 Memory 的接收端口。
Mem0 Chat Memorysearch_results / Search Results / JSON需检查的 JSON 结果;未导出记录结构。
Composio 中的 Mem0dataFrame / Table / Table独立的连接器约定,不能替代 Memory 端口。

原生组件标识符为 mem0.mem0_chat_memory。组件目录还列出 composio.ComposioMem0APIComponent,显示名称为 Mem0,具有必填的 api_key、空的 action_button 选项列表,以及 Table 输出。其描述为空。本页的存储与检索示例使用原生组件;独立条目未记录可用的 Mem0 操作。

如果需要使用外部记忆的组件,Message History 记录了兼容 Memory 的输入。其模式和消息输出请参考该文档。不要仅因 memory 表示对话信息,就将其直接发送到要求 JSON 或 Message 的显示字段。

凭据与范围明确的起点

通过凭据机制指南提供自己的 Mem0 账户 API 凭据;若配置选择使用 OpenAI,也需提供自己的 OpenAI 账户凭据。各提供商分别计费。

为 Mem0 检查准备一个虚构用户标识符和一条简短的虚构偏好。不要将凭据值放进这些消息。独立的 mem0_api_key 和 openai_api_key 字段表示两个凭据位置,并不保证两者都必填,也不保证所选后端可以省略其中任何一个。

分别检查写入与检索试验

示例配置,并非已记录的测试

  1. 在 Chat Input 的 input_value 中填入“虚构的工作区标签是 Cedar。”将其 message 输出连接到 Mem0 Chat Memory 的 ingest_message;该连接传递待存储的陈述。
  2. 将 Mem0 Chat Memory 的 user_id 设为 synthetic-cedar-user,使用自己的凭据配置 mem0_api_key,且只提供服务支持的 mem0_config。仅当所选配置需要时,才添加 openai_api_key。首次检查时,保持 existing_memory 未连接。
  3. 检查一次写入试验,并使用服务提供的检查方法核实已存储的虚构条目。返回 Memory 对象不等于证明那句话已被保存。
  4. 检索时,移除写入连接。通过 input_value 向 Chat Input 提供问题“虚构的工作区标签是什么?”,再将其 message 输出连接到 Mem0 的 search_query。保留已审查的身份和后端设置,使这次试验只改变所请求的操作。
  5. 若要显示 JSON,使用 Chat Output,将其 input_value 连接到 Mem0 的 search_results。在后续提示中加入检索内容前,先将返回内容与已存储的 Cedar 陈述比较。

预期检查产物是搜索输出实际返回的 JSON,其中任何匹配内容都应人工审查。本页不编造记录、分数、记忆标识符或成功响应。空结果、意外内容和服务调用失败需要在试验记录中分别注明。

在来源笔记中保留虚构标签的原始拼写。如果返回 JSON 使用了不同表述,应区分这是表示方式变化,还是存储了不同偏好;没有公布的结果结构,就不能假定哪个 JSON 成员包含来源文本。如果无法识别检索内容,应暂停组装提示,不要将整个响应都视为偏好内容传入。

复用前,先确认 Mem0 配置的优先级

共享的访问范围检查见智能体记忆隔离练习。

假设后续流程从前一个节点提供 existing_memory,同时又填入 mem0_config。哪个对象决定写入和搜索使用的后端?导出数据没有回答这一问题。引入 Memory 连接前,先保留可用配置及实际观察到的搜索响应作为基线。添加该连接后,检查实际服务目标;仅凭 JSON 内容相同,无法确定是哪一个后端提供了结果。如果无法确定优先级,应保持两套配置独立,不要将它们混合到一个无法解释存储目标的流程中。

将身份、查询和配置与实际观察到的 JSON 一并记录。如果配置变化后结果不同,应先检查该变化,不要直接归因于记忆学习。组件目录没有为此节点提供持久学习声明、搜索结果结构、保留期限或删除操作。

何时应选择比 Mem0 更简单的记忆路径?

当需求涉及 Mem0 特有的写入、用户、搜索或配置约定时,使用 Mem0 Chat Memory。如果仅需 Message History 已有文档覆盖的存储消息模式,应先参考该文档。智能体记忆术语页解释更广泛的概念;本集成页说明原生 Mem0 字段和两种输出类型。

不要假定该配置提供图查询、删除控制或已证实的保留策略,再据此选择它。这些能力并未由导出接口确立。浏览集成中心了解其他已有文档的连接分类。

作者:Ai Flowi · 发布于

工作流用量

套餐:Go 年付方案每月 USD8 起(月付 USD10),Plus 年付方案每月 USD16 起(月付 USD20),Pro 100 年付方案每月 USD80 起(月付 USD100),Pro 200 年付方案每月 USD160 起(月付 USD200),Pro 500 年付方案每月 USD400 起(月付 USD500),每月包含 5,000 至 250,000 个 Flowi Tokens,并支持充值;每次节点运行消耗 1 个 token;不包含第三方 API 和模型使用费用。