文章开头
想让你的AI助手读懂业务数据,比如MES系统日志吗?但又不想碰复杂的代码?
本教程将手把手带你完成 N8N 与 Weaviate 向量数据库的连接配置。
你只需要跟着步骤操作,就能为你的AI Agent打造一个专属知识库,轻松实现RAG检索增强,大幅提升工作效率。
配置目的
我们的目标很简单:为AI建立一个“外部大脑”(向量数据库)。
我们会将处理好的业务日志数据,喂给这个“大脑”储存起来。
后续,AI Agent在回答问题时,就能快速从这里查找信息,给出更精准、更贴合业务的回答。这就是RAG技术的核心。
前置条件
在开始之前,请确保你已经准备好两样东西:
1. 一个可以正常访问的N8N实例(云端或本地均可)。
2. 准备注册一个 Weaviate 账号,用于创建数据库。
账号平台准备
首先,我们需要从 Weaviate 平台获取连接 N8N 所需的“钥匙”。
第一步,访问 Weaviate Cloud 官网并注册一个账号。
第二步,登录后,创建一个新的数据集群(Cluster)。你可以选择免费的沙盒(Sandbox)套餐用于测试。
第三步,集群创建成功后,在详情页面找到并复制两个关键信息:
– 集群URL (Endpoint)
– 管理员API密钥 (Admin Key)
请把这两项信息先保存到记事本里,我们马上会用到。
关键参数说明
拿到“钥匙”后,我们回到N8N,把它配置到工作流中。
1. 创建N8N连接凭证
在N8N主界面,从左侧导航栏进入 “Credentials” 区域。
点击 “Add Credential” 按钮,在搜索框中输入 “Weaviate” 并选中它。
在弹出的配置窗口中,将刚才保存的信息填入对应位置:
– API Key: 粘贴你复制的 Admin Key。
– Host/Cluster URL: 粘贴你复制的 集群URL。
填写完毕后,点击 “Save” 保存。这样N8N就知道如何访问你的数据库了。
2. 配置Weaviate节点
在你的工作流中,添加一个 “Weaviate Vector Store” 节点。
首先,在 “Credential for Weaviate” 选项中,选择你刚刚创建好的凭证。
接下来是最关键的一步:设置 Index Name。
在节点的 “Weaviate Collection” 字段中,输入一个自定义的名称,比如 mes_log_analyzer。
重要提示:这个名称是你数据表的唯一标识。后续无论是用节点“插入(Insert)”数据,还是“查询(Query)”数据,都必须使用完全相同的名称,否则将无法找到数据。
常见错误提示
如果在配置或运行时遇到问题,通常是以下两种情况:
1. 连接超时或认证失败
这通常意味着你的凭证信息填错了。请返回 “Credentials” 部分,仔细检查你的 API Key 和集群URL是否复制正确,确保没有多余的空格或字符。
2. 找不到数据或 Index Name 不匹配
当你查询数据却返回空结果时,请检查所有用到 Weaviate 的节点。
确保每一个节点的 “Weaviate Collection” 字段都填写了完全相同的名称(例如:mes_log_analyzer)。一个字母的大小写错误都会导致匹配失败。

