SuperAPI AI 工具集

agent-kit-plugin

智能体与模型

查看项目

更新于 10-15 18:13

技能介绍

用途

该技能用于在用户提出“创建 Hedera 插件”“构建 Hedera Agent Kit 插件”“扩展 Hedera Agent Kit”“创建自定义 Hedera 工具”等需求时提供指导。它帮助开发者创建自定义插件,以扩展 Hedera Agent Kit,从而为 Hedera 网络交互添加新工具,包括代币操作、账户管理、共识服务、智能合约以及自定义集成。

主要能力

插件通过实现 Plugin 接口来扩展 Agent Kit。每个插件包含名称、可选版本、可选描述,以及一个 tools 工厂函数,该函数接收 Context 对象并返回 Tool 数组。工具以继承 BaseTool 的类形式编写,BaseTool 实现了 Tool 接口,并运行一个 7 阶段生命周期:preToolExecutionHook、normalizeParams、postParamsNormalizationHook、coreAction、postCoreActionHook、secondaryAction、postToolExecutionHook。注册在 agent kit 上的钩子和策略会在第 1、3、5、7 阶段自动触发,无需手动调用。

工具分为两类:变更型工具(状态变更操作,如代币创建/铸造/转账、账户更新、主题提交),其 coreAction 构建 Transaction,secondaryAction 调用 handleTransaction,并使用 transactionToolOutputParser;查询型工具(只读操作,如代币信息、余额、镜像节点获取),其 coreAction 直接返回结果,需重写 shouldSecondaryAction 返回 false,并使用 untypedQueryOutputParser。

使用方式

快速开始包含 5 个步骤:安装依赖(搭建 TypeScript 项目,使用 @hashgraph/hedera-agent-kit 和 @hiero-ledger/sdk);创建插件结构(创建 index.ts 和 tools/ 目录);定义工具(每个工具是继承 BaseTool 的类);正确导出(导出插件对象和工具名称常量);注册到智能体(在 toolkit 配置的 plugins 数组中导入并传入插件)。

创建单个工具的步骤包括:定义工具常量(UPPER_SNAKE_CASE 加 _TOOL 后缀)、创建提示函数、使用 Zod 定义参数、实现 BaseTool 子类(变更型或查询型)、导出工厂函数。

插件通过显式传入所选工具包来注册。工具包位于独立包中:LangChain 对应 @hashgraph/hedera-agent-kit-langchain,Vercel AI SDK 对应 @hashgraph/hedera-agent-kit-ai-sdk,ElizaOS 对应 @hashgraph/hedera-agent-kit-elizaos,MCP 对应 @hashgraph/hedera-agent-kit-mcp。空的 plugins 数组意味着零工具,需显式列出每个插件,或使用 /plugins 子路径的 allCorePlugins 一次性加载所有内置核心插件。

适用场景

适用于需要为 Hedera Agent Kit 添加自定义网络交互能力的开发场景,例如自定义代币操作、账户管理、共识服务、智能合约调用或其它自定义集成,并将这些工具暴露给 AI 智能体使用。

限制

资料未提供关于收费、价格、平台支持范围或效果保证的信息。工具的具体实现逻辑需由开发者自行编写,技能仅提供结构、接口、生命周期和模式指导。