最近智能体定制化赛道异常火爆。
打开闲鱼搜索"Coze 定制",密密麻麻的服务报价直接刷屏,即使表明看起来几十块的商家,一细聊,都是几百到上千不等的报价。
有趣的是,这些智能体定制化服务背后,最核心的不只是工作流设计,还有一个被很多人忽视的重要角色 —— 插件。
细看会发现,Coze 官方和众多智能体爱好者已经创造了大量有价值的免费插件。
而更让我惊喜的是,有些聪明的开发者并没有止步于此。他们把这些插件直接开放给浏览器插件、网页使用,悄悄做成了小而美的产品...
不得不说,这波操作真的很秀。
的确,相比自己从零开始写大量代码逻辑,站在巨人的肩膀上搞定一切,不是更香吗?
本文将介绍如下内容,带你了解 Coze 插件变现的新思路:
怎么寻找合适的插件
怎么使用 API 调用 Coze 插件
Cursor + Coze 插件开发思维导图插件
效果如下:
这次我们做一个简单的需求,用户故事:用户,在网页上选择一段文字,点击浮动按钮,可以生成思维导图的图片在侧边栏显示。
前段时间,我介绍过一些好用的 Coze 插件:
除此之外,我们可以在 Coze 商店进行搜索。商店里提供了大量免费插件。在左侧,我们可以按照类目进行筛选。
需要注意的是,就算我们找到了符合需求的插件,最好也在 Coze 里实际测试一下,确认两点:
功能是否正常:避免插件不兼容或无法正常使用的情况。
费用情况:是免费的还是付费的?如果是付费的,费用是否在可接受范围内?
目前,插件商店里的插件大致可以分为三种类型:
1、无效插件:虽然插件上架前都需要通过测试,但商店里还是有一些插件在实际使用中无法正常工作,可能是因为服务器不再运行,或者插件本身已经失效。
2、免费插件:这种插件无需验证信息,直接可以使用,是真正的“即插即用”类型。为这些“为爱发电”的开发者点赞!在选择免费插件时,建议优先考虑官方提供的插件,可靠性通常更高。
3、商用插件:这类插件因为涉及技术成本或资源消耗,通常需要官方密钥验证。对于这些付费插件,我们可以根据自身需求和预算,评估是否合适。
无论选择哪种类型的插件,在调研阶段,最好都先在一个独立的 Coze 工作流里测试一下,确保输出的数据真的符合需求。
根据我们的需求,我们需要找到一款指定文字生成思维导图的插件。
经过筛选,我们找到两个官方的免费插件,仔细阅读插件描述后,发现 TreeMind 树图插件基本上能够满足需求。
创建插件测试流程,输入符合长度的文字开始验证。
确认输出结果后,我们发现属性 data_struct.pic 返回了一个图片链接,成功生成了所需的思维导图图像。
这张图片正是我们所需要的东西。
为了方便接下来通过 API 正常调用插件,我们需要将整个流程发布上线,这样就可以在开发中顺利使用了。
在使用 API 之前,建议先了解一下 Coze API 的使用限制和计费方式,避免不小心超出限制,影响使用体验。
这里要特别注意:在调用 Coze 工作流或 Bot 时,基础版本的账户每月只有 100 次调用机会,超过后将暂停服务,无法继续调用。
所以在测试和部署时,务必要规划好使用频次和成本。
专业版不限次数和频率,但是会按次、按大模型的 Token 消耗来收费。
这次案例咱们不涉及到大模型的使用,完全是关于调用次数的问题。所以,重点就放在调用次数的计费方式上。
正常价格为 0.002 元/次,可以通过购买智能体资源包来获取更加优惠的价格。
除此之外,官方还为每个用户提供了超优惠的限购活动,以下是智能体开发者必买套餐。
大模型的计费方式不是本文的重点,大家有兴趣的话可以直接参考官方文档了解详情。
地址:https://www.volcengine.com/docs/84458/1288966#%E6%96%B9%E8%88%9F%E6%A8%A1%E5%9E%8B%E6%9C%8D%E5%8A%A1
首先我们先查看下 Coze API 文档。
地址:https://www.coze.cn/open
细心的小伙伴可能注意到,准备工作里除了要创建个人访问令牌,还提到需要创建和发布 Bot。
不过这次我们不打算用 Bot 作为 API,只是使用带插件的工作流,所以可以忽略创建 Bot 这一步。
现在,我们先来创建个人访问令牌。注意,令牌创建后要及时保存,因为一旦关闭页面将无法再次查看哦!
地址:https://www.coze.cn/open/oauth/pats
接下来,我们一起看看如何使用 API 调用工作流的具体要求和操作方法。
API 调用工作流文档地址:https://www.coze.cn/docs/developer_guides/workflow_run
如果我们用 API 调用工作流,有几个要求要特别注意:
1、工作流必须 提前发布。
2、工作流里不能包含这些节点:消息节点、开启流式输出的结束节点、问答节点。
另外,涉及复杂场景时,有一个小技巧:专业版用户可以在调用工作流时指定参数 is_async=true,这样可以开启异步模式,更适合处理耗时较长的任务。
过去使用工作流时,超时问题确实挺常见,比如 工作流整体、模型节点、插件节点 的运行时间都限制在 3 分钟内,处理复杂操作需求时,很容易超时。
一旦使用异步方式,时间将会延长(具体如下表),这样更适合处理复杂任务。
测试发现: 插件节点有很大概率在 1 分钟之后就会超时,并非官方给出的 3 分钟。
选择国内目前比较流行的 Apifox 平台,注册并登录进入。
地址:https://app.apifox.com/main
1、成功登录并进入页面后,点击进入 个人项目。
2、接下来,根据需求从工作流的请求示例中复制同步或异步执行的代码。
因为这次工作流里只包含插件,所以我们直接选择 同步执行 的请求代码即可。
3、回复 Apifox 点击更多功能 > 导入 cURL,导入上一步复制的代码。
4、接下来需要配置 API 调用参数。
配置 Headers > Authorization, 从下方地址创建并复制而来。
来源:https://www.coze.cn/open/oauth/pats
配置流程 ID 和其他参数。
workflow_id:从已发布工作流的网页地址上复制 wordflow_id 参数的内容。
parameters:根据流程的开始节点配置,有几个配几个。
最后,点击发送,测试成功。
点击 生成接口请求代码,记录刚才的请求代码和返回结果,用于在 Cursor 中生成代码使用。
记录提示词( 大家根据实际情况记录):
为了更快拿到反馈,我们可以先用 Cursor 生成一个基础框架,之后再逐步填充具体需求,最后进行插件的测试和迭代。
这样一来,反馈可以尽早收集,优化也会更高效。
输入初版提示词,用于生成插件代码的基本结构。
继续要求生成侧边栏相关的代码。
根据 AI 的提示,来进行测试。可以打开浏览器,进入插件的加载链接,选择插件代码所在的文件夹。这样一来,就能加载插件,开始后续测试啦!
插件加载链接:chrome://extensions/
在正式测试前,可以按下 F12 打开开发者工具,切换到 Console 页签。
接着点击右上角的“清除”按钮,保持 Console 页面干净,这样可以避免网页本身的错误信息干扰视线。
这样在测试时,如果出现报错,Console 里显示的基本就是和插件本身相关的错误信息,方便排查问题。
在第一次测试中发现:选中文字后并未出现浮动按钮,而且 Console 中也没有任何错误提示。
这些信息可以整理后,反馈给 Cursor,以便它协助排查原因。
第二次测试发现:选中文字后浮动按钮正常显示了,但点击按钮后侧边栏并未弹出,同时 Console 依旧没有任何错误提示。
反馈给 Cursor 后问题顺利修复咯!
在测试“选中文字,点击浮动按钮,显示侧边栏和文字”这个基础功能时,我发现 Cursor 的代码成功率不太高,经常需要花时间去调试。
为此,我准备了一个代码模板,后续遇到类似需求时,大家可以直接基于模板开发,提高效率!
评论区回复“思维导图插件”领取。
在基于现有代码进行二次开发时,建议提前把已有的功能告诉 Cursor,这样可以帮助它更好地理解代码背景,从而提高开发的准确性和效率。
再输入完整的提示词(不要复制,注意根据个人实际代码来组合提示词):
加载插件后,我们来测试下。
不过还是有些问题需要注意,比如:没有关闭按钮、文字不该出现在侧边栏、没有加载状态提示等。
输入提示词,优化下交互方式,优化后的效果如下:
目前还有很多可以优化的地方,比如缺少思维导图的查看和下载功能,样式设计上也不够美观。
我们可以让 Cursor 继续进行优化,这里就不再具体演示了。
最终效果如下:
评论区回复“思维导图插件”领取完整代码。
如今的 AI 时代,与其单打独斗,不如学会借力。
Coze 插件就像是一个个现成的乐高积木,而我们要做的,就是用创意把它们拼接成独特的作品。
不必执着于从零开始写代码,学会借助现有的工具,让创意为你带来无限可能。
毕竟,在这个快速迭代的 AI 时代,懂得站在巨人肩膀上的人,总能看得更远,走得更快。
我是 🐼 熊猫 Jay,希望这篇文章能有帮助。
如果觉得不错,随手点个赞、收藏、转发三连吧。
如果想第一时间收到推送,也可以给我个关注 ⭐
谢谢你看我的文章 ~