You need to enable JavaScript to run this app.
文档中心
数据智能体 DataAgent（私有化）

数据智能体 DataAgent（私有化）

请输入
  • 文档首页
    • 数据智能体 DataAgent（私有化）iDAOpenAPI智能体智能体绑定知识库
复制全文
下载 pdf
我的收藏
智能体
智能体绑定知识库
复制全文
下载 pdf
我的收藏
智能体绑定知识库

智能体绑定知识库 bindKnowledgeBase

请求说明

用于将知识引擎知识库绑定到指定智能体上。

项目

内容

请求方式

POST

请求地址

https://${IDA_DOMAIN}/dataAgent/llm/openApi/v2/deepresearch/bindKnowledgeBase

默认鉴权

Authorization: Bearer ${JWT_TOKEN}

内容类型

Content-Type: application/json

请求参数

位置

参数

类型

是否必选

示例值

传参说明

Body

agentId

number

是

61

智能体 ID。

Body

appId

number

否

1

项目 ID（知识引擎项目），作为知识库归属租户。
数据来源参考IDA-获取知识库项目

Body

knowledgeEngineBaseIds

number[]

否

[182]

知识引擎知识库 ID 列表。
数据来源参考IDA-获取项目下的知识库列表

说明：当 knowledgeEngineBaseIds 为空数组或不传时，接口行为（是否清空绑定/不做变更）以实际实现为准。

请求示例

标准 Curl 示例：

curl -X POST \
  "https://${IDA_DOMAIN}/dataAgent/llm/openApi/v2/deepresearch/bindKnowledgeBase" \
  -H "Authorization: Bearer ${JWT_TOKEN}" \
  -H "Content-Type: application/json" \
  --data-raw '{"agentId":279,"appId":1,"knowledgeEngineBaseIds":[182]}' \
  --silent | jq

返回参数

data 字段

字段路径

类型

示例值

说明

data.success

array

[...]

绑定成功的知识库简要结果列表。

data.failed

array

[]

绑定失败的知识库简要结果列表。

data.errorMsg

array

[]

错误信息列表（通常用于汇总错误提示）。

data.message

string

""

总体提示信息。

data.extra

object

{...}

绑定过程的扩展信息（包含更完整的知识库详情与分类结果）。

data.success[] 字段（简要结果）

字段路径

类型

示例值

说明

data.success[].id

integer

55

知识库 ID。

data.success[].name

string

xxx的知识库

知识库名称。

data.success[].success

boolean

true

是否绑定成功。

data.success[].errorMsg

string

null

null

data.extra 字段（扩展结果）

字段路径

类型

示例值

说明

data.extra.successKnowledgeBaseList

array

[...]

成功绑定的知识库完整信息列表。

data.extra.failedKnowledgeBaseList

array

[]

绑定失败的知识库完整信息列表。

data.extra.duplicatedKnowledgeBaseList

array

[]

重复绑定的知识库列表（例如请求中包含已绑定的知识库）。

data.extra.successKnowledgeBaseList[] 字段（知识库完整信息）

字段路径

类型

示例值

说明

...[].id

integer

55

知识库 ID。

...[].name

string

xxx的知识库

知识库名称。

...[].description

string

xxxx的测试知识库

知识库描述。

...[].tenantId

integer

1

知识库所属租户 ID。

...[].createdBy

string

admin

创建人。

...[].createDate

string

2026-07-18 13:35:37

创建时间（字符串）。

...[].createTime

integer

1784352937887

创建时间戳（毫秒）。

...[].updateDate

string

2026-07-23 15:44:24

更新时间（字符串）。

...[].updateTime

integer

1784792664203

更新时间戳（毫秒）。

...[].status

string

1

知识库状态（枚举含义以产品侧定义为准）。

...[].permission

string

team

知识库权限范围（枚举含义以产品侧定义为准）。

...[].actions

array

["read","write","create"]

当前用户可对该知识库执行的操作集合。

...[].approvalRequired

boolean

false

操作是否需要审批。

...[].category

string

general

知识库分类。

...[].contentType

string

general

内容类型。

...[].type

string

vision

知识库类型。

...[].language

string

English

知识库语言。

...[].docNum

integer

6

文档数量。

...[].chunkNum

integer

5

切片数量。

...[].tokenNum

integer

0

Token 数量。

...[].defaultDocId

integer

262

默认文档 ID。

...[].parserId

string

verag_1_55_kg

解析器 ID。

...[].parserConfig

object

{...}

解析器配置。

...[].similarityThreshold

number

0.2

相似度阈值。

...[].vectorSimilarityWeight

number

0.3

向量相似度权重。

...[].scheduleConfig

object

{...}

调度配置。

...[].autoLabels

array

[]

自动标签列表。

...[].avatar

string

null

null

...[].llmId

string

null

null

...[].embdId

string

""

Embedding 模型 ID；示例中为空字符串。

...[].retrievalAppCount

integer

null

null

...[].subjectId

integer

0

主题 ID。

parserConfig 字段

字段路径

类型

示例值

说明

...[].parserConfig.pages

array

[[1,1000000]]

解析页码范围。

...[].parserConfig.ragEngine

string

sophon

RAG 引擎标识。

scheduleConfig 字段

字段路径

类型

示例值

说明

...[].scheduleConfig.scheduleType

integer

0

调度类型。

...[].scheduleConfig.bdbTaskId

integer

-1

BDB 任务 ID；-1 通常表示未绑定任务。

...[].scheduleConfig.frequency

string

null

null

...[].scheduleConfig.dayOfWeek

string

null

null

...[].scheduleConfig.dayOfMonth

string

null

null

...[].scheduleConfig.timeSetting

string

null

null

结果判定与说明

项目

说明

绑定成功判定

code = llm/ok 且 data.success[].success = true，表示对应知识库绑定成功。

成功列表（简要）

data.success 用于快速查看哪些知识库绑定成功。

成功列表（详细）

data.extra.successKnowledgeBaseList 返回成功绑定知识库的完整信息。

失败列表

data.failed 与 data.extra.failedKnowledgeBaseList 为空表示无失败项。

重复列表

data.extra.duplicatedKnowledgeBaseList 为空表示无重复绑定项。

响应示例

{
  "JSONIFY_PRETTYPRINT_REGULAR": false,
  "code": "llm/ok",
  "data": {
    "errorMsg": [],
    "extra": {
      "duplicatedKnowledgeBaseList": [],
      "failedKnowledgeBaseList": [],
      "successKnowledgeBaseList": [
        {
          "actions": [
            "read",
            "write",
            "create"
          ],
          "approvalRequired": false,
          "autoLabels": [],
          "avatar": null,
          "category": "general",
          "chunkNum": 5,
          "contentType": "general",
          "createDate": "2026-07-18 13:35:37",
          "createTime": 1784352937887,
          "createdBy": "admin",
          "defaultDocId": 262,
          "description": "xxx的测试知识库",
          "docNum": 6,
          "embdId": "",
          "id": 55,
          "language": "English",
          "llmId": null,
          "name": "xxx的知识库",
          "parserConfig": {
            "pages": [
              [
                1,
                1000000
              ]
            ],
            "ragEngine": "sophon"
          },
          "parserId": "verag_1_55_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-07-23 15:44:24",
          "updateTime": 1784792664203,
          "vectorSimilarityWeight": 0.3
        }
      ]
    },
    "failed": [],
    "message": "",
    "success": [
      {
        "errorMsg": null,
        "id": 55,
        "name": "xxx的知识库",
        "success": true
      }
    ]
  },
  "msg": {}
}

最近更新时间：2026.08.17 14:12:01
这个页面对您有帮助吗？
有用
有用
无用
无用