{T}

什么是插件？使用插件的最佳实践？

在现代软件开发和应用中，插件已经成为一种必不可少的工具。它们能够扩展软件的功能，提升用户体验，并且在很多情况下，可以显著提高开发效率和生产力，那 Coze 平台的插件又是怎样的呢？

本篇文章将深入探讨插件的概念、类型、使用方法以及最佳实践，希望能够帮助读者全面理解插件的作用和应用。

插件的传统概念

插件（Plugin），顾名思义，是指可以“插入”到主程序中，扩展其功能的独立组件。插件通常是可选的，不会改变主程序的核心代码，但能增强或增加特定功能，其设计理念在于提供一种灵活且可扩展的架构，使得软件可以根据不同用户的需求进行个性化定制。

插件通过标准化的接口与主程序进行交互。主程序提供插件运行所需的环境和 API，插件则通过这些接口调用主程序的功能，从而实现自身的功能扩展。例如，一个浏览器插件可以通过浏览器提供的 API 访问网页内容，并对其进行修改或增强。

插件的类型和用途非常广泛，其中最常见的包括浏览器插件、内容管理系统（CMS）插件和开发工具插件。

浏览器插件是最常见的插件类型之一，它们可以增强浏览器的功能。例如，Adblock Plus 可以拦截网页中的广告，1Password 可以管理和自动填写密码，Google Translate 插件则能翻译网页内容。

对于开发者来说，开发工具插件也是必不可少的工具。各种 IDE（集成开发环境）插件可以提高开发效率，如代码格式化、调试工具、版本控制集成等。以 Visual Studio Code 为例，Prettier 插件可以自动格式化代码，Debugger for Chrome 插件可以帮助调试 JavaScript 代码。

抱歉可能对于小白来说不好理解，但这的确就是技术领域的插件的传统概念，接下来我们会用更加通俗易懂的方式来解释插件的概念。

先来简单总结下使用插件的好处：

  1. 插件可以显著提高用户的生产力。例如，开发工具中的插件可以自动完成重复性任务，使得开发者可以将更多精力集中在核心功能开发上。
  2. 插件能够在不修改主程序代码的情况下，扩展软件的功能。例如，通过安装不同的插件，一个简单的文本编辑器可以变成一个功能强大的 IDE。
  3. 每个用户的需求可能不同，插件提供了一种个性化定制软件的方法。用户可以根据自己的需要选择安装特定的插件，以实现所需的功能。

所以，Coze 平台的插件其实跟传统插件的概念是一样的，都是为了扩展软件的功能，提高用户体验和生产力。

对于非技术人员来说，插件可以被比作家用电器中的各种配件。例如，一个基本的厨房用具套装可能包含一个多功能搅拌机，而插件就像是这个搅拌机的各种附件，如切片器、搅拌器、榨汁器等。通过安装不同的附件，搅拌机可以执行不同的任务，而无需购买新的设备。插件的作用也是如此，它们通过扩展主程序的功能，使得软件可以完成更多的任务，而不需要重新开发或购买新的软件。

所以要理解插件的核心概念，非技术人员可以从以下几点入手：

  • 插件是独立的组件：就像搅拌机的附件一样，插件是独立于主程序的组件，但它们能够与主程序无缝协作。
  • 插件扩展功能：通过添加插件，软件可以获得新的功能，就像搅拌机可以通过不同的附件来切片、搅拌、榨汁等。
  • 插件易于安装和使用：大多数插件都设计得非常易于安装和使用，用户只需简单几步操作即可将插件集成到主程序中。

如何使用 Coze 插件？

平台本身的插件生态就很丰富，这也多亏了官方和第三方开发者的不断努力。接下来我们来简单快速说说怎么使用插件吧。

第一种是直接在在 Bot 内使用插件。

  1. 登录平台：首先需要登录扣子平台。
  2. 选择空间：进入指定的个人空间或团队空间。
  3. 添加插件：在 Bot 的编辑页面，选择插件区域，点击加号图标来添加插件。可以手动添加，也可以点击图示红色框的右上角圆圈的A按钮，让语言模型自动推荐适合的插件。
  4. 设置和配置：在添加插件页面，展开目标插件查看工具，然后点击添加。用户可以查看当前团队下可用的插件。
  5. 测试插件：在 Bot 的回复逻辑区域，定义如何使用插件，并在预览与调试区域测试插件功能。

第二种是在工作流中使用插件节点。

  1. 登录平台：首先需要登录扣子平台。
  2. 选择空间：进入个人空间或团队空间。
  3. 创建或选择工作流：在工作流页面，选择已创建的工作流或新建工作流。
  4. 添加插件节点：在工作流中添加插件节点，并配置输入输出参数。
  5. 测试和优化：在工作流中测试插件的功能，确保其能够正确运行。

至于如何创建自己的自定义插件，因为这个会涉及到一些编程等技术基础，篇幅比较复杂，我会单独在后续内容写一篇延伸文章来详细讲解。

插件功能详解

接下来我们回到 Bot 编辑页面，具体看看每个添加的插件具体有哪些交互功能，注意，是每个添加的插件都会有这些功能。

这里我就拿 Bing 搜素插件作为例子吧。

第一个图标是插件的详情介绍，包括其输入参数的描述，我们先来看看：

编号 1 是插件某个功能的名称和简介，这里就不过多叙述了。但是有一个需要注意的是，当你的 Bot 添加了多个插件时，这里的名称和简介就是给大模型的提示了，即让大模型各个插件的作用，然后根据你的会话内容调用适合的插件来返回结果。

编号 2 是影响返回的搜索结果数量的参数。它的数据类型是 integer，也就是整数。默认值为 10，最大值为 50。实际返回的结果数量可能会少于请求的数量。这是告诉插件每次返回多少个搜索结果，比如，当你搜索“最新的手机型号”时，你可以通过这个参数来控制返回的手机型号数量。如果设置为 10，系统就会返回 10 个结果；如果设置为 50，系统就会返回最多 50 个结果。数据类型为整数是因为我们需要精确地指定返回的结果数量，而不需要小数或其他形式的数据。

编号 3 是用户的搜索查询词。它的数据类型是 string，也就是字符串。查询词不能为空。这是插件用来识别用户要搜索什么内容的关键词。例如，当你在搜索框中输入“今天天气怎么样”，这个查询词会被传递给大模型，大模型会根据这个关键词来返回相关的搜索结果。数据类型为字符串是因为查询内容通常是文本形式的描述，需要用字符串来表示。

编号 4 是从返回结果前要跳过的基于零的偏移量。它的数据类型是 integer，也就是整数。默认值为 0。这是告诉插件从第几个结果开始显示。例如，如果你已经看过前 10 个搜索结果，你可以把这个参数设置为 10，这样系统就会从第 11 个结果开始显示。数据类型为整数是因为偏移量需要精确到具体的结果条目，而整数可以精确表示这种位置信息。

大模型会根据用户的自然语言输入内容，自动识别出其中的关键词和参数，然后将这些参数赋值给对应的插件参数。例如，当用户输入“给我显示 20 个最新的手机型号”，大模型会识别出“最新的手机型号”作为 query 参数，“20”作为 count 参数，然后调用相应的插件并传递这些参数，从而返回符合用户需求的搜索结果。

这只是其中一个插件的例子，但是插件的功能交互就是如此来实现的。不同的插件会有不同的输入参数设置，但整体的交互流程都是通过大模型自动识别输入内容并进行赋参，从而实现智能的功能调用。数据类型的存在是为了确保参数的格式和内容正确无误，从而让系统能够正确处理和返回结果。

第二个图标是复制插件的名称，点击后会复制插件的名称到剪贴板：

第三个图标是绑定卡片数据，点击后会绑定卡片数据到插件。那什么是卡片数据呢？其实这个卡片数据应该叫消息卡片，是一种消息格式，用于在聊天应用中显示结构化的信息。消息卡片通常包含标题、副标题、图片、按钮等元素，可以帮助用户更直观地理解和处理信息。在 Coze 平台中，用户可以通过插件将消息卡片发送给 Bot，从而实现更丰富的交互体验。这个功能就是用来绑定消息卡片数据到插件的，让插件能够根据卡片数据生成相应的消息卡片。

具体消息卡片的详解我会在后续的文章中详细讲解，这里就不展开了。

这里最简单地给你演示一下一个插件有卡片数据和没卡片数据的区别吧。

以下是我一个没有绑定消息卡片的插件结果输出，都是些 JSON 结构的数据结果，可读性比较差，也不好看：

当我们绑定了我自定义的消息卡片后，我们再试一次，看看效果：

是不是瞬间看起来就高大上了很多？这就是消息卡片的作用，让用户更直观地理解和处理信息。

第四个图标是编辑参数插件，点击后会编辑插件的参数：

这里你可以看到插件的参数设置，可以根据自己的需求来设置输入参数，也可以查看插件具体的输出参数是怎样的，这样插件就会根据你的设置来返回结果。这里就不得不要先卖个关子提示一个输入输出参数的关键技术：JSON，这个是插件参数设置的重要技术实现，下一篇我们就来详细讲解，目前大家只需知道这个是插件参数设置的重要技术实现就行了。

第五个图标是删除插件，点击后会删除使用指定插件，这里就不展开了。

插件的最佳实践

好了，我们已经了解了插件的概念、类型和使用方法，接下来我们来看看插件的最佳实践，如何才能更好地使用插件，提高 Bot 的功能和性能。

  • 保持简洁和功能专一：每个插件应该只实现一个特定的功能，避免功能过于复杂。这样不仅可以减少 Bot 设计和维护的难度，还能使用户更容易理解和使用插件。例如，一个负责文本格式化的插件只需要关注如何格式化文本，而不应该同时尝试处理文本的翻译和校对功能。

  • 遵循插件“少而精”的原则：在选择插件时，应该遵循“少而精”的原则，只选择真正需要的插件，避免过度依赖插件。过多的插件不仅会增加系统的复杂性，还可能导致 Bot 的输出不稳定、甚至输出没有意义的信息出来。因此，应该根据实际需求选择适合的插件，保持系统的简洁性和高效性。

  • 避免添加多个有相似功能的插件：如果多个插件提供的功能相似，应该选择其中一个插件，并根据实际需求进行调整和优化。这样可以避免插件之间的冲突和重复，提高 Bot 输出的稳定性和性能。例如，如果有多个插件都提供了文本翻译功能，可以选择其中一个插件，并根据实际需求进行配置，避免同时使用多个插件。

总结

本文详细探讨了插件的概念、类型、使用方法以及最佳实践。以下是关键观点的总结：

  1. 插件的定义和传统概念：

    • 插件是独立于主程序的组件，通过标准化的接口与主程序进行交互，从而扩展主程序的功能。
    • 插件的类型包括浏览器插件、CMS 插件、开发工具插件等，广泛用于各种软件中以增强功能和用户体验。
    • 非技术人员可以将插件比作家用电器的各种配件，通过不同的插件，主程序可以完成更多任务，而无需重新开发或购买新软件。

  2. 使用插件的好处：

    • 提高用户生产力：开发工具中的插件可以自动完成重复性任务，让用户专注于核心功能。
    • 扩展软件功能：插件能够在不修改主程序代码的情况下，增加新的功能。
    • 提供个性化定制：用户可以根据自己的需求选择安装不同的插件，以实现特定功能。

  3. 如何使用 Coze 插件：

    • 详细步骤包括登录平台、选择空间、添加和配置插件、测试插件功能等。
    • 插件可以在 Bot 内直接使用，也可以在工作流中使用插件节点。

  4. 插件功能详解：

    • 以 Bing 搜索插件为例，介绍了插件的功能名称、输入参数的描述（如 count、query 和 offset 参数）及其数据类型。
    • 大模型会根据用户的自然语言输入内容，自动识别出关键词和参数，然后调用相应的插件并传递这些参数，从而返回符合用户需求的结果。

  5. 插件的最佳实践：

    • 保持简洁和功能专一：每个插件应该只实现一个特定功能，避免功能过于复杂。
    • 遵循插件“少而精”的原则：只选择真正需要的插件，避免系统复杂性和潜在冲突。
    • 避免添加多个有相似功能的插件：选择其中一个最适合的插件，避免插件之间的冲突和重复。

通过了解和应用这些知识和实践，你可以更有效地使用插件来扩展软件功能，提高开发效率和用户体验。未来的内容中，我们还会深入探讨如何创建自定义插件及其他高级功能，以帮助你更全面地掌握插件技术。