本文以开发一个查询股票价格的插件为例,介绍如何通过插件集成的 IDE 工具创建自定义插件。
登录扣子编程。
在页面顶部选择目标工作空间,然后在左侧导航栏中单击资源库。
在页面右上角,单击 +资源 > 插件。
在新建插件对话框内完成配置,并单击确认。
查询股票价格。接收股票名称,查询并返回对应价格信息。待页面自动跳转后,单击在IDE中创建工具。
在弹出的创建工具对话框,设置工具名称与介绍,并单击确定。
search_stock_prices。根据股票名称查询股票价格。在 IDE 工具中,单击元数据页签。
在元数据的输入参数区域,单击编辑,并新增 code 参数,描述为股票名称。
单击代码页签,在代码编辑器中通过快捷键唤起 AI 助手(macOS 为 Command + I、Windows 为 Ctrl + I)。
向 AI 助手输入代码编辑需求,由 AI 生成代码。
例如输入:根据 input.code,到 alpha vantage 查询股票价格。
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<Input>): Promise<Output> {
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,
};
}
}
在页面左下角,添加 axios@1.6.8 依赖包。
在页面右上角单击测试代码图标,并在输入区域单击自动生成图标。
将自动生成的测试数据改为 AAPL,并单击运行。
在输出区域查看测试结果,并单击更新输出参数。
在页面中间单击元数据页签,在输出参数区域单击编辑,完善输出参数的描述。
登录扣子编程。
在页面顶部选择目标工作空间,然后在左侧导航栏中单击新建项目。
在项目开发页面,选择创建智能体或者进入指定智能体。
在智能体编排页面,找到插件区域,并单击右侧的 + 图标。
在添加插件页面,单击团队工具,并选择添加 search_stock_prices 工具。
在智能体的人设与回复逻辑中,设置调用插件的规则。
在智能体的预览与调试中,测试智能体功能。
如下图所示,智能体调用查询股票价格插件的 search_stock_prices 工具处理用户咨询的 AAPL 股票价格。