领域知识注入
更新时间：2025-06-24
概述
用户可通过接口注入特定领域知识，提升整体的问答效果，该接口仅支持智能搜索生成服务。
增加领域知识
接口定义
| URL | https://qianfan.baidubce.com/v2/ai_search/domain_knowledge |
|---|---|
| Method | POST |
| Content-Type | application/json |
请求结构
Plain Text
1POST /v2/ai_search/domain_knowledge HTTP/1.1
2HOST: qianfan.baidubce.com
3Authorization: Bearer <AppBuilder API Key>
4Content-Type: application/json
5{
6 "items":[
7 {"key":"艾酷","value":"iqoo,IQOO"},
8 {"key":"南航","value":"南方航空"}
9 ]
10}Header参数
| 字段 | 值 | 说明 |
|---|---|---|
| Content-Type | application/json | 必填 |
| Authorization | XXXXX | XXXXX为appbuider-token，请前往获取https://console.bce.baidu.com/ai_apaas/secretKey |
请求body入参
| 字段名 | 字段类型 | 是否必须 | 说明 |
|---|---|---|---|
| items | Array |
是 | 领域知识不能超过十个、每个领域知识长度不能超过200个字符" |
| config_id | str | 否 | 策略配置id，需要提前调用配置接口创建id |
Knowledge
| 字段名 | 字段类型 | 是否必须 | 说明 |
|---|---|---|---|
| key | string | 是 | 原始关键词key |
| value | string | 是 | 对应规范领域知识value |
调用示例
Plain Text
1curl --location 'https://qianfan.baidubce.com/v2/ai_search/domain_knowledge' \
2--header 'X-Appbuilder-Authorization: Bearer <token>' \
3--header 'X-Appbuilder-User-Id: 56db3ee88b9e4c4dad3294ba9ffe44a6' \
4--header 'Content-Type: application/json' \
5--data '{
6 "items":[
7 {"key":"艾酷","value":"iqoo,IQOO"},
8 {"key":"南航","value":"南方航空"}
9 ]
10}'响应示例
Plain Text
1{"request_id": "123"}删除领域知识
接口定义
| URL | https://qianfan.baidubce.com/v2/ai_search/domain_knowledge |
|---|---|
| Method | DELETE |
| Content-Type | application/json |
请求结构
Plain Text
1DELETE /v2/app/conversation HTTP/1.1
2HOST: qianfan.baidubce.com
3Authorization: Bearer <AppBuilder API Key>
4Content-Type: application/json
5?key=%E8%89%BE%E9%85%B7Header参数
| 字段 | 值 | 说明 |
|---|---|---|
| Authorization | XXXXX | XXXXX为appbuider-token，请前往获取https://console.bce.baidu.com/ai_apaas/secretKey |
请求params入参
| 字段名 | 字段类型 | 是否必须 | 说明 |
|---|---|---|---|
| key | str | 是 | 需要对key进行urlencode |
| config_id | str | 否 | 策略配置id，需要提前调用配置接口创建id |
调用示例
Plain Text
1#删除key：艾酷
2curl --location --request DELETE 'https://qianfan.baidubce.com/v2/ai_search/domain_knowledge?key=%E8%89%BE%E9%85%B7' \
3--header 'X-Appbuilder-Authorization: Bearer <token>' \
4--header 'X-Appbuilder-User-Id: 56db3ee88b9e4c4dad3294ba9ffe44a6' \
5--header 'Content-Type: application/json'查询领域知识
接口定义
| URL | https://qianfan.baidubce.com/v2/ai_search/domain_knowledge |
|---|---|
| Method | GET |
| Content-Type | application/json |
请求结构
Plain Text
1GET /v2/ai_search/domain_knowledge HTTP/1.1
2HOST: qianfan.baidubce.com
3Authorization: Bearer <AppBuilder API Key>
4Content-Type: application/json
5?offset=0&limit=50Header参数
| 字段 | 值 | 说明 |
|---|---|---|
| Authorization | XXXXX | XXXXX为appbuider-token，请前往获取https://console.bce.baidu.com/ai_apaas/secretKey |
请求params入参
| 字段名 | 字段类型 | 是否必须 | 说明 |
|---|---|---|---|
| offset | str | 否 | 偏移量 |
| limit | str | 否 | 条数限制，最大不超过 50 |
| config_id | str | 否 | 配置id |
调用示例
Plain Text
1curl --location 'https://qianfan.baidubce.com/v2/ai_search/domain_knowledge?offset=0&limit=50' \
2--header 'X-Appbuilder-Authorization: Bearer <token>' \
3--header 'X-Appbuilder-User-Id: 56db3ee88b9e4c4dad3294ba9ffe44a6' \
4--header 'Content-Type: application/json'响应示例
Plain Text
1{
2 "count": 1,
3 "items": [
4 {
5 "key": "艾酷",
6 "value": "iqoo"
7 }
8 ],
9 "request_id": "352ffa2f-bb1d-425f-8a7d-905046608193"
10}