文档首页/ 智能体开发平台 AgentArts/ API参考/ API/ 知识库/ 文件下载 - DownloadKnowledgeBaseFile
更新时间:2026-03-06 GMT+08:00
分享

文件下载 - DownloadKnowledgeBaseFile

功能介绍

下载知识库中的指定文件。

适用场景

  • 智能体中添加知识库时,可以通过本接口下载检索结果中的文件。

  • 工作流中添加知识检索节点时,当工作流运行完成后,可以通过本接口下载检索结果中的文件。

知识库内的文件不能通过该接口直接下载。

文件的默认有效期为7天。

调用方法

请参见如何调用API

URI

GET /v2/{project_id}/knowledge-bases/{knowledge_base_id}/files/{file_id}/content

表1 路径参数

参数

是否必选

参数类型

描述

project_id

String

参数解释

当前租户项目ID。

获取方法请参考获取项目ID

约束限制

不涉及。

取值范围

由英文,数字,“-”,“_”组成,不超过64位字符。

默认取值

不涉及。

knowledge_base_id

String

参数解释

知识库ID。

获取方式:

方式一:

  1. 进入AgentArts智能体开发平台。

  2. 在左侧导航选择“开发中心 > 智能体管理”,选择工作流应用。

  3. 添加“知识检索节点”,选择需要检索的知识库。

  4. 运行工作流,完成后在右上角选择“调试 > 调用详情 > 知识检索”,在输出栏内获取“knowledge_base_id”。

  5. 如果是通过“调用工作流应用”接口调用,可在返回信息中获取“knowledge_base_files_info”字段,从该字段中获取“knowledge_base_id”。

方式二:

  1. 进入AgentArts智能体开发平台。

  2. 在左侧导航选择“开发中心 > 智能体管理”,选择智能体应用。

  3. 添加“知识库”,选择需要检索的知识库。

  4. 运行智能体,完成后选择“retrieval”,在返回结果中获取“knowledge_base_id”。

  5. 如果是通过“调用智能体应用”接口调用,可在返回信息中获取“knowledge_base_files_info”字段,从该字段中获取“knowledge_base_id”。

约束限制

不涉及。

取值范围

由英文,数字,“-”,“_”组成,不超过64位字符。

默认取值

不涉及。

file_id

String

参数解释

文件ID。

方式一:

  1. 进入AgentArts智能体开发平台。

  2. 在左侧导航选择“开发中心 > 智能体管理”,选择工作流应用。

  3. 添加“知识检索节点”,选择需要检索的知识库。

  4. 运行工作流,完成后在右上角选择“调试 > 调用详情 > 知识检索”,在输出栏内获取“file_id”。

  5. 如果是通过“调用工作流应用”接口调用,可在返回信息中获取“knowledge_base_files_info”字段,从该字段中获取“file_id”。

方式二:

  1. 进入AgentArts智能体开发平台。

  2. 在左侧导航选择“开发中心 > 智能体管理”,选择智能体应用。

  3. 添加“知识库”,选择需要检索的知识库。

  4. 运行智能体,完成后选择“retrieval”,在返回结果中获取“file_id”。

  5. 如果是通过“调用智能体应用”接口调用,可在返回信息中获取“knowledge_base_files_info”字段,从该字段中获取“file_id”。

约束限制

不涉及。

取值范围

由英文,数字,“-”,“_”组成,不超过64位字符。

默认取值

不涉及。

请求参数

表2 请求Header参数

参数

是否必选

参数类型

描述

X-Auth-Token

String

参数解释

用户Token。

必填,通过调用IAM服务获取用户Token接口获取(响应消息头中X-Subject-Token的值)。

约束限制

不涉及。

取值范围

不涉及。

默认取值

不涉及。

响应参数

状态码:200

表3 响应Body参数

参数

参数类型

描述

-

File

文件流。

请求示例

  • 下载知识库中的指定文件。

    {
      "method" : "GET",
      "url" : "https://api.example.com/v2/{project_id}/knowledge-bases/{knowledge_base_id}/files/{file_id}/content",
      "headers" : {
        "X-Auth-Token" : "TEST-TOKEN******"
      }
    }

响应示例

状态码:200

文件流。

状态码

状态码

描述

200

文件流。

错误码

请参见错误码

相关文档