文件格式转换

要解决什么问题

在 Agent 或 IDE 里做 PDF、Office、图片、音视频 等格式互转时，如果每次都手写 CloudConvert API、维护 OAuth 与任务轮询，成本和出错面都很大。本技能把 CloudConvert 封装进 Composio 工具集，经 Rube MCP 暴露给模型：先发现当前可用工具与 schema，再在校验连接后执行转换，而不是硬编码过期的 slug 或参数字段。

技能如何工作

典型流程分三步：

1. 工具发现：调用 RUBE_SEARCH_TOOLS，按 CloudConvert 相关用例拿到工具 slug、输入 schema、推荐执行顺序和已知坑点。
2. 连接检查：用 RUBE_MANAGE_CONNECTIONS 指定 toolkit cloudconvert；状态须为 ACTIVE，否则按返回的授权链接完成绑定。
3. 执行：通过 RUBE_MULTI_EXECUTE_TOOL 使用搜索到的 slug；批量或脚本化场景可用 RUBE_REMOTE_WORKBENCH 里的 run_composio_tool()。需要完整 schema 时可查 RUBE_GET_TOOL_SCHEMAS（含 schemaRef 的工具）。

执行时须严格使用搜索结果的字段名与类型；RUBE_MULTI_EXECUTE_TOOL 始终带上 memory 参数（可为 {}）；同一工作流内复用 session ID，新工作流再新建。

适用边界与注意点

• 依赖 Rube MCP 已接入（例如客户端配置 https://rube.app/mcp），且 CloudConvert 连接已激活。
• 不要跳过 RUBE_SEARCH_TOOLS：工具 schema 会变，硬编码 slug 或参数容易直接失败。
• 列表类响应注意 分页 token，需拉取到结束再汇总结果。

工具集文档见 Composio 官方：composio.dev/toolkits/cloudconvert。