用途
该技能用于通过 Rube MCP(Composio)自动化 DocuSign 电子签名任务,涵盖模板、信封、签名和文档管理。它把 DocuSign 的常见操作封装为可调用的工具序列,适合需要批量或流程化处理签署任务的场景。
主要能力
- 浏览与选择模板:列出所有可用模板,获取模板详细信息(templateId、名称、描述、角色和字段)。
- 基于模板创建和发送信封:使用模板创建信封,分配模板角色,并发送签署。
- 监控信封状态:获取信封详情和状态,查看收件人级别的签署进度。
- 向现有信封添加模板:在草稿信封中追加模板,合并其字段和角色。
- 管理信封生命周期:发送草稿信封、作废信封等。
使用方式
前置条件:
- Rube MCP 必须已连接(RUBE_SEARCH_TOOLS 可用)。
- 通过 RUBE_MANAGE_CONNECTIONS 激活 DocuSign 连接(toolkit 为 docusign)。
- 始终先调用 RUBE_SEARCH_TOOLS 获取当前工具架构。
设置步骤:
- 获取 Rube MCP:在客户端配置中添加 https://rube.app/mcp 作为 MCP 服务器。无需 API 密钥,添加端点即可工作。
- 确认 RUBE_SEARCH_TOOLS 有响应,以验证 Rube MCP 可用。
- 调用 RUBE_MANAGE_CONNECTIONS,toolkit 为 docusign。
- 若连接不是 ACTIVE,按返回的授权链接完成 DocuSign OAuth。
- 确认连接状态为 ACTIVE 后再运行任何工作流。
核心工作流:
- 浏览和选择模板
- 使用时机:用户想查找可用的文档模板用于发送。
- 工具序列:DOCUSIGN_LIST_ALL_TEMPLATES(必需),DOCUSIGN_GET_TEMPLATE(可选)。
- 关键参数:列表可选搜索/过滤参数;详情需 templateId(来自列表结果)。
- 响应包含模板 templateId、名称、描述、角色和字段。
- 注意:模板 ID 是 GUID;模板定义收件人角色和签署标签,创建信封前需理解角色;大型模板库需要分页,检查 continuation token;模板访问取决于账户权限。
- 基于模板创建和发送信封
- 使用时机:用户想使用预建模板发送文档以供签署。
- 工具序列: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 会覆盖模板默认邮件主题。
- 监控信封状态
- 使用时机:用户想检查已发送信封的状态或跟踪签署进度。
- 工具序列:DOCUSIGN_GET_ENVELOPE(必需)。
- 关键参数:envelopeId(GUID)。
- 响应包含 status、recipients、sentDateTime、completedDateTime。
- 注意:信封状态包括 'created'、'sent'、'delivered'、'signed'、'completed'、'declined'、'voided';'delivered' 表示邮件已打开,并非文档已签署;'completed' 表示所有收件人已签署;recipients 数组显示每个收件人的签署状态;信封 ID 是 GUID,始终从创建或搜索结果中解析。
- 向现有信封添加模板
- 使用时机:用户想向现有信封添加额外文档或模板。
- 工具序列:DOCUSIGN_GET_ENVELOPE(前置,验证信封存在且为草稿状态),DOCUSIGN_ADD_TEMPLATES_TO_DOCUMENT_IN_ENVELOPE(必需)。
- 关键参数:envelopeId、documentId、templateId。
- 注意:信封必须处于 'created'(草稿)状态才能添加模板;不能向已发送的信封添加模板;文档 ID 在信封内是顺序的(从 '1' 开始);添加模板会将其字段和角色合并到现有信封。
- 管理信封生命周期
- 使用时机:用户想发送、作废或管理草稿信封。
- 工具序列:DOCUSIGN_GET_ENVELOPE(前置,检查当前状态),DOCUSIGN_SEND_ENVELOPE(可选,发送草稿信封)。
- 关键参数:envelopeId;发送时信封必须处于 'created' 状态且所有必需收件人齐全。
- 注意:只有 'created'(草稿)信封可以发送;已发送信封不能取消发送,只能作废;作废信封会通知所有收件人;发送前所有必需收件人必须有有效电子邮件地址。
适用场景
- 需要从模板批量或流程化发送签署文档。
- 需要跟踪多个信封的签署进度和状态。
- 需要在草稿信封中组合多个模板或文档。
- 需要管理信封的发送、作废等生命周期操作。
限制与注意事项
- 模板角色名称区分大小写,必须与模板定义完全匹配;缺少角色分配会导致信封创建失败。
- 信封状态转换是单向的,不能回退到之前的状态。
- 所有 DocuSign ID(模板、信封)均为 GUID 格式,不要硬编码 GUID,它们因账户而异。
- DocuSign API 有按账户的速率限制;批量创建信封应限流;轮询信封状态应使用合理间隔(30-60 秒)。
- 响应数据可能嵌套在 data 键下;收件人信息嵌套在信封响应中;日期字段使用 ISO 8601 格式;解析时应防御性处理可选字段。
- 具体收费、价格、平台支持范围等资料未提供。