coze开发-9、技能-插件

coze开发-9、技能-插件
🛠️ 插件的原理与应用
插件的定义
插件是模型调用特定工具的能力，用户输入一个问题时，模型通过意图识别来判断是否需要调用某个预定义函数。

插件的功能
插件主要完成以下两件事：

判断是否需要调用预定义的函数。
执行函数调用并处理相应的参数和返回值。
举例说明
假设我们需要获取天气信息，由于模型无法直接获取天气，因此需要一个查询天气的函数。该函数包含两个参数，一个用于判断是否需要调用该函数，另一个是具体的查询内容。

插件的组成
插件实际上是一个工具的集合，包含一个或多个工具或API。当前集成的插件类型包括：

插件类型 描述
办公效率 提高办公效率的工具
图片处理 处理和生成图片的工具
多模态模型 支持不同模式的模型使用
插件的应用场景
使用这些插件可以扩展机器人的能力边界，例如在机器人中添加搜索新闻的功能。

基本概念
在使用插件时，需了解以下基本概念：

工具：多个与办公相关的工具或API，如文档整理和会议安排工具。
输入参数：调用工具后的输出内容，如会议安排成功的信息或错误码。
实战演练
插件的使用步骤
打开插件商店：在B0TH开发过程中，通过技能模块添加插件。
选择插件：根据需要选择合适的插件，当前平台支持AI自动推荐功能。
配置参数：每个插件都有输入参数和输出参数。
参数类型 描述
输入参数 工具所需的输入内容，如搜索内容
输出参数 工具执行后的结果，如返回的网页信息
示例：头条搜索插件
头条搜索插件包含两个可添加的内容，分别是BR0D浏览和SUSS搜索。
在插件添加后，显示插件的信息、名称及所用工具的名称。
输入参数的示例
输入查询：指定要搜索的内容。
搜索数量：指定需要返回的网页数量，默认为10。
输出参数的理解
输出参数是指插件执行后生成的内容，常用于工作流中作为下一个节点的输入。

输出内容 描述
URL内容 返回的网页地址
文章标题 网页内容的标题
重要信息 其他有用的信息
插件的运行状态
在实际运行时，例如调用头条搜索插件，会返回生成的结果，包括调用记录和输入参数的信息。

插件的调用效果
通过调用不同的插件，模型能够根据用户的输入判断调用哪个工具。例如，输入关于“老虎”的查询时，模型会决定调用头条搜索而非图像生成插件。

人设与回复逻辑
为了更好地让模型理解何时调用哪个插件，可以在角色背景、技能描述中明确指示。例如，当用户需要生成图片时，可以调用相应的工具。

部分 描述
角色背景 描述机器人在何种场景下调用工具
技能描述 指明在何种情况下应使用哪些工具
以上是插件添加后的功能作用，以及如何通过角色背景和回复逻辑来优化插件的使用。

🧩 插件及其相关概念
插件的基本概念
“插件是一种可扩展的功能模块，可以为应用程序增加新功能或改进现有功能。”

插件的组成要素
参数：用于传递信息的变量，分为输入参数和输出参数。
输入参数：用于插件运行时接收外部信息的参数。
插件的运行原理
在插件运行过程中，会涉及以下逻辑：

逻辑 描述
输入 接收用户输入的参数，例如查询内容、时间等。
处理 根据输入参数进行逻辑处理。
输出 返回处理结果，例如查询结果或其他反馈。
示例：抖音视频查询插件
在探索抖音视频的搜索功能时，我们可以设置以下参数：

关键词：搜索的关键词。
数量：返回的视频数量。
排序方式：如按点赞数排序。
发布时间：限制视频的发布时间（例如过去7天）。
通过调用查询接口，我们能够自动解析并获得所需参数，最终返回指定数量的视频结果。

插件的创建流程
创建插件的步骤
进入插件部分：在个人空间中找到插件创建选项。
填写插件信息：
插件名称
插件描述
选择服务接口：可选择已有服务接口或自定义代码。
配置授权方式：选择所需的授权方式，如无需授权等。
示例：创建一个查询天文图片的插件
工具名称：ASA
工具描述：查看天文图片
API路径：填写相应的API路径
请求方式：选择合适的请求方法（如GET或POST）。
参数配置
在创建插件时，我们需要配置输入和输出的参数。例如：

参数名称 描述 类型 是否必填
C0UNT 返回的图片数量 整数 是
DATE 查询的日期 字符串 否
调试与验证
在插件创建完成后，执行调试与验证步骤：

运行插件：检查输入参数是否正确。
查看输出：确认输出结果与预期一致。
修改与更新：根据测试结果进行必要的调整。
发布插件
成功创建并验证插件后，可以进行发布：

填写个人信息：如位置信息、设备信息等。
选择发布选项：确认是否收集用户的个人信息。
提交审核：将插件提交到插件商店，供更多用户使用。
插件商店的功能
在插件商店中，用户可以：

浏览和搜索已有的插件。
提交反馈，建议新的插件功能。
查看插件的描述和参数信息。
以上是关于插件创建与使用的完整流程，了解这些知识能帮助我们更好地利用插件的能力。