RAG API 的服务地址、协议约定、请求格式、接口清单与限流规则。
通过 RAG API，您可以以编程方式管理知识库、导入文档、执行检索以及调用知识问答服务。所有接口均通过 DashScope 网关提供服务。
RAG API 包含三组接口，路径前缀不同：
例如，检索接口的完整地址为：
所有接口返回统一的 JSON 结构。
成功响应：
失败响应：
排查问题时，请提供
列表接口支持分页查询。不同接口的请求方法、参数命名与传参位置存在差异，调用时需注意区分：
各接口设有请求频率限制，超出时返回 HTTP
调用 API 前，请先获取 API Key。
服务地址
{workspace_id} 是业务空间 ID，格式如 llm-xxxxxxxxxxxx，在控制台业务空间管理页面查看或创建。
所有接口使用统一的服务地址（Base URL）：
| 接口组 | 路径前缀 | 说明 |
|---|---|---|
| 知识库管理 | /api/v1/indices/ | 知识库 CRUD、文档管理、切片管理、检索 |
| 数据导入 | /api/v1/connector/dash/ | 类目管理、文件上传、连接器配置 |
| 知识问答 | /api/v2/apps/knowledge/ | 知识问答服务（SSE 流式） |
协议约定
- 所有接口均通过 HTTPS 访问，不支持 HTTP。
- 请求体和响应体均为 JSON 格式，字符集 UTF-8。
- 知识库管理、文档管理、切片管理、检索、数据导入等接口统一使用
POST方法；少数查询接口使用GET方法并通过 query string 传参，包括查询知识库列表、查询文档列表、查询导入任务状态。各接口的实际方法与参数位置以接口说明为准。
通用请求头
| Header | 必填 | 说明 |
|---|---|---|
Authorization | 是 | Bearer <API-Key>，在控制台 API Key 页获取。详见认证方式。 |
Content-Type | 是 | POST 请求为 application/json。 |
通用响应格式
所有接口返回统一的 JSON 结构。
成功响应：
request_id，以便技术支持快速定位。完整错误码说明见错误码。
分页
列表接口支持分页查询。不同接口的请求方法、参数命名与传参位置存在差异，调用时需注意区分：
查询知识库列表的分页参数必须通过 query string 传递（
page_number、page_size，注意是 page_number 而非 page_num）；若放在请求体中，服务端会忽略并按默认值返回。接口清单
知识库
文档管理
切片管理
同步任务
数据导入
| 接口 | 说明 |
|---|---|
| 查询类目列表 | 查询当前业务空间下的类目列表，支持按类型、名称过滤 |
| 新增类目 | 在当前业务空间下创建新的类目 |
| 删除类目 | 删除指定的类目 |
| 查询文件列表 | 查询当前业务空间下的文件列表，支持按类目、文件名和文件 ID 过滤 |
| 查询文件详情 | 查询指定文件的详细信息，包括大小、MD5、标签和时间戳 |
| 删除文件 | 永久删除指定的文件 |
| 批量更新标签 | 批量更新多个文件的标签，支持覆盖和追加两种模式 |
| 申请上传租约 | 上传文件到数据中心的第一步，返回 OSS 预签名 URL 和租约 ID |
| 注册文件 | 上传文件的最后一步，将通过 OSS 上传的文件注册到数据中心 |
| 从 OSS 批量导入 | 从已授权的阿里云 OSS Bucket 批量导入文件到数据中心 |
| 新增连接器 | 创建新的数据连接器，用于管理数据导入来源 |
| 查询连接器 | 查询指定连接器的详细信息 |
知识检索与问答
Agent 管理
| 接口 | 说明 |
|---|---|
| Agent 管理概述 | RAG Agent 实例的全生命周期管理 API |
| 创建 Agent | 创建一个新的 RAG Agent，初始状态为 draft |
| 更新 Agent | 更新 Agent 的名称、描述或草稿配置 |
| 发布 Agent | 将 beta 草稿发布为新版本 |
| 删除 Agent | 软删除 Agent，标记状态为 deleted |
| 查询 Agent 列表 | 分页查询当前租户下的 Agent 列表 |
| 查询 Agent 详情 | 获取 Agent 完整信息，支持指定版本 |
| 复制 Agent | 复制已有 Agent，生成新的草稿 |
限流
各接口设有请求频率限制，超出时返回 HTTP 429。完整的限流规则见限流策略。