> ## Documentation Index
> Fetch the complete documentation index at: https://ppio.com/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# DeepSearcher 接入 PPIO LLM API

前段时间，OpenAI 的 Deep Research 与 X 平台主推的 Grok Deepsearch 强大的信息整合能力让大家眼前一亮。但每月 200 美金的高昂订阅成本、仅限单一模型，依赖社交数据等现状，还是造成了部分应用场景的局限，在专业领域应用时难以满足部分开发者的严苛要求。

而现在，专注于向量数据库的 **Zilliz** 在开发者社区给出了新的解法——7.1k stars 的 **GitHub 开源项目 DeepSearcher**

1. **0** 订阅成本：即刻部署，**0订阅成本**使用
2. 可**多模型**切换：自由切换 DeepSeek/Qwen 等顶尖大模型
3. **本地**知识导入：无缝融合企业文档/CAD图纸/代码库等非结构化数据，隐私保护更佳

作为国内最早上线 DeepSeek 全模型 API 的供应商之一，**PPIO 派欧云**在助力 DeepSearcher 也发挥着效能。作为一站式 AIGC 云服务平台的PPIO 派欧云，为 AI 开发者和企业提供低成本、稳定可靠且接入简单的大模型 API 与 GPU 算力服务。这里有高性能的 API 服务，覆盖最新的 DeepSeek、Qwen 等系列模型，低价、稳定、快速，仅需一行代码即可调用，还支持在 chatbox、angthingLLM、Ragflow 等 20 多个主流第三方平台使用。

为了帮助大家更好地使用 DeepSearcher + PPIO 高性能API ，我们准备了一份**详细教程**，从环境配置到接入PPIO，手把手教你10分钟打造"开源引擎+自选大模型+私有知识库"的三重架构。

## PPIO x DeepSearcher 图文使用教程

### 1. 获取 PPIO 配置信息

（1）**获取【API Base URL】**：固定为：`https://api.ppio.com/openai`

（2）**获取【API Key】**：登录派欧云控制台[API密钥管理](https://ppio.com/settings/key-management)页面，点击创建按钮。注册账号记得填写邀请码【VOJL20】

<img src="https://mintcdn.com/ppinfra/HqssR35NC59tPJra/third-party/images/deepsearcher/image.png?fit=max&auto=format&n=HqssR35NC59tPJra&q=85&s=f47ca77c54987058206581a6e19a391c" alt="image.png" width="2992" height="1166" data-path="third-party/images/deepsearcher/image.png" />

（3）**生成并保存【API密钥】**

!!注意:密钥在服务端是加密存储，请在生成时保存好密钥；若遗失可以在控制台上删除并创建一个新的密钥。

<img src="https://mintcdn.com/ppinfra/HqssR35NC59tPJra/third-party/images/deepsearcher/image(1).png?fit=max&auto=format&n=HqssR35NC59tPJra&q=85&s=28104191ae7546c7b005e595b64cb644" alt="image(1).png" width="3000" height="1168" data-path="third-party/images/deepsearcher/image(1).png" />

<img src="https://mintcdn.com/ppinfra/HqssR35NC59tPJra/third-party/images/deepsearcher/image(2).png?fit=max&auto=format&n=HqssR35NC59tPJra&q=85&s=f2fc35106cbe942ce532c1edcadb3f71" alt="image(2).png" width="2980" height="1232" data-path="third-party/images/deepsearcher/image(2).png" />

（4）**获取需要使用的模型ID**，推荐使用：

* deepseek/deepseek-r1-turbo
* deepseek/deepseek-v3-turbo
* deepseek/deepseek-v3-0324
* qwen/qwq-32b

其他模型ID、最大上下文及价格可参考：[模型列表](https://ppio.com/model-api/pricing)

### 2. 安装 DeepSearcher

在PPIO官网准备好信息后，具体安装指南参考：[https://github.com/zilliztech/deep-searcher](https://github.com/zilliztech/deep-searcher)

**（1）克隆仓库**

```
git clone https://github.com/zilliztech/deep-searcher.git

cd deep-searcher
```

**（2）创建一个虚拟环境并激活它**

```
#MAKE SURE the python version is greater than or equal to 3.10
python3 -m venv .venv
source .venv/bin/activate
```

**（3）安装依赖**

```
pip install -e .
```

### 3. 修改示例代码以接入 PPIO 模型

示例代码位于 `examples/basic_example.py`。可以使用此示例来运行 DeepSearcher。

**（1）配置 PPIO API Key**

将您刚刚获取的 API Key 设置到本地环境变量 `PPIO_API_KEY` 中。

```bash theme={null}
export PPIO_API_KEY="您的 PPIO API Key"
```

**（2）配置 PPIO 模型**

在示例代码的 `config = Configuration()` 这一行后添加代码，设置 PPIO 的 LLM 与 Embedding 模型：

```python theme={null}
config = Configuration()
config.set_provider_config("llm", "PPIO", {"model": "deepseek/deepseek-r1-turbo"})
config.set_provider_config("embedding", "PPIOEmbedding", {"model": "baai/bge-m3"})
init_config(config=config)
```

**（3）配置需要检索的文件路径与 prompt**

从指定的本地路径加载文件，并将其内容存储到的集合中。修改调用 `load_from_local_files` 处的代码。
您可以使用项目提供的 `examples/data/WhatisMilvus.pdf` 文件，也可以使用您自己的文件。
如需执行时删除并重新创建该集合，可将 `force_new_collection` 设置为 `True`

```python theme={null}
load_from_local_files(
    paths_or_directory=os.path.join(current_dir, "data/WhatisMilvus.pdf"),
    collection_name="milvus_docs",
    collection_description="All Milvus Documents",
    force_new_collection=True, # If you want to drop origin collection and create a new collection every time,set force_new_collection to True
)
question="Write a report comparing Milvus with other vector databases."
```

**（4）运行示例代码**

在项目根目录下运行：

```bash theme={null}
python examples/basic_example.py
```

## 运行效果展示

我们用两个场景展示一下 DeepSearcher 的效果。

### 1. 车企行业报告分析

我们为 DeepSearcher 提供了一份 .xlsx 格式的车企行业报告。

**Prompt:**

```
请从财务和宏观经济角度，对 A 股新能源汽车行业以及行业内 TOP5 车企的发展进行分析。在财务分析部分，需涵盖基本的财务关键指标。在宏观经济分析部分，考虑宏观经济指标对行业的影响，对 A 股新能源汽车行业整体发展趋势进行总结，并基于财务和宏观经济分析，对 TOP5 新能源车企的未来发展潜力和竞争态势做出比较和预测，指出各车企的优势与挑战。请以专业、严谨的语言，结合具体数据进行分析阐述。
```

**输出内容：**

```
基于文档数据，A股新能源汽车行业及TOP5车企分析如下：
一、财务分析（以比亚迪、长安汽车为例）：
1. 比亚迪2024Q3营收430.48亿元（同比-17.74%），净利润6.91亿元（同比-39.45%），显示成本端承压明显；但2025年股息分配方案达10派30.98元，现金流表现优于同业。
2. 长安汽车2023Q4营收744.71亿元（同比+0.09%），净利润14.11亿元（同比-12.48%），盈利能力弱于比亚迪，但2024Q2实现净利润6.63亿元（环比+44.22%），展现弹性恢复。
二、宏观经济影响：
1. 行业2024年营收普遍负增长（比亚迪-17.74%，长安-12.82%），反映补贴退坡与消费疲软双重压力。2024Q3行业净利润环比-92.85%，显示季度波动加剧。
2. 原材料价格高位震荡，2024年TOP5车企平均毛利率同比下降3-5个百分点，成本传导能力分化。
三、行业趋势与竞争格局：
1. 行业集中度提升：比亚迪2024年营收规模超长安汽车1.6倍，头部效应显著。2025年研发投入头部车企占比预计提升至8-10%。
2. 技术路线分化：比亚迪垂直整合优势稳固（2024年专利数量同比+25%），长安汽车智能化转型加速（L4自动驾驶投入占比升至15%）。
四、TOP5车企竞争力预测：
1. 比亚迪：优势在于全产业链布局（电池自供率85%）和海外市场突破（2024出口占比升至18%），挑战来自原材料套期保值风险。
2. 长安汽车：依托燃油车利润反哺（2024传统业务贡献65%现金流），但新能源转型速度滞后（电动化率21% vs 行业均值35%）。
3. 其他头部：需关注新势力企业的毛利率改善（2024Q3平均毛利率回升至18.7%）及传统车企的混动技术突破。
行业未来3年将维持15-20%复合增速，头部企业市占率有望从2024年的58%提升至2026年的65%，技术迭代与全球化布局将成为核心竞争维度。
```

**输出结果分析：**

DeepSearcher 通过数据和具体因素（如补贴削减、成本压力）建立了宏观经济与行业表现的联系，其回答全面且数据丰富，涵盖财务指标、宏观经济影响和竞争趋。这种深度和具体性使其对需要基于证据、可操作性评估的读者有一定价值。

运行效果展示：

<img src="https://mintcdn.com/ppinfra/HqssR35NC59tPJra/third-party/images/deepsearcher/deepsearcher-car.gif?s=db74b01114b3869c00b1c572d36b4dd1" alt="deepseracher-car.gif" width="1595" height="856" data-path="third-party/images/deepsearcher/deepsearcher-car.gif" />

### 2. 根据JD筛选简历

我们为 DeepSearcher 提供了多份候选人简历 PDF 文件。

**Prompt:**

```
请根据以下优先级及标准，严格评估候选人的简历匹配度，从筛选出适合团队合作的3个与岗位匹配的实习生简历，并说明原因。筛选条件：1.硬性条件：Excel技能达标；英语能力达标。2.加分条件：（1）跨境电商经历（权重40%）：考虑平台经验；欧盟业务；数据成果。（2）供应链经验（权重30%）：选品分析；物流管理；单证处理。（3）工具能力（权重20%）：BI工具；ERP系统；自动化。（4）文化适配（权重10%）：跨文化经历；抗压案例；协作证明
```

**输出内容：**

```
**简历一（[姓名 1]）**  
匹配原因：  
1. 具备Shopee欧洲站运营经验，直接参与选品、数据分析和物流优化，熟悉跨境电商全链路；  
2. 熟练运用Excel高级函数（VLOOKUP/SUMIFS）和BI工具，完成供应链可视化项目；  
3. 英语CET-6 550分，参与跨部门协作的供应链优化项目，团队协同能力突出。  
**简历三（[姓名 3]）**  
匹配原因：  
1. 参与校园跨境电商创业项目，完成欧洲市场选品和跨语言协作，体现团队执行力；  
2. 掌握Excel数据清洗和基础分析技能，英语CET-6 505分满足基础沟通需求；  
3. 市场调研经历可为欧洲市场竞品分析提供支持。  
**简历十（[姓名 10]）**  
匹配原因：  
1. 自主运营eBay欧洲站店铺，实现从0到5000美元月销售额，实战经验丰富；  
2. 主导选品和供应链优化项目，直接降低15%采购成本，展现业务闭环能力；  
3. 英语CET-6 508分，熟悉跨境电商全流程操作，创业经历强化问题解决能力。
```

**输出结果分析：**

DeepSearcher 提供了的细节和数据支持，紧密结合岗位需求，对岗位需求画像与候选人能力能够精准映射，对团队合作能力也有明确评估，展现了的专业性和针对性。

综合来看，DeepSearcher在数据处理准确性、分析结构化程度、洞察力方面表现都较为出色。其对复杂查询的处理更稳定，更加贴合数据本身进行洞察，提供较高质量的分析，这种特性使其在为使用者提供可靠、深入的行业报告方面更具价值。
