Affinda 文档自动化

要解决的问题

当你需要在流水线里批量做文档识别，比如把合同、票据、表单转成结构化字段时，通常得自己对接 Affinda API：管理 token、写重试逻辑、处理分页，还得手动维护工具的输入参数。一旦 Affinda 的工具 schema 有变动，硬编码的脚本就挂了。这个技能要解决的就是这个问题——把 Affinda 的操作封装成可被 MCP 客户端直接调用的工作流，让 agent 按固定套路完成识别任务。

它的工作机制

核心思路是通过 Rube MCP 调用 Composio 的 Affinda 工具集，整个流程分三步：

1. 发现工具：总是先调用 RUBE_SEARCH_TOOLS，拿到当前可用的 tool slugs、输入 schema、推荐的执行计划和已知坑点。
2. 检查连接：用 RUBE_MANAGE_CONNECTIONS（toolkit 设为 affinda）确认连接是 ACTIVE 状态，没连上就按返回的授权链接走完配置。
3. 执行任务：通过 RUBE_MULTI_EXECUTE_TOOL 调用上一步发现的具体工具；批量操作则交给 RUBE_REMOTE_WORKBENCH 里的 run_composio_tool()；对带 schemaRef 的工具用 RUBE_GET_TOOL_SCHEMAS 拿完整定义。

几个容易踩的点：永远先搜索再执行，不要硬编码工具名和参数；执行前必须确认连接为 ACTIVE；参数字段名和类型要严格照搜索结果来；调用 RUBE_MULTI_EXECUTE_TOOL 时 memory 参数即使为空也要传 {}；同一工作流内复用 session ID，新工作流才生成新的；响应里有分页 token 的话要持续拉取直到取完。

适用边界

这个技能只负责编排 Affinda 的文档识别操作，前提是客户端已经接入 Rube MCP 端点。它不承诺 Affinda 本身的 OCR 质量，也不处理识别结果的业务校验，错误恢复和重试仍由上层应用决定。