# 存至 MOI 卷

把工作流产生的文档、数据行、文本或 JSON 保存到指定 MOI 卷或目录。

适用于保存处理结果，供下载、后续导入或其它工作流使用。

## 配置保存位置和内容

“目标位置” `target_ref` 必填，选择接收结果的 Catalog 卷或目录，再根据上游结果绑定一种主要内容。

| 内容 | 绑定方式 |
| --- | --- |
| 文档 | 绑定 `documents`，保留文档结构与元数据 |
| 表格行 | 绑定 `rows`，并提供 `columns` 指定 CSV 表头 |
| 纯文本 | 绑定 `text`，例如 AI 推理生成的摘要 |
| JSON | 绑定 `json`，用于保存结构化对象或数组 |
| 已有文件 | 绑定 `file_ids`，按文件引用处理 |

保存格式取决于输入内容。文档带有相关解析产物时，可能打包为 ZIP。

## 使用输出

`file_id` 是主要结果文件，`file_ids` 覆盖全部结果文件。`volume_id` 与 `result_ref` 用于定位保存结果。

`count` 表示保存的记录数或文件数，具体取决于输入类型。需要处理全部结果文件时，使用 `file_ids`。

## 示例：保存查询结果为 CSV

流程示意：SQL 处理 → 存至 MOI 卷。

绑定查询结果 `rows`，填写与结果列一致的 `columns`，选择目标卷。CSV 第一行为表头；后续文件导入时需要相应跳过表头。

## 继续阅读

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