使用自定义工具

导入方式

Monkeys 支持三种自定义工具导入方式：

• Monkeys manifest.json。
• 已有 OpenAPI schema。
• 手动 API 定义。

如果你能控制工具服务，推荐使用 manifest.json。如果服务已经暴露高质量 OpenAPI，可以直接导入 OpenAPI。对于一次性 API 或没有 OpenAPI 的服务，可以手动导入。

通过 manifest.json 导入

部署工具服务，并确保 Monkeys 可以访问 manifest URL，例如：

http://tool-service.example.com/manifest.json

然后在 Studio 的工具管理页面导入。manifest 还可以定义凭证、触发器、健康检查、限流和 OpenAPI 地址。

详情请看 工具声明式语法 和 开发自定义工具。

通过 OpenAPI 导入

如果已有服务暴露 OpenAPI JSON，可以直接导入 OpenAPI URL。Monkeys 会解析方法和 schema，并生成工具调用表单。

手动导入

手动导入适合简单 HTTP API。你需要定义：

• 展示名称和描述。
• 请求 URL 和 HTTP 方法。
• 凭证位置和 key。
• 请求参数。
• 预期输出字段。

当 API 需要凭证时，应把密钥保存在凭证配置中，不要硬编码在工作流里。