使用 Rube MCP 在 Codex 中自动化 Godial 操作composio-skills/godial-automation 实战指南【免费下载链接】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导读Godial 是企业级消息与销售沟通平台本技能Skill以composio-skills/godial-automation/SKILL.md为操作手册指导 Codex 通过 Composio 的 Godial 工具集toolkit在 Rube MCP 网关之上完成连接建立、工具发现、工作流编排与批量执行。读完本文你将掌握一套先发现、再连接、后执行的通用自动化范式能够基于当前 schema 安全地调用 Godial 工具并规避工具变更、连接失效、分页遗漏等典型陷阱。一、技能定位与仓库背景在仓库 README.md 中composio-skills/是专门存放通过 Rube MCP 自动化各类 SaaS 应用的技能集合目录其中每个子目录对应一个独立技能如composio-automation、composio-search-automation等godial-automation是其中之一。技能本身由以下元数据驱动--- name: godial-automation description: Automate Godial tasks via Rube MCP (Composio). Always search tools first for current schemas. requires: mcp: [rube] ---从该结构可以推断name用于标识技能description是 Codex 触发技能的依据描述中特别强调始终先搜索工具以获取当前 schemas而requires.mcp声明了运行前置条件——必须在客户端中接入名为rube的 MCP 服务器。这种轻量声明 按需触发的设计与仓库内 skill-creator/SKILL.md 所述的渐进式披露progressive disclosure原则一致元数据常驻上下文正文仅在触发后加载。二、前置条件Prerequisites在运行任何 Godial 工作流之前需要满足以下条件Rube MCP 已连接确保RUBE_SEARCH_TOOLS工具可用这是后续所有发现操作的基础Godial 连接处于 ACTIVE 状态通过RUBE_MANAGE_CONNECTIONS建立并激活 toolkit 为godial的连接始终先调用RUBE_SEARCH_TOOLS获取当前可用的工具 slug、输入 schema 与执行建议切勿跳过发现步骤直接硬编码。三、Setup接入 Rube MCP 并激活 Godial 连接Rube MCP 的接入方式极其轻量在客户端如 Codex的 MCP 服务器配置中添加https://rube.app/mcp端点即可无需任何 API Key添加端点后立即可用。接入后按以下顺序完成 Godial 连接激活验证 Rube MCP 可用——确认RUBE_SEARCH_TOOLS能够正常响应调用RUBE_MANAGE_CONNECTIONS传入 toolkitgodial若连接状态不是 ACTIVE则跟随返回的认证链接完成授权设置确认连接状态为 ACTIVE 后再运行任何工作流。该无密钥、端点即用的模式是 Rube MCP 网关的核心价值OAuth 认证、凭据托管与连接生命周期均由网关统一管理技能本身不需要保存任何敏感信息。四、工具发现Tool DiscoveryComposio 的工具 schema 会随上游 API 演进而变化因此技能的黄金法则是任何一次执行前都要先做工具发现。推荐的首次发现调用如下RUBE_SEARCH_TOOLS queries: [{use_case: Godial operations, known_fields: }] session: {generate_id: true}该调用会返回四类关键信息可用工具 slugtool slug后续执行阶段用来指定具体工具输入 schema每个工具的参数名、类型与必填项推荐执行计划针对该 use case 的最佳调用序列已知陷阱known pitfalls官方标注的易错点。注意首次发现时使用session: {generate_id: true}让网关生成新的会话 ID后续在同一工作流内的调用则应复用该 ID见下文。五、核心工作流模式Core Workflow PatternGodial 自动化采用固定三步工作流发现 → 检查连接 → 执行。下面逐步展开所有请求体均可在 godial-automation/SKILL.md 中找到对应原始示例。Step 1发现可用工具RUBE_SEARCH_TOOLS queries: [{use_case: your specific Godial task}] session: {id: existing_session_id}与首次发现不同此处在同一个工作流内复用已有会话 IDsession.id保证网关能关联上下文。use_case应替换为具体任务描述如创建 Godial 外呼任务查询客户列表等从而缩小工具集合、获得针对性 schema。Step 2检查连接RUBE_MANAGE_CONNECTIONS toolkits: [godial] session_id: your_session_id执行前确认toolkits数组中包含godial并核对返回状态。只有连接状态为 ACTIVE 时才能继续否则应回到 Setup 阶段跟随认证链接重新授权。将连接检查独立成一步可以在连接失效时快速定位问题避免把认证失败误判为工具调用错误。Step 3执行工具RUBE_MULTI_EXECUTE_TOOL tools: [{ tool_slug: TOOL_SLUG_FROM_SEARCH, arguments: {/* schema-compliant args from search results */} }] memory: {} session_id: your_session_id执行阶段的要点tool_slug必须来自 Step 1 的搜索结果禁止硬编码arguments必须严格遵循搜索结果返回的 schema字段名、类型、必填项逐一对应memory参数必须始终携带即使为空也要写成{}——这是该网关的调用契约缺失可能导致请求失败session_id沿用本工作流的会话 ID使多次工具调用保持上下文连续。RUBE_MULTI_EXECUTE_TOOL支持在tools数组中一次性传入多个工具调用适合把查询客户 → 创建消息 → 发送这类多步骤链路合并为一次请求减少往返。六、批量操作与完整 Schema进阶工具除上述三步核心流程外技能还提供了两个进阶工具场景工具用法批量操作Bulk opsRUBE_REMOTE_WORKBENCH通过run_composio_tool()在远端沙箱中批量执行工具获取完整 SchemaRUBE_GET_TOOL_SCHEMAS针对返回schemaRef的工具拉取完整的 JSON Schema 定义当某个工具在搜索结果中只返回schemaRef引用而非完整 schema 时用RUBE_GET_TOOL_SCHEMAS获取其完整定义当需要对大量记录执行同构操作如批量同步客户数据时用RUBE_REMOTE_WORKBENCH的run_composio_tool()将执行工作放到远端工作台避免在本地循环中反复传输数据。七、已知陷阱清单Known Pitfalls技能文档总结了一组经过实战验证的避坑要点每一条都对应一个真实的失败模式始终先搜索工具 schema 会变化不调用RUBE_SEARCH_TOOLS就硬编码 tool slug 或参数是最常见的失效原因检查连接执行前务必确认RUBE_MANAGE_CONNECTIONS返回 ACTIVE连接过期后所有工具调用都会失败Schema 合规参数必须使用搜索结果中的精确字段名与类型多一个、少一个或拼错字段名都会导致请求被拒Memory 参数RUBE_MULTI_EXECUTE_TOOL的每次调用都要包含memory即使为空{}会话复用同一工作流内复用会话 ID 以保持上下文开启新工作流时才生成新 ID避免跨任务污染分页处理检查响应中的分页 token持续拉取直到数据完整防止结果被截断导致漏处理。八、快速参考表Quick Reference将整个工作流浓缩为一张速查表便于在 Agent 会话中快速定位操作方式操作方式查找工具RUBE_SEARCH_TOOLS传入 Godial 相关的 use case建立连接RUBE_MANAGE_CONNECTIONStoolkit 为godial执行工具RUBE_MULTI_EXECUTE_TOOL使用发现的 tool slug批量操作RUBE_REMOTE_WORKBENCHrun_composio_tool()获取完整 SchemaRUBE_GET_TOOL_SCHEMAS用于带schemaRef的工具九、实战示例一次完整的 Godial 自动化会话将上述各环节串联起来一次完整的会话流程如下接入 Rube MCP在 Codex 客户端 MCP 配置中添加https://rube.app/mcp首次发现RUBE_SEARCH_TOOLSqueries: [{use_case: Godial operations, known_fields: }]session: {generate_id: true}得到工具清单与初始会话 ID建立连接RUBE_MANAGE_CONNECTIONStoolkitgodial按返回链接完成授权确认 ACTIVE定向发现RUBE_SEARCH_TOOLS中把use_case换成具体任务描述复用第 2 步的会话 ID拿到目标工具的精确 schema执行RUBE_MULTI_EXECUTE_TOOL携带 schema 合规的arguments、空memory与同一session_id收尾检查响应分页 token 确认无遗漏新任务开始时重新generate_id开启新会话。十、与仓库其他技能的协同关系godial-automation并非孤立存在。在composio-skills/目录下从-21risk-automation到zyte-api-automation的上百个技能共享同一套 Rube MCP 调用范式三阶段工作流、同样的RUBE_SEARCH_TOOLS/RUBE_MANAGE_CONNECTIONS/RUBE_MULTI_EXECUTE_TOOL三件套差异仅在于 toolkit 名称与业务语义。因此掌握本技能的方法论后你可以无障碍地迁移到其他任何 Composio 技能把 toolkit 换成目标应用名把use_case换成对应业务描述即可。这种一套模式、千个应用的设计正是该技能集合的可复用性所在。结语composio-skills/godial-automation用一份精炼的 SKILL.md 封装了通过 Rube MCP 自动化 Godial 的完整闭环无密钥接入、连接生命周期管理、动态 schema 发现、三阶段工作流与批量执行以及一整套经实战沉淀的避坑清单。对开发者而言照此流程即可让 Codex 安全、稳定地操作 Godial 业务数据对 Agent 而言这份文档本身就是一个先搜索、再连接、后执行的可复用行为模板。【免费下载链接】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），仅供参考