Skip to main content
智谱AI 为开发者提供全系列 AI 搜索工具，覆盖 基础检索（Web Search API）、问答增强（Web Search in Chat）、搜索智能体（Search Agent） 三大服务，基于统一 API 接口集成自研引擎及第三方服务（搜狗/夸克），提供从原始网页数据抓取、搜索结果与 LLM 生成融合、到多轮对话上下文管理的全链路能力，助力开发者以 更低成本 构建可信、实时、可溯源的 AI 应用。

​
服务概览

Web Search API

直接获取结构化搜索结果（标题/摘要/链接等），支持多搜索引擎

Web Search in Chat

将搜索结果融入大模型生成回答并标注网页结果来源，实时检索+LLM生成无缝衔接

Search Agent

根据搜索意图进行query拆解，对话状态管理与智能路由，意图理解增强上下文管理

​
Web Search API

Web Search API 是一个专给大模型用的搜索引擎，在传统搜索引擎网页抓取、排序的能力基础上，增强了意图识别能力，返回更适合大模型处理的结果（网页标题、网页 URL、网页摘要、网站名称、网站图标等）。
  1. 意图增强检索：支持智能识别用户查询意图，自动判断是否需要网页检索
  2. 结构化输出：返回适合 LLM 处理的数据格式（含标题/URL/摘要/网站名/图标等）
  3. 多引擎支持：整合智谱自研引擎及主流搜索引擎（搜狗/夸克）
  4. 支持指定范围搜索：可自定义返回的搜索结果数量、域名、时间范围等指定搜索，并可调整网页摘要的字数，帮助实现搜索行为的精细化管控
  5. 可灵活控制输出结果时间：响应参数可设置网页发布时间字段，便于时效性分析和排序
接口调用
  • Python
  • Java
  • 响应示例
安装 SDK
# 安装最新版本
pip install zai-sdk

# 或指定版本
pip install zai-sdk==0.0.4
验证安装
import zai
print(zai.__version__)

from zai import ZhipuAiClient

client = ZhipuAiClient(api_key="your-api-key")

response = client.web_search.web_search(
   search_engine="search_pro",
   search_query="搜索2025年4月的财经新闻",
   count=15,  # 返回结果的条数，范围1-50，默认10
   search_domain_filter="www.sohu.com",  # 只访问指定域名的内容
   search_recency_filter="noLimit",  # 搜索指定日期范围内的内容
   content_size="high"  # 控制网页摘要的字数，默认medium
)
print(response)

​
MCP Server

访问官方MCP文档了解更多关于该协议的信息。
安装指南
  • 使用支持MCP协议的客户端，如Cursor和Cherry Studio。
  • 从智谱AI 平台获取 API 密钥。
在Cursor中使用Cursor 0.45.6包含MCP功能。Cursor 作为 MCP 服务客户端，可以通过简单配置连接到 MCP 服务。导航路径：Cursor设置 → [功能] → [MCP服务器]配置 MCP 服务器
{
  "mcpServers": {
    "zhipu-web-search-sse": {
      "url": "https://open.bigmodel.cn/api/mcp-broker/proxy/web-search/mcp?Authorization=Your Zhipu API Key"
    }
  } 
}
Cursor MCP 使用方法Cursor MCP 需在 Composer 的 Agent 模式下使用。

​
对话中的网络搜索

对话中的网络搜索允许 Completions API 调用搜索引擎，将实时网络检索结果与 GLM 的生成能力相结合，提供最新且可验证的答案。
  • Python
  • Java
  • 响应示例
安装 SDK
# 安装最新版本
pip install zai-sdk

# 或指定版本
pip install zai-sdk==0.0.4
验证安装
import zai
print(zai.__version__)

from zai import ZhipuAiClient

client = ZhipuAiClient(api_key="your-api-key")

# 定义工具参数
tools = [{
    "type": "web_search",
    "web_search": {
        "enable": "True",
        "search_engine": "search_pro",
        "search_result": "True",
        "search_prompt": "你是一位财经分析师。请用简洁的语言总结网络搜索{search_result}中的关键信息，按重要性排序并引用来源日期。今天的日期是2025年4月11日。",
        "count": "5",
        "search_domain_filter": "www.sohu.com",
        "search_recency_filter": "noLimit",
        "content_size": "high"
    }
}]

# 定义用户消息
messages = [{
    "role": "user",
    "content": "2025年4月的重要财经事件、政策变化和市场数据"
}]

# 调用API获取响应
response = client.chat.completions.create(
    model="glm-4-air",  # 模型标识符
    messages=messages,  # 用户消息
    tools=tools         # 工具参数
)

# 打印响应结果
print(response)

​
搜索智能体

基于搜索意图，智能分解为多个搜索查询，检索对应的搜索结果，并综合所有网页内容生成全面的模型回答。答案详尽且富有洞察力。
  • Python
  • Java
  • 运行结果
安装 SDK
# 安装最新版本
pip install zai-sdk

# 或指定版本
pip install zai-sdk==0.0.4
验证安装
import zai
print(zai.__version__)

from zai import ZhipuAiClient

client = ZhipuAiClient(api_key="your-api-key")
generate = client.assistant.conversation(  
    assistant_id="659e54b1b8006379b4b2abd6",  
    conversation_id=None,  
    model="glm-4-assistant",  
    messages=[  
        {  
            "role": "user",  
            "content": [{  
                "type": "text",  
                "text": "请对2025年第一季度中东地缘政治冲突对全球能源市场的影响进行全面分析。结合原油价格波动数据、主要产油国政策调整以及欧洲能源替代方案。生成基于时间线的风险评估报告，突出期货市场的实时反应和关键机构响应（如IEA建议）。"  
            }]  
        }  
    ],  
    stream=True,  
    attachments=None,  
    metadata=None  
)  

for resp in generate:  
    print(resp)

​
搜索引擎说明

搜索引擎编码特性价格
search_std基础版（智谱AI 自研）：满足日常查询需求，性价比极高0.01元/次
search_pro高级版（智谱AI 自研）：多引擎协作显著降低空结果率，召回率和准确率大幅提升0.03元/次
search_pro_sogou搜狗：覆盖腾讯生态（新闻/企鹅号）和知乎内容，在百科、医疗等垂直领域权威性强0.05元/次
search_pro_quark夸克：精准触达垂直内容0.05元/次
⌘I