智能体定制开发最常见的延期,不是模型,是接口。

演示时手工贴数据,上线时要接系统。接口一卡,排期就乱。

所以我们在报价前先做接口调研,不先承诺工期。

先列系统清单

把任务涉及的 systems 全部列出来:CRM、ERP、工单、订单、库存、企微、邮箱、网盘。

每个系统写:谁在用、有没有接口、接口谁维护、最近一次升级是什么时候。

没有接口的系统,先标红。

再分读和写

查订单是读,改地址是写。

读接口通常容易开,写接口要审批、要日志、要回滚。

第一版尽量只做读。写操作单独评估。

看权限怎么开

接口有没有鉴权?能不能按角色授权?能不能只给某个字段?

如果只能给超级管理员权限,先别接。

权限开得太大,后面很难收。

看数据格式

字段名、类型、枚举值、空值怎么表示、时间格式、编码。

同名不同义最麻烦。订单的“状态”和工单的“状态”,可能完全不是一回事。

要求对方提供字段字典,不要靠猜。

看频率和限制

接口有没有调用频率限制?批量查询一次能查多少?超时时间多长?

智能体一次任务可能查十次,人工一次只查一次。频率限制要提前算。

看测试环境

有没有测试环境?测试数据能不能用?测试环境和生产差多少?

只能在生产上试的接口,风险高。先要求测试环境,或者做只读沙箱。

看异常和回滚

接口超时怎么办?返回空数据怎么办?写操作失败能不能回滚?

没有异常处理的接口,不要直接接自动流程。

看负责人

接口谁维护?升级提前通知吗?出问题找谁?

没有负责人的接口,出故障只能等。

看日志

调用有没有日志?能不能查到哪次请求、哪个字段、什么结果?

没有日志,出错无法定位。

接口调研怎么排时间

先用半天列系统,再用一天问接口,再用半天确认字段。

不要等开发介入才查。报价前查清楚,后面少返工。

一个常见的误判

业务说“我们有接口”,不代表能接。

有接口不等于有权限、有文档、有测试环境。

这三样缺一样,工期就不能按“接口已存在”来估。

接口调研的输出

一张表、一份风险清单、一个第一版范围建议。

不是一份会议纪要。

表给开发看,风险清单给项目经理看,范围建议给老板看。

一个报价前的红线

接口负责人不清、测试环境没有、字段字典没有,先别报固定工期。

可以先报调研,再报开发。

一个替代方案

没有接口,先人工半自动。

接口只读,先做查询。

接口不稳,先做批量或缓存,不要做实时。

一个协作方式

让客户技术负责人参与调研,不要只和业务聊。

业务知道要什么,技术知道能不能接。

两边都在,调研才完整。

一个提醒

接口调研不是技术细节,是项目排期的基础。先做调研,再报价。这一步省不得。否则后面更贵。这是经验。记住。别省。

一个调研问题清单

接口在哪、谁维护、有没有文档、能不能测试、支持什么鉴权、有没有频率限制、字段怎么定义、出错怎么返回。

八个问题,问完再估工期。

一个调研表

系统、接口、读写、权限、字段、频率、测试环境、异常、负责人、日志。

十列填完,再评估工期。

填不满,先别承诺上线时间。

边界

没有接口,但业务愿意人工半自动,可以先做“生成结果、人工录入”。

接口稳定、只读、字段清楚,可以先做查询。

接口复杂、写操作多、负责人不清,先别做全自动。

智能体定制开发,先做接口调研,不是拖延,是避免开发到一半才发现接不上。接口调研做完,再决定第一版接什么。不要反过来,先承诺功能再找接口。先做调研。

如果你正在评估定制项目,可以看我们的智能体定制开发,先把接口清单和字段字典要过来。

相关阅读:智能体定制开发,为什么演示能过、上线却不行、智能体接错系统,为什么比不接更危险。