联网搜索

一个接口完成联网搜索，自动选择最优服务商。

使用场景

• 用户需要搜索任何网络信息

使用流程

1. 判断搜索强度 → 2. 调用接口 → 3. 使用结果

1. 判断搜索强度

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"]        # 错误信息

参数

返回值

{
    "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