DifyAI · 企业 Agent 平台拆解
PROJECT TEARDOWN / 2023.03 — 2026.06

把“会聊天的模型”
变成“可治理的业务系统”

以 Dify 私有化为 AI 应用底座,以 API 网关和权限审计为安全边界,以 Agent 与 Workflow 驱动知识问答、支付结算、数据分析和 SQL 诊断。

55%客服人力成本降低
70%支付结算效率提升
90%SQL 排查耗时缩短
4 层入口、编排、集成、治理

项目等式

企业 AI = 模型能力 × 业务连接 × 安全治理 × 流程闭环

知识库让模型“知道企业知识”;API 让它“查到真实数据”;Workflow 和 Agent 让它“完成任务”;权限、审计和规则服务让任务“可控、可追责、可复制”。

Dify 私有化RAGAgentWorkflowAPI GatewaySQL 诊断

一、总体架构

Dify 负责 AI 应用编排,但不应该成为企业系统的万能数据库客户端。所有真实数据访问和业务动作,都通过受控的能力服务完成。

外部入口企业微信 / 飞书 / 钉钉 / WebAPI Gateway认证 · 授权 · 租户上下文 · 限流 · 审计Dify 私有化编排层Chatflow / Workflow / Agent / Prompt企业能力服务层订单 / 支付 / 结算 / 审批 / 工单模型服务层LLM / Embedding / Rerank知识与数据层文档存储 / 向量库 / 业务数据治理与观测权限 · 规则 · 消息队列 · 日志 · Trace

模型负责什么

理解自然语言、识别意图、抽取参数、选择工具、解释结果、生成回复。

代码负责什么

权限校验、金额计算、SQL 风险检测、状态判断、数据查询、真实业务执行。

平台负责什么

应用编排、知识库、Prompt、Agent、Workflow、会话、模型与资源管理。

二、核心业务流程

下面五张流程图展示从用户消息进入,到 AI 理解、检索、调用工具、执行规则、返回结果和审计的完整链路。

流程 A|统一消息接入与异步处理

用户消息渠道输入Webhook验签 / 解密去重与幂等channel + messageId消息队列入队后返回 ACK任务 Worker身份 / 会话 / 路由Dify 编排RAG / Workflow / Agent业务工具API / 规则 / 数据渠道发送文本 / Markdown / 卡片审计与 Trace全链路留痕

回调接口只做校验、入队和 ACK;耗时任务由 Worker 完成,避免渠道超时和重复执行。

流程 B|RAG 知识问答

用户问题清洗 / 改写意图分类知识问答 / 实时查询权限与范围过滤用户 / 部门 / 密级混合检索向量 + 关键词重排序Rerank / Top-K上下文与 Prompt结果拼接 / 引用LLM 生成答案 + 来源绑定质量判断置信度 / 安全 / 引用返回答案可追溯回复澄清或转人工无权限 / 低置信度

没有足够依据时,不允许模型补写企业规则;应明确说明未找到依据并转人工。

流程 C|支付结算查询与核对

用户请求订单号或批次号参数提取与校验格式正确?权限校验数据访问范围业务领域路由订单 / 支付 / 结算订单与退款查询数据支付与结算查询数据金额核对规则容差 / 差异结果汇总与报告差异项 / 证据确认提醒确认 / 拒绝人工复核参数错误 / 越权 / 异常

金额计算、差异判断和状态机必须由领域服务执行;模型只负责理解请求和解释结果。

流程 D|SQL 故障诊断

SQL / 错误 / Trace用户输入解析、脱敏与安全检查危险语句拦截元数据与执行计划只读 EXPLAIN规则引擎索引 / 扫描 / 锁历史案例检索相似故障LLM 辅助归纳基于证据解释诊断报告根因 / 建议 / 验证方案人工审核与测试禁止直接改生产

机器人可以分析生产 SQL,但默认不能执行生产 DDL、删除数据或直接修改索引。

流程 E|高风险动作:预览、确认、执行、审计

识别操作并评估风险风险等级 / 工具Dry-run 模拟执行对象 / 范围 / 影响用户是否确认?确认 / 取消二次认证与授权幂等 / 超时 / 重试执行操作成功 / 失败取消并记录不执行拒绝或重试失败 / 超时审计记录所有结果留痕

三、权限、数据与可靠性

权限不能只写在 Prompt 里

正确链路是:渠道用户 → 身份映射 → 角色/组织权限 → 数据范围 → Gateway 强校验 → 业务服务。即使模型生成越权参数,网关也必须拒绝。

userId → roles → departments → dataScope → API policy → data query

所有调用都要能追溯

审计记录 requestId、userId、channel、application、intent、tool、参数、结果、风险等级、确认记录、模型和延迟。

RECEIVED → PROCESSING → WAITING_TOOL → GENERATING → SUCCEEDED └→ RETRYING → FAILED/DEAD_LETTER
关键边界:大模型负责理解和生成;规则服务负责计算和判断;业务 API 负责真实数据访问;权限中心负责安全边界;审计系统负责追责。

四、实施路线与验收

01

平台底座

Dify 私有化、模型、知识库、权限、应用发布、日志监控。

02

低风险问答

制度、FAQ、操作手册和客服知识;验证召回与转人工。

03

只读 API

订单、支付、结算、审批查询;统一工具契约和鉴权。

04

Workflow + Agent

核对、提醒、数据分析、SQL 诊断;建立风险确认机制。

05

多渠道复制

企业微信稳定后适配飞书、钉钉和 Web,复用核心 Agent。

06

平台推广

工具注册中心、模板、评估集、运维规范和培训材料。

推荐先打通的最小闭环

企业微信用户入口结算助手接收与编排查询业务系统获取数据规则核对确定性判断审计留痕结果记录
维度验收指标说明
知识问答命中率、引用准确率、转人工率按业务知识集建立评估集
Agent工具选择准确率、任务完成率区分只读和执行任务
系统P50/P95 延迟、错误率、重复消息率按渠道和应用分别统计
安全越权拦截率、危险 SQL 拦截率、审计完整率必须有负向测试
业务客服成本、结算耗时、SQL 排查耗时补齐上线前基线和统计周期

五、辩证看待

✓ 成立的设计判断

  • 私有化适合敏感业务数据、统一权限和内网系统集成。
  • RAG 比把所有知识塞进 Prompt 更可更新、可追溯。
  • API 网关比模型直连数据库更容易治理。
  • Workflow 与 Agent 混合比全交给 Agent 更稳定。

⚠ 需要警惕

  • “接入数据库”不等于 AI 可以自由查库。
  • 效率指标必须有基线、样本量和统计口径。
  • Dify 不会自动解决企业权限、数据质量和合规问题。
  • 多渠道适配还涉及身份、加密、卡片和限流差异。