Baidu 组件

概述

Baidu组件是RAGFlow 搜索服务组件，百度搜索组件，通过百度搜索引擎获取网络信息。

主要功能

🔍 百度搜索引擎集成
📊 支持多种配置选项和参数调节
🔧 与其他组件无缝集成
⚡ 高性能处理和错误恢复

适用场景

实时信息查询
网络资料搜集
新闻热点获取
中文内容搜索

参数配置

基础参数

参数名	类型	必填	默认值	说明
`query`	string	是		搜索关键词
`num_results`	number	否	10	返回结果数量
`safe_search`	boolean	否	True	安全搜索

详细说明

主要参数说明

query

类型: string
描述: 搜索关键词
默认值:
是否必填: 是

num_results

类型: number
描述: 返回结果数量
默认值: 10
是否必填: 否

safe_search

类型: boolean
描述: 安全搜索
默认值: True
是否必填: 否

输入输出

输入格式

Baidu组件接受上游组件的标准输出：

json

{
  "content": "输入内容",
  "component_id": "upstream_component_id",
  "reference": []
}

输出格式

json

{
  "content": "处理后的输出内容",
  "component_id": "baidu_component_id",
  "metadata": {
    "processing_time": 0.123,
    "success": true
  },
  "reference": []
}

使用示例

示例1: 基础配置

json

{
  "component_name": "Baidu",
  "params": {
    "query": 
  }
}

示例2: 高级配置

json

{
  "component_name": "Baidu",
  "params": {
    "query": "",
    "num_results": 10,
    "safe_search": True
  }
}

前端实现

节点组件

typescript

// web/src/pages/flow/canvas/node/baidu-node.tsx
export function BaiduNode({ id, data, isConnectable, selected }: NodeProps) {
  return (
    <section className={`${styles.ragNode} ${selected ? styles.selectedNode : ''}`}>
      <Handle type="target" position={Position.Left} isConnectable={isConnectable} />
      <Handle type="source" position={Position.Right} isConnectable={isConnectable} />
      
      <NodeHeader id={id} name={data.name} label={data.label} />
      
      <div className={styles.nodeBody}>
        <div className={styles.nodeInfo}>
          <span className={styles.nodeDescription}>百度搜索组件，通过百度搜索引擎获取网络信息</span>
        </div>
      </div>
    </section>
  );
}

配置表单

typescript

// web/src/pages/flow/form/baidu-form/index.tsx
const BaiduForm: React.FC<IOperatorForm> = ({ onValuesChange, form }) => {
  return (
    <Form form={form} layout="vertical" onValuesChange={onValuesChange}>

      <Form.Item
        name="query"
        label="搜索关键词"
        rules={[{ required: true, message: '请输入搜索关键词' }]}
      >
        <Input placeholder="请输入搜索关键词" />
      </Form.Item>

      <Form.Item
        name="num_results"
        label="返回结果数量"
      >
        <InputNumber style={{ width: '100%' }} placeholder="10" />
      </Form.Item>

      <Form.Item
        name="safe_search"
        label="安全搜索"
        valuePropName="checked"
      >
        <Switch />
      </Form.Item>

    </Form>
  );
};

后端实现

参数类

python

# agent/component/baidu.py
class BaiduParam(ComponentParamBase):
    """
    Baidu组件参数
    """
    
    def __init__(self):
        super().__init__()
        self.query = ""  # 搜索关键词
        self.num_results = 10  # 返回结果数量
        self.safe_search = True  # 安全搜索
        
    def check(self):
        """参数验证"""
        # 验证必填参数
        self.check_empty(["query"], "必填参数不能为空")

class Baidu(ComponentBase):
    """
    Baidu组件实现
    """
    
    component_name = "Baidu"
    
    def _run(self, history, **kwargs):
        """
        执行Baidu组件逻辑
        """
        # 获取输入
        input_df = self.get_input()
        
        if input_df.empty:
            raise ValueError("Baidu组件需要输入数据")
        
        input_content = input_df.iloc[0]["content"]
        
        # 执行核心处理逻辑
        result = self._process_content(input_content)
        
        # 返回结果
        return pd.DataFrame([{
            "content": result,
            "component_id": self._id,
            "metadata": {
                "processing_time": time.time() - start_time,
                "success": True
            },
            "reference": input_df.iloc[0].get("reference", [])
        }])
    
    def _process_content(self, content):
        """
        处理内容的核心逻辑
        """
        # TODO: 实现具体的处理逻辑
        return f"已处理: {content}"

最佳实践

1. 参数配置建议

根据具体使用场景调整参数
注意参数之间的依赖关系
合理设置超时和重试机制

2. 错误处理

python

def robust_processing(self, content):
    """
    带错误处理的处理方法
    """
    try:
        return self._process_content(content)
    except Exception as e:
        logger.error(f"Baidu组件处理失败: {str(e)}")
        return f"处理失败: {str(e)}"

3. 性能优化

合理使用缓存机制
优化处理算法
控制资源使用

常见问题

Q1: 组件配置后不生效怎么办？

A: 检查参数格式和必填项是否正确配置。

Q2: 处理大量数据时性能较慢？

A: 可以调整批处理大小或使用异步处理。

Q3: 如何调试组件执行过程？

A: 使用调试模式和日志功能查看详细执行信息。

Baidu 组件

概述

主要功能

适用场景

参数配置

基础参数

详细说明

主要参数说明

query

num_results

safe_search

输入输出

输入格式

输出格式

使用示例

示例1: 基础配置

示例2: 高级配置

前端实现

节点组件

配置表单

后端实现

参数类

最佳实践

1. 参数配置建议

2. 错误处理

3. 性能优化

常见问题

Q1: 组件配置后不生效怎么办？

Q2: 处理大量数据时性能较慢？

Q3: 如何调试组件执行过程？

相关组件

推荐搭配组件

典型工作流模式

Baidu 组件 ​

概述 ​

主要功能 ​

适用场景 ​

参数配置 ​

基础参数 ​

详细说明 ​

主要参数说明 ​

query ​

num_results ​

safe_search ​

输入输出 ​

输入格式 ​

输出格式 ​

使用示例 ​

示例1: 基础配置 ​

示例2: 高级配置 ​

前端实现 ​

节点组件 ​

配置表单 ​

后端实现 ​

参数类 ​

最佳实践 ​

1. 参数配置建议 ​

2. 错误处理 ​

3. 性能优化 ​

常见问题 ​

Q1: 组件配置后不生效怎么办？ ​

Q2: 处理大量数据时性能较慢？ ​

Q3: 如何调试组件执行过程？ ​

相关组件 ​

推荐搭配组件 ​

典型工作流模式 ​

Baidu 组件

概述

主要功能

适用场景

参数配置

基础参数

详细说明

主要参数说明

query

num_results

safe_search

输入输出

输入格式

输出格式

使用示例

示例1: 基础配置

示例2: 高级配置

前端实现

节点组件

配置表单

后端实现

参数类

最佳实践

1. 参数配置建议

2. 错误处理

3. 性能优化

常见问题

Q1: 组件配置后不生效怎么办？

Q2: 处理大量数据时性能较慢？

Q3: 如何调试组件执行过程？

相关组件

推荐搭配组件

典型工作流模式