文件上传

1. 组件概述

文件上传是一个数据输入组件，用于让用户选择并上传文件到服务器。它支持多种文件类型限制、文件大小限制、单文件或多文件上传，以及拖拽上传等功能。在 AI Agent 应用中，文件上传常用于让用户提交需要 AI 处理的文档，如论文、数据表格、文本文件等。

加载中...

查看 JSON

复制 JSON

2. 应用场景示例

• 场景一：论文优化助手。用户上传 PDF 或 Word 格式的论文，点击”开始分析”按钮后，工作流调用 AI 对论文进行结构分析和优化建议。配置时设置文件类型为 .pdf, .docx, .doc，开启自动上传，绑定变量后供工作流读取文件内容。
• 场景二：数据分析工具。用户上传 Excel 或 CSV 数据文件，AI 自动解析数据并生成可视化图表或分析报告。配置时设置文件类型为 .xlsx, .xls, .csv，限制最大体积防止上传过大文件，可提供模板链接让用户下载标准格式模板。

加载中...

查看 JSON

复制 JSON

3. 功能配置

高级

基本折叠组

配置项	说明
绑定变量	组件的变量名，用户上传的文件信息会以此变量名存储。其他组件可以绑定此变量来获取文件信息，调用工作流时此变量的值会传递给工作流。
标题	表单项左侧显示的标签文字，用于说明该上传项的用途，如”上传论文”、“导入数据”。
按钮名称	上传按钮上显示的文字。默认为”文件上传”，可根据场景自定义，如”选择文件”、“上传文档”等。
可多选	开启后允许用户一次选择并上传多个文件。关闭时为单文件上传模式，重新选择文件会替换之前的文件。
最大数量	开启多选后可见。限制最多可上传的文件数量，范围为 1-5 个。达到上限后上传按钮会被禁用。
最大体积	限制单个文件的最大大小，单位为 KB。超过此大小的文件将无法上传，系统会给出提示。建议根据实际需求设置合理的限制，避免用户上传过大的文件。
上传方式	选择文件的上传存储方式。可选项：文件接收器（上传到自定义的文件接收接口）、对象存储（上传到平台默认的对象存储服务，推荐使用）。
存储仓库	选择”对象存储”上传方式时可见。目前仅支持”平台默认”选项。
文件接收器	选择”文件接收器”上传方式时可见。配置自定义的文件上传接口地址。
自动上传	开启后，用户选择文件后会立即自动开始上传。关闭后需要用户手动点击上传按钮才会开始上传。建议保持开启，提升用户体验。
文件类型	限制允许上传的文件类型，填写文件后缀名，多个类型用逗号分隔。例如 .pdf, .docx, .txt 表示只允许上传这三种格式的文件。留空则不限制文件类型。
模板链接	提供一个模板文件的下载链接。适用于需要用户按特定格式上传文件的场景，如 Excel 数据导入。配置后会在组件上方显示”下载模板”链接。
拖拽上传	开启后，用户可以将文件直接拖拽到上传区域进行上传，同时上传区域会显示更大的拖放提示框。适合需要频繁上传文件的场景。
标题提示	在标题旁边显示一个小问号图标，鼠标悬停时弹出提示内容。适合放置关于上传要求的简短说明。
描述	显示在组件下方的说明文字，用于补充解释上传要求或注意事项，如”请上传 PDF 格式的论文，文件大小不超过 10MB”。

状态折叠组

配置项	说明
可见	控制组件是否显示。默认可见。可以绑定变量实现动态控制。
隐藏	控制组件是否隐藏。与”可见”相反。
禁用	控制组件是否禁用。禁用后用户无法选择或上传文件。可以绑定变量实现动态控制，例如在某些条件满足前禁用上传功能。

校验折叠组

配置项	说明
必填	开启后，该文件上传项必须上传文件才能提交表单。适用于文件为必要输入的场景。

事件

配置项	说明
添加事件	支持四种触发事件：值变化（文件上传完成或上传失败后触发）、移除文件（用户删除已上传的文件时触发）、上传成功（单个文件上传成功时触发）、上传失败（单个文件上传失败时触发）。常见用法是在”上传成功”事件中调用工作流，让 AI 处理上传的文件内容。