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