# 文档文本嵌入

从文档视觉清单提取文本记录，生成文本向量并写入指定文本索引表。

适用于与图片索引配套的多模态流程。已有普通文档数组且希望直接写入知识库时，可使用[嵌入并添加到知识库](../ai-processing/knowledge-index.md)。

## 绑定清单与文本索引

使用模板时，检查已绑定的清单和索引配置；自行编排时，提供以下输入。

| 输入 | 说明 |
| --- | --- |
| 视觉清单 | 上游生成的清单对象或清单文件引用 |
| 文本向量表 `text_vector_table` | 必填，保存文本向量的目标表 |
| 嵌入模型 `embedding_model` | 必填，用于生成文本向量 |
| 启用 `enabled` | 为 false 时跳过写入并返回 `disabled` |

多级索引默认关闭，需要时开启。

绑定包含文本及来源信息的视觉清单。

## 使用输出

`documents` 是从清单生成的文本记录，`documents_count` 是记录数量。`written` 表示实际写入的向量行数，`text_vector_table` 与 `embedding_model` 用于核对索引配置。

检查 `status` 区分实际写入与禁用状态。

## 示例：配套建立文本检索

流程示意：构建文档视觉清单 → 文档文本嵌入。

绑定视觉清单，填写文本索引表和嵌入模型。图片检索另接图片嵌入节点，两种索引分别检查写入结果。

## 继续阅读

- [变量与数据传递](../../variables-and-data.md)
- [运行与调试](../../run-debug.md)