使用说明
- 粘贴 JSON 或 YAML 格式的 OpenAPI 3.x 或 Swagger 2.0 文档。
- 每个接口会生成一个工具:path、query、header 参数和 JSON 请求体会合并成一个输入 schema,
$ref会被展开。 - 取消勾选不希望模型调用的接口,选择输出格式,把 tools 数组复制到 API 请求或 MCP 服务器中。
常见问题
工具名称是怎么生成的?
优先使用 operationId;没有时用请求方法和路径拼出名称,例如 get_users_by_id。名称会限制在 64 个字符以内,只包含字母、数字、_ 和 -,以符合各家 API 的要求。
应该把所有接口都暴露成工具吗?
通常不需要。工具列表短、描述清楚时,模型选择工具更准确。只保留 agent 真正需要的接口,并改写描述,说明每个工具应该在什么情况下使用。