在线签约助手

解决的问题

在 Signwell 中完成一次合同签署，通常需要在多个页面之间来回切换：准备模板、指定签署人、发送文档、追踪每个人是否已阅读或签署、导出已完成的 PDF。当签署批次变多时，光是核对状态就会消耗大量注意力，而且每一步都要人工录入字段，出错后常常要整批重发。

这类操作本身非常适合交给 Agent 处理，但有两个难点：一是 Signwell 的工具和参数可能随版本调整，硬编码的字段名很容易失效；二是签署动作之间存在依赖，前一步未完成时后续调用通常没有意义。

技能如何工作

这个技能不直接封装 Signwell 的 REST API，而是通过 Composio 提供的 Signwell toolkit，经 Rube MCP 暴露给 Agent 调用。它把「搜索工具→检查连接→执行任务→确认结果」拆成清晰阶段，让 Agent 能按需组合操作。

• 工具发现：调用 RUBE_SEARCH_TOOLS，传入 Signwell 的具体用途，返回可用工具的 slug、输入 schema、推荐执行计划和已知坑点。
• 连接管理：通过 RUBE_MANAGE_CONNECTIONS 激活 signwell 工具包；若未授权，会返回授权链接，需在浏览器完成设置并确认状态变为 ACTIVE。
• 执行与批量：单步操作用 RUBE_MULTI_EXECUTE_TOOL，可按发现到的 slug 连续执行；批量流程可通过 RUBE_REMOTE_WORKBENCH 调用 run_composio_tool()，在脚本中编排多步任务。

核心调用顺序是：先 RUBE_SEARCH_TOOLS，再 RUBE_MANAGE_CONNECTIONS，最后才执行具体工具。每一步都依赖上一步返回的实时信息，这也是它能跟上 Signwell 更新的原因。

适用边界与注意点

• 不要硬编码工具 slug 或参数：schema 可能变化，每次工作流都应重新搜索。
• 执行前确认连接状态：只有 ACTIVE 时才能继续，否则会因授权失效而中断。
• 遵守 schema 约定：字段名和类型要与搜索结果完全一致，否则调用会被拒绝。
• 保留 memory 参数：RUBE_MULTI_EXECUTE_TOOL 中即使没有上下文，也要传入空对象 {}。
• 复用会话 ID：同一工作流内应沿用已有 session，新开工作流再生成新的。
• 处理分页：响应中若含分页 token，需继续拉取直到数据完整，避免遗漏待签署文档。

该技能依赖 Rube MCP 在线可用，本身不提供 Signwell 的认证凭据；签署类操作通常涉及法务与合规要求，生产环境中建议在执行前保留人工确认环节。