文档格式转换
将以下提示词粘贴到你的 AI 对话框中:
请根据 https://skillhub.cn/install/skillhub.md,安装 @org-02qudk26/convertapi-automation。
技能介绍
要解决什么问题
在 Agent 或 IDE 里做 PDF、Office、图片 等文档互转时,若直接硬编码 ConvertAPI 的 HTTP 接口,工具名和参数 schema 一变就会调用失败。本技能通过 Rube MCP 暴露 Composio 的 convertapi 工具包,让模型先查当前可用工具再执行,而不是凭记忆猜 slug 和字段。
技能如何工作
典型流程分三步:
- 发现工具:调用
RUBE_SEARCH_TOOLS,按「ConvertAPI / 文档转换」类用例拿到当前 tool slug、输入 schema 与已知坑点。 - 校验连接:用
RUBE_MANAGE_CONNECTIONS指定 toolkitconvertapi;若非 ACTIVE,按返回的授权链接完成绑定后再继续。 - 执行转换:用
RUBE_MULTI_EXECUTE_TOOL传入搜索到的 slug 与合规参数;批量场景可走RUBE_REMOTE_WORKBENCH里的run_composio_tool()。
执行前务必遵守文档中的约束:每次 workflow 先 search、Multi Execute 必须带 memory(可为 {})、同一次流程复用 session id,并处理响应里的分页 token。
适用边界与注意点
- 依赖 Rube MCP 已接入且
RUBE_SEARCH_TOOLS可用;ConvertAPI 账号需通过 Composio 连接,本技能不负责代管 API Key 的本地配置方式(Rube 端点本身无需在客户端填 Key)。 - 工具 schema 会更新,禁止在未调用
RUBE_SEARCH_TOOLS的情况下写死参数名或类型;需要完整定义时可配合RUBE_GET_TOOL_SCHEMAS(含schemaRef的工具)。 - 具体支持格式、配额与计费以 Composio ConvertAPI toolkit 文档 与 ConvertAPI 服务条款为准。
使用场景
- 在 Cursor/Claude 等已接 Rube MCP 的客户端里,先把用户上传的 PDF 转成可编辑的 Office 再交给后续步骤处理
- Agent 工作流里需批量把同一批图片或 HTML 转为 PDF,通过 `RUBE_REMOTE_WORKBENCH` 循环调用已发现的 ConvertAPI 工具
- 新接入 ConvertAPI 后先跑 `RUBE_SEARCH_TOOLS` 确认当前 slug 与输入字段,再执行互转,避免 schema 变更导致调用失败
- Composio 侧 ConvertAPI 连接过期或未 ACTIVE 时,按 `RUBE_MANAGE_CONNECTIONS` 返回的链接完成授权后再继续转换任务
适合人员
- 在自研 Agent 里通过 Rube 编排 Composio 工具、需要稳定调用文档互转的后端工程师
- 法务或合规岗位每周处理大量合同 PDF,希望在 IDE 助手内用 MCP 触发格式转换而非手工上传第三方网站
- 运维文档维护者要把历史 Word/Markdown 批量导出为 PDF 归档,并希望在单次会话内复用 session 跑多步转换
- 集成 Composio toolkit 的解决方案顾问,为客户演示 ConvertAPI 连接校验与按 schema 执行的完整 MCP 流程