使用 Rube MCP 自动化 Typless 文档处理Composio Typless 工具包实战指南【免费下载链接】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 仓库中 typless-automation 技能文档编写的技术指南。Typless 是面向企业文档数据捕获的智能平台专注于从发票、收据、护照等非结构化文档中自动抽取结构化字段。本指南以该技能为核心结合仓库中 README.md 对 Codex Skills 机制的说明以及 skill-installer 的安装脚本完整展开 Rube MCP 环境下的连接、工具发现、执行与故障排查全流程。文中所有命令与参数均以仓库实际内容为准。Typless 的自动化集成可以彻底改变企业文档处理流程——通过 Rube MCP你可以让 Codex 直接调用 Composio 的 Typless 工具包从发票、收据、护照等文档中自动抽取结构化数据。本文将带你从零搭建 Rube MCP 环境掌握先发现、后连接、再执行的三步工作流并了解如何规避工具 schema 变更、连接状态失效等常见坑位让文档数据捕获真正实现零人工干预。背景Codex Skills 如何承载自动化能力在深入 Typless 之前先理解其运行载体。本仓库awesome-codex-skills是一个精选的 Codex Skills 集合用于在 Codex CLI 和 API 环境中自动化各类工作流。每个技能Skill都以独立文件夹存放一个SKILL.md内含 YAML frontmatter 元数据namedescription和分步指引。Codex 通过读取元数据来决定何时触发技能并在触发后才加载正文从而保持上下文精简。Typless 自动化技能正是这一机制的具体落地它通过requires: mcp: [rube]声明对 Rube MCP 服务器的依赖将 Typless 的工具调用封装为可复用的操作指引。Prerequisites开工前的三项检查技能文档composio-skills/typless-automation/SKILL.md明确列出了启动前的三项前提条件缺一不可Rube MCP 已连接客户端环境中RUBE_SEARCH_TOOLS工具可用Typless 连接处于 ACTIVE 状态通过RUBE_MANAGE_CONNECTIONS工具toolkit 为typless建立并确认先搜索再执行任何工作流开始前必须先调用RUBE_SEARCH_TOOLS获取当前工具 schema。第三点是整个技能的灵魂原则——工具 schema 会随版本更新而变化硬编码 tool slug 或参数必然导致失败。Setup五分钟搭建 Rube MCP 环境技能的 Setup 环节非常简洁核心就一句话在客户端配置中把https://rube.app/mcp添加为 MCP 服务器无需任何 API Key。Rube 是 Composio 提供的 MCP 网关统一承载各集成工具包的调用入口。添加完成后按以下四步确认环境就绪调用RUBE_SEARCH_TOOLS确认 Rube MCP 正常响应调用RUBE_MANAGE_CONNECTIONS指定 toolkit 为typless若连接状态不是 ACTIVE跟随返回的 auth 链接完成授权设置确认连接状态显示 ACTIVE再开始运行任何工作流。从仓库源码结构看skill-installer/scripts/install-skill-from-github.py 提供了将技能安装到$CODEX_HOME/skills默认~/.codex/skills的标准路径安装后重启 Codex 即可让新技能被元数据加载。README 也强调技能通过 frontmatter 的description触发描述任务时 Codex 会自动匹配技能。Tool Discovery动态发现工具 schema工具发现是防止工具不存在报错的关键防线。技能给出标准的发现调用格式RUBE_SEARCH_TOOLS queries: [{use_case: Typless operations, known_fields: }] session: {generate_id: true}该调用会返回四个关键信息可用工具 slug如 Typless 的文档上传、抽取任务创建、结果查询等输入 schema每个工具参数的字段名、类型与必填性推荐执行计划完成特定用例的建议调用序列已知坑点官方预置的常见错误提示。实践中use_case应替换为你具体的任务描述如 extract invoice data from PDFknown_fields可填写已知的参数线索以提升匹配精度session: {generate_id: true}用于首次调用时生成新的会话 ID。Core Workflow Pattern三步核心工作流技能将整个自动化流程固化为三步模式是所有 Typless 任务的通用骨架。Step 1发现可用工具RUBE_SEARCH_TOOLS queries: [{use_case: your specific Typless task}] session: {id: existing_session_id}与初始发现不同此处使用已有会话 ID保持同一工作流内的上下文连续。Step 2检查连接状态RUBE_MANAGE_CONNECTIONS toolkits: [typless] session_id: your_session_id确认返回的 connection 状态为 ACTIVE。若连接失效如 OAuth token 过期需重新走授权流程。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执行阶段有两个细节值得注意arguments必须严格按 Step 1 搜索结果中的字段名和类型填写schema 合规memory参数每次调用都必须携带即使为空也要传{}。RUBE_MULTI_EXECUTE_TOOL支持在tools数组中传入多个工具实现批量或串行操作。Known Pitfalls六个必须规避的坑技能文档列出六条实践教训每一条都来自真实运行环境的经验总结永远先搜索工具 schema 会变化禁止不调用RUBE_SEARCH_TOOLS就硬编码 tool slug 或参数检查连接执行前务必确认RUBE_MANAGE_CONNECTIONS显示 ACTIVE防止因 token 过期导致静默失败Schema 合规使用搜索结果中的精确字段名和类型一个字段名拼写错误就可能导致整个调用失败Memory 参数必带RUBE_MULTI_EXECUTE_TOOL调用必须包含memory空值也要传{}会话复用同一工作流内复用 session ID新工作流再生成新 ID避免上下文串扰分页处理响应中若出现分页 token需持续获取直到数据拉取完整防止结果截断。Quick Reference常用操作速查表操作方法查找工具RUBE_SEARCH_TOOLS Typless 相关的 use case建立连接RUBE_MANAGE_CONNECTIONStoolkit 为typless执行工具RUBE_MULTI_EXECUTE_TOOL 发现的 tool slug批量操作RUBE_REMOTE_WORKBENCHrun_composio_tool()获取完整 schemaRUBE_GET_TOOL_SCHEMAS针对带schemaRef的工具这张速查表是日常高频操作的索引当工具涉及schemaRef即 schema 引用而非内联定义时用RUBE_GET_TOOL_SCHEMAS拉取完整定义当需要批量处理大量文档时可借助RUBE_REMOTE_WORKBENCH远程执行环境调用run_composio_tool()避免单次执行的内存与上下文限制。典型场景推演发票数据抽取将上述工作流套用到最典型的 Typless 场景——发票数据抽取完整链路如下搜索use_case: extract structured data from invoice PDF得到文档上传与抽取任务相关工具连接确认typless连接 ACTIVE上传文档 → 创建抽取任务 → 轮询任务结果三步用RUBE_MULTI_EXECUTE_TOOL串行执行参数严格取自 Step 1 的 schema若返回结果带分页继续拉取直到完整。这一模式同样适用于收据、护照、身份证等 Typless 支持的所有文档类型只需在 Step 1 调整use_case描述即可。总结Typless 自动化技能的价值在于将连接管理、schema 发现、工具执行三个易错环节固化为标准流程连接一次、长期复用每次任务先搜索再执行执行始终携带 memory 并遵守 schema。通过 Rube MCP 的单一端点无需管理多个 API Key即可在 Codex 中直接驱动 Typless 的文档数据捕获能力。若要在本地启用此技能可将 composio-skills/typless-automation 目录安装到$CODEX_HOME/skills/可参考 skill-installer 的安装脚本重启 Codex 后即按本文工作流触发使用。Powered by Composio【免费下载链接】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），仅供参考