4.1 插件是什么及其工作原理

内容讲解

如果说大语言模型（LLM）为 Bot 提供了强大的“思考”能力，那么**插件（Plugin）**则为 Bot 提供了连接现实世界的“手臂”和“感官”。插件本质上是一组 API（应用程序编程接口） 的集合，它允许 Bot 调用外部服务来完成特定的任务，例如：

• 获取实时信息：查询天气、新闻、股票价格。
• 执行在线操作：预订机票、发送邮件、创建日历事件。
• 使用专业工具：生成图片、进行科学计算、分析数据。

工作原理：
当 Bot 的提示词或用户的输入触发了某个插件时，Coze 的 LLM 会像一个聪明的“调度员”一样：

1. 理解意图：识别出用户的需求需要通过某个工具来完成。
2. 选择工具：从 Bot 配置的插件列表中，选择最合适的那个工具（即某个具体的 API）。
3. 准备参数：从对话中提取所需的信息，作为调用 API 的参数。
4. 执行调用：Coze 后端执行对该 API 的网络请求。
5. 理解结果：LLM 读取 API 返回的数据（通常是 JSON 格式）。
6. 生成回复：将 API 的结果用自然语言组织起来，回复给用户。

流程图：插件调用过程

4.2 使用内置插件

内容讲解

Coze 平台已经内置了超过60种强大的插件，开箱即用，覆盖了新闻、搜索、图片生成、效率工具等多个领域。这极大地降低了开发者的门槛。

操作步骤：为你的 Bot 添加“必应搜索”插件

让我们来改造上一章的“电影推荐官”，让它能从互联网上获取最新的电影信息。

1. 进入 Bot 编辑页面：打开你的“电影推荐官” Bot。
2. 添加插件：在左侧的技能编排区，点击“插件”旁边的“+”号按钮。
3. 选择插件：在弹出的插件商店中，你可以看到所有可用的插件。在搜索框中输入“必应搜索”，找到该插件并点击“添加”。
4. 修改提示词：插件添加后，还需要在提示词中“告知” Bot 如何使用这个新工具。修改“人设与回复逻辑”如下：

   # 角色
   你是一位知识渊博、品味独特的电影推荐官。
   
   # 技能
   1. 你会主动询问用户当前的心情或喜欢的电影类型。
   2. 你会使用【必应搜索】插件来查找最新的、符合用户描述的电影信息。
   3. 推荐时，你需要简洁地介绍电影的剧情、亮点以及推荐理由。
   4. 你的回答风格应该风趣幽默，富有感染力。
   
   # 限制
   - 不要推荐恐怖电影。
   - 每次只推荐一部电影。
   

5. 调试测试：在预览窗口中输入 推荐一部最近上映的科幻电影。在“调试信息”中，你将能清楚地看到 Bot 调用了“必应搜索”插件，并将搜索结果作为生成回答的依据。

4.3 从 OpenAPI Spec 创建自定义插件

内容讲解

当内置插件无法满足你的需求时，Coze 允许你创建自定义插件。创建自定义插件最标准、最高效的方式是通过 OpenAPI Specification（曾被称为 Swagger Spec）。

OpenAPI 是一种用于描述 RESTful API 的标准格式。你只需要提供一个符合该标准的 JSON 或 YAML 文件，Coze 就能自动解析出其中包含的所有 API，并将其转换为一个可用的插件。

操作步骤：创建一个获取“每日一句”的插件

假设我们有一个提供每日一句的 API，其 OpenAPI Spec 如下：

{
  "openapi": "3.0.0",
  "info": {
    "title": "每日一句",
    "version": "1.0.0"
  },
  "paths": {
    "/": {
      "get": {
        "summary": "获取每日一句",
        "responses": {
          "200": {
            "description": "成功获取",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "hitokoto": {
                      "type": "string"
                    }
                  }
                }
              }
            }
          }
        }
      }
    }
  }
}

1. 进入插件管理：在 Coze 工作台左侧导航栏，点击“插件”。
2. 创建插件：点击“创建插件”按钮。
3. 选择创建方式：选择“从 OpenAPI 创建”。
4. 填写信息：
   • 插件名称：每日一句
   • 上传方式：选择“URL”，并填入提供上述 JSON 的 URL；或者选择“手动创建”，将 JSON 内容粘贴进去。
5. 创建并调试：点击“创建”后，Coze 会解析该文件。在接下来的调试页面，你可以测试这个插件是否能正常工作。
6. 在 Bot 中使用：调试通过后，就可以像使用内置插件一样，将这个“每日一句”插件添加到你的 Bot 中了。

4.4 插件的调试与管理

内容讲解

• 插件调试：创建或添加插件后，务必进行充分调试。在插件的调试页面，你可以手动填写参数，点击“运行”来测试 API 的连通性和返回结果是否正确。
• 插件管理：在工作台的“插件”页面，你可以看到所有你创建和使用的插件。你可以对它们进行编辑、删除、分享等操作。
• 版本控制：Coze 支持插件的版本管理。当你对插件进行修改后，可以创建一个新的版本，而不会影响正在使用旧版本的 Bot。

本章总结

本章我们解锁了 Coze 的一项核心能力——插件。我们理解了插件是 Bot 连接现实世界的桥梁，并掌握了其工作原理。我们学会了如何轻松地使用内置插件来增强 Bot 的功能，更进一步地，我们还学习了如何通过 OpenAPI Spec 创建自定义插件，将任何外部服务集成到我们的 Bot 中。最后，我们了解了插件的调试与管理方法。现在，你的 Bot 已经不再局限于模型自带的知识，而是拥有了获取无限信息和执行无限操作的潜力。