> For the complete documentation index, see [llms.txt](https://doc.duaer.com/zh/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://doc.duaer.com/zh/build/duaer-embedding.md).

# 用 Duaer Embedding 把文字变成向量

在 Duaer 里，Duaer Embedding 把每条数据的文字变成一个向量，用来做语义搜索、相似匹配或聚类。
## 生成向量

1. 在节点面板搜索 Duaer Embedding，接到上一个节点后面。
2. Text 填要变成向量的文字，通常用表达式取上一个节点的字段，例如 {{ $json.description }}。
3. 打开 Model 下拉框选一个向量模型。
4. 点执行此步骤。每条数据原有的字段都保留，另多一个 embedding 字段，里面是一串数字。

Duaer Embedding 会把多条数据合在一次调用里发出，默认每次 50 条，可以在 Options 的 Batch Size 里改。

## Duaer Embedding 的选项

- Dimensions：向量长度。只有支持缩短输出的模型才用得上，不填就用模型默认长度。
- Output Field：放向量的字段名，默认 embedding。
- Batch Size：一次调用发多少条文字，1 到 500。

同一个工作流里要拿来比较的向量，必须用同一个模型、同一个 Dimensions 生成，不同模型的向量不能互相比较。

## Duaer Embedding 能选哪些模型

Model 下拉框列出 Duaer 管理员在「管理 → 模型池」里开启的向量模型，例如火山方舟的豆包向量模型，或 OpenRouter 上的 Voyage、Nemotron Embed。

费用按所选模型计入工作流所有者的 AI 积分，见 [Duaer 套餐与积分](/zh/manage-cloud/plans.md)。
## Questions

### Duaer Embedding 的下拉框为什么是空的？

Duaer 管理员还没在「管理 → 模型池」里开启向量模型。开启之后，它会出现在 Duaer Embedding 的列表里。

### Duaer Embedding 一条数据出错，其他数据会怎样？

默认整个节点停止。打开节点设置里的 On Error → Continue 后，Duaer Embedding 把出错的数据换成带 error 字段的一条，其余照常输出；一次调用失败时，这一批的数据都会带 error。

## 相关

- [Duaer 套餐与积分](https://doc.duaer.com/zh/manage-cloud/plans.md)
- [用 Duaer Judgment 判断一段文字](https://doc.duaer.com/zh/build/duaer-judgment.md)