Dify.ai 全维度使用手册

基于官网官方资料整理，本手册旨在帮助用户快速掌握 Dify 平台的定位、功能、资费及实操方法，涵盖从云端体验到私有化部署的全流程知识。Dify 是开源一站式 Agentic AI 低代码/无代码应用开发平台。

一、平台基础介绍

1. 产品定位

Dify（开发方：LangGenius）是面向企业/个人的生产级 AI 应用开发底座。它整合了 RAG 知识库、可视化工作流、Agent 智能体、第三方工具插件以及多模型接入的全链路能力。

• 核心价值：实现不用深度编程即可从 0 到 1 落地 AI 产品。
• 开源生态：项目托管在 GitHub（10.5 万 + Star、累计 500 万 + 下载），全球超百万 AI 应用基于 Dify 搭建。
• 服务对象：服务沃尔沃、马士基、理光、伟创力等跨国企业，落地覆盖 20+ 行业、数十个国家。

2. 部署两种形态

用户可根据需求选择以下两种使用方式：

1. SaaS 云端版：访问 dify.ai 官网在线使用，开箱即用，无需自备服务器，适合快速验证和轻量应用。
2. 开源私有化部署：从 GitHub 拉取源码，在本地或企业服务器部署。完全开源免费（MIT 开源协议），数据完全自留本地，适合对数据隐私有极高要求的场景。

3. 核心优势

• 可视化拖拽：无需代码即可编排逻辑。
• 全链路 RAG 流水线：支持文档解析、向量化、检索与重排的全流程。
• 海量插件市场：内置上千款插件，快速扩展能力。
• 多模型接入：支持主流大模型一键切换。
• 企业级管控：具备细粒度权限、数据隔离及审计日志。
• 多渠道发布：一键发布为网页、API、小程序、微信/钉钉机器人等。

二、六大核心功能详解

1. RAG 知识库（核心能力）

• 格式支持：支持 PDF、Word、Markdown、网页、Excel 等全格式文档上传。
• 自动化处理：自动进行文本分段、向量化处理并存入向量库。
• 深度定制：支持自定义切片规则、召回策略及重排模型。
• 应用场景：搭建专属私有知识库，实现企业制度问答、文档精准答疑等。
• 管理功能：支持批量导入、多知识库隔离、权限分级管理。

2. 可视化 Agent & 工作流 (Workflow)

• 零代码画布：通过拖拽组件编排 AI 逻辑，串联大模型与工具。
• 工具集成：可接入 Google 搜索、Notion、GitHub、Gmail、Wolfram 等第三方工具。
• 高级编排：支持嵌套、复用工作流，实现自动邮件回复、文档翻译、数据统计、AI 绘图等自动化任务。
• 模板库：内置现成模板（如邮件自动回复、意图识别客服），一键复用。

3. 多模型统一接入中心

• 广泛支持：一键接入全球主流大模型，包括 OpenAI、Azure、月之暗面 (Moonshot)、Llama、SiliconFlow 及本地 Ollama 模型。
• 灵活切换：统一调用格式，支持自由切换模型进行效果对比。
• 多模态支持：支持文本对话、DALL-E 绘图、语音转写 (TTS/STT) 等模型接入。

4. 应用快速发布与分发

• 多渠道部署：构建完成的 AI 应用可一键发布为网页组件、API 接口、独立对话网页。
• 即时通讯集成：生成微信、钉钉等机器人的接入代码。
• 团队协作：支持团队共享应用、工作流模板社区共建。
• 配置迁移：支持导出 DSL 配置文件，实现跨环境导入/导出。

5. 插件市场 & 扩展生态 (Marketplace)

• 丰富资源：平台内置 8600+ 插件，涵盖模型 (MODEL)、工具 (TOOL)、Agent 策略、扩展组件四大类。
• 常用插件：全网搜索、Notion 读写、GitHub 代码读取、Wolfram 数学计算、YouTube 数据分析、维基百科检索等。
• 安装便捷：一键安装即可在工作流中调用，无需开发对接 API。

6. 企业级管控与可观测

• 权限管理：细粒度成员权限控制，实现多租户数据隔离。
• 用量统计：记录 API 调用用量，支持多维度成本分析。
• 安全审计：日志全记录、API 调用限流、审计日志，适配企业合规需求。
• 规模化支撑：支撑上万员工级内部机器人部署（如马士基案例：19000+ 员工、20+ 部门）。

三、适用人群与场景

1. 个人用户（产品/运营/学生/自媒体）

• 自媒体：批量文案生成、选题调研 Agent、个人知识库助手。
• 学生/研究者：文献知识库搭建、论文总结、联网检索研究助手。
• 职场人士：搭建个人文档助手、简历优化机器人、自动邮件助手。

2. 中小企业（销售/行政/IT 部门）

• 客服支持：企业 FAQ 智能问答机器人，大幅减少人工工时。
• 内部管理：员工制度、产品手册机器人，提升内部检索效率。
• 市场营销：批量营销文案、素材生成工作流。

3. 中大型企业（制造/医药/汽车/物流）

• 私有化知识库：全部门知识库落地、跨部门智能 Agent。
• 产线支持：产线质检文档、供应链知识库、企业内部统一 AI 中台。
• 自研底座：基于 Dify 二次开发商用 SaaS 产品。

4. AI 开发者 & 创业团队

• 快速验证：快速验证 AI 产品原型，低成本上线 AI 工具。
• 自有服务：依托开源私有化部署，做自有 AI 服务。
• 降本增效：大幅缩短研发周期，降低技术门槛。

四、免费与付费资费详情

重要提示：

• 私有化部署：软件本身永久免费开源，费用仅来自用户自己的服务器硬件、向量库及大模型 API 充值成本。
• 云端 SaaS：使用 Dify 平台需遵守订阅制，大模型 API 费用需用户自行充值。

1. 云端 SaaS 免费套餐 (Free)

• 基础额度：有限的知识库容量、少量应用数量、每日免费模型调用额度。
• 限制条件：插件部分高级功能锁定、无企业权限管理、API 调用限速、不支持超大文件批量上传。
• 适用场景：新手体验、个人小工具原型测试。

2. 付费版本 (官网在线订阅)

（1）Pro 专业版（个人/小团队）

• 功能扩容：扩容知识库存储、不限应用数量、解除 API 限速、全插件开放。
• 服务支持：基础数据统计、优先客服支持。
• 计费方式：按需订阅包月/包年。

（2）Enterprise 企业版（中大型公司）

• 定制服务：企业级权限管控、私有化部署技术支持、专属客户经理。
• 安全合规：超大容量向量库、定制化部署、SLA 服务保障、合规数据方案。
• 联系方式：具体报价需联系官方（400-115-0592）。

3. 额外成本说明

• Dify 平台费 ≠ 大模型费用：无论免费或付费套餐，调用 OpenAI、月之暗面等第三方大模型，需用户自行在对应模型厂商充值 API 密钥。Dify 仅做中转，不收取模型服务费。

五、详细使用步骤（云端 SaaS 新手五步上手）

步骤 1：注册账号

打开 dify.ai/zh，使用邮箱注册，免费开通试用账户，进入工作台。

步骤 2：选择应用类型

在首页新建应用，选择以下 3 大类型之一：

1. 对话应用 (Chatbot)：适用于聊天机器人、客服问答。
2. 知识库问答：基于自有文档的 RAG 机器人。
3. 工作流 (Workflow)：适用于复杂自动化 Agent、多步骤串联 AI 任务。

步骤 3：接入大模型

• 路径：设置 → 模型供应商。
• 操作：填入对应厂商 API Key（如 OpenAI、通义千问、Ollama 本地模型）。
• 注意：绑定后全局可用；本地 Ollama 模型可零 API 成本，适合本地私有化测试。

步骤 4：知识库上传 & 配置（RAG 场景）

1. 进入左侧“知识库” → 新建知识库。
2. 上传 PDF、Word 或网页链接。
3. 配置文本切片大小、召回数量、重排模型（新手默认参数即可）。
4. 将知识库关联至对应的对话应用，完成文档绑定。

步骤 5：配置工作流/提示词，发布上线

• 对话应用：编辑系统提示词（角色设定、回答规则）。
• 工作流：在画布拖拽添加模型、搜索、第三方工具节点，连线编排逻辑。
• 发布：点击右上角“发布”，生成对话网页、获取 API 接入地址、获取嵌入代码（可嵌入官网/公众号）。

六、私有化部署简述

若选择私有化部署，需遵循以下基本流程：

1. 获取源码：访问 GitHub langgenius/dify 仓库拉取源码。
2. 环境准备：准备服务器，安装 Docker、Docker Compose 及必要依赖。
3. 一键启动：运行 Docker Compose 命令启动服务。
4. 功能同步：部署后功能同云端，所有数据存储于自有服务器。
5. 模型接入：可配置连接本地 Ollama 模型，实现零 API 成本运行。

七、新手避坑指南

1. 模型相关坑

• API Key 管理：调用报错无返回，需先核对密钥、检查模型厂商账户余额。
• 模型规格选择：低成本小模型可能无法支撑复杂 RAG 或长文档总结，新手优先选择 GPT-3.5/通义千问等稳定模型。
• 本地模型连接：私有化部署需放开服务器内网端口；SaaS 云端无法直接访问本地 Ollama。

2. RAG 知识库踩坑

• 切片大小：切片过大导致召回杂乱、过小丢失上下文，推荐 500~1200 字符。
• 图片型 PDF：扫描版 PDF 原生不识别图片文字，需先 OCR 转文字再上传。
• 数据量管理：免费版有额度限制，海量文档需分批上传，大文件需拆分。

3. 工作流 Workflow 避坑

• 逻辑错误：分支判断、循环节点配置失误会导致流程卡死，建议分步测试单个节点再串联。
• 插件依赖：部分第三方工具（如谷歌搜索、Notion）需要单独配置对应平台 API 密钥，仅安装插件无法直接生效。

4. 资费 & 部署坑

• 混淆概念：私有化部署软件本身免费，费用仅在服务器和模型；云端免费版耗尽后无提醒，需提前查看用量统计。
• 数据隐私：敏感涉密文档不要上传云端 SaaS，必须选择本地私有化部署。

5. 发布使用坑

• 跨域问题：嵌入网站对话组件时，若跨域报错，需前端配置跨域白名单。
• 限流问题：API 调用频繁可能超限，可升级套餐或添加调用限流规则。