SuperAPI AI 工具集

tool-function-schema-designer

设计与创作

查看项目

更新于 10-16 03:16

技能介绍

用途:为 LLM 的工具/函数调用设计健壮、可被模型可靠调用的 schema,适用于实现函数调用、工具注册与参数校验的场景。

主要能力:提供 OpenAI function calling 格式的 JSON Schema 定义(含 name、description、parameters、required、enum、minimum/maximum、default 等);配套 TypeScript 类型接口;使用 Zod 做运行时校验;构建工具注册表(schema、implementation、validator 三件套);统一错误处理(区分 VALIDATION_ERROR 与 EXECUTION_ERROR);并给出示例调用。

使用方式:先定义工具 schema,再写匹配的 TypeScript 接口与实现函数,用 Zod schema 在调用前校验参数,将工具登记进 TOOLS 注册表,通过 executeTool 或 safeExecuteTool 按名称查找、校验并执行。示例中 search_documentation 接收 query(必填)、filters(category、version)与 max_results(1-10,默认 5)。

最佳实践:描述清晰说明何时使用;类型具体(枚举、范围、模式);设置合理默认值减少必填项;严格校验不信任 LLM 输出;错误信息帮助模型纠正;提供示例调用;保持类型安全。输出清单包括 JSON schema、TypeScript 接口、Zod 校验、实现函数、错误处理、3 个以上示例调用、注册表条目与文档。

限制:资料未提供具体安装命令、依赖版本、支持的模型或平台范围,也未说明收费与效果数据。