寓言故事
信使学会交出工单,而不是只写一段建议
仓库里有位聪明信使,听得懂人的要求。工人说想查库存,他能写出一段很像样的说明,却不能让系统真的查。
管理员最早让信使把命令写在句子里。工程师再从句子中猜要调用哪个系统、参数是什么。
猜测很快出事。客户说“下周三之前”被解析错,产品型号少了一个字母,取消订单和查询订单也混在一起。
有人试图用正则和关键词修补。每多一个业务动作,就多一堆例外规则,维护成本越来越高。
新管理员改了规矩。可执行动作先登记成函数,写清名称、参数、类型、必填项和含义。信使需要行动时,必须交出结构化工单。
系统收到工单后先校验参数,再由应用层决定是否执行、是否审批、是否补问,以及如何把结果交回信使。
信使不再凭一句自然语言推动外部系统。它负责选择函数并填参数,真正执行仍由受控程序完成。
管理员仍要防错。函数设计太宽、描述含糊、缺少权限和幂等控制,结构化调用也会造成真实损失。他明白,让机器请托工具的关键不是让它更会说,而是让它用机器可读的参数提出可审核的动作请求。后来,又来了一件更棘手的活。表面看只是旧问题放大,实际把藏在流程里的缝隙都逼了出来:谁先接手、谁能改动、出了错怎样回到上一步,过去靠熟人默契混过去的地方,现在都必须说清楚。主事人没有再催大家更用心,而是把现场重新走了一遍。他让人记录每次交接、每次失败和每次补救,哪些地方只是慢,哪些地方会误伤结果,哪些地方一旦错了就很难追回。新规矩推开后,最初几天并不顺手。有人嫌多了一道检查,有人觉得旧经验被冒犯。可当下一次异常出现时,大家第一次能沿着痕迹找到问题发生的位置,而不是围着结果互相猜。