了解扣子：如何用 CozeIDE 制作一个插件

CozeIDE 是扣子给你提供的插件开发利器，你可以在 CozeIDE 上开发、测试插件，并由扣子帮你托管运行插件代码，你无需关心购买服务器、配置域名等事项。CozeIDE 还内置了 AI 编程助手，无论你是否有编程基础，都可以通过 AI 助手，快速开发插件。

CozeIDE 有哪些主要功能？

CozeIDE 为插件开发者提供了一整套代码编辑、依赖包管理、测试、元数据管理、发布部署能力，以及 AI 编程助手，解决你开发插件过程中的各种问题。

1、代码编辑

CozeIDE 为你提供了代码模板，你只需要在代码模板的基础上进行开发、完善。IDE 提供了 2 种运行时：Node.js 和 Python，满足你不同的诉求。

Node.js 模板示例

Python 模板示例

2、AI 编程助手

如果你写代码过程遇到问题，可通过快捷键唤起 AI 编程助手（macOS 为 Command + I、windows 为 Ctrl + I）。AI 编程助手可为你提供以下几个便捷的能力：

AI 生成代码：输入想要的功能，点击
AI 修改代码：选中待修改的代码，唤起 AI 助手，输入想要修改的功能。
AI 代码解释/代码注释：选中代码后，输入/ 选择不同指令，由 AI 对代码进行解释，或者自动生成代码注释。

3、依赖包管理

依赖包是代码运行依赖的外部代码模块。如果你的代码中引用了其他外部的模块，但没有安装依赖，IDE 会提示错误。根据错误信息，点击左下角【添加依赖】，输入依赖的名称即可安装。安装过程中可查看控制台的日志，观察安装进度。

具体示例

未安装依赖时报错

安装依赖

安装依赖后未报错

若需要指定安装某个版本，你可以通过依赖名@版本号来进行选择。

4、元数据

元数据的作用是让大模型理解每个工具输入参数、输出参数有哪些，以及对应的含义。

在以下代码示例中，这个工具接收一个输入参数：name，并返回一个参数：message。因此，我们需要将 name 和 message 补充到元数据面板。

5、测试

写完代码和元数据后，需要验证代码是否正常运行。点击右侧的测试，输入测试的数据。

如果你已经填写元数据中的输入参数，则可以点击自动生成，IDE 会生成符合你结构定义的随机数据。你需要修改成你需要的值即可。填写完成后，点击运行，即可看到测试结果。

如果你之前未填写元数据的输出参数结构，可以在测试通过后，点击下方的【更新输出参数】，IDE 会自动更新覆盖在元数据区域，你只需要补充完善描述即可。

6、发布

测试通过后，就可以去点击发布啦。如果你开发了多个工具，但有些没测试完成不想发布，可以在该入口禁用这些工具，只发布启用的工具。

接着选择“信息收集声明”。如果插件会收集用户信息，请选择“是”并选择具体信息，用户在使用该插件时能了解收集的信息。否则，选择“否”，点击发布即可。

接下来我们以开发实际插件为例，演示整个创建流程。

插件一、查询股票价格（难度 🌟 ）

明确目的和方案

首先，需要构思这个插件具备什么能力：根据股票名称查询股票价格。

接着搜索哪些网站可以免费查询股票价格。通过互联网检索，可以得知“alpha vantage”提供了免费查询美股股票价格的能力。明确了目的和方案后，开始开发插件。该插件难度🌟，教程内已提供源码，可直接复制使用。

操作步骤

步骤一：新建插件和工具

打开 https://www.coze.cn/ 选择需要所属的团队。
点击右上角创建插件，填写名称，选择插件创建方式为“在 Coze IDE 创建”，运行时选择“Node.js”（你也可以根据自己的情况，选择 Python）
插件名称：查询股票价格
插件描述：查询股票价格
点击“在 IDE 中创建工具”，填写工具名称和介绍：
名称：search_stock_prices
介绍：根据股票名称查询股票价格

步骤二：代码编写和开发

因为已经明确需要根据股票名称查询价格，所以可以先在元数据中定义一个输入参数，名称：code，描述为：股票名称

编写元信息

在代码编辑器中，通过快捷键唤起 AI 助手（macOS 为 Command + I、windows 为 Ctrl + I），输入我们的需求：根据 input.code，到 alpha vantage 查询股票价格。你也可以手动编写代码。
AI 生成代码后，点击接受，再进行调整，最后得到这样一份代码。（若 AI 生成效果不好，可直接复制本代码使用）

``import { Args } from '@/runtime';
import { Input, Output } from "@/typings/search_stock_prices/search_stock_prices";
import axios from 'axios';
export async function handler({ input, logger }: Args): Promise {
  const code  = input.code;
  const apiKey = 'YOUR_ALPHA_VANTAGE_API_KEY';
  const url = https://www.alphavantage.co/query?function=GLOBAL_QUOTE&symbol=${code}&apikey=${apiKey};

    try {
    const response = await axios.get(url);
    const data = response.data['Global Quote'];
    return {
      code: code,
      price: data['05. price'],
    };
  } catch (error) {
    logger.error(Error fetching stock price for ${code}: ${error});
    return {
      code: code,
      price: null,
    };
  }
}