SuperAPI AI 工具集

docusign-automation

办公与效率

查看项目

更新于 10-15 10:22

技能介绍

用途

该技能用于通过 Rube MCP(Composio)自动化 DocuSign 电子签名任务,涵盖模板、信封、签名和文档管理。它把 DocuSign 的常见操作封装为可调用的工具序列,适合需要批量或流程化处理签署任务的场景。

主要能力

  • 浏览与选择模板:列出所有可用模板,获取模板详细信息(templateId、名称、描述、角色和字段)。
  • 基于模板创建和发送信封:使用模板创建信封,分配模板角色,并发送签署。
  • 监控信封状态:获取信封详情和状态,查看收件人级别的签署进度。
  • 向现有信封添加模板:在草稿信封中追加模板,合并其字段和角色。
  • 管理信封生命周期:发送草稿信封、作废信封等。

使用方式

前置条件:

  • Rube MCP 必须已连接(RUBE_SEARCH_TOOLS 可用)。
  • 通过 RUBE_MANAGE_CONNECTIONS 激活 DocuSign 连接(toolkit 为 docusign)。
  • 始终先调用 RUBE_SEARCH_TOOLS 获取当前工具架构。

设置步骤:

  1. 获取 Rube MCP:在客户端配置中添加 https://rube.app/mcp 作为 MCP 服务器。无需 API 密钥,添加端点即可工作。
  2. 确认 RUBE_SEARCH_TOOLS 有响应,以验证 Rube MCP 可用。
  3. 调用 RUBE_MANAGE_CONNECTIONS,toolkit 为 docusign。
  4. 若连接不是 ACTIVE,按返回的授权链接完成 DocuSign OAuth。
  5. 确认连接状态为 ACTIVE 后再运行任何工作流。

核心工作流:

  1. 浏览和选择模板
  • 使用时机:用户想查找可用的文档模板用于发送。
  • 工具序列:DOCUSIGN_LIST_ALL_TEMPLATES(必需),DOCUSIGN_GET_TEMPLATE(可选)。
  • 关键参数:列表可选搜索/过滤参数;详情需 templateId(来自列表结果)。
  • 响应包含模板 templateId、名称、描述、角色和字段。
  • 注意:模板 ID 是 GUID;模板定义收件人角色和签署标签,创建信封前需理解角色;大型模板库需要分页,检查 continuation token;模板访问取决于账户权限。
  1. 基于模板创建和发送信封
  • 使用时机:用户想使用预建模板发送文档以供签署。
  • 工具序列:DOCUSIGN_LIST_ALL_TEMPLATES(前置),DOCUSIGN_GET_TEMPLATE(可选),DOCUSIGN_CREATE_ENVELOPE_FROM_TEMPLATE(必需),DOCUSIGN_SEND_ENVELOPE(必需)。
  • 关键参数:CREATE_ENVELOPE_FROM_TEMPLATE 需要 templateId、templateRoles(包含 roleName、name、email 的数组)、status('created' 草稿或 'sent' 立即发送)、emailSubject、emailBlurb;SEND_ENVELOPE 需要 envelopeId。
  • 注意:templateRoles 必须与模板中定义的角色名称完全匹配(区分大小写);创建时 status 设为 'sent' 会立即发送,草稿用 'created';若创建时 status 为 'sent',无需再调用 SEND_ENVELOPE;每个角色至少需要 roleName、name 和 email;emailSubject 会覆盖模板默认邮件主题。
  1. 监控信封状态
  • 使用时机:用户想检查已发送信封的状态或跟踪签署进度。
  • 工具序列:DOCUSIGN_GET_ENVELOPE(必需)。
  • 关键参数:envelopeId(GUID)。
  • 响应包含 status、recipients、sentDateTime、completedDateTime。
  • 注意:信封状态包括 'created'、'sent'、'delivered'、'signed'、'completed'、'declined'、'voided';'delivered' 表示邮件已打开,并非文档已签署;'completed' 表示所有收件人已签署;recipients 数组显示每个收件人的签署状态;信封 ID 是 GUID,始终从创建或搜索结果中解析。
  1. 向现有信封添加模板
  • 使用时机:用户想向现有信封添加额外文档或模板。
  • 工具序列:DOCUSIGN_GET_ENVELOPE(前置,验证信封存在且为草稿状态),DOCUSIGN_ADD_TEMPLATES_TO_DOCUMENT_IN_ENVELOPE(必需)。
  • 关键参数:envelopeId、documentId、templateId。
  • 注意:信封必须处于 'created'(草稿)状态才能添加模板;不能向已发送的信封添加模板;文档 ID 在信封内是顺序的(从 '1' 开始);添加模板会将其字段和角色合并到现有信封。
  1. 管理信封生命周期
  • 使用时机:用户想发送、作废或管理草稿信封。
  • 工具序列:DOCUSIGN_GET_ENVELOPE(前置,检查当前状态),DOCUSIGN_SEND_ENVELOPE(可选,发送草稿信封)。
  • 关键参数:envelopeId;发送时信封必须处于 'created' 状态且所有必需收件人齐全。
  • 注意:只有 'created'(草稿)信封可以发送;已发送信封不能取消发送,只能作废;作废信封会通知所有收件人;发送前所有必需收件人必须有有效电子邮件地址。

适用场景

  • 需要从模板批量或流程化发送签署文档。
  • 需要跟踪多个信封的签署进度和状态。
  • 需要在草稿信封中组合多个模板或文档。
  • 需要管理信封的发送、作废等生命周期操作。

限制与注意事项

  • 模板角色名称区分大小写,必须与模板定义完全匹配;缺少角色分配会导致信封创建失败。
  • 信封状态转换是单向的,不能回退到之前的状态。
  • 所有 DocuSign ID(模板、信封)均为 GUID 格式,不要硬编码 GUID,它们因账户而异。
  • DocuSign API 有按账户的速率限制;批量创建信封应限流;轮询信封状态应使用合理间隔(30-60 秒)。
  • 响应数据可能嵌套在 data 键下;收件人信息嵌套在信封响应中;日期字段使用 ISO 8601 格式;解析时应防御性处理可选字段。
  • 具体收费、价格、平台支持范围等资料未提供。