Zep 向量存储节点#
已弃用 此节点已被弃用,将在未来版本中移除。
使用 Zep 向量存储节点与 Zep 向量数据库进行交互。你可以将文档插入向量数据库、从向量数据库获取文档、检索文档以提供给连接到 链(chain) 的检索器(retriever),或直接将其连接到一个 智能体(agent),作为 工具(tool) 使用。
在本页面中,你将找到 Zep 向量存储节点的参数说明以及相关资源链接。
凭据
有关此节点的身份验证信息,请参阅 此处。
示例和模板
如需使用示例和模板帮助你快速上手,请参考 n8n 的 Zep 向量存储集成页面。
子节点中的参数解析#
当使用表达式处理多个数据项时,子节点(sub-nodes)的行为与其他节点不同。
大多数节点(包括根节点)可以接收任意数量的数据项作为输入,逐个处理这些项,并输出结果。你可以使用表达式引用输入项,节点会依次为每个输入项解析该表达式。例如,若有五个 name 值作为输入,表达式 {{ $json.name }} 会依次解析为每一个名字。
而在子节点中,表达式始终解析为第一个输入项。例如,在同样有五个 name 值输入的情况下,表达式 {{ $json.name }} 始终指向第一个名字。
节点使用模式#
你可以通过以下几种方式使用 Zep 向量存储节点。
作为普通节点插入、更新和检索文档#
你可以将 Zep 向量存储作为普通节点来插入或获取文档。这种模式下,Zep 向量存储节点处于常规连接流程中,不涉及智能体(agent)的使用。
你可以在 此模板 的场景 1 中看到一个示例(该示例使用 Supabase,但使用模式相同)。
直接作为工具连接到 AI 智能体#
你可以将 Zep 向量存储节点直接连接到 AI 智能体 的工具连接器(tools connector),以便在回答查询时利用向量存储作为资源。
此时的连接路径为:AI 智能体(工具连接器) → Zep 向量存储节点。
使用检索器获取文档#
你可以将 向量存储检索器(Vector Store Retriever) 节点与 Zep 向量存储节点结合使用,从后者中提取文档。这种方式通常与 问答链(Question and Answer Chain) 节点配合使用,用于从向量存储中检索与当前聊天输入相匹配的文档。
一个连接流程示例(该示例使用 Pinecone,但模式相同)如下所示: 问答链(检索器连接器) → 向量存储检索器(向量存储连接器) → Zep 向量存储。
使用向量存储问答工具回答问题#
另一种模式是使用 向量存储问答工具(Vector Store Question Answer Tool) 来总结结果并回答来自 Zep 向量存储节点的问题。与直接将 Zep 向量存储作为工具不同,此模式使用专门设计用于汇总向量存储中数据的工具。
连接流程示例(该示例使用 Supabase,但模式相同)如下所示: AI 智能体(工具连接器) → 向量存储问答工具(向量存储连接器) → Zep 向量存储。
节点参数#
操作模式#
该向量存储节点包含四种模式:Get Many、Insert Documents、Retrieve Documents (As Vector Store for Chain/Tool) 和 Retrieve Documents (As Tool for AI Agent)。所选模式决定了节点可执行的操作以及可用的输入和输出选项。
Get Many#
在此模式下,你可以通过提供提示词(prompt)从向量数据库中检索多个文档。系统会将提示词嵌入(embed),并基于相似性进行搜索。节点返回与提示最相似的文档及其相似度得分。当你希望获取一组相似文档并将其作为附加上下文传递给智能体时,此功能非常有用。
Insert Documents#
使用“插入文档”模式可将新文档插入你的向量数据库。
Retrieve Documents (as Vector Store for Chain/Tool)#
使用“检索文档(作为链/工具的向量存储)”模式,配合向量存储检索器(retriever),从向量数据库中检索文档,并提供给连接至链(chain)的检索器。在此模式下,必须将该节点连接到一个检索器节点或根节点。
Retrieve Documents (as Tool for AI Agent)#
使用“检索文档(作为 AI 智能体的工具)”模式,可在回答查询时将向量存储作为工具资源使用。当智能体生成回复时,若问题内容与向量存储的名称和描述匹配,则会调用该向量存储。
重新排序结果(Rerank Results)#
启用 重新排序(reranking) 功能。启用此选项后,必须将一个重新排序节点连接到向量存储节点,该节点会对查询结果进行重新排序。此功能可用于 Get Many、Retrieve Documents (As Vector Store for Chain/Tool) 和 Retrieve Documents (As Tool for AI Agent) 三种模式。
插入文档参数#
- 集合名称(Collection Name):输入用于存储数据的集合名称。
获取多个参数#
- Collection Name(集合名称) : 输入要从中检索数据的集合名称。
- Prompt(提示) : 输入搜索查询内容。
- Limit(限制) : 设置从向量数据库中检索的结果数量。例如,设置为
10可获取最相关的十条结果。
检索文档(作为链/工具的向量存储)参数#
- Collection Name(集合名称) : 输入要从中检索数据的集合名称。
检索文档(作为 AI Agent 的工具)参数#
- Name(名称) : 向量存储的名称。
- Description(描述) : 向大语言模型(LLM)说明此工具的功能。清晰且具体的描述有助于 LLM 更频繁地生成符合预期的结果。
- Collection Name(集合名称) : 输入要从中检索数据的集合名称。
- Limit(限制) : 设置从向量数据库中检索的结果数量。例如,设置为
10可获取最相关的十条结果。
节点选项#
嵌入维度(Embedding Dimensions)#
在嵌入数据和查询数据时,该值必须保持一致。 它用于设置表示文本语义意义的浮点数数组的大小。
是否自动嵌入(Is Auto Embedded)#
在 插入文档(Insert Documents) 操作模式下可用,默认启用。 禁用此选项后,您可以在 Zep 中配置嵌入(embeddings),而不是在 n8n 中进行配置。
元数据过滤器(Metadata Filter)#
在 获取多个(Get Many) 模式下可用。搜索数据时,使用此选项匹配与文档关联的元数据。
这是一个 AND 查询:如果指定了多个元数据过滤字段,则所有条件都必须匹配。
插入数据时,元数据由文档加载器(document loader)设置。有关文档加载的更多信息,请参考 默认数据加载器(Default Data Loader)。
模板与示例#
浏览 Zep 向量存储集成模板,或 搜索所有模板
相关资源#
更多服务信息,请参考 LangChain 的 Zep 文档。 查看 n8n 的 高级 AI(Advanced AI) 文档。