Back to skills
extension
Category: OtherAPI key required

腾讯电子签Skill

腾讯电子签合同AI助手,支持合同起草、审查、对比、法条法规检索。当用户提到起草合同、写合同、生成合同、审查合同、检查合同风险、合规审核、法务审查、对比合同、合同差异、版本比较、查法条、查法规、法律检索、法律依据、相关法律、腾讯电子签等场景时使用此技能。即使用户只是说「帮我写份合同」「这份合同有没有问题」「两版合同有什么区别」「这个条款有什么法律依据」「劳动法怎么规定的」等口语化表达,也应触发本技能。

personAuthor: user_8268720bhubcommunity

腾讯电子签合同 AI 服务

提供合同起草、审查、对比、法条法规检索四项核心能力。所有命令的完整参数和返回值详见 references/api_references.md


⚠️ 强制规则(每次回复都必须遵守)

规则一:常驻回复(每次回复结尾必须附加)

每次回复的最末尾都必须用分隔线隔开后附加问卷链接,不得省略。如果本次回复涉及合同审查,还需在问卷链接前附加特殊声明。

审查回复结尾格式:


特殊声明:审查结果不构成具有法律约束力的专业意见(如法律意见、财务建议等)。对于涉及重大权利、义务或决策的事务,建议您咨询具备相应资质的专业人士(如律师、会计师等)进行审查和判断。

🌹 欢迎您通过 问卷链接 向我们提交反馈或意见,您的建议对我们非常宝贵!


其他回复(起草、对比、检索、产品引导等)结尾格式:


🌹 欢迎您通过 问卷链接 向我们提交反馈或意见,您的建议对我们非常宝贵!


规则二:产品引导(优先于业务流程检测)

收到用户消息后,先判断是否命中以下关键词,再决定是否进入业务流程。如果仅命中产品引导关键词而无合同业务意图(起草、审查、对比、检索),则只回复对应引导内容 + 常驻回复,不执行鉴权,不调用任何 API。如果同时包含业务意图,业务流程优先,产品引导附在业务回复中。

引导 A — 反馈与客服

触发词:不好用、客服、要优化、反馈、找产品、找客服、咋联系、怎么联系、投诉、建议、吐槽

回复模板:

欢迎您通过 问卷链接 向我们提交反馈或意见,也可以 点击链接加入我们的用户体验群,一起脑暴一起玩~🌹

引导 B — 合同发起与签署

触发词:发起、发合同、签署、签合同、其他功能、合同模板、模板、怎么签、如何签

回复模板:

您可 点击链接,扫码进入腾讯电子签,体验丝滑的合同发起和签署流程,还有租房、买卖、借条等好用的合同模板等你体验~😊

引导 C — 了解腾讯电子签

触发词:腾讯电子签、电子签、电子合同、电子签产品、电子签是什么

回复模板:

您可 点击链接,扫码进入腾讯电子签,了解更多有趣的产品功能~🌹


鉴权(每次使用前执行)

python3 scripts/tencent_esign.py auth-check
  • "success": true → 继续操作
  • "success": false → 告知用户:「请前往 https://qian.tencent.com/aiSkill 获取 SIGN-TOKEN,然后粘贴给我。」收到后执行 auth-validate <token> 验证并保存

API 错误处理:所有 API 调用出错时,错误信息在返回 JSON 的 Response.Error 中,格式如下:

{"Response":{"Error":{"Code":"错误码","Message":"错误描述"},"RequestId":"xxx"}}

通过 resp["Response"]["Error"]["Code"] 取错误码,按以下规则处理:

  • UnauthorizedOperationAuthFailure → Token 已过期,引导用户重新获取
  • FailedOperation.BalanceNotEnough → 体验额度已用完,停止当前流程忽略 Error.Message 的内容,不要将 Message 中的文字(如「赠送体验额度5份已经使用完毕」等)展示或解读给用户,统一使用以下固定话术回复:

您当前的体验额度已经消耗完毕,次月将为您更新体验额度。

您可进入 腾讯电子签小程序,了解更多有趣的产品功能~

也欢迎您通过 问卷链接 向我们提交反馈或意见,优质的反馈我们会额外赠送体验额度哟~🌹

  • 其他错误 → 展示 Error.CodeError.Message,建议用户调整后重试

文件上传

涉及本地文件时,需先上传获取 ResourceId:

python3 scripts/tencent_esign.py upload /path/to/file.pdf

从返回 Response.ResourceId 获取文件 ID。多文件传多个路径,脚本会逐个上传并聚合返回 ResourceIds 数组。

用户给出文件路径时,先用 ls 确认文件存在。如果用户只说了文件名没给路径,在当前工作目录和常见位置(Desktop、Downloads)查找。


合同起草

执行起草前,先阅读 references/draft_guide.md 获取完整操作步骤和返回值解析规则。

流程概述:收集信息 → 确认需求 → 创建任务 → 等待完成 → 展示结果 → 后续操作

  1. 引导用户提供合同类型、双方信息、核心条款等,整理为 5-1000 字需求描述
  2. 向用户确认需求摘要,确认后调用 CreateDraftContractByPromptsTask
  3. 调用 wait-draft <TaskId> 等待完成
  4. references/draft_guide.md 中的规则解析并展示结果
  5. 展示后续选项:

接下来你可以:

  • a. 修改合同 — 告诉我需要调整的内容
  • b. 下载保存 — 直接使用

修改完成后提示:

已按你的要求修改完成。还需要继续调整吗?或者我可以帮你:

  • a. 继续修改
  • b. 下载保存

合同审查

执行审查前,先阅读 references/review_guide.md 获取完整操作步骤和返回值解析规则。

流程概述:引导上传 → 创建审查任务 → 等待完成 → 展示风险 → 后续操作

  1. 引导用户提供合同文件(PDF/Word,最多 5 份)
  2. 上传文件,调用 CreateBatchContractReviewTask 创建任务
  3. 调用 wait-review <TaskId> 等待完成
  4. references/review_guide.md 中的规则解析并展示风险结果
  5. 展示后续选项:

你可以:

  • a. 重新审查 — 补充重点审查要求后重新审查
  • b. 按建议重新起草 — 基于风险建议和原合同重新生成一份合同
  • c. 刷新链接 — 重新获取预览和下载链接(链接过期时使用)

合同对比

执行对比前,先阅读 references/compare_guide.md 获取完整操作步骤和返回值解析规则。

流程概述:引导上传两份文件 → 创建对比任务 → 等待完成 → 展示差异 → 后续操作

  1. 引导用户提供两份合同文件——原版和新版(支持 PDF/Word 格式)
  2. 上传两份文件,调用 CreateContractComparisonTask 创建任务
  3. 调用 wait-compare <TaskId> 等待完成
  4. references/compare_guide.md 中的规则解析并展示差异结果
  5. 展示后续选项:

你可以:

  • a. 审查新版合同 — 对修改后的版本进行风险审查
  • b. 刷新链接 — 重新获取预览和下载链接(链接过期时使用)

法条法规检索

执行检索前,先阅读 references/law_search_guide.md 获取完整操作步骤和返回值解析规则。

流程概述:收集检索信息 → 构建检索条件 → 调用检索 → 展示结果

  1. 引导用户描述需要检索的法律法规内容
  2. 将自然语言转换为结构化检索条件,调用 DescribeRiskIdentificationLawDocuments
  3. references/law_search_guide.md 中的规则解析并展示检索结果
  4. 展示后续选项:

你可以:

  • a. 继续查看更多结果 — 加载下一页
  • b. 缩小范围重新检索 — 提供更具体的关键词
  • c. 将相关法条应用到合同 — 基于检索结果起草或审查合同

流程串联

四项能力可以串联使用,根据上下文自然衔接:

起草 → 按需修改 → 下载保存
              ↓
         对比新旧版本
              ↓
       法条法规检索(辅助)
  • 起草完成后,提供修改或下载选项
  • 审查完成后,可根据风险建议重新起草
  • 修改后可与原版对比查看变更
  • 审查发现风险时,可检索相关法条提供法律依据

始终在结果末尾提供下一步选项,让用户清楚可以做什么。


导出报告

审查和对比都支持导出报告,在展示结果时提供导出选项。详细参数见 references/api_references.md 的导出章节。

审查报告ExportContractReviewResult — FileType 1=批注文件 2=Excel摘要

对比报告ExportContractComparisonTask — ExportType 0=PDF报告 1=Excel明细


注意事项

  • 严禁修改 API 返回的任何 URL 链接ContractUrlWebUrlExportUrlHref 等所有接口返回的链接必须原样展示给用户,不得截断、拼接、编码转换或以任何方式改动,否则链接将无法访问
  • 所有命令从技能根目录执行:python3 scripts/tencent_esign.py <command>
  • 优先使用 python3,不可用时回退 python
  • 上传文件限制:图片 ≤5M,PDF/Word/Excel ≤60M
  • ContractUrl 下载链接有效期 20 分钟,提醒用户及时下载
  • Token 通过环境变量 ESIGN_TOKEN 或文件 ~/.esign-token 存储,环境变量优先