用 Voyage 嵌入作物照片并存进 Qdrant

用 Voyage 嵌入作物照片并存进 Qdrant

一个手动启动的 n8n 工作流。它列出 Google Cloud Storage 存储桶里的作物照片，用 Voyage AI 把每张照片变成嵌入向量，再把向量存进一个 Qdrant 集合，每次四张照片。

包里有什么

• workflow.json：n8n 导出的工作流，二十五个节点。十三个干活，十二个是便签，解释各个步骤。里面没有任何凭据。
• README.md：这份设置说明，压缩包里的是英文版。

我们相对原来的副本改了什么

• 把照片分批并给每张照片一个 UUID 的步骤原来是一个 Python Code 节点。在 n8n 2 里，原生 Python 只提供 _items 和 _item，没有 _input，也会拦住 uuid 这样的标准库导入，除非实例允许（n8n 文档，2026 年 11 月 12 日查阅）。Mindket 的版本用 JavaScript 做同样的事。
• Qdrant 集群地址和存储桶名称原来属于原作者。它们现在是占位符 <YOUR_QDRANT_CLUSTER_URL> 和 <YOUR_BUCKET_NAME>。
• 有几个节点原来关联着作者 n8n 里的凭据。这些关联已删掉，请选你自己的。
• 别的都没改。番茄过滤、批大小和便签都是文件原有的。

开始之前

• 一个 n8n 实例，n8n Cloud 或自己的服务器都行。
• 一个 Qdrant 集群，用 Qdrant Cloud 或自己的服务器都行，要有它的地址和一个 API 密钥。
• 一个 Voyage AI API 密钥。
• 一个 Google Cloud Storage 存储桶，里面的图片任何人不用登录就能读取，并按类别分文件夹，比如 agricultural-crops/cucumber/photo-1.jpg。Voyage 会从地址下载每张图片。

设置

1. 在 n8n 里新建一个工作流，打开它的菜单，选 Import from File，选中 workflow.json。
2. 添加一个 Qdrant API 凭据，填上你的集群地址和密钥。在 Check Qdrant Collection Existence、Create Qdrant Collection、Payload index on crop_name 和 Batch Upload to Qdrant 里选中它。
3. 为 Voyage 添加一个 Header Auth 凭据。名称填 Authorization，值填 Bearer <YOUR_VOYAGE_KEY>，换成你自己的密钥。在 Embed crop image 里选中它。
4. 添加一个 Google Cloud Storage 凭据，在 Google Cloud Storage 里选中它。
5. 在那个节点里，把 <YOUR_BUCKET_NAME> 换成你的存储桶。把 prefix 设为放着各类别文件夹的那个文件夹。文件里用的是 agricultural-crops。
6. 打开 Qdrant cluster variables，把 <YOUR_QDRANT_CLUSTER_URL> 换成你的集群地址，前面带 https://，结尾不要斜杠。检查集合名称、批大小 4 和向量维度 1024。
7. 看一下 Filtering out tomato to test anomalies。它故意跳过番茄文件夹。如果想要每个类别，就删掉这个节点或改一改。
8. 点 Execute workflow。

一次运行的过程

1. 你点 Execute workflow 时，手动触发器启动这次运行，Qdrant cluster variables 设好集群地址、集合名称、向量维度和批大小。
2. Check Qdrant Collection Existence（HTTP Request 4.2）问 Qdrant 集合是否存在，If collection exists 读取回答。
3. 如果不存在，Create Qdrant Collection 就创建它，带一个命名向量 voyage，用 Cosine 距离比较。随后 Payload index on crop_name 在 crop_name 字段上加一个关键字索引。
4. Google Cloud Storage 列出前缀下的每个对象。Get fields for Qdrant 为每张照片生成一个 publicLink，并从它所在的文件夹取出 cropName。
5. Filtering out tomato to test anomalies 丢掉番茄的照片。
6. 一个 Code 节点按 batchSize 把照片分批，并给每张照片一个 UUID，因为 Qdrant 不会自己生成点 id。Batches in the API's format 把每一批整理成 Voyage 和 Qdrant 各自要的格式。
7. Embed crop image 把一批照片发给 Voyage 的多模态嵌入 API，模型是 voyage-multimodal-3，input_type 设为 document。Batch Upload to Qdrant 把这一批连同 id、向量和 payload 一起保存。

改变结果

• 存储桶和文件夹：Google Cloud Storage 里的 bucketName 和 prefix。
• 集合、批大小和向量维度：Qdrant cluster variables 里的值。
• 被跳过的文件夹：Filtering out tomato to test anomalies 里的条件。
• 每张照片附带保存的字段：Batches in the API's format 里的 batchPayloadQdrant。
• 嵌入模型：Embed crop image 里的 model。向量维度要跟着改，并换一个新集合。

注意事项

• 每个集合只运行一次。UUID 每次运行都是随机的，所以再运行一次会把每张照片作为新点再存一遍。
• Voyage 从地址取每张图片，所以文件必须是公开的。Voyage 的文档（2026 年 11 月 12 日查阅）说图片必须是 PNG、JPEG、WEBP 或 GIF，最大 20 MB、1600 万像素。它的地址还必须返回内容长度，并遵守 robots.txt。
• 文件里用的是 voyage-multimodal-3，那份文档仍把它列为推荐模型。
• 批大小为 4 时，一百张照片会调用 Voyage 25 次、Qdrant 25 次。
• Voyage 按你的密钥计费嵌入，Qdrant 把向量存在你的集群里。
• 每张照片的公开地址会发给 Voyage，地址和作物名称会发给 Qdrant。
• 文件里没有任何凭据和密钥。