用途:诊断并修复 ToolUniverse 中失败的工具,流程为定位错误、确认根因、实施针对性修复并验证。修复前应先用 CLI 复现问题:python3 -m tooluniverse.cli run <ToolName> '<json_args>',因为部分由智能体报告的缺陷实为 MCP 接口混淆导致的误报。
主要能力:覆盖常见错误类型,包括 JSON 解析错误(二进制响应)、Schema 校验错误、可空字段错误、互斥参数错误、混合类型字段错误、无效测试示例、API 参数错误、API 密钥配置错误、端点模式错误与瞬时 API 失败。修复原则强调从根因预防而非事后补救、在输入处校验而非输出处、不掩盖静默转换、区分“无数据”与“查询错误”、修抽象而非个例。
使用方式:运行 python scripts/test_new_tools.py <tool-pattern> -v 做集成测试;修改 JSON 配置或工具类后运行 python -m tooluniverse.generate_tools 重新生成;若存在单元测试则运行 pytest tests/tools/test_<tool-name>_tool.py -v。修复位置按问题类型区分:二进制响应改 *_tool.py 与 *_tools.json,Schema 不匹配改 return_schema,端点 URL 与测试示例改 JSON 配置,API 密钥应改用环境变量而非工具参数。
适用场景:ToolUniverse 工具开发与维护中的缺陷排查、Schema 与参数校验修复、测试用例更新。
限制:资料未提供具体支持的 API 列表、版本要求、性能数据或收费信息;部分细节需参考 unit-tests-reference.md。