Files
zhuangang/topics/ai/lowcode/01-dify-coze.md
T

83 lines
4.1 KiB
Markdown
Raw Blame History

This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
---
id: ai.lowcode.dify-coze
title: Dify / Coze 低代码 AI 平台:工作流、知识库、自定义工具和与代码开发的分工
type: lesson
domain: ai
stack: [lowcode]
tags: [Dify, Coze, 低代码, 工作流, 知识库, 自定义工具, OpenAPI]
level: basic
prerequisites: [ai.rag.pipeline-chunking]
est_hours: 2.5
related: [ai.lowcode.scenario.poc-to-production, ai.function-calling.tool-loop, ai.lowcode.interview]
week: [13]
order: 1
---
# Dify / Coze 低代码 AI 平台:工作流、知识库、自定义工具和与代码开发的分工
> Dify、Coze 等平台迭代很快,界面和功能以官方文档为准:https://docs.dify.ai/ 、https://www.coze.cn/open/docs
## 解释说明
低代码 AI 平台把大模型应用的常见部件做成可视化组件:
| 部件 | 说明 |
| --- | --- |
| 应用类型 | 聊天助手、Agent、工作流(Workflow / Chatflow) |
| 知识库 | 上传文档 → 自动切分、嵌入、检索(可配置切分规则、混合检索、重排) |
| 工作流节点 | 大模型、知识检索、条件分支、代码节点、HTTP 请求、工具、变量处理 |
| 工具 | 内置工具 + **自定义工具**(导入 OpenAPI 描述即可调用你的接口) |
| 发布 | Web 页面、API、嵌入网页;部分平台可发布到飞书 / 企业微信 / 公众号等渠道 |
| 运维 | 对话日志、标注、简单的效果统计 |
**Dify** 开源、可私有化部署(Docker Compose),适合企业内部;**Coze(扣子)** 是字节的平台,渠道发布方便,也有开源版本(以官方为准)。
### 和写代码怎么分工?
| 适合低代码 | 适合写代码 |
| --- | --- |
| 快速验证想法(PoC)、内部小工具 | 复杂业务逻辑、精细的权限控制 |
| 业务人员需要自己调整提示词和流程 | 需要完整测试、评测门禁、版本管理 |
| 标准的知识库问答 | 高并发、低延迟、自定义的检索优化 |
常见的企业做法是**组合**:平台负责编排和界面,核心业务能力用代码实现成接口,作为自定义工具接入平台。这样开发者掌握关键逻辑和权限,业务人员可以调整流程。
## 案例
运营团队想要一个“订单查询助手”。开发者用 FastAPI 写了订单查询接口(带 API Key 鉴权和店铺隔离),导出 OpenAPI 描述;运营在 Dify 中创建工作流:意图判断 → 调用订单查询工具 → 大模型组织回复,并接入知识库回答售后政策。两天上线试用,后续根据日志调整提示词。
## 代码示例
供 Dify 导入的自定义工具接口(完整版本 [examples/dify-tool-api/app.py](examples/dify-tool-api/app.py),带测试):
```python
app = FastAPI(
title="订单查询工具",
version="1.0.0",
servers=[{"url": "http://127.0.0.1:8100"}], # 导入时需要 servers,部署后改成实际地址
)
@app.get("/orders/{order_id}", operation_id="getOrderStatus", response_model=OrderStatus,
summary="查询订单状态", description="根据订单号查询订单状态和预计送达时间。订单号形如 A1001。")
def get_order_status(order_id: str, shop: str = Depends(auth)) -> OrderStatus:
...
```
要点:`operation_id` 会成为工具名;`summary` / `description` 就是模型看到的工具说明,要写清楚;鉴权用 API Key,每个调用方一个 Key,按 Key 隔离数据。在 Dify 中导入 `http://<地址>/openapi.json` 即可。
## 易错点
- 自定义工具接口没有鉴权,或者所有调用方共用一个 Key。
- OpenAPI 中缺少 `servers`、`operationId`,导入失败或工具名难以理解。
- 平台部署在内网,工具接口地址填了 `localhost`(平台容器里的 localhost 不是你的电脑)。
- 把复杂业务逻辑都写在代码节点里,无法测试和复用。
- 平台中的提示词和流程没有版本记录,改坏了无法回退:定期导出 DSL / 配置并放进 Git。
- 私有化部署后忽视升级和安全补丁。
## 面试常问
- 用过 Dify / Coze 吗?做过什么?
- 低代码平台和自己写代码怎么选?
- 怎么把公司已有的接口接入 Dify?