百度智能云千帆AppBuilder平台利用百度AI搜索API搭建智能体

大模型开发/技术交流

千帆AI搜索开发大赛
百度AI搜索

9月19日2037看过

百度智能云千帆AppBuilder提供的智能搜索能力，通过整合全网实时信息检索与智能总结技术，为开发者构建知识增强型应用提供了高效工具。本文将从API功能特性、核心参数配置、请求响应结构等维度展开技术解析，配合官方示例代码说明调用流程与场景实践。

一、API功能架构与核心价值

智能搜索API基于ernie-3.5-8k模型实现多模态内容检索，支持文本、图片、视频等多类型资源过滤。其优势在于：

实时性：通过search_recency_filter参数可限定检索时间范围（如示例中设置的"year"），确保信息时效性；
多源整合：resource_type_filter支持按类型筛选结果，例如配置"type": "image","top_k": 4可提取前4位相关图片资源；
推理增强：当enable_reasoning设为true时，系统会对检索结果进行逻辑归纳，生成结构化摘要。

二、请求参数配置详解

开发者可通过HTTP POST请求调用/v2/ai_search/chat/completions接口，以下为关键参数说明：

  
  
  
  
  
  
   
   
   
   
   
   
    bash
   
   
   
   
   
   
   
   
   
   
   
   
    curl --location 'https://qianfan.baidubce.com/v2/ai_search/chat/completions' \--header 'X-Appbuilder-Authorization: Bearer <AppBuilder API Key>' \--header 'Content-Type: application/json' \--data '{  "messages": [{"content": "北京有哪些景点","role": "user"}],  "search_source": "baidu_search_v1",  "resource_type_filter": [{"type": "image","top_k": 4}, ...],  "search_recency_filter": "year",  "model": "ernie-3.5-8k",  "enable_reasoning": true}'

鉴权配置：需在Header中传入X-Appbuilder-Authorization字段，值为Bearer+API Key；
语义控制：temperature（0.11）与top_p（0.55）共同调节生成结果的多样性与准确性；
检索模式：search_mode设为"auto"时，系统自动判断是否需要展开深度搜索。

三、响应数据结构与解析示例

成功调用后返回的JSON包含choices与references两部分：

  
  
  
  
  
  
   
   
   
   
   
   
    json
   
   
   
   
   
   
   
   
   
   
   
   
    {"choices":[{"message":{"content":"北京的景点非常丰富，其中包括：\n1. 故宫博物院..."}}],"references":[{"title":"北京必玩景点TOP10|2025最新攻略...","url":"https://baijiahao.baidu.com/s?id=1830291819430711070...