定义
文档读取节点可以读取已上传至「文档」中的内容,并将其存入变量,供工作流后续节点使用。例如,读取的文档内容可以作为变量传递给大模型节点,让大模型理解文档内容并进行问答会话。
如何配置
文档
添加「文档读取节点」至画布后,单击节点可在右侧配置栏进行配置。点击“+”选择需要读取的文档,最多可选择10个文档。需配置选中的每个文档的「目标变量名称」(必填),输出变量的格式为「String」。

- 一个文档读取节点可读取一个或多个文档,通过点击“+”添加新的文档;
- 变量/表达式:在此处写入完整的文档名称和路径,例如分类1/分类2/文档名,即可读取对应路径下的文档。此对话框内支持插入变量。一个变量/表达式 输入框支持输入一个文档的路径。
小技巧:通过在「变量/表达式」插入变量的方式,可以灵活读取文档内容。例如:在一个对话式工作流中,通过自然语义变量提取器提取到文档路径/名称,插入文档读取节点的「变量/表达式」输入框中。可实现在工作流中轻松调用指定文档的效果。
常见使用场景
- 核对文档内容使用「文档读取节点」读取文档后,可添加审核节点(如使用LLM节点),配置审核规则来检查文档内容是否符合要求(如格式是否正确、有无敏感信息等)。若发现不符合规则的内容,通过后置节点输出警报或修改建议,从而保证文档始终符合标准和规范。
- 内容信息比对使用「文档读取节点」读取文档后,可配置后置节点进行文档内容比对。例如,文档内容为已购客户名单,后置节点可以引用此变量,判断咨询客户是否为已购客户(如使用LLM节点或代码执行节点)。若匹配成功,可触发相应的处理流程,从而实现精准的客户关系管理。
- 文档内容快速查询使用「文档读取节点」读取文档后,可配置后置节点以实现快速查询。例如,文档内容为售后政策,后置节点可以引用此变量,添加查询节点(如使用LLM节点),根据客户反馈的问题快速输出对应的售后政策,提升服务效率和客户满意度。
「文档读取节点」和「知识检索节点」的区别
| 对比维度 | 文档读取节点 | 知识检索节点 |
|---|---|---|
| 功能定位 | 将指定文档转化为结构化变量输出 | 根据输入问题或关键词检索文档中的相关信息,并输出 |
| 内容处理方式 | 读取指定文档内容,不进行语义分析 | 对文档内容进行索引和语义处理以便检索 |
| 输出结果及形式 | 结构化变量,格式为「String」 | 相关知识条目列表(含标题、内容片段等) |
| 配置 | 无需输入变量,仅将指定文档输出为结构化变量 | 需输入「查询变量」,可设置检索的「TopK」和「相关性阈值」 |
文档读取节点错误处理分支说明
「文档读取节点」支持在同一个节点中读取多个文档,并分别输出为不同变量。
在实际使用中,可能会出现部分文档读取成功、部分文档读取失败的情况。例如:某个文档路径配置错误、目标文档不存在,或当前用户没有对应文档的访问权限。
因此,当「文档读取节点」的错误处理方式设置为「默认值」时,系统会提供「默认值生效范围」配置,用于控制默认值的应用方式。
| 选项 | 说明 |
|---|---|
| 仅出错项 | 只有读取失败的文档输出变量使用默认值;读取成功的文档仍输出真实内容 |
| 所有项 | 只要任一文档读取失败,该节点下所有文档输出变量都会使用各自配置的默认值 |
选择「仅出错项」时,即使某个文档读取失败,节点也会继续运行。失败的文档变量会输出默认值,其他成功读取的文档变量仍会正常输出真实内容。
选择「所有项」时,只要有任一文档读取失败,当前节点下的所有输出变量都会统一回退到默认值。
该机制适用于一个节点同时读取多个文档的场景,可以避免因为单个文档读取失败,导致整个节点没有可用输出。
简单案例展示
AirDroid家长控制软件用户助手(服务式工作流):回答用户关于如何使用AirDroid家长控制的任何问题。
- 开始节点:添加“问题”变量以输入用户的问题。
- 文档读取节点:上传并读取「文档」中的“AirDroid家长控制用户指南”文档。
- 大模型节点:
- SYSTEM:例如,“您是AirDroid家长控制的产品助手,请回答用户关于如何使用AirDroid家长控制的问题。”
- USER:插入用户的问题,即“问题”变量。
- 结束节点:选择大模型节点输出的变量,即“文本(String)”。

注意事项
- 您最多只能添加10个文档。
- 如果文档更新,则需要重新训练并测试输出效果是否准确。
- 输出变量名称必须填写,否则无法选择。
发表评论.