概述
在调用百度AI搜索API进行联网搜索总结时,可设置一系列特定的用户输入,通过完全匹配或者语义匹配的方式命中后,进行特定知识库检索后总结、特定知识库检索+联网搜索后总结、预置特定回答等方式进行输出,确保符合品牌立场、人设、形象,该接口仅支持智能搜索生成服务。
在调用该接口前:
新增问答策略
接口定义
请求结构
POST /v2/ai_search/qa_strategy HTTP/1.1HOST: qianfan.baidubce.comAuthorization: Bearer <AppBuilder API Key>Content-Type: application/json{ "query": "xx是组装厂吗?", "config_id": "0035f63a-74fb-4615-b1ea-96f9e1f9ed55", "query_match_strategy": { "name": "keyword", "keywords":[ "xx","组装厂" ] }, "answer_strategy": { "name": "preset_answer", "preset_answer_strategy_detail": { "content": "xx不是组装厂", "references": [ { } ] } }}
请求参数
参数名称
类型
是否必填
描述
query
str
是
问答query,不超过 25 6个字符
config_id
str
否
策略配置id,需要提前调用配置接口创建id
query_match_strategy
object
是
query匹配策略
answer_strategy
object
是
回复策略
query_match_strategy对象
参数名称
类型
是否必填
描述
name
string
是
匹配策略名字: exact-完全匹配 semantic-语义 keyword-关键词匹配
similarity_threshold
float
否
当语义匹配时,该字段会被用到,值介于 0~1 之间,默认 0.9
keywords
array<string>
否
当关键词匹配时,该字段会被用到,范围为0~256
answer_strategy对象
参数名称
类型
是否必填
描述
name
string
是
回复策略
preset_answer_strategy_detail
object
否
预置回答策略
knowledge_base_answer_strategy_detail
object
否
知识库回答策略
answer_strategy.preset_answer_strategy_detail对象
参数名称
类型
是否必填
描述
content
string
是
预设答案内容
references
array[reference]
是
参考信息来源
answer_strategy.knowledge_base_answer_strategy_detail对象
参数名称
类型
是否必填
描述
knowledge_base_ids
array<string>
是
知识库id数组
document_ids
array<string>
是
文档id数组
top_k
int
否
最相关的前k个结果,默认top6
调用示例
curl --location 'https://qianfan.baidubce.com/v2/ai_search/qa_strategy' \--header 'Content-Type: application/json' \--header 'Authorization: <token>' \--data '{ "query": "xx是组装厂吗?", "query_match_strategy": { "name": "keyword", "keywords":[ "xx","组装厂" ] }, "answer_strategy": { "name": "preset_answer", "preset_answer_strategy_detail": { "content": "xx不是组装厂", "references": [ { } ] } }}'
响应参数
参数名称
类型
是否必填
描述
request_id
string
是
请求request_id
code
string
否
错误代码,当发生异常时返回
message
string
否
错误消息,当发生异常时返回
响应示例
删除问答策略
接口定义
请求结构
DELETE /v2/ai_search/qa_strategy HTTP/1.1HOST: qianfan.baidubce.comAuthorization: Bearer <AppBuilder API Key>Content-Type: application/jsonquery=%E5%B0%8F%E7%B1%B3%E6%98%AF%E7%BB%84%E8%A3%85%E5%8E%82%E5%90%97%EF%BC%9F?
请求params入参
参数名称
类型
是否必须
描述
query
str
是
需要对query进行urlencode
config_id
str
否
策略配置id,需要提前调用配置接口创建id
调用示例
curl -X "DELETE" \-H "Authorization: <token> " \--location 'https://qianfan.baidubce.com/v2/ai_search/qa_strategy?query=%E5%B0%8F%E7%B1%B3%E6%98%AF%E7%BB%84%E8%A3%85%E5%8E%82%E5%90%97%EF%BC%9F'
响应参数
参数名称
类型
是否必填
描述
request_id
string
是
请求request_id
code
string
否
错误代码,当发生异常时返回
message
string
否
错误消息,当发生异常时返回
响应示例
分页查询问答策略
接口定义
请求结构
GET /v2/ai_search/qa_strategy HTTP/1.1HOST: qianfan.baidubce.comAuthorization: Bearer <AppBuilder API Key>Content-Type: application/json?offset=2&limit=4
请求params入参
参数名称
类型
是否必须
描述
offset
str
否
偏移量
limit
str
否
条数限制,最大不超过 50
config_id
str
是
配置id
调用示例
curl --location 'https://qianfan.baidubce.com/v2/ai_search/qa_strategy?offset=2&limit=4' \--header 'Content-Type: application/json' \--header 'Authorization: <token>' \
响应格式
参数名称
类型
必填
描述
request_id
string
是
请求request_id
code
string
否
错误代码,当发生异常时返回
message
string
否
错误消息,当发生异常时返回
count
int
是
结果总数
items
array<qa_strategy>
是
问答策略数组
+qa_strategy
object
是
问答策略
++answer_strategy
object
是
回复策略
++query_match_strategy
object
是
query匹配策略
++query
string
是
query
响应示例
{ "request_id": "123", "count": 14, "items": [{ "qa_strategy": { "answer_strategy": { "knowledge_base_answer_strategy_detail": null, "name": "preset_answer", "preset_answer_strategy_detail": { "content": "今天黄金价格多少一克", "references": [{ "content": " 快讯 美元指数再次冲高!金价小幅上涨!...", "date": "2024-12-03", "given_to_llm": true, "icon": "https://appbuilder.bj.bcebos.com/baidu-search-rag-pro/icon/default.png", "image_detail": { "height": null, "url": null, "width": null }, "ref_num": "1", "resource_type": "web", "title": "今天黄金价格多少一克_今日金价表_2024年金价多少钱...", "url": "http://www.huangjinjiage.cn/", "video": null, "web_anchor": "金价查询网" }] } }, "query_match_strategy": { "name": "exact", "similarity_threshold": 0.0 } }, "query": "小米是组装厂吗" }]}