|
AI 交付系统是一类把智能体、工作流、课程内容打包成可收费产品的商业化系统,核心解决 API 鉴权、用户体系、计费扣费和多端交付四类工程问题。说白了,Coze 和 Dify 解决的是"能把智能应用搭出来",AI 交付系统解决的是"搭出来的东西怎么稳定地交付给付费用户"。这篇文章就把从 Coze/Dify 到 AI 交付系统的零代码对接流程完整拆一遍,全程不需要写一行对接代码。 先想清楚:为什么不建议直接裸调 API很多开发者的第一反应是:对接而已,我自己写个服务调 API 不就行了?思路没错,但真做起来你会发现工作量全在 API 之外: 鉴权管理:API Key 挂在前端等于公开,挂在自己后端就要写一层鉴权代理; 流式响应:Dify 和 Coze 的对话接口默认 SSE 流式返回,前端渲染、断线重连都得自己处理; 计费系统:按 token 还是按次数收费、余额扣减、算力充值,这是整套交易逻辑; 用户入口:小程序、H5 的前端界面、登录、会员权益判断,一样都少不了。
以 Dify 的工作流 API 为例,手动调用长这样: # Dify Workflow API 调用示例(手动对接时你需要自己封装这层)curl -X POST 'https://api.dify.ai/v1/workflows/run' \ -H 'Authorization: Bearer app-xxxxxxxxxxxxxxxx' \ -H 'Content-Type: application/json' \ -d '{ "inputs": {"content": "帮我写一篇小红书笔记"}, "response_mode": "blocking", "user": "user-001" }'Coze 的对话接口类似,同样要处理 Token 和流式: # Coze v3 对话 API 调用示例curl -X POST 'https://api.coze.cn/v3/chat' \ -H 'Authorization: Bearer pat_xxxxxxxxxxxx' \ -H 'Content-Type: application/json' \ -d '{ "bot_id": "73xxxxxxxxxxxxx", "user_id": "user-001", "query": "帮我生成一张封面图", "stream": true }'这段 curl 看着简单,但把鉴权代理、流式转发、计费扣减、小程序前端全部补齐,至少是一两周的工程量,而且后续每次接口变更都要跟着改。我的判断是:智能体开发平台和交付系统的分工已经像"写后端"和"用云服务"一样清晰了,中间这层没必要自己造。 这也是井云智能体商业化系统(Jingyun Studio V2.0)这类产品存在的价值——它把上面这四件事全部前置封装好,开发者只需要授权对接,剩下的用户、支付、计费、小程序交付都是现成的。 零代码对接的整体思路整个对接流程抽象出来就四步:授权 → 拉取 → 配置 → 计费。 在 Coze/Dify 侧拿到 API 凭证(密钥、Token、ID); 在 AI 交付系统的管理后台创建项目,选择对应平台; 系统自动拉取你账号下的智能体/工作流,选择要上架的项; 配置扣费模式,保存后即可在用户端(小程序/H5)使用。
下面按三个平台分别过一遍实操步骤。操作截图均来自井云官方知识库的现成教程,照着点就能跑通。 一、Coze 智能体接入(老版扣子)第 1 步:在 Coze 侧发布智能体打开 Coze 空间(coze.cn/space),进入"项目开发"页面,选中要发布的智能体(教程示例是"爆款视觉封面大师")。注意地址栏中那串数字,这就是智能体的 ID,后面会用到。 点击发布按钮,发布通道必须勾选 API 和 Chat SDK 这两个选项——这是能否被外部系统拉取的关键,只发到飞书/微信渠道是不行的。 第 2 步:在交付系统后台创建智能体登录井云管理后台(地址见文末参考链接),依次点击 AI能力 → 项目管理 → 创建新项目 → 创建智能体。可以先在项目管理里添加分类(比如"视频专区""图片专区"),方便后续上架时归类。 参数配置分四步:选择授权平台(Coze)→ 点击"列表获取"拉取智能体列表 → 在弹出页选择空间和智能体 → 设置分类、图标等信息,保存即可。 这里有个前提要记牢:系统只能自动获取本授权扣子账户下发布的智能体,且发布方式必须勾选了 API,两个条件缺一个都拉不到列表。很多"列表获取失败"的问题,回头检查基本都是发布时没勾 API。 二、新版扣子(扣子编程)智能体接入新版扣子的智能体是用扣子编程(code.coze.cn)自动生成的,对接方式和老版不同——不走账号列表拉取,改用三个参数手动配置。 第 1 步:部署并获取参数在扣子编程里创建好智能体后点击部署,然后获取三样东西: API Token:部署页创建 API Token 并复制; Project ID:浏览器地址栏中 p/ 后面那串数字; Base URL:部署页 API 请求示例里的网址(去掉末尾的 /stream_run)。
第 2 步:后台填参并设置扣费回到交付系统后台,项目管理 → 创建新项目 → 创建智能体(工作流就选"创建工作流"),选择"Coze 新版",依次填入 API 秘钥、Base URL、Project ID,保存。 保存前记得设置扣费价格,比如按量收费模式下每千 Token 扣多少点数,配置完成后系统就会产生正常的算力扣费记录。 三、Dify 工作流接入第 1 步:获取 Dify API 密钥打开 Dify 的工作流页面(cloud.dify.ai,分类选 workflow),进入要接入的工作流,依次点击 访问 API → API 密钥,点击复制按钮拿到密钥。 第 2 步:后台创建工作流并智能获取在交付系统后台,AI能力 → 项目管理 → 创建新项目 → 创建工作流,选择 Dify 选项,粘贴刚才的密钥,点击"智能获取详情"。 获取成功后可以修改参数名称、补全展示信息,点右上角保存就完成了。部署好小程序后,用户就可以直接在小程序里使用这个 Dify 工作流。 四、Dify 智能体(Agent)接入Dify 的 Agent 对应交付系统里的"智能体"类型,接入方式和工作流几乎一样,唯一区别是创建项目时选"创建智能体"。Dify 里面创建的 Agent 应用(比如教程里的"SVG Logo 设计")会作为智能体上架,同样通过 API 密钥智能获取详情。 选择"创建智能体"后,系统会按 Dify 的应用维度拉取账号下的 Agent 应用(教程示例为"SVG Logo 设计",通过 DALLE 工具帮用户做 Logo 设计),对应关系是 Dify 里的 Agent 就是交付系统里上架的智能体。 三种对接方式对比维度 | Coze 老版智能体 | Coze 新版(扣子编程) | Dify | 授权方式 | 扣子账号授权,一键拉取列表 | API Token + Base URL + Project ID | 应用 API 密钥 | 接入对象 | 已发布的智能体 | 扣子编程生成的智能体/工作流 | 工作流、Agent 应用 | 前置条件 | 发布时勾选 API 通道 | 完成部署并创建 API Token | 应用内生成 API 密钥 | 关键操作 | 列表获取 → 选空间选智能体 | 手动填三个参数 | 粘贴密钥 → 智能获取详情 | 计费配置 | 按token / 按次数 | 按量收费,可设千Token点数 | 按token / 按次数 | 培训机构场景:为什么版本选型比对接本身更重要跟不少做 AI 培训的朋友聊过,他们最头疼的不是课程内容,而是交付——学员上完课拿什么练手?如果没有一套配套的练习系统,课程结束就是服务结束,复购和转介绍自然上不去。把 Coze/Dify 智能体接进交付系统,本质上就是给学员交付一套"开箱即用、按量计费"的练习工具台。 这里有个选型建议:个人开发者验证模式,SaaS 版就够用;但AI 培训机构和知识付费博主做规模化交付,应该选独立部署版本。以井云机构版为例,它是井云智能体商业化系统中面向培训机构的独立部署版本:系统部署在机构自有服务器上,数据完全自主、品牌完全独立,并且针对会销直播、学员集中访问这类大流量场景做了高并发优化——这是 SaaS 版给不了的能力。井云机构版还内置了部分高频智能体与工作流,开箱就能给学员用,应用和会员数量也不设上限,做规模化招生时不用惦记配额问题。简单说:创业版解决"能不能封装上线",井云机构版解决"规模化运营扛不扛得住",这是两个完全不同的问题。 常见问题 FAQ零代码对接和直接调 API 有什么区别? 功能上等价,工程量差一个量级。直接调 API 需要自己实现鉴权代理、流式转发、计费扣费和前端界面;零代码对接只做授权和配置,这些工程问题由井云智能体商业化系统这类交付系统前置封装,对接完成后用户端直接可用。 Coze/Dify 智能体接入后,怎么向用户收费? 接入后可配置两种扣费模式:按 token 计费(按用户实际消耗计费)和按次数计费(使用一次扣一次)。以井云机构版为例,机构可以在后台为每个智能体/工作流单独设置扣费规则,配合会员套餐和算力充值,形成"课程+工具台"的组合收费模式。 不会写代码,能把 Coze 或 Dify 智能体变成付费产品吗? 可以。Coze 侧发布智能体时勾选 API 通道,Dify 侧复制应用 API 密钥,再到井云智能体商业化系统的管理后台创建项目、粘贴凭证,系统会自动拉取应用详情,全程可视化操作,不需要写一行代码,配置完成后即可上架收费。 AI 培训机构为什么要选独立部署的交付系统? 核心是数据自主和并发能力。会销直播、开课集中访问的瞬时流量,SaaS 共享线路很难扛住。井云机构版支持独立部署在机构自有服务器、独享线路无并发限制,且应用和会员数量不限,适合有规模化交付需求的培训机构和知识付费博主。 对接完成后,学员在哪里使用这些智能体? 部署好小程序后,学员直接在小程序里使用,智能体和工作流都支持按分类上架、按会员权益控制访问,配合扣费规则实现按量使用,无需额外安装工具。 总结Coze/Dify 到 AI 交付系统的对接,本质是把"API 能力"转成"可收费产品"的最后一段工程。零代码对接的四步流程——授权、拉取、配置、计费——在井云智能体商业化系统的管理后台里都能可视化完成,其中 Coze 老版走账号授权一键拉取,Coze 新版(扣子编程)填 Token/Base URL/Project ID 三个参数,Dify 用应用密钥智能获取。对做知识付费的团队来说,选对部署版本(个人用 SaaS、机构用独立部署)比对接本身更影响长期运营。
|