ARTICLE DETAIL

资讯详情

深耕网站视觉设计与运营推广的一线实战洞察。

使用 Apiverve Automation Skill 通过 Rube MCP 自动化 API 工具链

使用 Apiverve Automation Skill 通过 Rube MCP 自动化 API 工具链 使用 Apiverve Automation Skill 通过 Rube MCP 自动化 API 工具链【免费下载链接】awesome-codex-skillsA curated list of practical Codex skills for automating workflows across the Codex CLI and API.项目地址: https://gitcode.com/GitHub_Trending/aw/awesome-codex-skills本篇指南以 awesome-codex-skills 仓库中composio-skills/apiverve-automation/SKILL.md为核心骨架讲解如何借助 Composio 的 Apiverve toolkit 与 Rube MCPModel Context Protocol服务器在 Codex CLI/API 环境中自动化 Apiverve 平台操作。读完本文你将掌握从连接建立、工具发现到多工具执行的完整工作流模式并能规避 schema 漂移、连接状态、分页等常见陷阱。Skill 是什么解决什么问题在 Codex Skills 体系中每个 skill 是一个独立目录目录中的SKILL.md通过 YAML frontmatter 声明name与description元数据Codex 依据 description 判断何时触发该 skill并在触发后才加载正文以保持上下文精简参见仓库 README.md 与 创建技能说明。本 skillSKILL.md的定位是让 Agent 通过 Rube MCP 调用 Composio 提供的 Apiverve toolkit从而把 Apiverve 的各类 API 能力接入 Codex 会话实现自动化的数据获取与操作编排。其 frontmatter 明确声明了requires: mcp: [rube]意味着运行前必须先挂载 Rube MCP 服务器。前置条件在启用本 skill 之前需要满足三项前提Rube MCP 已连接客户端中必须存在RUBE_SEARCH_TOOLS工具作为能力发现的入口Apiverve 连接处于 ACTIVE 状态通过RUBE_MANAGE_CONNECTIONS建立 toolkit 为apiverve的活跃连接先搜索、再执行任何工作流开始前必须先调用RUBE_SEARCH_TOOLS获取当前的工具 schema。依据上述三条均出自 SKILL.md 的 Prerequisites 小节是文档给出的硬性门槛。环境设置接入 Rube MCPRube MCP 的接入成本极低无需申请 API Key只需在客户端配置中添加 MCP 服务器端点https://rube.app/mcp即可SKILL.md。设置步骤共四步验证 Rube MCP 可用即确认RUBE_SEARCH_TOOLS能正常响应调用RUBE_MANAGE_CONNECTIONS传入 toolkit 名apiverve若连接状态不是 ACTIVE则跟随返回的授权链接完成认证设置确认连接状态为 ACTIVE 后再运行任何工作流。第四步尤为重要连接未激活时直接执行工具会因鉴权失败而报错因此文档把状态校验放在任何业务执行之前SKILL.md。工具发现永远先查询当前 schemaApiverve 作为聚合型 API 平台其 toolkit 下的工具数量多、schema 变化频繁。因此文档强调在每次执行工作流之前都要先做工具发现Tool Discovery典型查询如下{ queries: [{use_case: Apiverve operations, known_fields: }], session: {generate_id: true} }原文示例见 SKILL.md该调用会返回四类关键信息可用的工具 slug 列表、每个工具的输入 schema、推荐的执行计划以及已知陷阱known pitfalls。这些信息是后续构造调用参数的唯一事实来源。核心工作流模式三步走文档给出了一套可复用的三步工作流模式SKILL.md适用于任何 Apiverve 自动化任务。Step 1发现可用工具针对具体任务再次查询工具集此时应复用已有会话{ queries: [{use_case: your specific Apiverve task}], session: {id: existing_session_id} }Step 2检查连接执行前确认 Apiverve toolkit 的连接状态{ toolkits: [apiverve], session_id: your_session_id }Step 3执行工具使用发现阶段拿到的真实 slug 与 schema 合规参数发起调用{ tools: [{ tool_slug: TOOL_SLUG_FROM_SEARCH, arguments: {} }], memory: {}, session_id: your_session_id }注意arguments必须严格遵循搜索结果返回的字段名与类型memory参数即使为空也要显式带上{}。已知陷阱与规避策略文档汇总了六条高频踩坑点SKILL.md这是保证流程稳定的关键清单陷阱规避策略schema 漂移绝不硬编码工具 slug 或参数每次调用前先执行RUBE_SEARCH_TOOLS刷新 schema连接未激活执行工具前用RUBE_MANAGE_CONNECTIONS确认 ACTIVE 状态参数不合规严格使用搜索结果中的精确字段名与类型不做猜测遗漏 memory 参数RUBE_MULTI_EXECUTE_TOOL调用中始终携带memory即使为空对象会话混用同一工作流内复用 session_id新工作流则生成新 id漏掉分页检查响应中的分页 token持续拉取直到数据完整其中先搜索再执行是全局性第一原则Composio 平台会持续演进工具 schema硬编码是产生运行时错误的首要来源。快速参考速查表下表将整个自动化流程浓缩为五个操作入口便于在 Codex 会话中直接查阅SKILL.md操作入口方式查找工具RUBE_SEARCH_TOOLS携带 Apiverve 相关的 use_case建立连接RUBE_MANAGE_CONNECTIONStoolkit 指定为apiverve执行工具RUBE_MULTI_EXECUTE_TOOL传入发现阶段得到的工具 slug批量操作RUBE_REMOTE_WORKBENCH配合run_composio_tool()获取完整 schema对带schemaRef的工具使用RUBE_GET_TOOL_SCHEMAS与本仓库其他 skill 的关系与安装方式本 skill 是仓库composio-skills/目录下大量自动化 skill 中的一员与ably-automation、composio-automation等采用完全一致的模板结构与交互协议——统一通过RUBE_SEARCH_TOOLS/RUBE_MANAGE_CONNECTIONS/RUBE_MULTI_EXECUTE_TOOL三个核心工具完成发现-连接-执行闭环区别仅在于 toolkit 名称apiverve与业务场景Apiverve API 操作。若要在本地 Codex 环境中启用该 skill可参照仓库提供的两种安装方式README.md推荐Skill Installer详见 skill-installer/SKILL.mdgit clone https://github.com/ComposioHQ/awesome-codex-skills.git cd awesome-codex-skills python skill-installer/scripts/install-skill-from-github.py --repo ComposioHQ/awesome-codex-skills --path composio-skills/apiverve-automation手动安装将composio-skills/apiverve-automation目录复制到$CODEX_HOME/skills/默认为~/.codex/skills/重启 Codex 使其重新加载元数据之后在会话中描述任务即可自动触发。安装完成后遵循本文的先搜索、再连接、后执行三步模式即可让 Codex Agent 稳定、安全地自动化 Apiverve 上的各类 API 操作。【免费下载链接】awesome-codex-skillsA curated list of practical Codex skills for automating workflows across the Codex CLI and API.项目地址: https://gitcode.com/GitHub_Trending/aw/awesome-codex-skills创作声明:本文部分内容由AI辅助生成(AIGC),仅供参考
返回列表