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

# DeepSearcher

DeepSearcher объединяет передовые LLM (OpenAI o1, o3-mini, DeepSeek, Grok 3, Claude 4 Sonnet, Llama 4, QwQ и др.) и векторные базы данных (Milvus, Zilliz Cloud и др.), выполняя поиск, оценку и рассуждения на основе приватных данных, чтобы предоставлять высокоточные ответы и подробные отчеты.

**Идеально подходит для:** корпоративного управления знаниями, интеллектуальных систем вопросов и ответов, а также сценариев информационного поиска.

<img src="https://mintcdn.com/jiekou/plu1OZSHwjdzCc5v/images/deepsearch_1.png?fit=max&auto=format&n=plu1OZSHwjdzCc5v&q=85&s=3bfbe56e6997032d94c0e3c37aa33702" alt="Пример изображения 1" width="1960" height="1636" data-path="images/deepsearch_1.png" />

## 1. Получение конфигурационной информации JieKou.AI

### (1) Регистрация и получение API-ключа

Зарегистрируйтесь и войдите в JieKou.AI. При регистрации укажите инвайт-код【YGHNZ0】, чтобы получить регистрационный бонус \$2.

<img src="https://mintcdn.com/jiekou/plu1OZSHwjdzCc5v/images/common_jiekou_homepage.png?fit=max&auto=format&n=plu1OZSHwjdzCc5v&q=85&s=ca878d25d643316d41367137b72b4a28" alt="Пример изображения 2" width="1920" height="816" data-path="images/common_jiekou_homepage.png" />

Откройте страницу управления【API key】, нажмите кнопку добавления, введите собственное имя ключа и сгенерируйте API-ключ.

<img src="https://mintcdn.com/jiekou/plu1OZSHwjdzCc5v/images/common_apikey_menu.png?fit=max&auto=format&n=plu1OZSHwjdzCc5v&q=85&s=742c54b92cd31a1ea915392ec52d8710" alt="Пример изображения 3" width="1907" height="927" data-path="images/common_apikey_menu.png" />

<img src="https://mintcdn.com/jiekou/plu1OZSHwjdzCc5v/images/deepsearch_4.png?fit=max&auto=format&n=plu1OZSHwjdzCc5v&q=85&s=596560f4e89d33cc1dc70e6b366481a5" alt="Пример изображения 4" width="1869" height="936" data-path="images/deepsearch_4.png" />

### (2) Генерация и сохранение API-ключа

!Внимание: ключ хранится на сервере в зашифрованном виде, и после создания его нельзя просмотреть повторно. Пожалуйста, надежно сохраните ключ; если он будет утерян, необходимо удалить его в консоли и создать новый.

<img src="https://mintcdn.com/jiekou/plu1OZSHwjdzCc5v/images/common_apikey_save.png?fit=max&auto=format&n=plu1OZSHwjdzCc5v&q=85&s=30053211224f16298aefbe8602e71089" alt="Пример изображения 5" width="1909" height="906" data-path="images/common_apikey_save.png" />

### (3) Получение ID модели, которую нужно использовать

В каталоге моделей JieKou.AI найдите нужную модель, скопируйте model id и базовый URL.

<img src="https://mintcdn.com/jiekou/plu1OZSHwjdzCc5v/images/common_model_square-gemini-3-pro.png?fit=max&auto=format&n=plu1OZSHwjdzCc5v&q=85&s=29c3faf0dd833d9b8bbee105c96c80f1" alt="Пример изображения 6" width="1894" height="887" data-path="images/common_model_square-gemini-3-pro.png" />

* Gemini-3-pro-preview
* Gemini-2.5-pro
* Claude-sonnet-4-5
* Gpt-5.1
* Gpt-4o

Другие ID моделей, максимальный контекст и цены см. здесь: [Каталог моделей](https://jiekou.vip/models-console/library?auth_res=success\&is_reg=false)

## 2. Установка DeepSearcher

Подробное руководство по установке см.: [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. Изменение примера кода для подключения моделей JieKou.AI

Пример кода находится в `examples/basic_example.py`. Вы можете использовать этот пример для запуска DeepSearcher.

(1) Настройте API Key

Установите только что полученный API Key в локальную переменную окружения `JIEKOU_API_KEY`.

```
export JIEKOU_API_KEY="您的 JIEKOU API Key"
```

(2) Настройте LLM и модель Embedding

Добавьте код после строки `config = Configuration()` в примере кода

```
config.set_provider_config("llm", "JiekouAI", {"model": "claude-sonnet-4-5-20250929"})
config.set_provider_config("embedding", "JiekouAIEmbedding", {"model": "qwen/qwen3-embedding-8b"})
```

(3) Настройте путь к файлам для поиска и prompt

Загрузите файлы из указанного локального пути и сохраните их содержимое в коллекцию. Измените код в месте вызова `load_from_local_files`. Вы можете использовать файл `examples/data/WhatisMilvus.pdf`, предоставленный проектом, или свои собственные файлы. Если при выполнении нужно удалить и заново создать эту коллекцию, установите `force_new_collection` в `True`.

```
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) Запустите пример кода из корневого каталога проекта:

```
python examples/basic_example.py
```
