| name | approval.file_upload |
| description | 通过云之家审批文件服务上传本地文件,并返回可直接写入轻云 attachmentWidget 的附件对象。 |
Approval File Upload
Use this skill when a shadow write needs a real uploaded attachment, especially before calling customer/contact update skills that accept attachmentWidget values.
Workflow
- Read
references/execution.json for the fixed internal API and upstream approval file-service chain.
- Confirm the local file path exists. Do not guess or fabricate file metadata.
- Call the internal upload API first:
POST /api/approval/files/upload.
- Reuse the returned
attachmentValue object as-is in downstream LightCloud attachmentWidget fields.
- Never invent
fileId, fileType, fileSize, or fileExt.
Input Rules
- Required params:
filePath
- Optional params:
bizKey
- Default
bizKey: cloudflow
- Output must preserve both:
- the raw uploaded file info
- the normalized
attachmentValue shape for LightCloud writes
Output Contract
- Internal upload response includes:
filePath
bizKey
accessTokenScope
uploaded
attachmentValue
attachmentValue must stay in LightCloud format:
[
{
"fileName": "测试上传附件.pptx",
"fileId": "69ea3d811285ac00016ede26",
"fileSize": "3888931",
"fileType": "doc",
"fileExt": "pptx"
}
]
References
references/execution.json
references/source-summary.md