download

接口名称

Windows命令（CMD）：curl.exe -o "{result.zip}" "{BASE_URL}/download?task_id={TASK_ID}&download_result_path={DOWNLOAD_RESULT_PATH}"

Windows命令（PowerShell）：curl.exe -o "{result.zip}" "{BASE_URL}/download?task_id={TASK_ID}&download_result_path={DOWNLOAD_RESULT_PATH}"

Linux/MacOS命令：curl -o "{result.zip}" "{BASE_URL}/download?task_id={TASK_ID}&download_result_path={DOWNLOAD_RESULT_PATH}"

接口描述

用于从工作区下载需要的结果文件或文件夹。

参数说明

参数	参数说明
task_id	可选参数，任务ID，用于唯一标识本次任务，绑定对应远程工作区。若指定task_id，则以指定的task_id为准。若指定的task_id不存在，则会报错。若未指定task_id，系统会自动分配一个task_id。
download_result_path	必选参数，待下载文件的后端路径（通常run接口会返回一些文件路径信息）。

参数

参数说明

task_id

可选参数，任务ID，用于唯一标识本次任务，绑定对应远程工作区。

若指定task_id，则以指定的task_id为准。
若指定的task_id不存在，则会报错。
若未指定task_id，系统会自动分配一个task_id。

download_result_path

必选参数，待下载文件的后端路径（通常run接口会返回一些文件路径信息）。

使用示例

Windows命令（CMD）：

curl.exe -o "result.zip" "http://xxx.xxx.xxx.xxx:xxx/download?task_id=20260728_084921_8cd5&download_result_path={DOWNLOAD_RESULT_PATH}"

Windows命令（PowerShell）：

curl.exe -o "result.zip" "http://xxx.xxx.xxx.xxx:xxx/download?task_id=20260728_084921_8cd5&download_result_path={DOWNLOAD_RESULT_PATH}"

Linux/MacOS命令：

curl -o "result.zip" "http://xxx.xxx.xxx.xxx:xxx/download?task_id=20260728_084921_8cd5&download_result_path={DOWNLOAD_RESULT_PATH}"

task_id使用规则：
- 若指定task_id，则以指定的task_id为准。
- 若指定的task_id不存在，则会报错。
- 若未指定task_id，系统会自动分配一个task_id。

必须指定正确的task_id和download_result_path，否则无法定位并下载文件。
download_result_path可以从run接口返回的过程和结果内容中获取。
-o：curl命令参数，指定本地保存的文件名。
使用示例中文件名、task_id、BASE_URL、DOWNLOAD_RESULT_PATH等参数请根据实际情况进行替换，BASE_URL为后端服务地址，格式为http://<IP地址>:<端口>。

返回值

Agent会返回下载结果的相关信息，例如下载文件名称、大小、保存路径等。

[主Agent] > result.zip 文件已成功生成！

文件位置：/home/skills/result.zip

文件内容：
- sample.txt - 包含示例文本内容

文件大小：约 300 字节（压缩后）

您可以从上述路径下载 result.zip 文件。文件中包含一个 sample.txt 文本文件，内容为一些示例文本信息。

是否还需要其他帮助？
C:\Users\xxx>curl.exe -o "result.zip" "http://xxx.xxx.xxx.xxx:xxx/download?&download_result_path=/home/skills/result.zip"
  % Total    % Received % Xferd  Average Speed   Time    Time     Time  Current
                                 Dload  Upload   Total   Spent    Left  Speed
100    59  100    59    0     0    564      0 --:--:-- --:--:-- --:--:--   567

父主题： 接口介绍