leaseId 来自第一步 applyFileUploadLease 返回。关键参数
| 参数 | 说明 |
|---|---|
leaseId | 上传租约 ID（来自 applyFileUploadLease） |
category | 类目 ID（字段名为 category 而非 categoryId），可传 default 使用默认类目 |
categoryType | UNSTRUCTURED（默认，知识库）或 SESSION_FILE（会话文件，最长 7 天） |
parser | 解析器，详见下表 |
tags | 文件标签，最多 100 个，单个 ≤32 字符，总长度 ≤700 |
originalFileUrl | 关联 URL，智能体对话时作为回答来源返回 |
解析器选择
| parser | 适用场景 |
|---|---|
AUTO_SELECT | 自动选择（默认） |
DOCMIND | 智能文档解析 |
DOCMIND_DIGITAL | 电子文档解析 |
DOCMIND_LLM_VERSION | 大模型文档解析 |
DASH_QWEN_VL_PARSER | Qwen VL 视觉解析（需同时传 parserConfig） |
DOCMIND_LLM_VERSION_MEDIA | 音视频解析 |
Authorizations
DashScope API Key，在控制台 API Key 页面（https://agent.console.aliyun.com/settings/apikey）获取。
Body
application/json上传租约 ID，即 applyFileUploadLease 接口返回的 fileUploadLeaseId。
类目 ID（注意：此字段名为 category，不是 categoryId），通过 listCategory 获取。可传入 default 使用系统默认类目；categoryType 为 SESSION_FILE 时传入 default 即可。
解析器类型。AUTO_SELECT 自动选择解析器；DOCMIND 智能文档解析；DOCMIND_DIGITAL 电子文档解析；DOCMIND_LLM_VERSION 大模型文档解析；DASH_QWEN_VL_PARSER Qwen VL 解析（需同时传 parserConfig）；DOCMIND_LLM_VERSION_MEDIA 音视频解析。categoryType 为 UNSTRUCTURED 时按类目数据解析设置解析文件；为 SESSION_FILE 时系统使用默认方式解析（不支持更改）。
类目类型，默认 UNSTRUCTURED。UNSTRUCTURED：类目，用于构建知识库；SESSION_FILE：用于智能体应用会话交互的文件。使用 SESSION_FILE 时，applyFileUploadLease 的 categoryType 也须传 SESSION_FILE；此类文件仅当前会话有效，关闭会话后过期（最长 7 天），不支持长期保存。
文件关联的标签列表，默认为空（不设置标签）。最多传入 100 个标签，所有标签字符长度总和不超过 700，单个标签最多 32 个字符。
为文件关联一个 URL。构建文档搜索类知识库时系统记录该链接，与智能体应用对话时随该文件召回结果返回（通过 docUrl 字段）。智能体应用须开启知识库并启用“展示回答来源”，否则此参数不生效。
解析配置，仅 parser 为 DASH_QWEN_VL_PARSER 时必填，其他解析方式无需传入。