合同法务和财务文档处理，为什么不要把模型写死在业务代码里

：Gemini 场景复盘这篇想从开发者视角聊一个很实际的问题：合同和财务资料不适合只追求生成速度，更需要摘要可追踪、风险点可解释、权限和日志可审计。

聊 Gemini，不能只停在模型能力上。更实际的问题是，它能不能在“合同比对”这类场景里跑出结果。第一次试 AI，大家容易盯着回答本身；进入业务后，谁来用、谁复核、成本怎么算、出错怎么补救，都会变成具体问题。

先把场景落到流程里

适合做条款摘要、风险点初筛、发票资料整理和报销说明归纳。关键结论仍然要让法务或财务人员复核。

试用阶段最怕目标太大。今天做客服，明天做报表，后天做内容，最后每个方向都只浅尝一下。先把一个场景跑透，比同时铺开更靠谱。把这些问题说清楚，Gemini 的能力才有地方落下去。比如合同里出现付款周期、违约责任、数据使用范围等条款，Gemini 可以先把它们标出来，帮助法务更快定位重点。但它不能替代最终判断，因为合同语境、行业习惯和公司风险偏好都需要人来确认。文档类场景越严肃，越要保留审计和复核。

别只看一次回答

开发者最容易踩的坑，是一开始为了快，在多个 service 里直接调用 Gemini。短期看没问题，后期一旦要换模型、加 fallback、做埋点、查成本，就会发现到处都是散落逻辑。更稳的做法是先封装 modelClient，把请求、响应、错误、重试和日志都统一起来。模型名称、temperature、max_tokens、超时时间、重试次数、降级模型也尽量配置化。只要要进生产，就要提前想清楚风险点召回率、误报率、复核耗时、审计日志完整度这些指标怎么采集。

模型输出只是链路里的一段。没有日志、没有引用、没有成本归因，后面出了问题就只能凭感觉猜。如果结果没有引用、没有日志、没有责任边界，后面出现问题就很难追溯。从代码维护上看，最好从第一版就把模型调用当成外部依赖处理。外部依赖会失败、会限流、会变更价格，也可能在某个时间段不稳定。你不需要一开始做得很复杂，但要让失败可见、可降级、可替换。

这类实现不一定复杂，但一定要从第一天就留好可替换空间。模型能力会变，价格会变，调用限制也可能变。代码结构如果太死，后面每次变化都会变成一次小迁移。

我更建议把第一版目标定得窄一点：先让它稳定服务一个场景，而不是同时兼顾十个需求。场景越窄，测试样本越容易准备，异常越容易复现，后面抽象成通用能力也更有底气。如果合同和财务资料没有权限控制，提效可能会带来更大的合规风险。文档越敏感，越要记录谁调用、调用了什么、结果给了谁。

最后再补一点：不要过早抽象一个“大而全”的 AI 平台。先把一个场景打磨到稳定，再把共性能力抽出来。过早抽象会让代码看起来很漂亮，但真实需求一变，反而更难维护。

从开发者角度看，最值得提前做的是把边界留好。不要为了赶 demo 把模型名称、接口地址和错误处理写死，后面一旦要扩展到其它模型，就会发现改动比想象中大。

对开发者来说，147AI 的意义主要是减少重复接入。工具不必讲得太重，能让样本跑起来、让模型对比更快完成，就已经够用了。

等这个小场景跑稳以后，再考虑抽象通用能力也不迟。先把请求、响应、错误、成本这些最基础的信息记录清楚，后面无论换模型还是加模型，都不会太被动。

开发者最怕后期返工。先把配置、日志和 fallback 留出来，哪怕第一版很简单，也比把模型写死强。

最后

回到开发者视角，文档处理最重要的是别把路写死。先把一个小场景跑稳，再抽象公共能力，会比一开始就做大平台更靠谱。