通过 Rube MCP 自动化 Agent Mail 邮件任务：Composio agent_mail 工具包 Codex 技能实战指南

通过 Rube MCP 自动化 Agent Mail 邮件任务Composio agent_mail 工具包 Codex 技能实战指南【免费下载链接】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-skillsAgent Mail 自动化技能agent-mail-automation是本仓库中一套基于 Rube MCP 的 Codex 技能用于通过 Composio 的agent_mail工具包自动完成邮件收发、整理与投递等操作。读完本文你将掌握从连接 Rube MCP、激活 Agent Mail 连接到发现工具、按规范参数执行邮件操作的一整套可复现流程并理解每个环节背后的原理与避坑要点。技能定位与核心思路该技能的元数据frontmatter声明了它的两个关键约束name: agent-mail-automation description: Automate Agent Mail tasks via Rube MCP (Composio). Always search tools first for current schemas. requires: mcp: [rube]从声明可以看出这套技能的设计哲学是**先用 Rube 搜索工具、再执行工具**所有工具槽位tool slug与输入参数都以RUBE_SEARCH_TOOLS的实时返回为准绝不硬编码。这一点贯穿了本文后续的每一个环节也是整套流程最核心的纪律。在仓库中agent-mail-automation与 composio-automation、composio-search-automation 等技能共享同一套 Rube MCP 调用模式区别仅在于使用的工具包名称不同分别为agent_mail、composio、composio_search。因此本文讲解的调用链可以无障碍迁移到其他 Composio 工具包的自动化中。前置条件在运行任何工作流之前需要满足以下三个条件Rube MCP 已连接确认RUBE_SEARCH_TOOLS工具可用这是后续一切操作的前提Agent Mail 连接已激活通过RUBE_MANAGE_CONNECTIONS建立并确认agent_mail工具包对应的连接状态为ACTIVE先搜索后执行任何时候都应先调用RUBE_SEARCH_TOOLS获取当前工具 schema而不是凭记忆或历史经验直接构造参数。环境搭建接入 Rube MCP 并激活连接第一步添加 Rube MCP 服务器在客户端如 Codex的 MCP 服务器配置中添加https://rube.app/mcp该端点无需任何 API Key——只需要把地址加入配置即可生效。这是 Rube MCP 与大多数需要密钥签发的 MCP 服务最大的不同点。第二步验证并激活 Agent Mail 连接按照技能文档中的 Setup 清单完成以下四步确认RUBE_SEARCH_TOOLS有响应以验证 Rube MCP 已经就绪调用RUBE_MANAGE_CONNECTIONS并在参数中指定工具包agent_mail如果返回的连接状态不是ACTIVE则按照返回的认证链接完成授权通常是 OAuth 流程在运行任何工作流之前再次确认连接状态显示为ACTIVE。补充说明如果你更习惯命令行方式仓库中的 connect 技能 提供了等价的 Composio CLI 路径——composio login登录、composio link gmail等命令完成 OAuth 授权之后composio execute GMAIL_SEND_EMAIL即可直接发信。Rube MCP 与 Composio CLI 的授权体系一致二者可以互为补充。工具发现先搜索永远不要硬编码技能文档反复强调一个铁律工具 schema 会变化不要硬编码工具槽位或参数。因此任何工作流的第一步都是工具发现推荐的发现请求如下RUBE_SEARCH_TOOLS queries: [{use_case: Agent Mail operations, known_fields: }] session: {generate_id: true}该调用会返回四类关键信息可用的工具槽位tool slugs每个工具的输入 schema字段名、类型、必填项推荐执行计划已知的常见坑位known pitfalls。session字段中的generate_id: true表示让服务端生成一个新的会话 ID在同一个工作流的后续调用中应复用这个会话 ID 以保持上下文连贯。核心工作流三步执行模式技能文档给出了标准的发现 → 检查连接 → 执行三步模式这是所有 Agent Mail 自动化任务的通用骨架。Step 1发现可用工具RUBE_SEARCH_TOOLS queries: [{use_case: your specific Agent Mail task}] session: {id: existing_session_id}将use_case换成你的具体任务描述例如发送邮件给团队或获取未读邮件列表并复用上一步获得的会话 ID。返回结果中的tool_slug和argumentsschema 就是下一步执行的依据。Step 2检查连接状态RUBE_MANAGE_CONNECTIONS toolkits: [agent_mail] session_id: your_session_id执行任何工具前先确认连接状态为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参数必须始终携带即使没有额外上下文也要传空对象{}——这是文档明确要求的规范。RUBE_MULTI_EXECUTE_TOOL支持在tools数组中同时传入多个工具调用适合在一次往返中完成读取邮件 → 提取要点 → 写回复草稿这类复合流程。已知陷阱清单技能文档总结了六条经过实战检验的避坑要点每一条都对应真实踩坑场景陷阱说明永远先搜索工具 schema 会变化未经RUBE_SEARCH_TOOLS确认就硬编码工具槽位或参数是最常见的错误检查连接执行前务必确认RUBE_MANAGE_CONNECTIONS返回ACTIVE状态严格遵循 schema使用搜索结果中的准确字段名与类型不要凭经验猜测始终携带 memoryRUBE_MULTI_EXECUTE_TOOL调用必须包含memory参数空上下文也要传{}会话复用同一工作流内复用会话 ID开启新工作流时才生成新 ID分页处理检查响应中的分页令牌pagination token持续翻页直到取完所有结果其中会话复用与分页处理尤其值得注意会话 ID 是维持多步任务上下文的纽带而分页令牌则决定了批量邮件处理类任务能否完整跑完这两点都容易被初次使用者忽略。快速参考表技能文档末尾提供了操作速查表覆盖了从查询到批量执行的完整能力边界操作方式查找工具RUBE_SEARCH_TOOLS使用 Agent Mail 相关的 use case建立连接RUBE_MANAGE_CONNECTIONS工具包指定为agent_mail执行工具RUBE_MULTI_EXECUTE_TOOL使用搜索发现的工具槽位批量操作RUBE_REMOTE_WORKBENCH配合run_composio_tool()完整 schemaRUBE_GET_TOOL_SCHEMAS用于获取带schemaRef的完整工具定义可以看到常规单步操作走RUBE_MULTI_EXECUTE_TOOL而大批量、需要更灵活编排的场景则交给RUBE_REMOTE_WORKBENCH的远程执行环境当某个工具在搜索结果中只返回了schemaRef引用而非完整定义时则用RUBE_GET_TOOL_SCHEMAS拉取完整 schema。从仓库源码看调用链设计对比仓库中同模式的技能文件可以发现RUBE_SEARCH_TOOLS → RUBE_MANAGE_CONNECTIONS → RUBE_MULTI_EXECUTE_TOOL是一条被广泛复用的标准调用链。例如 composio-automation 与 composio-search-automation 的文档结构、请求参数形态与本技能完全一致唯一差异是toolkits字段的值。这种设计反映了两个工程意图Schema 即真相Composio 工具包的工具定义tool slug、参数 schema是动态演进的Rube MCP 通过先搜索再执行的强制流程确保 Agent 永远基于最新 schema 行动连接与执行解耦连接状态管理RUBE_MANAGE_CONNECTIONS与工具执行RUBE_MULTI_EXECUTE_TOOL分离授权生命周期独立于单次任务一次 OAuth 授权后可持续复用。此外若需要把 Agent Mail 自动化与更广的邮件能力结合仓库中的 connect 技能 提供了可直接参考的邮件场景范例例如用composio search send an email --toolkits gmail发现工具再用composio execute GMAIL_SEND_EMAIL携带recipient_email、subject、body等参数完成发信并支持--get-schema与--dry-run在执行前校验输入。这套 CLI 工作流与 Rube MCP 的 MCP 工作流互为印证可帮助你理解参数 schema 的实际形态。将技能安装到 Codex 使用按照仓库 README.md 的说明本技能可以随整个仓库一起安装到 Codexgit 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 agent-mail-automation安装完成后技能会被放入$CODEX_HOME/skills/agent-mail-automation/重启 Codex 使其加载新的元数据。之后在会话中描述邮件自动化任务时Codex 会根据技能 frontmatter 中的description自动匹配并触发本技能随后按照本文的三步工作流完成实际操作。小结Agent Mail 自动化技能的核心价值在于通过 Rube MCP 这一免密钥的 MCP 端点把 Composio 的agent_mail工具包接入 Codex并以先搜索、再检查、后执行的规范流程让 Agent 真正完成邮件任务的端到端操作。掌握本文的调用链、参数规范与六条避坑要点后你可以把它平移到仓库中其他 700 个 Composio 技能只需替换toolkits名称从而批量打通各类第三方应用的自动化能力。【免费下载链接】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），仅供参考