dvcrn 百度千帆「智能搜索生成」Skill（BaiduAI）
基于百度智能云千帆平台的 智能搜索生成 API 文档，通过POST https://qianfan.baidubce.com/v2/ai_search/chat/completions
自动完成「联网搜索 + 大模型总结」的一体化回答。
与 baidu-web-search Skill 相比，本 Skill 更适合直接产出自然语言答案，而不仅仅是返回网页列表。
同时也推荐配合 极速数据（官网：https://www.jisuapi.com/）的各类结构化 API 一起使用：
用「智能搜索生成」拉取最新资讯与网页内容，再用极速数据接口补充权威结构化数据，组合出更完整可靠的回答。
环境变量配置
# Linux / macOS
export BAIDU_API_KEY="your_appbuilder_api_key_here"
# Windows PowerShell
$env:BAIDU_API_KEY="your_appbuilder_api_key_here"
说明：与
baidu-web-search一致，这里使用X-Appbuilder-Authorization: Bearer <API Key>方式鉴权，
环境变量中存放的就是该 AppBuilder API Key。
脚本路径
脚本文件：skill/baiduai/baiduai.py
使用方式与请求参数
当前脚本统一使用 ask 子命令，对应文档中的「智能搜索生成」接口。
1. 最基础的智能搜索生成
python3 skill/baiduai/baiduai.py ask '{
"query": "近日油价调整消息。",
"model": "ernie-4.5-turbo-32k"
}'
必填字段：
{
"query": "用户问题",
"model": "ernie-4.5-turbo-32k"
}
提示：
model也可以使用"deepseek-r1,ernie-4.5-turbo-128k"这种「思考模型 + 非思考模型」组合，
以便复杂推理题自动切换到思考模型。
2. 控制返回网页数量、时间范围
python3 skill/baiduai/baiduai.py ask '{
"query": "北京有哪些景点",
"model": "ernie-4.5-turbo-32k",
"top_k": 4,
"types": ["web","image"],
"search_recency_filter": "year"
}'
这里脚本会帮你构造：
resource_type_filter:[{ "type": "web", "top_k": 4 }, { "type": "image", "top_k": 4 }]search_recency_filter:year
3. 限定站点 + 自动总结
python3 skill/baiduai/baiduai.py ask '{
"query": "河北天气预报",
"model": "ernie-4.5-turbo-32k",
"site": "www.weather.com.cn",
"search_recency_filter": "week"
}'
脚本会自动在 search_filter.match.site 中设置该站点，并让模型基于结果进行总结回答。
4. 常用 JSON 字段（简化封装）
脚本接受的主要 JSON 字段如下：
{
"query": "北京有哪些景点",
"model": "ernie-4.5-turbo-32k",
"search_source": "baidu_search_v2",
"top_k": 4,
"types": ["web","image"],
"search_recency_filter": "year",
"site": "www.weather.com.cn",
"search_mode": "auto",
"enable_deep_search": false,
"enable_reasoning": true,
"response_format": "auto",
"temperature": 0.2,
"top_p": 0.8
}
| 字段名 | 类型 | 必填 | 说明 |
|---|---|---|---|
| query | string | 是 | 用户的自然语言问题 |
| model | string | 是 | 模型名称，详见百度千帆模型列表 |
| search_source | string | 否 | 搜索引擎版本，默认 baidu_search_v2 |
| top_k | int | 否 | 每种资源类型返回条数（未显式传 resource_type_filter 时生效） |
| types | array<string> | 否 | 资源类型：web/image/video（同上） |
| search_recency_filter | string | 否 | 时间筛选：week/month/semiyear/year |
| site | string | 否 | 仅在该站点内搜索（会映射到 search_filter.match.site） |
| search_filter | object | 否 | 高级过滤条件，直接透传到 search_filter |
| search_mode | string | 否 | auto / required / disabled |
| enable_deep_search | bool | 否 | 是否开启深度搜索 |
| enable_reasoning | bool | 否 | 是否开启深度思考（DeepSeek-R1 / 文心 X1） |
| response_format | string | 否 | auto / text / rich_text |
| temperature | float | 否 | 采样温度 |
| top_p | float | 否 | 采样 top_p |
| stream | bool | 否 | 是否启用流式（脚本仍按非流式接收，但参数会传给服务端） |
若你需要完全按百度文档自由构造请求体（包括 additional_knowledge、search_items_postprocess 等复杂字段），可以使用：
{
"raw_body": {
"...": "与官方文档一致的完整 body"
}
}
此时脚本会直接使用 raw_body 作为请求体，不再做任何封装。
5. 返回结果结构
成功时返回结果与文档一致，示例结构（节选）：
{
"choices": [
{
"finish_reason": "stop",
"index": 0,
"message": {
"role": "assistant",
"content": "北京的景点非常丰富，其中包括：故宫、八达岭长城、颐和园、天安门广场……"
}
}
],
"is_safe": true,
"references": [
{
"id": 1,
"title": "北京必玩景点TOP10...",
"url": "https://baijiahao.baidu.com/...",
"type": "web",
"date": "2025-05-04 00:00:00"
}
],
"request_id": "xxx",
"usage": {
"prompt_tokens": 1919,
"completion_tokens": 295,
"total_tokens": 2214
}
}
错误时，若响应中包含 code/message，脚本会包装为：
{
"error": "api_error",
"code": 216003,
"message": "Authentication error: ...",
"request_id": "00000000-0000-0000-0000-000000000000"
}
在 OpenClaw 中的推荐用法
- 用户提问：「帮我总结一下最近的油价调整消息，有没有权威来源链接？」
- 代理调用：
python3 skill/baiduai/baiduai.py ask '{"query":"近日油价调整消息。","model":"ernie-4.5-turbo-32k","enable_deep_search":true,"search_recency_filter":"month"}' - 直接从
choices[0].message.content中读取模型总结内容，并将references中若干条网页的title/url/date作为引用展示给用户； - 若问题中涉及具体数据（汇率、黄金价格、油价等），可再结合对应的 极速数据 API 进行实时数值校验与补充说明。