百炼 WebSearch 快速入门指南

什么是百炼 WebSearch？

百炼 WebSearch 是阿里云百炼平台提供的一款强大的联网搜索 MCP（Model Context Protocol）工具。它能够让你的 AI 应用具备实时获取互联网信息的能力，突破大模型训练数据的时效性限制。
地址：https://bailian.console.aliyun.com/

为什么选择百炼 WebSearch？

核心优势

1. 实时性：获取最新的网络信息，不受模型训练时间限制
2. 准确性：基于通义实验室先进的搜索算法，提供高质量的搜索结果
3. 易用性：标准化 API 接口，快速集成到现有系统
4. 稳定性：企业级服务保障，高可用性设计

应用场景

• RAG（检索增强生成）系统中的外部知识补充
• 需要实时信息的智能客服系统
• 动态数据查询的业务场景
• 智能问答系统的信息扩展

快速入门教程

第一步：开通百炼服务

1. 登录阿里云百炼控制台
2. 进入 MCP 广场搜索 "websearch"
3. 找到 "联网搜索" 服务并开通

第二步：获取 API 密钥

1. 在百炼控制台创建 API Key
2. 获取访问所需的 Base URL 和认证信息

第三步：环境准备

# 安装必要的依赖
pip install openai-agents
pip install python-dotenv

第四步：核心代码实现

以下是完整的使用示例：

import asyncio
import os
import json
from agents.mcp import MCPServerStreamableHttp

# 配置参数
DASHSCOPE_BASE_URL = "your-dashscope-base-url"  # 从百炼控制台获取
DASHSCOPE_API_KEY = "your-api-key"              # 从百炼控制台获取

async def search_with_bailian(query: str, count: int = 5):
    """
    调用百炼 WebSearch 进行网络搜索
    
    Args:
        query: 搜索关键词
        count: 返回结果数量
        
    Returns:
        搜索结果列表
    """
    # 创建 MCP 客户端
    search_client = MCPServerStreamableHttp(
        name="web_search_mcp",
        params={
            "url": DASHSCOPE_BASE_URL,
            "headers": {"Authorization": f"Bearer {DASHSCOPE_API_KEY}"},
            "timeout": 10,  # 连接超时时间
        },
        max_retry_attempts=3
    )
    
    try:
        # 建立连接
        await search_client.connect()
        
        # 调用搜索工具
        result = await search_client.call_tool(
            tool_name="bailian_web_search",
            arguments={
                "query": query,
                "count": count,
            }
        )
        
        # 解析搜索结果
        search_data = json.loads(result.content[0].text)
        web_documents = search_data.get("pages", [])
        
        return web_documents
        
    finally:
        # 清理资源
        await search_client.cleanup()

def main():
    """主函数示例"""
    # 测试搜索
    query = "海尔洗衣机操作指南"
    
    # 异步执行搜索
    results = asyncio.run(search_with_bailian(query))
    
    # 处理结果
    print(f"找到 {len(results)} 条搜索结果")
    for i, doc in enumerate(results, 1):
        print(f"\n--- 结果 {i} ---")
        print(f"标题: {doc.get('title', '无标题')}")
        print(f"URL: {doc.get('url', '无链接')}")
        print(f"摘要: {doc.get('snippet', '无摘要')[:100]}...")

if __name__ == "__main__":
    main()

最佳实践建议

1. 错误处理

async def safe_search(query: str):
    try:
        results = await search_with_bailian(query)
        return results
    except Exception as e:
        logger.error(f"搜索失败: {e}")
        return []

2. 性能优化

• 合理设置超时时间
• 使用连接池复用连接
• 控制并发请求数量

3. 结果处理

def process_search_results(results):
    """处理搜索结果，提取有用信息"""
    processed_docs = []
    for doc in results:
        processed_docs.append({
            "title": doc.get("title", ""),
            "url": doc.get("url", ""),
            "snippet": doc.get("snippet", "")[:200],  # 限制摘要长度
            "source": doc.get("hostname", "")
        })
    return processed_docs

常见问题

Q1: 如何调试搜索效果？

A: 可以使用百炼控制台提供的测试工具，或者在代码中添加详细的日志记录。

Q2: 搜索结果的准确性如何保证？

A: 百炼使用了多种检索模型和语义理解技术，可以通过调整查询词和结果过滤来提高准确性。

Q3: 费用如何计算？

A: 按调用次数或 Token 消耗计费，具体请参考百炼官方定价说明。

总结

百炼 WebSearch 为开发者提供了简单而强大的网络搜索能力，特别适合需要实时信息的 AI 应用场景。通过简单的 API 调用，即可让您的应用获得最新的网络信息，大幅提升用户体验。