用途:该技能为通过 CData Connect AI 查询 DocuSign 数据提供专门指引,构建在 connect-ai-base 技能之上。使用前必须先定位并读取 connect-ai-base 技能;若当前环境未加载、未启用或未安装,应立即停止任务,告知用户需先安装并启用该技能。本技能替代 DocuSign 驱动的 getInstructions,识别连接后直接进行模式发现(getTables / getColumns)。
主要能力:DocuSign 为单模式驱动,模式名为 DocuSign。数据围绕信封生命周期组织:信封包含文档、有签署收件人,并经历 created → sent → delivered → completed 等状态。关键表均为只读视图,包括 Envelopes、Templates、Documents、Recipients、DocumentTabs、Folders。Envelopes 状态为小写字符串:created、sent、delivered、signed、completed、declined、voided。查询“已签署”可用 Status IN ('completed','signed'),查询“进行中”可用 Status IN ('sent','delivered')。
使用方式:先通过 getCatalogs 过滤 DRIVER = 'DocuSign' 识别连接。查询操作使用表,创建、修改、下载操作使用存储过程。Documents 与 Recipients 必须同时带 Type('envelopes' 或 'templates')和 Id(父信封或模板 ID)过滤,否则查询失败或返回整表。下载用 DownloadDocument,云环境省略 @DownloadLocation 与 @FileStream,返回 base64。创建发送用 CreateAndSendEnvelope,创建模板用 CreateTemplate,云环境优先使用 base64 的 @DocumentsAggregate,而非 @FileLocation 或 @Content。
适用场景:查询近期完成或待处理信封、查看指定信封的文档与收件人、按共享范围查询模板、查询作废信封及原因、下载已签署文档、创建并发送信封或模板。
限制:所有表为只读视图,不支持 INSERT/UPDATE/DELETE。AddDocumentToTemplate 在云环境暂不支持,因仅接受磁盘路径或 InputStream,无 base64 替代;可改用 CreateTemplate 的 Pattern B 一次性创建带文档的模板。云环境无磁盘访问,InputStream 无法通过 MCP 传递。Folders 受连接属性 FolderType 影响,代理无法从 Connect AI 内部检测当前作用域。过滤建议使用显式日期字面量而非 DATEADD()。若存储过程返回权限错误,需检查 Connect AI 连接的 readonly 设置与 DocuSign API 用户角色权限。收件人聚合参数名在不同过程间不同,调用前用 getProcedureParameters 确认。