每支诉讼团队都有一些在每个案件上以相同方式执行的步骤:建立文件夹、为上传内容加标签、创建准备任务、在结案时导出全部内容。如果你的软件有 API,脚本就能每次都以相同方式完成这些步骤,律师助理就可以把时间用在需要判断的工作上。法律 API 自动化并不是要取代那种判断,而是要去掉围绕判断的那些点击。

本指南面向律所管理员、诉讼支持人员,以及批准技术决策的律师。内容包括如何选择要自动化的事项、五个入门工作流、防止自动化造成损害的保障措施,以及在需要开发人员时如何向其说明需求。不假定读者具备编程知识。

API(应用程序编程接口)让一个程序可以请求另一个程序做事:创建文件夹、上传文件、列出任务。法律 API 自动化利用这些请求来运行可重复的诉讼支持步骤,而无需有人在界面上逐一点击。

大多数现代法律软件的 API 都是 REST API:脚本通过 HTTPS 向某个资源的地址发送经过身份验证的请求,例如案件或一项证据,并收到结构化数据作为回应。好的 API 会发布交互式文档,通常采用 Swagger/OpenAPI 格式,你可以在其中查看每一个可用请求并试着调用。

API 与 AI 助手集成不同。脚本每次都精确执行它所编写的内容。通过 MCP 连接的 AI 助手会根据对话决定采取哪些操作。对于可重复的工作流,确定性脚本通常更合适;对于开放式问题,助手可能更合适。我们关于律所的 MCP 与 AI 集成的指南介绍助手这一侧。

哪些诉讼支持任务应该自动化?

把那些频繁、基于规则且繁琐的步骤自动化,这类步骤的错误容易发现和修正。凡是需要法律判断的事项,或任何会离开律所的内容,都保持由人控制。

任务要自动化吗?原因
为新案件创建标准的文件夹和标签结构是每次都一样;容易核对
把扫描文件夹中的文件上传到正确的案件是,并加以检查数量大;案件匹配必须可靠
根据听证会日期创建准备任务是基于规则;减少遗漏步骤
结案时导出案件文件以便归档是可重复;支持你的保留政策
判断相关性或保密特权否需要法律判断
向对方律师或专家提供材料否(仅组装)涉及范围、遮盖和保密特权的判断

值得优先搭建的五个工作流

这五项在大多数诉讼实务中都会反复出现,适合作为首批项目,因为每一项范围有限、容易核对。

1. 新案件框架搭建

案件开启时,脚本会创建律所的标准证据文件夹(例如:沟通记录、财务、照片、学校与医疗、诉状),应用标准标签和类别,并添加接案任务清单。每个案件都以相同的方式开始整理,这会让后续的自动化更容易。

2. 从受监视文件夹批量上传

工作人员把扫描或下载的文件放入特定案件的文件夹;脚本将它们上传到正确的案件,根据文件名设置说明,并加上“未审阅”标签。仍由人审阅每一项;脚本只是省去上传这一步。

3. 从听证会生成任务

添加听证会后,定时脚本会从该日期倒推创建准备任务:客户文件截止日期、证物清单草稿、卷宗组装、客户准备会议。把它与你的日程控制配合使用;参见不错过法院期限的日程安排。法院期限本身仍应由人计算并核对。

4. 每周状态摘要

脚本会汇总未完成的任务、标为未审阅的项目,以及各在办案件中尚未完成的客户请求,并向团队负责人发送内部摘要。它把周一早上的忙乱变成一份清单。

5. 结案时的归档导出

案件结案时,脚本会请求完整导出,并按保留政策将其存入律所的归档位置,然后记录已完成此操作。在删除任何内容之前,由人确认归档可以打开。

如何保证 API 自动化的安全?

把每一项自动化都当作持有钥匙的工作人员:只给它所需的访问权限,关注它的行为,并能收回钥匙。根据规则 5.1 和 5.3 承担的监督职责,不会因为助手是软件就消失。

  • 每项自动化一个令牌,按用途命名,绝不在脚本或人员之间共用。
  • 最小权限:除非脚本必须写入,否则只读;除非确有必要,否则不授予删除权限。
  • 过期与撤销:在可行时设置有效期;令牌一旦泄露,立即撤销。
  • 密钥存放:把令牌放在密钥管理器或受保护的环境设置中,绝不要放在脚本文件或共享文档里。
  • 可安全运行两次:创建文件夹或任务之前,先检查是否已经存在,这样重试就不会重复工作。
  • 失败要显眼:记录每一次运行,出错时通知指定的人。
  • 遵守限制:遇到速率限制时暂停并重试,而不是持续冲击 API。
  • 先用测试案件:在接触真实数据之前,先针对非客户的测试案件运行新的自动化。

如何推出你的第一项自动化?

像任何流程变更一样推出:先从一个案件开始,加以衡量,再扩展。未经告知就上线的自动化,往往会让工作因此改变的人感到困惑。

  1. 把当前流程写下来。列出手工步骤、由谁完成,以及需要多长时间。这会成为你的基线和规格说明。
  2. 查阅 API 文档。确认你想自动化的每一步都有对应的请求,并在测试案件上逐一手动试一遍。
  3. 在非客户数据上构建并测试。反复运行,包括连续运行两次,并故意制造故障,看看它如何失败。
  4. 在一个真实案件上试点。告诉团队这项自动化会做什么,以及他们仍应自己完成什么。
  5. 一个月后复查。把所花时间与基线对比,检查日志,并决定是否扩展。

若想更全面地了解自动化在诉讼支持之外、在整个律所的哪些地方有回报,请参阅律所工作流程自动化:从哪里开始。

用 API 做自动化,是否需要开发人员?

并非总是需要。许多自动化平台可以不写代码就调用 API,技术上比较熟练的律师助理往往也能借助 API 文档搭建简单的工作流程。对于会写入多个案件、处理敏感文件或无人值守运行的自动化,聘请开发人员或技术顾问是值得的,主要是为了测试和错误处理。

无论哪种方式,都先写一份简短的规格说明。它会迫使那些否则会在代码里被偶然做出的决定提前定下来。

模板:给开发人员的自动化简报

目标:当听证会添加到案件时,创建我们的五项标准准备任务。触发:每隔 [interval] 定时检查自上次运行以来新增的听证会。操作:创建任务 [list],截止日期为听证会前 [X] 天,指派给 [role]。不得:更改或删除现有任务;若运行两次,不得创建重复项。权限:读取听证会,仅写入任务。错误:记录日志并向 [name] 发送电子邮件。测试:针对测试案件 [ID] 运行,并在上线前展示结果。负责人:[name],每月复查日志。

大多数故障是悄无声息的。请留意以下情况:

  • 静默失败。脚本几周前就已停止运行,却无人察觉;既要为错误建立警报,也要为“没有运行”建立警报。
  • 重复项。一次重试创建了第二套任务或文件夹。
  • 权限蔓延。为测试创建的令牌被授予了宽泛的写入权限,且从未撤销。
  • API 变更。供应商改了一个字段,脚本就行为异常;在供应商更新后重新检查。
  • 无人认领的自动化。编写者已离开律所,没有人知道脚本做什么。

回报是可以衡量的:花在搭建和来回整理上的时间更少,遗漏的步骤也更少。我们关于减少诉讼支持中的非计费工时的指南说明了如何追踪这些时间花在哪里。如果你正在评估某个平台的 API,CourtBriefly 的 REST API 是一个有用的示例,展示了应关注的内容:带读取或写入权限的范围受限令牌、可选的到期与撤销、对证据、文件夹、标签、听证会、任务、共享和导出的覆盖,以及可交互的Swagger API 参考。无论你构建什么,都把律师的判断留在规则所要求的位置,其余交给脚本处理。