功能简介

上传文件到扣子编程。消息中无法直接使用本地文件，创建消息或对话前需要先上传本地文件。本指令仅输出最常用的文件 ID。

使用场景

需要上传文件供智能体使用时 需要在对话中发送图片、文档等文件时 需要批量上传文件时

参数说明

输入参数

参数名	类型	必填	说明
文件路径	字符串	是	待上传文件的本地路径。支持相对路径和绝对路径

输出参数

参数名	类型	必填	说明
文件ID	字符串	是	已上传的文件 ID，可用于在消息中引用此文件

注意事项

文件大小限制：接口允许上传的最大文件大小为 512 MB；在与智能体对话时，实际可用大小还取决于智能体所用模型版本

上传方式：必须使用 multipart/form-data 方式上传文件

返回内容：虽然接口还会返回文件名、大小、上传时间等字段，但本指令仅输出「文件ID」，便于后续节点直接使用

流控限制：个人版和专业版一般为 10 QPS，团队版和企业版一般为 20 QPS（以扣子官方说明为准）

文件有效期：普通上传的文件将保存在扣子编程服务端，有效期为 3 个月。若上传的文件被用作扣子头像，则永久有效

使用限制：上传到扣子编程的文件仅限本账号查看或使用。不支持下载已上传的文件，用户仅可在对话、工作流、端插件、RTC 和 WebSocket 中通过文件 ID 访问和使用文件

支持格式：支持文档（DOC、DOCX、XLS、XLSX、PPT、PPTX、PDF、Numbers、CSV）、文本文件（CPP、PY、JAVA、C）、图片（JPG、JPG2、PNG、GIF、WEBP、HEIC、HEIF、BMP、PCD、TIFF）、音频（WAV、MP3、FLAC、M4A、AAC、OGG、WMA、MIDI）、视频（MP4、AVI、MOV、3GP、3GPP、FLV、WEBM、WMV、RMVB、M4V、MKV）、压缩文件（RAR、ZIP、7Z、GZ、GZIP、BZ2）等格式