文档中心

数据智能体 DataAgent（私有化）

智能体

查看智能体绑定知识

查看知识绑定关系

查询指定智能体已绑定的知识库列表（分页返回）。

请求说明

项目	内容
请求方式	`POST`
请求地址	`https://${IDA_DOMAIN}/dataAgent/llm/openApi/v2/deepresearch/knowledgeBaseList`
默认鉴权	`Authorization: Bearer ${JWT_TOKEN}`
Content-Type	`application/json`

请求参数

位置	参数	类型	是否必选	示例值	说明
ROOT	agentId	Number	是	`61`	智能体 ID
ROOT	page	Number	否	`1`	页码，默认 `1`
ROOT	pageSize	Number	否	`10`	每页数量，默认 `5`

请求示例

curl -X POST \
  "https://${IDA_DOMAIN}/dataAgent/llm/openApi/v2/deepresearch/knowledgeBaseList" \
  -H "Authorization: Bearer ${JWT_TOKEN}" \
  -H "Content-Type: application/json" \
  --data-raw '{"agentId":279,"page":1,"pageSize":10}' \
  --silent | jq

返回参数

返回内容解析

字段路径	类型	示例值	说明
`JSONIFY_PRETTYPRINT_REGULAR`	boolean	`false`	JSON 输出格式控制标记（通常无需业务侧处理）。
`code`	string	`llm/ok`	请求结果码。`llm/ok` 表示请求成功。
`msg`	object	`{}`	提示信息对象；示例为空对象。
`data`	object	`{...}`	Agent 已绑定知识库的分页列表结果。

data 字段（分页信息）

字段路径	类型	示例值	说明
`data.isSuccess`	boolean	`true`	查询是否成功。
`data.errorMsg`	string	`""`	错误信息；成功时通常为空字符串。
`data.items`	array	`[...]`	当前页的知识库绑定关系列表。
`data.page`	integer	`1`	当前页码（从 1 开始）。
`data.pageSize`	integer	`10`	每页数量。
`data.total`	integer	`2`	总记录数（总绑定关系数）。
`data.totalPages`	integer	`1`	总页数。
`data.hasNextPage`	boolean	`false`	是否还有下一页。

data.items[] 字段（绑定关系记录）

字段路径	类型	示例值	说明
`data.items[].id`	integer	`25`	绑定关系记录 ID。
`data.items[].agentId`	integer	`279`	Agent ID。
`data.items[].appId`	integer	`1`	应用 ID。
`data.items[].orgId`	integer	`1`	组织/租户 ID。
`data.items[].knowledgeEngineBaseId`	string	`55`	知识库 ID。
`data.items[].knowledgeEngineBaseName`	string	`openAPi测试`	知识库名称。
`data.items[].knowledgeBase`	object	`{...}`	知识库详情（完整信息）。
`data.items[].knowledgeBaseStatus`	object	`{...}`	知识库状态信息。
`data.items[].isDefault`	boolean	`false`	是否为默认知识库。
`data.items[].priority`	integer	`0`	绑定优先级。
`data.items[].status`	integer	`1`	绑定关系状态（枚举含义以产品侧定义为准）。
`data.items[].deleted`	boolean	`false`	是否已删除。
`data.items[].metaInfo`	object	`{}`	绑定关系扩展信息；示例为空对象。
`data.items[].creator`	string	`admin`	绑定关系创建人。
`data.items[].updator`	string	`admin`	绑定关系最近更新人。
`data.items[].createdAt`	string	`2026-08-14 10:08:23`	绑定关系创建时间。
`data.items[].updatedAt`	string	`2026-08-14 10:08:23`	绑定关系更新时间。

data.items[].knowledgeBaseStatus 字段（知识库状态）

字段路径	类型	示例值	说明
`data.items[].knowledgeBaseStatus.code`	string	`1`	知识库状态码（枚举含义以产品侧定义为准）。
`data.items[].knowledgeBaseStatus.message`	string	`VALID`	知识库状态描述；`VALID` 表示知识库有效。

data.items[].knowledgeBase 字段（知识库详情）

字段路径	类型	示例值	说明
`data.items[].knowledgeBase.id`	integer	`55`	知识库 ID。
`data.items[].knowledgeBase.name`	string	`openAPi测试`	知识库名称。
`data.items[].knowledgeBase.description`	string	`openAPi测试`	知识库描述。
`data.items[].knowledgeBase.tenantId`	integer	`1`	知识库所属租户 ID。
`data.items[].knowledgeBase.createdBy`	string	`admin`	知识库创建人。
`data.items[].knowledgeBase.createDate`	string	`2026-07-18 13:35:37`	创建时间（字符串）。
`data.items[].knowledgeBase.createTime`	integer	`1784352937887`	创建时间戳（毫秒）。
`data.items[].knowledgeBase.updateDate`	string	`2026-07-23 15:44:24`	更新时间（字符串）。
`data.items[].knowledgeBase.updateTime`	integer	`1784792664203`	更新时间戳（毫秒）。
`data.items[].knowledgeBase.status`	string	`1`	知识库状态（枚举含义以产品侧定义为准）。
`data.items[].knowledgeBase.permission`	string	`team`	知识库权限范围。
`data.items[].knowledgeBase.actions`	array	`["read","write","create"]`	当前用户对该知识库可执行的操作集合。
`data.items[].knowledgeBase.approvalRequired`	boolean	`false`	操作是否需要审批。
`data.items[].knowledgeBase.category`	string	`general`	知识库分类。
`data.items[].knowledgeBase.contentType`	string	`general`	内容类型。
`data.items[].knowledgeBase.type`	string	`vision`	知识库类型。
`data.items[].knowledgeBase.language`	string	`English`	知识库语言。
`data.items[].knowledgeBase.docNum`	integer	`6` / `1`	文档数量。
`data.items[].knowledgeBase.chunkNum`	integer	`5` / `0`	切片数量。
`data.items[].knowledgeBase.tokenNum`	integer	`0`	Token 数量。
`data.items[].knowledgeBase.defaultDocId`	integer	`269`	默认文档 ID。
`data.items[].knowledgeBase.parserId`	string	`verag_1_55_kg`	解析器 ID。
`data.items[].knowledgeBase.parserConfig`	object	`{...}`	解析器配置。
`data.items[].knowledgeBase.scheduleConfig`	object	`{...}`	调度配置。
`data.items[].knowledgeBase.similarityThreshold`	number	`0.2`	相似度阈值。
`data.items[].knowledgeBase.vectorSimilarityWeight`	number	`0.3`	向量相似度权重。
`data.items[].knowledgeBase.autoLabels`	array	`[]`	自动标签列表。
`data.items[].knowledgeBase.avatar`	string	null	`null`
`data.items[].knowledgeBase.llmId`	string	null	`null`
`data.items[].knowledgeBase.embdId`	string	`""`	Embedding 模型 ID；示例中为空字符串。
`data.items[].knowledgeBase.retrievalAppCount`	integer	null	`null`
`data.items[].knowledgeBase.subjectId`	integer	`0`	主题 ID。

parserConfig 字段

字段路径	类型	示例值	说明
`data.items[].knowledgeBase.parserConfig.pages`	array	`[[1,1000000]]`	解析页码范围。
`data.items[].knowledgeBase.parserConfig.ragEngine`	string	`sophon`	RAG 引擎标识。

scheduleConfig 字段

字段路径	类型	示例值	说明
`data.items[].knowledgeBase.scheduleConfig.scheduleType`	integer	`0`	调度类型。
`data.items[].knowledgeBase.scheduleConfig.bdbTaskId`	integer	`-1`	BDB 任务 ID；`-1` 通常表示未绑定任务。
`data.items[].knowledgeBase.scheduleConfig.frequency`	string	null	`null`
`data.items[].knowledgeBase.scheduleConfig.dayOfWeek`	string	null	`null`
`data.items[].knowledgeBase.scheduleConfig.dayOfMonth`	string	null	`null`
`data.items[].knowledgeBase.scheduleConfig.timeSetting`	string	null	`null`

项目	说明
查询成功判定	`code = llm/ok` 且 `data.isSuccess = true`，表示查询成功。
绑定数量	`data.total = 1`，表示 Agent 当前共绑定 1 条知识库关系记录。
分页状态	`page = 1`、`pageSize = 10`、`totalPages = 1`、`hasNextPage = false`，表示已返回全部数据。
知识库状态	`knowledgeBaseStatus.message = VALID` 表示知识库有效；示例中两条记录均为 `VALID`。

返回示例

{
  "JSONIFY_PRETTYPRINT_REGULAR": false,
  "code": "llm/ok",
  "data": {
    "errorMsg": "",
    "hasNextPage": false,
    "isSuccess": true,
    "items": [
      {
        "agentId": 279,
        "appId": 1,
        "createdAt": "2026-08-12 11:45:43",
        "creator": "admin",
        "deleted": false,
        "id": 25,
        "isDefault": false,
        "knowledgeBase": {
          "actions": [
            "read",
            "write",
            "create"
          ],
          "approvalRequired": false,
          "autoLabels": [],
          "avatar": null,
          "category": "general",
          "chunkNum": 0,
          "contentType": "general",
          "createDate": "2026-08-12 11:39:38",
          "createTime": 1786505978938,
          "createdBy": "admin",
          "defaultDocId": 269,
          "description": "openAPi测试",
          "docNum": 1,
          "embdId": "",
          "id": 56,
          "language": "English",
          "llmId": null,
          "name": "openAPi测试",
          "parserConfig": {
            "pages": [
              [
                1,
                1000000
              ]
            ],
            "ragEngine": "sophon"
          },
          "parserId": "verag_1_56_kg",
          "permission": "team",
          "retrievalAppCount": null,
          "scheduleConfig": {
            "bdbTaskId": -1,
            "dayOfMonth": null,
            "dayOfWeek": null,
            "frequency": null,
            "scheduleType": 0,
            "timeSetting": null
          },
          "similarityThreshold": 0.2,
          "status": "1",
          "subjectId": 0,
          "tenantId": 1,
          "tokenNum": 0,
          "type": "vision",
          "updateDate": "2026-08-12 11:39:56",
          "updateTime": 1786505996952,
          "vectorSimilarityWeight": 0.3
        },
        "knowledgeBaseStatus": {
          "code": "1",
          "message": "VALID"
        },
        "knowledgeEngineBaseId": "56",
        "knowledgeEngineBaseName": "openAPi测试",
        "metaInfo": {},
        "orgId": 1,
        "priority": 0,
        "status": 1,
        "updatedAt": "2026-08-14 10:32:34",
        "updator": "admin"
      }
    ],
    "page": 1,
    "pageSize": 10,
    "total": 1,
    "totalPages": 1
  },
  "msg": {}
}

最近更新时间：2026.08.17 14:12:02

这个页面对您有帮助吗？

有用

无用

数据智能体 DataAgent（私有化）

查看知识绑定关系 #

请求说明 #

请求参数 #

请求示例 #

返回参数 #

返回内容解析 #

data 字段（分页信息） #

data.items[] 字段（绑定关系记录） #

data.items[].knowledgeBaseStatus 字段（知识库状态） #

data.items[].knowledgeBase 字段（知识库详情） #

parserConfig 字段 #

scheduleConfig 字段 #

#

返回示例 #

查看知识绑定关系

请求说明

请求参数

请求示例

返回参数

返回内容解析

data 字段（分页信息）

data.items[] 字段（绑定关系记录）

data.items[].knowledgeBaseStatus 字段（知识库状态）

data.items[].knowledgeBase 字段（知识库详情）

parserConfig 字段

scheduleConfig 字段

返回示例