概述
用户可通过接口注入特定领域知识,提升整体的问答效果,该接口仅支持智能搜索生成服务。
增加领域知识
接口定义
请求结构
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":"南方航空"}
]
}
请求body入参
字段名 |
字段类型 |
是否必须 |
说明 |
items |
Array |
是 |
领域知识不能超过十个、每个领域知识长度不能超过200个字符" |
config_id |
str |
否 |
策略配置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":"南方航空"}
]
}'
响应示例
删除领域知识
接口定义
请求结构
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
请求params入参
字段名 |
字段类型 |
是否必须 |
说明 |
key |
str |
是 |
需要对key进行urlencode |
config_id |
str |
否 |
策略配置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'
查询领域知识
接口定义
请求结构
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
请求params入参
字段名 |
字段类型 |
是否必须 |
说明 |
offset |
str |
否 |
偏移量 |
limit |
str |
否 |
条数限制,最大不超过 50 |
config_id |
str |
否 |
配置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"
}