> ## 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.

# Dify

> 了解如何在 Dify 中通过 OpenAI-API-compatible provider plugin 接入 siflow endpoint，用于 Chat、Agent 和 Workflow 应用。

[Dify](https://dify.ai) 是一个开源 LLM 应用开发平台，可以通过可视化方式构建 chatbots、agents 和 workflows。Dify 可通过 **OpenAI-API-compatible** provider plugin 连接到 siflow endpoint，因此 Chat、Agent、Workflow 等应用类型都可以使用算秩模型。

## 配置

您需要先准备一个 Dify workspace，可以使用 [Dify Cloud](https://cloud.dify.ai)，也可以使用 [self-hosted deployment](https://docs.dify.ai/en/getting-started/install-self-hosted/docker-compose) （Dify 1.x 的 plugin marketplace 需要该版本）。

<Note>
  只有 workspace 的 **owners** 和 **admins** 可以管理 model providers，API Key 会在 workspace 范围内共享。
</Note>

### 1. 安装 provider plugin

1. 从左侧边栏打开 **Integrations → Model Provider**。
2. 在 **Install model providers** 列表中找到 **OpenAI-API-compatible**（发布者为 *langgenius*），单击 **Install**。

   如果 **OpenAI-API-compatible** 没有出现在第一页，可以使用搜索框，或单击 **Discover more in Dify Marketplace** 查找。

### 2. 添加算秩模型

以添加 `glm-5.2` 模型为例：

1. 在 **OpenAI-API-compatible** provider 卡片中单击 **Add Model**，填写所需字段，然后保存。

   | 参数                         | 示例                                                                           |
   | -------------------------- | ---------------------------------------------------------------------------- |
   | Model Type                 | `LLM`                                                                        |
   | Model Name                 | `glm-5.2`                                                                    |
   | API Key                    | 您在 [API 密钥](https://console.siflow.cn/model-inference/api_keys) 创建的 API Key。 |
   | API endpoint URL           | `https://api.siflow.cn/model-api/v1`                                         |
   | Completion mode            | `Chat`                                                                       |
   | Model context size         | `131072`                                                                     |
   | Upper bound for max tokens | `8192`                                                                       |
   | Function calling           | 如果表单提供 tool-call 选项，请选择该选项，Agent apps 需要此能力。                                 |

   配置时请注意以下事项：

   * Streaming 和 vision 设置可保持默认。
   * 同一个 plugin 支持 `LLM`、`Text Embedding`、`Rerank`、`Speech2Text` 和 `TTS` 模型类型。如果应用需要这些能力，请参考 [模型广场](https://console.siflow.cn/model-inference/models) 选择对应的模型。
   * Agent apps 需要使用原生支持 tool calling 的模型。`glm-5.2` 支持该能力；如果要切换模型，请先查看平台的 tool-calling 模型列表。
   * 如果保存失败，或模型在应用中首次使用时报错，请检查 endpoint URL 是否以 `/v1` 结尾（不要以 `/` 结尾），并确认 API Key 中没有多余空格。

2. 将 `glm-5.2` 设置为 workspace 默认模型。

在 Model Provider 页面右上角单击 **Default Models**。在完成默认模型配置前，Dify 会显示 “Configure a default system model” 提示；设置后，应用会自动使用该模型。

## 验证

创建一个应用，例如 Studio 中的 Chat app，或 Agents builder 中的 agent。确认应用使用 `glm-5.2`，然后发送一条消息。如果返回正常的流式回复，即表示连接成功。