Coze插件使用

AI作画软件中文版 2025-07-26 09:30:43
 
今天分享扣子插件的使用。先说说插件,它就像工具集。比如做旅行规划AI应用,涉及景点信息、开放时间、门票、天气查询、酒店预定等,光靠大模型或deep seek不行,得用插件。
扣子里插件超多,有资讯阅读、旅行出游、效率办公、图片理解等。页面有个商店,里面有插件商店,分类丰富,像网络搜索、图像工具、新闻阅读等都是开放工具,随时可用。
以做天气查询为例,要用天气API。我演示下插件用法,我之前创建过“AI新闻”智能体,它有新闻插件。提示词里有相关描述,输入“最新新闻”,它就会调用插件搜新闻。看右边提示词,随便搜最新新闻,它会调用头条新闻,新闻地址、摘要等信息就出来了,这就是基本使用,还能加更多插件。
比如加墨迹天气,添加后在提示词里指定工具使用,按提示词思路加句话就行。比如说我现在要在这里加搜索最新天气功能。当用户询问最新天气,就调用墨迹天气插件的API,从官方获取最新天气信息,结果会自动保存,用户可在右侧聊天框搜索,比如查北京最新天气,能看到结果。
看,正在调用墨迹天气,能看到API调用情况。因集成了插件,能抓取实时天气,没问题。这插件可自行创建,但有收费,官方有说明,调用API计费,基础版和专业版赠送额度不同,建议用专业版,之前可免费开通,能体验更多次数且有限流,商用可开通付费版,额度更多,否则有使用限制。
整体限制在工作空间,比如扣子打开有个人空间,可创建多个空间,一个团队只能用1000个插件,每个插件最多含100个工具,账号下最多创15个IDE插件,权限可配置,团队成员都能创建插件。
若有个性化需求,官方插件不能满足,可自由创建。入口有两个,一是在项目开发应用里添加插件,若无想要的可点创建插件;二是打开工作空间的资源库。资源库右上角有个“资源”,点进去能创建插件。插件啥用?比如公司自研API,不想用官方的,就把API地址加到插件里。
插件就是调用外部HTTP服务接口。我之前写了个插件,里面能新增工具,一个插件可对应多个工具。像检索插件,能搜不同搜索引擎,每个工具就像调用API的接口。
我创建了个“查看所有智能体列表”工具,它调用官方接口,能拿到我发布的智能体。目前我就发了一个,是在扣子快速入门课里新增的“阮心鼓励关”,能回答问题并给人鼓励。
那怎么开发插件查发布过的智能体呢?在资源库的插件里创建工具,名称叫“查看智能体列表”,描述随便填。工具名对应函数名,就像墨迹天气插件里查询今天天气的工具。我的插件有“查看智能体列表”工具,函数名是“published多次list”,用来查所有智能体。查询应用时,若应用多会用到分页参数。查询需设置分页相关参数,可在新增工具里编辑。
这里的API来自模块中的扣子API,官方提供众多API,如查询知识库、调用工作流等,后续会分享。以获取发布的智能体列表为例,要用到相应API。
调用API需先申请token,我已申请好。查看官方文档的鉴定方式,访问API要先有个人访问令牌。登录个人访问页面加密钥,添加新令片并配权限,选过期时间,处理后复制密钥粘贴测试。
要查询智能体列表,先发布智能体,我已配好相关设置,还需复制工作空间ID粘贴到对应位置。接下来,咱们分页查询,每页查十条数据,然后运行看看。
看,这是我发布的智能体地址,有名称、描述、logo图片和发布时间。我发布了个叫暖心鼓励关的智能体。这官方API能用来调用智能体接口做处理,得知道怎么测试。
在“我的插件”里加好后,API文档里有写相关内容。复制这地址,新增工具时填上去,参数也按文档里的填。
点进去后,点编辑,有个自动解析,模拟调用下,消息报文就解析展示出来了,再点保存。默认拿到数据后,点试运行,就像这样,能拿到数据就没问题。
这东西要集成到插件里,得做配置。配好后点发布,插件就能用了,别人也能用,相当于公共仓库应用。
看这儿,用我插件的话,先移除再添加,选资源库工具里的“我的插件”加进去。加句话:搜索我的智能体列表时,先调用这工具,工具名是查询我的整理列表。比如现在搜我的智能体列表,就会调用这插件功能,实际是访问前面说的API。以下是智能体列表整体名称及相关情况,像暖心鼓励这类的,其描述等都能搜出来,图标也能查。这就是自定义插件逻辑。
以后公司写插件,可用官方方式发布,能自定义布艺参数并整合。它有边界,只提供新闻相关,超范围不回答。但若把插件使用写上,会调用插件解答,没写就只限AI新闻内容,写插件时要注意这点,有需要的可参考文档。
文档写得清晰,创建插件按步骤来:先选插件,填名称,配密钥(官方扣子密钥),再做配置,如填API地址(cos API里可拿密钥复制地址)、参数等,官方测试处能看到。
还有参数新增,比如访问API测试,像提供企业内部接口查询信息,要定好分页等参数及token,配置好测试能否调通,不通则聊天窗口会报错。关键一点,写完插件功能后,务必点发布。不点发布,在这找不到。点加号时,没发布就找不到。发布可能审核慢,等下就行。
使用插件,有提示词,可基于此创建AI新闻速览注释。比如查新闻、天气,配置相关提示即可。
用户搜啥调啥工具,这就是function calling。提示词里声明,大模型会返回含工具消息请求,就会调用工具,右侧列表能看到调用细节,像官方API、分页参数等,数据都能抓出并呈现,提示词很关键,要写清晰。
提示词里要写清用户做事时调啥工具、查询逻辑及限制,比如字数,因token上下文限制和API按token计费,输出太长有成本问题,得限制长度。
配好提示词后,可在工作流里添加插件节点,这种应用方式也没问题。还有一种工作流方式,就是切换成编排模式。编排分析多为多 agent 形式。在编排里,能添加技能,这里不显示插件名,直接是技能。一个插件下往往有多个工具,像并搜索就有两个工具,大部分虽只有一个。以头条搜索为例,一个是获取网页内容,一个是搜索用户题词,还有与 kimi 大模型整合的。在工作流里叫技能,其他地方可能叫插件,只是名称不同,界面一样,处理时别混淆。对话里叫插件,工作流里叫技能。
总结一下:插件类似工具集,一个插件下有多个工具,比如搜索天气有多种方式,包括公司集成的插件能查内部文档等。扣子有众多插件,如新闻、阅读、旅行等,可根据需求使用。注意,它收费,有免费额度,超了要付费,非商用别无限制用。若官方插件满足不了公司内部需求,可自行开发。开发插件需先获取请求地址及token,配置好后便可调用。发布插件有云端、IDE、端侧等方式,按场景配置,关键在token和请求类型,即调接口。
调接口要配好参数,插件配置完再配工具的API及参数,有自动解析功能,配好请求参数后,返回报文会自动解析显示,无需新增响应报文。点运行测试,没问题即可发布,发布后就能使用。
插件使用场景多样,可在单agent智能体应用开发中集成,还能在工作流及对话中使用。使用时要在提示词里写明调用场景、要求及限制,如字数等,否则结果可能不符预期。