网检索Agent-多模态文件操作
点击查阅官方文档

点击开启应用体验

使用联网搜索多模态能力时，可以通过如下文件接口，将需要与联网搜索 agent 交互的图片提前上传到 OSS 处，在进行联网问答时，使用已经提前上传到 OSS 图片 url， 可以提供更流畅的问答体验。

获取预签名 OSS 上传地址

获取与签名 OSS 上传地址，可以将图片上传至该地址

POST /web-search-agent/file/upload/apply HTTP/1.1

请求参数

参数名 类型 是否必须 说明
input object 是 输入字段
input.session\_id str 是 文件操作 session id（业务自定义）
input.files array 是 待上传文件列表
input.files\[\].file\_name str 是 文件名称
input.files\[\].file\_size int 是 文件大小(字节)
input.files\[\].content\_type str 是 文件 MIME 类型
parameters object 是 配置参数字段
parameters.agent\_options object 是 Agent 选项配置
parameters.agent\_options.agent\_id str 是 Agent ID

返回参数

参数名 类型 是否必须 说明
code str 是 状态码（成功：200）
message str 是 状态信息
output object 是 输出字段
output.request\_id str 否 请求ID
output.result object 是 文件处理结果
output.result.upload\_tasks array 是 上传任务列表
output.result.upload\_tasks\[\].file\_id str 是 文件 ID
output.result.upload\_tasks\[\].file\_name str 是 文件名称
output.result.upload\_tasks\[\].upload\_url str 是 OSS 预签名上传地址
output.result.upload\_tasks\[\].expire\_at int 是 上传 URL 过期时间(Unix 时间戳)，默认 1 小时

执行上传

在获取到 OSS 预签名上传地址后，可以通过如下操作将本地文件上传到对应的地址。其中，${output.result.upload_tasks[].upload_url}为通过调用获取预签名 OSS 上传地址 接口获取到对应文件的OSS 预签名上传地址。. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

curl -X PUT -T ./path/to/test.jpg -H "Content-Type: image/jpeg" ${output.result.upload_tasks[].upload_url}

回调获取文件上传的状态

调用文件上传回调，查看文件上传的结果，即是否成功。

POST /web-search-agent/file/upload/callback HTTP/1.1

请求参数

参数名 类型 是否必须 说明
input object 是 输入字段
input.session\_id str 是 文件操作 session id（业务自定义）
input.file\_id str 是 文件 ID(获取上传 URL 时返回)
parameters object 是 配置参数字段
parameters.agent\_options object 是 Agent 选项配置
parameters.agent\_options.agent\_id str 是 Agent ID

返回参数

参数名 类型 是否必须 说明
code str 是 状态码（成功：200）
message str 是 状态信息
output object 是 输出字段
output.request\_id str 否 请求ID
output.result object 是 处理结果
output.result.status str 是 上传状态(成功:SUCCESS)

获取文件上传的信息

查看已经上传文件的状态信息

POST /web-search-agent/file/info/get HTTP/1.1

请求参数

参数名 类型 是否必须 说明
input object 是 输入字段
input.session\_id str 是 文件操作 session id（业务自定义）
input.file\_ids array\[str\] 是 文件 ID 列表
parameters object 是 配置参数字段
parameters.agent\_options object 是 Agent 选项配置
parameters.agent\_options.agent\_id str 是 Agent ID

返回参数

参数名 类型 是否必须 说明
code str 是 状态码（成功：200）
message str 是 状态信息
output object 是 输出字段
output.request\_id str 否 请求ID
output.result object 是 处理结果
output.result\[\].file\_id str 是 文件 ID
output.result\[\].file\_name str 是 文件名称
output.result\[\].file\_size int 是 文件大小(字节)
output.result\[\].content\_type str 是 文件 MIME 类型
output.result\[\].preview\_url str 是 文件预览地址(OSS 预签名 URL)
output.result\[\].expire\_at int 是 预览 URL 过期时间(Unix 时间戳)
output.result\[\].status str 是 文件状态(如:done)

删除文件

删除已上传的文件

POST /web-search-agent/file/delete HTTP/1.1

请求参数

参数名 类型 是否必须 说明
input object 是 输入字段
input.session\_id str 是 文件操作 session id（业务自定义）
input.file\_ids array\[str\] 是 文件 ID 列表
parameters object 是 配置参数字段
parameters.agent\_options object 是 Agent 选项配置
parameters.agent\_options.agent\_id str 是 Agent ID

返回参数

参数名 类型 是否必须 说明
code str 是 状态码（成功：200）
message str 是 状态信息
output object 是 输出字段
output.request\_id str 否 请求ID
output.result object 是 处理结果
output.result\[\].status str 是 删除状态(成功:SUCCESS)