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

# Deep Research

> 了解如何在 Deep Research 中使用 Proxy API Mode 配置 OpenAI Compatible provider，接入 siflow endpoint，并运行多阶段研究工作流。

[Deep Research](https://github.com/u14app/deep-research) 是一个可自托管的 Web 应用，用于运行迭代式、多阶段研究工作流。它支持 **OpenAI Compatible** providers，因此可以接入 siflow endpoint。

本文默认模型为 `glm-5.2`；完整模型列表和价格请查看 [模型广场](https://console.siflow.cn/model-inference/models)。

请按照 [官方指南](https://github.com/u14app/deep-research) 部署，例如使用 `xiangfa/deep-research` Docker 镜像（端口 3000）。

## 配置

Deep Research 有两种 **API Modes**：*Local*（浏览器直接调用模型 API）和 *Proxy*（由应用服务端调用模型 API）。接入时请使用 **Proxy**。在 Local mode 中，浏览器会直接跨域调用 `https://api.siflow.cn/...`；API gateway 不会为浏览器请求返回 CORS headers，因此会被浏览器拦截并报 `error [TypeError]: Failed to fetch`。这是浏览器 CORS 限制，不是 key 或 URL 配置错误。Proxy mode 会由应用服务端发起请求，对浏览器来说属于 same-origin 请求，因此可以避开该问题。

在 [API 密钥](https://console.siflow.cn/model-inference/api_keys) 页面创建 API Key，并设置服务端环境变量。Proxy mode 会从这里读取 key 和 endpoint：

```bash theme={null}
OPENAI_COMPATIBLE_API_KEY=<Your API Key>
OPENAI_COMPATIBLE_API_BASE_URL=https://api.siflow.cn/model-api
ACCESS_PASSWORD=<a password you choose>
```

| 字段                               | 值                                                                                     |
| -------------------------------- | ------------------------------------------------------------------------------------- |
| `OPENAI_COMPATIBLE_API_KEY`      | 创建的 API Key                                                                           |
| `OPENAI_COMPATIBLE_API_BASE_URL` | `https://api.siflow.cn/model-api`，不要包含 `/v1`；proxy route 会自行追加 `/v1/chat/completions` |
| `ACCESS_PASSWORD`                | 您为 Deep Research UI 设置的访问密码                                                           |

然后在 UI 中打开 **Settings → Model**，并设置：

| 字段                          | 值                                     |
| --------------------------- | ------------------------------------- |
| API Mode                    | **Proxy**                             |
| AI Provider                 | **OpenAI Compatible**                 |
| Access Password             | 上面设置的 `ACCESS_PASSWORD`               |
| Thinking Model / Task Model | `glm-5.2`。两个字段都设置为 tool-capable model |

<img src="https://mintcdn.com/siflow/CfO6jliU08Hhf849/model-inference/media/deep-research-proxy-config.png?fit=max&auto=format&n=CfO6jliU08Hhf849&q=85&s=1b85f6cfd52debe60129f2acba618944" alt="Deep Research 中使用 Proxy 模式配置 OpenAI Compatible provider 和算秩 glm-5.2 模型" width="1032" height="970" data-path="model-inference/media/deep-research-proxy-config.png" />

## 验证

输入研究主题并启动。Deep Research 会通过 `glm-5.2` 运行各阶段（topic → questions → plan → collection → report）：

<img src="https://mintcdn.com/siflow/CfO6jliU08Hhf849/model-inference/media/deep-research-result.png?fit=max&auto=format&n=CfO6jliU08Hhf849&q=85&s=66d3cb4c54e2f6bbb08b454e8874e3cf" alt="Deep Research 使用算秩 glm-5.2 模型生成问题和报告计划" width="2098" height="3530" data-path="model-inference/media/deep-research-result.png" />