用途:为 LLM 的工具/函数调用设计健壮、可被模型可靠调用的 schema,适用于实现函数调用、工具注册与参数校验的场景。
主要能力:提供 OpenAI function calling 格式的 schema 示例(如 search_documentation,含 query、filters、max_results 等参数与 required 约束);给出与 schema 对应的 TypeScript 类型接口;用 Zod 做运行时校验;提供工具注册表(TOOLS)与统一执行入口 executeTool;包含错误处理(区分 VALIDATION_ERROR 与 EXECUTION_ERROR)与示例调用。
使用方式:按资料中的结构定义 schema、类型接口、Zod 校验器与实现函数,注册到 TOOLS,再通过 executeTool 校验后执行;输出清单要求包含 JSON schema、TypeScript 接口、Zod 校验、实现函数、错误处理、3 个以上示例调用、工具注册表条目与文档。
最佳实践:描述清晰说明何时使用工具;使用枚举、范围、模式等具体类型;设置合理默认值减少必填参数;严格校验不信任 LLM 输出;错误信息帮助模型纠正;提供示例调用;保持类型安全。
限制:资料未提供具体安装命令、依赖版本、收费或平台信息,暂未提供。