Agent Skills
返回列表
📁

文档格式转换

办公效率 更新于 2026.08.29

将以下提示词粘贴到你的 AI 对话框中:

请根据 https://skillhub.cn/install/skillhub.md,安装 @org-02qudk26/convertapi-automation。

技能介绍

要解决什么问题

在 Agent 或 IDE 里做 PDF、Office、图片 等文档互转时,若直接硬编码 ConvertAPI 的 HTTP 接口,工具名和参数 schema 一变就会调用失败。本技能通过 Rube MCP 暴露 Composio 的 convertapi 工具包,让模型先查当前可用工具再执行,而不是凭记忆猜 slug 和字段。

技能如何工作

典型流程分三步:

  1. 发现工具:调用 RUBE_SEARCH_TOOLS,按「ConvertAPI / 文档转换」类用例拿到当前 tool slug、输入 schema 与已知坑点。
  2. 校验连接:用 RUBE_MANAGE_CONNECTIONS 指定 toolkit convertapi;若非 ACTIVE,按返回的授权链接完成绑定后再继续。
  3. 执行转换:用 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 流程