Dify 与 Coze:对话工作流、知识库与工具契约
以售后查询为例梳理Chatflow、分类器、会话变量、MCP与插件,并区分云产品和开源自托管边界。
“退货规则是什么”和“帮我退这笔款”看起来都属于售后,实际需要不同路径:前者读取知识库,后者涉及身份、订单与写操作授权。把两者都连到同一个LLM节点,容易让模型将知识回答误当业务执行。对话平台最有价值的设计是把这些责任清楚拆开。
Dify的Workflow和Chatflow
Dify当前文档将Workflow描述为一次从开始到结束的运行,Chatflow面向会话,每次用户消息触发流程并可使用会话信息。不要简单理解成一个不能聊天、一个只能聊天;关键是触发、状态与输出方式。
Chatflow里应区分当前输入、历史消息、会话变量和节点临时输出。历史帮助理解代词,变量保存经过校验的结构化状态,例如用户已选订单;它们都不应保存不可控的全量敏感数据。知识库检索提供证据,回答节点组织用户可见输出,不能把原始内部调试字段全部透传。
Question Classifier用模型把输入分到预定义类别。当前文档区分类别说明与画布标签,它们独立编辑并分别暴露相关变量。设计类别时给出互斥边界,增加不确定或其他分支,避免将模型分类误当授权。规则查询、操作申请、无关问题可分开;“退款规则并帮我退款”属于多意图,需要显式处理或澄清。
Coze的工作流和开源Studio边界
Coze工作流同样需要把输入、节点输出、变量引用、插件和知识能力串成可调试流程。官方coze-studio仓库提供开源平台入口;云端产品、不同地域产品与开源部署并不保证节点、模型接入、发布渠道和版本完全相同。
不要把某个云端教程的按钮路径写成所有部署都适用。实际搭建时先记录产品区域、版本或commit、安装方式、插件版本,再验证所需功能。本次Coze网页文档未能提取正文,本文以官方开源仓库核对其平台定位,不宣称已逐项实测云端UI或特定MCP节点。
在两类平台上比较时看相同业务契约:是否能传结构化数组、是否有稳定conversation ID、工具返回错误如何分支、历史如何裁剪、版本能否导出、凭据如何隔离、调试记录能否关联业务ID。这样的比较比逐项复述按钮名称更耐版本变化。
工具、MCP与知识库各有边界
知识库文本进入模型上下文时保留来源和权限;检索无结果不应由模型自由补出制度。工具或插件调用应有输入schema、结果schema、超时、重试与权限。MCP可以标准化工具发现与调用协议,但不会自动证明服务器可信、工具无副作用或用户有权使用。
连接外部工具前明确凭据是谁的、可访问哪些资源、是否随租户变化。不要把平台管理员key放进普通输入变量,再交给模型决定使用对象。记忆内容也要有来源与有效期:用户说“我已审批”不能直接覆盖审批状态。
自托管意味着你负责数据库、对象存储、向量索引、插件服务、网络、升级与备份等实际组件;不等于模型免费或数据天然不出网。模型、embedding、rerank或外部插件仍可能发送数据。部署前画出实际数据路径,按依赖清单验证,而不是只看主Web容器能打开。
跟做:分类枚举与会话隔离
用Python 3.11+保存并执行 python chatflow_contract.py。这是本地会话状态机,分类由固定参数输入,既不是模型准确率实验,也不是Dify/Coze导出格式。没有访问云平台、执行退款或调用MCP服务器。
"""会话变量/分类路由本地模型;分类为固定规则,不是Dify/Coze运行。"""
from copy import deepcopy
class Chatflow:
def __init__(self):
self.sessions = {}
def turn(self, tenant, session_id, query, classification):
if classification not in {'policy', 'action', 'unknown'}:
raise ValueError('classifier output outside enum')
key = (tenant, session_id)
state = deepcopy(self.sessions.get(key, {'turns': 0, 'last_query': ''}))
state['turns'] += 1
state['last_query'] = query
if classification == 'policy':
output = {'answer': '7天内申请', 'sources': ['policy-v1#2']}
elif classification == 'action':
# 不执行退款:把请求交给受控工具服务。
output = {'status': 'requires-authorization'}
else:
output = {'status': 'clarify'}
self.sessions[key] = state
return state, output
if __name__ == '__main__':
flow = Chatflow()
print(flow.turn('a', 's1', '退货规则', 'policy'))
print(flow.turn('a', 's1', '帮我退款', 'action'))
print(flow.turn('b', 's1', '不清楚', 'unknown'))
try:
flow.turn('a', 's1', 'anything', 'delete_all')
except ValueError as error:
print(str(error))实际输出:
({'turns': 1, 'last_query': '退货规则'}, {'answer': '7天内申请', 'sources': ['policy-v1#2']})
({'turns': 2, 'last_query': '帮我退款'}, {'status': 'requires-authorization'})
({'turns': 1, 'last_query': '不清楚'}, {'status': 'clarify'})
classifier output outside enum同租户同会话的turns从1变2;不同租户即使session_id相同,也从1开始。操作分支返回requires-authorization,不把分类为action等同批准。非法类别拒绝且不会覆盖已保存会话状态。
示例只处理单进程串行情况;真实平台的并发同会话消息还要有版本号、锁或顺序队列,防止最后写入覆盖。检索证据也是固定夹具,无法证明知识库召回质量。
端到端调试
用一张表固定输入、期望分支、所需变量、允许工具和期望终止状态。先运行规则查询,再测试操作申请、空证据、错误类别、工具超时及跨租户同ID。发布后从真实API或聊天入口重放,检查草稿与发布版本是否一致。依据见 Dify分类器 与 Coze Studio官方仓库。
Coze Studio源码能证明什么,不能证明什么
本次追加核对官方开源仓库commit fefb05ff27be。在工具调试MCP调用实现中,Do方法直接返回未实现错误。与此同时,前端MCP发布配置会带MCPPublish检查类型查询工作流,过滤is_pass结果,并将选中的workflow_id/name写入selected_workflows。它证明配置界面和筛选逻辑存在,不能证明整个服务调用路径可运行;工具调试入口的未实现也不能扩大成“所有云产品永远不支持MCP”。
具体排错:若界面可以选择工作流,但调用返回上述未实现错误,先定位实际后端版本与入口,停止反复更换token或模型。可改用已验证的HTTP工具服务,或升级到有对应实现且经过验收的版本;不能只删除前端限制后当作功能补齐。测试分为工具发现、参数schema、实际调用、失败返回及身份范围,逐层通过后才写“支持”。独立的coze-mcp-server仓库提供从外部MCP客户端访问Coze的另一条路径,不等同Studio内部消费任意MCP服务;其仓库还标记已于2026-01-19归档,不能把旧安装命令当持续维护承诺。
官方Studio API说明给出的发布顺序是进入目标Agent、发布时选择API渠道,再创建有有效期的Personal Access Token,调用时携带Authorization。先发布再调用,能避免把仅保存的草稿误认为API已可用;PAT只证明调用身份,还要检查资源权限。发布后用同一无敏感测试输入核对Agent/工作流ID、返回状态与来源版本,令牌过期应作为认证故障处理,而不是让模型改写问题重试。
这些是开源Studio源码与Wiki支持的教学路径,不是云端各地域产品的统一按钮指南。本文没有创建真实账号、发布Agent或生成PAT,也没有启动Studio;源码发现的未实现路径明确保留为能力限制。
课后练习展开习题收起习题
先独立作答,再展开参考思路。检查自己的解释是否包含机制、条件和反例。
Chatflow为什么需要明确会话作用域?
参考思路与常见误区
每轮触发使用历史与会话变量,必须按租户和会话定位并控制寿命及并发,避免串会话。
常见误区:session字符串全球唯一就无需身份绑定。
分类器输出action后能直接退款吗?
参考思路与常见误区
分类只决定路由;退款仍需身份、订单、金额和业务授权,必要时等待可信审批。
常见误区:模型分类结果就是授权。
MCP连接成功代表哪些能力?
参考思路与常见误区
仅说明某种协议交互成立;还要核对工具schema、服务器信任、凭据范围、调用权限和副作用。
常见误区:MCP自动解决安全和业务幂等。
Coze云端与开源Studio可以视为同一环境吗?
参考思路与常见误区
不能;区域、版本、节点、模型、渠道与部署依赖可能不同,应按实际版本验证并记录。
常见误区:云端按钮教程必然适用于自托管。
自托管是否意味着数据不出网且无模型费用?
参考思路与常见误区
不意味着;模型、embedding、rerank和插件可能外发数据并计费,需核对实际数据流和依赖。
常见误区:部署Web容器在本机就等于完全离线。