Baidu AI Search Enhance - Dify Plugin

Baidu AI Search Enhance plugin that integrates Baidu Intelligent Search Generation (High Performance) API, providing real-time web search and AI-powered summarization for Dify users.

百度智能搜索增强插件，接入百度智能搜索生成（高性能版）API，为 Dify 用户提供实时网络搜索与 AI 智能摘要能力。

Features / 功能特性

• Intelligent Search Summaries — Real-time web search with AI-generated summaries via Baidu search engine
• Streaming Output — SSE streaming support for real-time response delivery
• Full Parameter Control — Temperature, Top-P, output format, resource type filters, and more
• Citation Tracking — Automatic extraction of search references with Dify citation display support
• Site & Time Filtering — Restrict searches to specific sites and time ranges
• Multi-Resource Types — Supports web, video, and image search resources

---

• 智能搜索摘要 — 基于百度搜索引擎，实时检索并生成 AI 摘要
• 流式输出 — 支持 SSE 流式响应，实时返回搜索结果
• 全参数可配 — 温度、Top-P、输出格式、资源过滤等参数全部开放
• 引用溯源 — 自动提取搜索引用来源，支持 Dify 引用展示
• 站点/时间过滤 — 可限定搜索站点和时间范围
• 多资源类型 — 支持网页、视频、图片三种搜索资源

Quick Start / 快速开始

1. Install Dependencies / 安装依赖

cd baidu_ai_search_enhance
pip install -r requirements.txt

2. Get API Key / 获取 API Key

Visit the Baidu Qianfan Platform to obtain your API Key.

Free tier: 100 requests per day.

前往 百度千帆平台 获取 API Key。每日有 100 次免费调用额度。

3. Start Plugin (Local Debug Mode) / 启动插件（本地调试模式）

# Enter the plugin directory
cd baidu_ai_search_enhance

# Copy environment config
cp .env.example .env

# Run the plugin (local mode)
python main.py

On successful startup you will see output similar to:

{"version":"0.0.1","type":"plugin","author":"ronrey-developer","name":"baidu_ai_search_enhance",...}
{"event": "log", "data": {"level": "INFO", "message": "Installed tool: baidu_ai_search",...}}
{"event":"heartbeat","session_id":null,"data":{}}

4. Use in Dify / 在 Dify 中使用

In your Dify workflow or conversation, add the Baidu AI Search tool, enter your API Key, and start using it.

Remote Debug / 远程调试

Remote debugging allows you to develop the plugin locally while connecting to a remote Dify instance for testing.

Steps / 步骤

1. Get the debug key from Dify Console
   Login to your Dify instance → "Plugins" → "Remote Debugging" → Copy the debug key and port.

2. Configure .env file

   INSTALL_METHOD=remote
   REMOTE_INSTALL_HOST=<your-dify-instance>
   REMOTE_INSTALL_PORT=5003
   REMOTE_INSTALL_KEY=<your-debug-key>
   

3. Start the plugin (must run from baidu_ai_search_enhance/ directory)

   cd baidu_ai_search_enhance
   python main.py
   

Parameters / 参数说明

Parameter	Type	Required	Default	Description
query	string	Yes	—	Search query text
stream	boolean	No	true	Enable SSE streaming output
temperature	number	No	~0	Sampling temperature (0, 1]
top_p	number	No	~0	Nucleus sampling parameter (0, 1]
instruction	string	No	—	System instruction for response style
response_format_type	select	No	text	Output format: text / json_object / json_schema
json_schema	string	No	—	JSON Schema definition (required for json_schema format)
web_top_k	number	No	20	Max web results (0-50)
video_top_k	number	No	0	Max video results (0-10)
image_top_k	number	No	0	Max image results (0-30)
site_filter	string	No	—	Comma-separated site filter
time_range	select	No	No Limit	Time range filter

Project Structure / 项目结构

baidu_ai_search_enhance/
├── manifest.yaml              # Plugin manifest (metadata, entrypoint, components)
├── main.py                    # Plugin entry point (initialization, startup)
├── requirements.txt           # Python dependencies
├── .env.example               # Environment variable template
├── icon.svg                   # Plugin icon
├── _assets/                   # Static assets (SDK requirement)
├── provider/
│   ├── baidu_ai_search.yaml   # Provider config (credentials, tool list)
│   ├── baidu_ai_search.py     # Provider implementation (credential validation)
│   └── tools/
│       ├── web_summary.yaml   # Tool parameter definitions
│       └── web_summary.py     # Tool implementation (API call logic)
└── README.md

Publishing to Dify Marketplace / 发布到 Dify 插件市场

1. Ensure the plugin functions correctly and all tests pass.
2. Package the baidu_ai_search_enhance/ directory into .difypkg format.
3. Follow the Dify Plugin Publishing Guide to submit for review.

Privacy Policy / 隐私政策

This plugin transmits search queries to Baidu's API servers (qianfan.baidubce.com) for processing. No user data is stored locally. Please refer to Baidu's Privacy Policy for details on how Baidu handles data. See PRIVACY.md for this plugin's privacy practices.

License / 许可证

MIT License