MindSearch API使用手册：后端接口的完整解析

MindSearch API使用手册：后端接口的完整解析

【免费下载链接】MindSearch 🔍 An LLM-based Multi-agent Framework of Web Search Engine (like Perplexity.ai Pro and SearchGPT) 项目地址: https://gitcode.com/gh_mirrors/mi/MindSearch

MindSearch是一个基于LLM的多智能体Web搜索引擎框架，它模仿人类思维过程进行深度搜索。本文将为您详细解析MindSearch后端API的使用方法，帮助您快速掌握这一强大的搜索工具。

🚀 MindSearch API核心功能

MindSearch后端API提供了强大的智能搜索能力，支持同步和异步两种调用模式。核心接口位于 mindsearch/app.py，主要处理用户查询并返回结构化的搜索结果。

主要特性：

• 多智能体协同搜索
• 实时流式响应
• 支持多种搜索引擎
• 会话状态管理

📋 API接口详解

1. 核心请求端点

MindSearch的主要API端点是 /solve，支持POST请求，用于处理用户查询并返回搜索结果。

请求格式：

{
  "inputs": "您的搜索问题",
  "session_id": 123456,
  "agent_cfg": {}
}

2. 参数配置说明

启动API服务时，您可以通过命令行参数进行配置：

python -m mindsearch.app --lang cn --model_format internlm_server --search_engine BingSearch

关键参数：

• --lang: 语言设置（cn/zh-CN 或 en）
• --model_format: 模型格式配置
• --search_engine: 搜索引擎选择

🔧 快速开始指南

环境准备

首先克隆项目并安装依赖：

git clone https://gitcode.com/gh_mirrors/mi/MindSearch
cd MindSearch
pip install -r requirements.txt

启动API服务

使用以下命令启动MindSearch后端服务：

python -m mindsearch.app --host 0.0.0.0 --port 8002 --lang cn

3. 后端调用示例

参考 backend_example.py，这是一个完整的API调用示例：

import requests
import json

url = "http://localhost:8002/solve"
headers = {"Content-Type": "application/json"}

def get_response(query):
    data = {"inputs": query}
    response = requests.post(url, headers=headers, data=json.dumps(data), timeout=20, stream=True)
    
    for chunk in response.iter_lines():
        if chunk:
            # 处理流式响应数据
            decoded = chunk.decode("utf-8")
            # 解析并处理返回结果

🔄 异步模式支持

MindSearch支持异步智能体模式，提供更高的并发性能。启用异步模式：

python -m mindsearch.app --asy

🌐 搜索引擎配置

MindSearch支持多种搜索引擎，您可以在 mindsearch/agent/init.py 中配置：

• BingSearch: 必应搜索引擎
• DuckDuckGoSearch: DuckDuckGo搜索引擎
• BraveSearch: Brave搜索API
• GoogleSearch: Google搜索API
• TencentSearch: 腾讯搜索API

💡 实用技巧

1. 会话管理

每个API请求可以指定唯一的 session_id，系统会自动维护会话状态，支持多轮对话。

2. 错误处理

API返回标准化的错误信息格式，便于客户端进行统一处理。

3. 性能优化

• 使用流式响应减少内存占用
• 合理配置搜索引擎参数
• 根据需求选择同步或异步模式

🛠️ 高级功能

智能体配置

通过 agent_cfg 参数可以深度定制智能体行为，满足特定的搜索需求。

总结

MindSearch后端API提供了一个功能强大、易于使用的智能搜索接口。通过本文的详细解析，您应该能够快速上手并充分利用这一工具的强大功能。

无论您是构建智能搜索应用还是进行信息检索研究，MindSearch都能为您提供可靠的技术支持。

【免费下载链接】MindSearch 🔍 An LLM-based Multi-agent Framework of Web Search Engine (like Perplexity.ai Pro and SearchGPT) 项目地址: https://gitcode.com/gh_mirrors/mi/MindSearch