联网搜索
一个接口完成联网搜索，自动选择最优服务商。
使用场景
- 用户需要搜索任何网络信息
使用流程
1. 判断搜索强度 → 2. 调用接口 → 3. 使用结果
1. 判断搜索强度
| 用户需求 | intensity 参数 | 说明 |
|---|---|---|
| 快速查询（天气、股价） | "quick" | 速度最快 |
| 一般查询（新闻、常识） | "normal" | 平衡速度和覆盖 |
| 深度查询（研究、分析） | "deep" | 结果最全面 |
2. 调用接口
from web_search import search
result = search("关键词", intensity="quick", freshness=7, sites=["gov.cn"])
3. 使用结果
if result["success"]:
answer = result["answer"] # 答案文本
sources = result["sources"] # 来源列表
else:
error = result["error"] # 错误信息
参数
| 参数 | 类型 | 默认值 | 说明 |
|---|---|---|---|
| query | str | 必填 | 搜索问题 |
| intensity | str | "normal" | 搜索强度：quick（快速）/normal（平衡）/deep（全面） |
| freshness | int | None | 时效筛选：7/30/180/365 天 |
| sites | list | None | 限定站点：["gov.cn"] |
返回值
{
"success": True,
"answer": "答案文本",
"sources": [{"title": "...", "url": "..."}]
}
示例
from web_search import search
# 快速查询
result = search("北京天气", intensity="quick")
# 一般查询 + 时效筛选
result = search("AI新闻", intensity="normal", freshness=7)
# 深度查询 + 站点限定
result = search("政策分析", intensity="deep", sites=["gov.cn"])
配置密钥
使用前需配置至少一个服务商密钥：
# 百炼（推荐国内搜索）
export BAILIAN_API_KEY="sk-eb..."
# Tavily（推荐海外搜索）
export TAVILY_API_KEY="tvly-dev-..."
# 火山引擎（国内备用）
export ARK_API_KEY="..."
其他文件
- 搜索实现 →
scripts/web_search.py - 服务商详情 →
references/comparison.md