今天给大家分享一下扣子插件的一些使用。首先我们来说一下什么是插件。插件的话在这个壳子里面，它可以当做一个工具集。比如说我们现在要做一些旅行规划的AI应用，那旅行规划的话可能会涉及到搜索旅行景点的一些信息，就当地的一些最新的信息。包括像有些景点的开放时间，然后一些旅行的一些要求，包括门票的一些信息，以及我们有时候需要去调用一些天气工具，查询当地的一个天气情况，以及要预定酒店等等。这些功能的话，光靠这个大模型或者deep seek是无法完成的那这时候的话我们就需要用到这个工具。那工具的话在扣子里面，它是用这种插件的这种方式去做的。
 
那扣子里面的话集成非常多的一些插件，比如说像一些资讯阅读、旅行出游、效率办公、图片理解。大家可以去到这个扣子的这个页面里面，有个地方，有一个有一个商店，商店里面有一个插件商店。大家可以看到这个分类非常多，就是很多。像一些我们常见的网络搜索，包括一些图像工具，新闻阅读等等。这些工具的话都是一些开放的工具，大家可以随时拿过来用。
 
比如说我们现在要做一个天气查询的话，那我们首先就要去用到这个天气的一个API。比如说我现在给大家演示一下怎么样用这个插件，比如说我现在我之前创建过一个智能体，这个智能体的话它叫做AI新闻，主要就是用来去生新闻的那大家可以看到，在这个里面其实有一个新闻的这么一个插件，我这个提示词这里的话其实有这么一段描述，就让它具备一个技能。当我这里输入去搜索最新的新闻的时候，他就会调用这个插件，去这个网络上面去搜最新的一些新闻。比如说我就在这里右边，给大家看一下这个提示词，我就随便搜这个最新新闻。大家可以看到它在调用头条的新闻。然后你看他这里包括新闻地址，然后摘要，是吧，整个一些最新的新闻的话就出来了，这个就是一个插件的一个基本使用，然后的话就是大家也可以添加更多的一个插件。
 
比如说我现在要去添加一个，比如说我说天气，天气比如说我们现在用的比较多的像这个墨迹天气，我们把它加入进来，添加进来，添加进来。添加进来之后的话，大家可以在提示词的这个里面去去指定这个工具的一个使用。比如说我们在这里同样的按照这个提示的一个思路，然后下面加一个东西，加一句话就可以了。
 
比如说我现在要在这里在上面加一个搜索最新天气，当用户询问最新的这个天气是天气是调用，咱们就调用这个day weather，就是这个墨迹天气提供的这个插件功能，提供了一个API。那这个API的话就是去调用墨迹天气官方的这个API，拿到最新的这个天气信息好，这样的话就可以了。只要有这么一句话，然后它这个里面是自动保存的，然后大家就可以在右侧的这个聊天框里面去搜，比如说查询什么北京最新天气，然后看结果。
 
你看你看正在调用墨迹天气，这里大家可以看到它的一个API调用的一些情况。这个其实就是因为我们在这里集成这么一个插件，所以大家可以看到今天是3月29号，然后就是天气的一些情况，就是抓的这个实时的这一块没有什么问题。然后的话就是这个插件的话，大家也可以自己去创建一个插件。这个咱们等下来说，插件其实它是有收费的，大家可以去看一下这个官方的这个说明，就是这一块因为调用这个API，它都是要计费的。这个基础版跟专业版的话，它每天赠送的这个额度会不一样。我建议大家用这个专业版。专业版的话这个开通费用，我记得之前也算是免费开通，这样可以免费体验到更多的一次数，并且的话它还有一些限流。如果说大家要拿它来做一个商用的话，那你可以去开通它的一个付费版本。
 
这样的话使用上面它的额度的话就会更多一些，不然的话它是有使用限制的，这个是需要说明的。然后整体的一个限制的话，就是我们一个工作空间。什么叫工作空间呢？就是我们现在比如说有一个扣子打开带大家看看到这里有个个人空间，咱们相当于可以创建多个空间。这个相当于一个团队，相当于每一个团队的话只能用1000个插件。每一个插件的话就是最多包含100个工具。这个地方，就是咱们的这个智能体这个里面，这个插件，就是只能放100个，然后每个账号下面最多可以创建15个IDE插件，然后包括一些权限的话，大家可以去配。团队还是有普通成员都可以去创建一个插件。
 
好，然后如果说大家有一些个性化的一些需求，你觉得官方的一些插件满足不了你的一些需求的话，那怎么办呢？大家可以自由的去创建这个插件，就在这个里面，它其实有几个入口，一个是大家在这个项目开发应用里面，我们找到这个有一个这个地方，这里大家看啊就是我们可以添加插件。添加插件。如果这里没有你想要的话，你可以点这边有一个按钮叫创建插件。这第一个路口，第二个路口的话，大家直接就打开这个工作空间，有一个叫资源库。资源库这里最右，右上角有一个叫资源，然后加这个插件，这里大家就可以看到创建一个插件，那么创建这个插件是干嘛的呢？就是比如说大家公司里面自己写了一套API，就是我想用自己的一些服务器去调用，不想用官方的那你就可以什么呢？你就把一些官方的这个，就是你的一个API的地址。
 
插件的话，它其实就是调用外部的一些服务接口，一般来说是一个HTTP服务的，就是你比如说我要写一个什么我的插件，然后把它加上描述，这样就可以了。这个其实我之前写了一个我的插件，这里的这个里面大家可以看到，这个是我的一个插件，我之前新增的那这个插件新增好之后的话，大家就可以在这个插件里面去新增这个工具，就是一个插件，它会对应有多个工具。比如说我这个是做检索的那我可能会检索不同搜索引擎，就是我是一个插件，但是我有很多工具，每一个工具的话，大家可以把它看作一个调用API的一个接口。
 
比如说我现在就实现了一个接口，大概创建工具的地方，你可以自己创建一个工具。比如说我现在创建了一个工具叫查看所有智能体列表，这个工具是干嘛的呢？这个是调用官方的一个接口，就是扣子官方的一个接口，去拿到我发布的所有的智能体。大家可以看到我目前就发布了一个智能体，这个是我在之前讲扣子快速入门那节课里面，给大家新增了一个叫阮心鼓励关的这么一个整体。主要就是他会去你问的一些问题，他会给你一些鼓励，去做一些这个相对来说也相当于做一个鼓励师的这么一个角色。这个是我发布的一个整体，那现在我需要就是比如说我现在需要开发一个插件，把我所有的发布过的智能体全部查出来。
 
那这个怎么实现呢？就是在咱们刚刚那个里面，大家看到这个资源库里面，就我的插件里面我可以干嘛呢？创建一个工具，我工具名称就叫查看智能体列表。然后工具描述的话大家这里随便填。然后完了之后这里大家可以看到就是工具名称是这个是这个英文的这个函数名。这里其实就是对应到我们这个智能体里面哪个东西？给大家看一下，在这个里面大家可以看到，就是这个工具里面我可能有很多。
 
你看这个是一个插件，插件里面对应有一个工具是吧？这个工具就是墨迹天气下面的一个查询今天实时的一个天气的一个这么一个工具。所以说咱们这里我写了一个我的插件的话，那我的插件有一个什么工具呢？
 
有一个查看智能体列表，所以说它的一个工具名称的话就叫做这个published bots list，就是查询所有的整体应用。那查询应用的话，应该我们的应用如果有很多的话，这里会用到一个叫分页参数。说白了就是我们要去查询对吧？查询这个size，包括一些分页，我们要做一些查询。那查询的话就相当于我们要干嘛呢？就是有一个分页参数，分页参数这里大家可以看到就是这里要填几个参数。那这个参数的话大家可以在新增这个工具里面这里编辑。
 
那这个地方它的一个API怎么来的呢？大家看啊在这个模块里面有一个叫扣子的API。扣子的API里面大家可以看到有一个比如说它有很多API，就是官方提供了很多API给你。比如说你要查询知识库，这个我们后续分享会给大家讲，包括工作流，你要调用工作流的一些API。比如说你要执行工作流或者是一些SDK语音、文件、绘画，就官方提供了很多能力。你如果说想把它做成一个插件去集成的话，那你就要把这些API要了解一下。比如说我们现在要做的就是我要获取我发布的这个智能体列表。其实我就是用的这个API，这里大家可以看到就是这么一个API，API里面就是我们可以干嘛呢？
 
就是在这个里面，大家可以看到，在这里首先这是官方的一个API列表，一个API列表里面就是我们可以做一个什么事情呢？我去调用这个API，调用这个API首先大家得需要有一个token，这个token的话就是你首先需要去做一个申请做一个申请。那我现在是已经申请了一个这么API的。然后的话这里大家可以看到有一个健全方式，健全方式这里打开，大家看这官方的文档里面写了一个鉴定方式。也就是说大家访问这个API的话，你首先要拿到一个个人访问令牌。个人访问令牌里面，在这里面大家可以去登录到这个个人访问页面里面，就加这个密钥。这个密钥的话就是我们去添加一个新的令片，然后大家去把这个权限给它配上。
 
也就是说你现在需要哪些权限，你就给他都配上。配上之后这些你选一个过期时间，比如说30天就过期了，那这个时间的话就是大家也可以把这个东西什么呢做一个处理，做一个处理，然后就是把它配一下，配一下就有一个密钥，密钥的话大家把它复制一下，到这个里面，你把它粘贴到这里就可以做一个测试。比如说我们现在要查询所有的智能体列表的话，那首先你要把这个智能体给发布一下。然后的话就是在这个里面，这里我其实已经配了一个了，然后你要拿到一个什么呢？就你的工作空间的一个ID，比如说这个是我的ID是吧？我的ID把它复制一下，然后粘贴到这里，粘贴到这里。然后的话就是去比如说我现在分页查询一页，就查十条数据，然后运行一下。
 
大家可以看到这个就是我发布的那个智能体的那个地址是吧？然后智能体的名称描述，然后智能体的logo的那个图片以及发布时间。大家看到我就发布了一个叫暖心鼓励关的这么一个智能体。这就是我们可以用这个在官方的这个API里面，咱们去调用这个智能体的一些接口，然后去干嘛呢？然后去做这个处理，也就是这个API大家要知道，就是怎么来做这个测试。好，理解这个之后的话，然后大家在这个地方就是去我的插件里面，在这里面你把它加好之后，就是这个API其实在这个文档里面其实有写。这个API里面大家可以看到，比如这个里面你看这个地址，大家把它复制一下，复制一下这个地址，然后就新增工具的时候把这个地址填上去，然后把参数，参数也是参考这里的参数，把它一个个的填上去。
 
点上去之后，然后这里大家可以做一个什么呢？做一个叫点一下这个编辑，有一个叫自动解析，就是你模拟下去调用一下，它会把这个消息报文自动给你解析出来，展示在这里，然后点一下保存就可以了。也就是他默认会拿到一些这个数据，然后再点咱们试运行。那现在比如说我点运行，这里大家可以看到，就是你看他会拿到这些数据是吧？拿这些数据这个就没问题了。Ok所以说这个东西的话就是我们要去集成到一个插件，我们要具备这么一个功能，就要去做一个配置。然后完了之后的话，大家可以看到就是。
 
这个配好之后，然后你要点这个发布，发布就是把把我这个插件发布是吧？发布上去就可以了，然后这个就可以用了。别人的话其实也可以用，就是相当于我一个公共的一个仓库应用。
 
好，然后的话大家看这里，就是在这个地方有一个什么呢？叫这个。比如说我现在用我那个插件怎么办呢？来看我觉得这里其实集成了，我先把它移除掉，我在加入，比如说我那个名字叫我的插件，看一下资源库，大家看啊点这个资源库工具，然后选我的插件，然后把它加进去来添加。大家看添加完之后它就在这里，然后我们这里加一句话就是什么呢？
 
搜索我的智能体列表，当用户询问我的智能体列表的时候，先调用这个工具是吧？这个是插件，这个是工具名，注意，这个是工具名查询我的整体列表。然后大家就问了，就比如说我现在要搜索我的智能体列表，来看它这里会调用什么呢？调用我的插件是吧？先调用这个插件里面的这个功能，然后他其实就是访问我刚刚提到那个API。然后这大家可以看到以下是您的智能体列表，智能体名称，什么暖心鼓励管什么什么吧？然后描述什么是不是都给它搜出来了，包括图标大家可以看到这个是不是都能查得出来。所以说这个就是自定义插件的一个逻辑，以后比如说你公司要自己写一个什么插件，你也可以用官方的方式把它发布出来。
 
这里你自己去自定义复习参数，可以把它整合到这个整体里面去，这个都非常方便，这个就是只能证明自己的逻辑，然后比如说我们还可以问他更多的一些问题，对吧？然后他你看这个里面只是能提供新闻相关的，所以说他这个是有边界的，超过这个范围他就不回答了。你看限制只讨论AI新闻有关的内容，拒绝回答与AI新闻无关的内容。但是如果说你把你那个什么这些智能体插件使用写在这上面的话，它还是会去调用那个插件去给你解答问题的。如果你没写这句话的话，那就会说出下面这一堆东西，就是只能提供与AI新闻相关内容，这就是大家去写插件的时候需要注意的一个点。就是我们如果自己有需要的话，大家可以参考这个文档。
 
我这个文档上面写的比较清晰，比如说怎么样去创建一个插件，其实我刚刚也讲过了，整个按这个步骤来，首先是选择这个插件，然后去填这个插件的一个名称，填完这个名称之后，把这个密钥给它配上。这个密钥的话我刚刚讲过了，要去拿到官方的那个扣子那个密钥。拿到那个密钥之后完了干嘛呢？就是需要去做一些配置，把一些工具。你看这个API地址，这个地址刚刚有提到，在这个cos API里面大家可以自由的去拿到这个密钥的，是吧？这些地址在这个里面把它复制一下就可以了，然后包括一些参数，官方的这个测试这个里面其实也可以看得到这个地方。好，然后是这个什么呢？就是一个参数，就是一些包括一些参数的一些新增是吧？就是测试怎么样去访问这个API。比如说你以后要提供一个企业内部的一个接口，比较查询内部的一些信息，那你要也提供一个相当于API接口，然后包括一些查询，很多情况下都要分页，分页查询未查询的话，就是你要把这些参数给他定好，包括一些token是吧？
 
配置好完了之后，你做个测试，看一下这个能不能调的通。这个能调通的话，那我们在聊天那个地方调用才会通。如果说大家去新增这里的时候就已经不通过的话，那在那个聊天窗口那里肯定也会报错的，这个是需要说明的。
 
然后最关键一点就是大家去把这个插件，你去写了之后，就大家把自己把这个插件，资源库里面这个插件功能写完之后，你一定要点发布。你如果不点发布的话，在这个地方，大家看这个地方你是找不到的。你点这个加号的时候，你点这个加号是在它是在这里找不到的，就是一定要在这个里面，大家一定要把它发布出来，发布的话是不行的那发布有时候可能会在审核，可能会有些慢。那也没关系，大家等一下就可以了。
 
然后使用插件的话，我其实也刚刚也讲到，就是这个地方给他提供了一个提示词，大家可以基于这个提示词去创建这么一个AI新闻，速览的这么一个注释。在这个里大家可以看到，比如说你想让他去查询这个新闻或者查天气的话，你直接在这个里面给配置一个相关的提示就可以了。就是当用户搜什么的时候，你让他去调什么工具，这个其实就是那个function calling，就是你在提示词里面声明了一点，那大模型后面会给你返回一个请求，里面会包含一个工具消息，他觉得你应该去调用工具。这时候这个整体这一块他就会开始调用这个工具，也就是大家可以看到我们这个右侧的一个列表里面。你看你问了一个搜索我的智能体列表，他就可以开始什么呢？调用我的插件，调用我的插件里面，这里大家可以看到它调用的一些细节是什么，就是调用官方的一个API？什么分页参数，空间ID等等，整个的数据你看是不是都给你抓出来了，对不对？抓出来之后，然后他把它最终呈现在这里，所以说这个地方就是一个提示词，就很关键了，就是你这里要写的比较清晰。
 
当用户做什么事情的时候，你让他去调用什么工具去做一个查询逻辑，包括一些限制。就是这个提示词里面，智能体的这个提示词里面，你要写清楚他只做哪些事情，不会做哪些事情。比如说字数限制，因为字数很长的话，它会有一个token的上下文限制，可能会导致一些成本方面的一些问题，就是这个输出内容太多了，它是要付费的是吧？API是按照token计费的，所以说这个长度大家其实也要限制一下，不能让它无限制的去输出。
 
然后就是把这个提示是配好之后，完了之后可以干嘛呢？你可以做一些处理，当然大家也可以在工作流里面去添加这个插件节点，就在这个工作流里面，其实我们也可以把它加一个插件。这个不光是用在我们刚刚提到的这个里面，在这个里面其实在工作流的这种应用里面，那其实也可以去添加这个插件的，这个都没什么问题，这个是一种使用方式。那其实还有一种就是，一些个工作流的方式，就是把它切换一下。那就编排，就编排的这种方式。我看一下编排分析应该是多agent的这种方式。大家看到编排，编排里面我们其实可以也可以提到你看这些个东西，就是你可以在这里加技能是吧？这里它就没有显示那个插件的名字，直接就是一个技能。
 
就是你选完这个技能之后，你看一个插件下面它其实有很多工具，就是这个你看并搜索它有两个是吧？两个这个工具，包括其他的可能也有多个的，有大部分其实都是一个。有的。你看头条搜索是搜索这个什么呢？这个浏览，loser，就是获取网页内容，一个是搜索用户的这个提示，包括跟kimi大模型的一个整合，它是有多个这个的，所以说这里的配件，这个地方就单独的这个工具的话，它其实就是一个技能，就是个技能。只是说在工作流里面，这个叫法不一样，这个里面叫技能。那有些地方可能就叫插件，所以说它只是一个叫法不一样。
 
你看这里它叫插件是吧？那么添加进来，其实这个插件做的事情就是技能，只是说在这个多agent里面，这个里面它叫技能叫技能只是说法不一样，其实跟那个界面是一样的。所以说大家在不同的这个地方去做一个处理就可以了，没什么太大区别，只是就是一个叫法不一样。在一个是在这个工作流里面，工作流里面这个叫叫这个技能是吧？然后在这个对话里面这个叫插件，换了个说法。
 
好，这个的话就是扣子插件的一个使用，然后我们来做个总结。首先的话就是大家知道什么是插件，插件的话就相当于是一个工具集，工具集的话就是一个插件下面会有多个工具。比如说我搜索天气的，那搜索天气可能有多种搜索方式？然后做检索的那有的是搜索，有的是匹配，有各种各样的工具，包括公司的一些集成，你们公司的一个插件，那有可能是查一些公司内部文档的，有可能是执行什么功能。就是这个工具的话，它下面可能有啊多个，就一个插件下面对应多个工具，那扣子的话有很非常多的一个插件，包括新闻、阅读、旅行等等很多的这种插件，大家都可以去根据需求去用一下。然后需要注意的是，这个东西是收费的，它每天有使用免费使用的额度，但是超过的话就会有一个费用，大家不要无限制的去那个，除非你真的是商用，然后包括一些限制，大家也要搞清楚，就数量这一块，然后是如果说，公司内部的需求，大家觉得就是这个呃，官方的这个插件满足不了你的需求的话，你可以自己开发一个插件。
 
开发一个插件的前提就是你要拿到插件的一个请求地址，包括一些token是吧？这些东西你需要自己给它配置好，配置好完了之后的话就可以去调用了，调用完了之后就是前提，首先一定要点这个发布，就是包括你要新增一个这么个插件，你看有几种方式，有云端的，有IDE的，还有这个端测的是吧。每一种插件的这种方式，大家根据具体的场景去配置就可以了，最关键的就是一个token，然后请求类型，这个说白了就是调接口，是吧？
 
调接口你要把一些参数配置好，配置好之后，然后先把插件配置，插件配置完之后把工具配成工具的话，就是配具体的API加这个参数。然后它这里有一个人性化的功能，就做了一个自动解析。你配只要配置请求参数就可以了。请求参数要调通了，它就会把这个返回的报文自动解析，把它显示出来。这样你就响应的报文你就不需要新增了。然后点运行的话，咱们测试一下，这里没问题的话，就可以发布了。发布完之后，发布完之后就可以去用这个插件。用这个插件的话有几个场景，一个的话是在普通的这个单agent里面，就是这种体应用开发里面，去把这个插件给它集成进来，就是咱们这里看到的这个地方，在这里把这个插件你就可以用起来了，这是第一种使用方式。然后的话还可以在这个工作旅游的这种方式下，就再多一阵子。
 
下面这个叫技能，就是每个场景下它的叫法不一样，所以说这个根据需要去那个，只是说比较关键一点，就是大家在这个提示词里面要把它写好。这个东西就是他的一个技能，他什么情况下需要去用到这个工具里面的技能，什么情况下有没有什么要求，包括一些一些具体的限制，比如说字数？无关的内容，就你写在这个上面的，你要写清楚什么场景下去调用这个功能。如果你没有写清楚的话，这里可能不就不是你想要的一个结果了，然后要把这些限制这些东西给它写好啊。