# 变量与数据传递

节点通过输入字段接收数据，通过输出字段把处理结果交给后续步骤。连好画布后，还需要设置输入绑定，让节点取得正确的数据。

## 选择数据来源

| 来源 | 适用情况 | 引用示例 |
| --- | --- | --- |
| 运行变量 `vars` | 本次运行填写的参数，例如源文件或目标表 | `{{ .vars.source_ref }}` |
| 上一步输出 `data` | 直接使用前一个节点返回的结果 | `{{ .data.documents }}` |
| 已保存的结果 `state` | 在后续多个步骤中复用同一份结果 | `{{ .state.parsed_documents }}` |

编辑工作流配置时，可通过 `save` 将输出保存到状态，供后续多个节点引用。运行变量用于配置本次处理，节点输出则会随着流程推进而变化。

## 示例：连接解析和分段

1. 在“读取 MOI 卷”中选择资料来源。
2. 将其 `sources` 输出绑定到“文档解析”的来源输入。
3. 将解析返回的 `documents` 绑定到“分段”的文档输入。
4. 将分段输出继续传给知识库写入节点。

文件引用和解析正文是不同的数据：`file_ids` 表示文件位置，`documents` 包含解析后的文档记录，`text` 或 `plain_text` 提供相应节点的正文输出。解析节点使用文件引用，分段和清洗节点使用解析后的文档或正文。

## 检查绑定

节点提示字段缺失时，查看上游实际输出，确认字段名称、数据类型和是否为空。后续需要追溯源文件时，传递包含来源信息的 `documents`。

- [选择节点](nodes/index.md)
- [运行与调试](run-debug.md)