Dify 入门：从 Web 到 API 的交付与集成方案
在 Dify 的'工作室'里组装好 AI 助手后，核心挑战在于如何将其交付到真实世界。AI 工程化的关键不仅在于构建，更在于集成。本文将介绍三种交付方式，将 AI 能力分发到业务场景中：
- Web App：生成公开链接，直接演示。
- 嵌入 (Embed)：将 AI 挂载到公司内网或博客。
- API (后端即服务)：让业务系统直接调用 AI 能力。
第一种交付：Web App（最快！3 秒上路）
这是最简单、最直接的交付方式。Dify 自带精美的移动端适配网页前端。
🎯 场景
- 开会时发给老板演示效果。
- 生成二维码贴在会议室墙上供员工查询规范。
🛠️ 操作步骤
- 进入应用概览页。
- 在左侧菜单栏找到'设置按钮'。
- 找到'公开访问 URL'，点击开关启用。
- 复制链接发送给同事或生成二维码。
无需登录 Dify 账号，用户点开链接即可对话。页面简洁专业，支持自定义 Logo 和背景颜色。
💡 笔记：该 URL 已封装鉴权、流式传输、错误处理等全套 Web 服务。
第二种交付：嵌入网站（最无感！融入业务）
若已有内部门户或技术博客，可将 AI 助手变成网页右下角的悬浮气泡插件。
🎯 场景
- 在公司管理平台网页右下角挂载 AI 客服。
- 在个人博客挂一个'数字分身'。
🛠️ 操作步骤
- 在应用右侧菜单点击'发布'下的下拉按钮。
- 选择'悬浮窗 (Floating Chatbot)'模式。
- 复制显示的
<script>代码。 - 粘贴到目标网站的
<body>标签结束前。
刷新网站后，右下角会出现蓝色气泡图标，点击即可与 AI 助手交互。
第三种交付：API 集成（最硬核！无限可能）
真正的企业级应用需要数据和逻辑解耦。Dify 的核心是 BaaS (Backend as a Service)，将 RAG、模型调用、Prompt 工程封装为标准 RESTful API。
🎯 场景
- 企业机器人：群聊 @机器人 提问。
- ERP 系统集成：数据录入界面自动校验。
- 私有化前端：使用 React 等新界面连接 Dify 后台。
🛠️ 操作步骤
- 点击左侧菜单'访问 API (API Access)'。
- 创建并保存 API 密钥。
- 查看自动生成的 API 文档。
- 找到
POST /chat-messages接口进行测试。
💻 极简测试
打开终端或 Postman，输入以下命令（替换 {YOUR_API_KEY}）：
curl -X POST 'https://api.dify.ai/v1/chat-messages' \
--header 'Authorization: Bearer {YOUR_API_KEY}' \
--header 'Content-Type: application/json' \
--data-raw '{ "inputs": {}, "query": "什么是数据质量？", "response_mode": "blocking", "conversation_id": "", "user": "dugufeng-test" }'
