领域知识注入
更新时间：2025-09-18
概述
用户可通过接口注入特定领域知识，提升整体的问答效果，该接口仅支持智能搜索生成服务。
增加领域知识
接口定义
| URL | 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":[{"key":"艾酷","value":"iqoo,IQOO"},
7 {"key":"南航","value":"南方航空"}]
8}Header参数
| 参数名称 | 描述 |
|---|---|
| Authorization | AppBuilder API Key请前往控制台获取。 |
Body参数
| 参数名称 | 类型 | 是否必选 | 描述 |
|---|---|---|---|
| items | Array<Knowledge> | 是 | 领域知识不能超过十个，每个领域知识长度不能超过200个字符。 |
| config_id | string | 否 | 策略配置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 '{"items":[{"key":"艾酷","value":"iqoo,IQOO"},{"key":"南航","value":"南方航空"}]}'响应示例
Plain Text
1{
2 "request_id": "123"
3}删除领域知识
接口定义
| URL | 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 | AppBuilder API Key请前往控制台获取。 |
Query参数
| 参数名称 | 类型 | 是否必选 | 描述 |
|---|---|---|---|
| key | string | 是 | 需要对key进行urlencode。 |
| config_id | string | 否 | 策略配置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 | /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 | AppBuilder API Key请前往控制台获取。 |
Query参数
| 参数名称 | 类型 | 是否必选 | 描述 |
|---|---|---|---|
| offset | string | 否 | 偏移量。 |
| limit | string | 否 | 条数限制，最大不超过 50。 |
| config_id | string | 否 | 配置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}