某企業(yè)的運(yùn)營團(tuán)隊(duì)月初要用智能體給一百二十多家合作門店推送對賬提醒。任務(wù)跑完后系統(tǒng)提示處理完成運(yùn)營同事?lián)苏J(rèn)為通知已經(jīng)發(fā)出。到了月中陸續(xù)有門店反饋沒有收到提醒人工核對才發(fā)現(xiàn)實(shí)際只發(fā)出去二十來?xiàng)l正好是接口返回的頭一頁剩下的條目從頭到尾都沒有被取出來過。團(tuán)隊(duì)起初懷疑是接口偶發(fā)異常給每個調(diào)用都加上了重試重新跑了一遍結(jié)果仍只多發(fā)出零星幾條。排查之后問題不在發(fā)送環(huán)節(jié)而在取數(shù)環(huán)節(jié)剩下的那些門店記錄從來沒有進(jìn)入過處理范圍重試再多也只是把同一批已經(jīng)處理過的記錄又走了一遍。接口按頁返回?cái)?shù)據(jù)是最常見的取數(shù)方式每調(diào)用一次只給出一頁需要帶著游標(biāo)繼續(xù)往后取直到?jīng)]有更多為止。智能體如果只調(diào)一次就認(rèn)為拿到了全部等于把這一頁取完了誤讀成數(shù)據(jù)取完了。這類偏差在小批量場景里不易暴露一旦目標(biāo)對象超過一頁后面的記錄就整批消失而表面上任務(wù)依然走完了全部流程。接口的頁大小有時由服務(wù)端默認(rèn)值決定并不完全受調(diào)用方控制調(diào)用方如果把它寫死在判斷邏輯里頁大小一變推斷就會跟著失準(zhǔn)。完成判定本身也容易出問題。有的流程靠本頁返回的條數(shù)是否小于頁大小來推斷是否結(jié)束。當(dāng)總量正好是頁大小的整數(shù)倍時用這種寫法會多發(fā)出一次取數(shù)請求最后一頁為空這是一次多余的往返并不會因此漏掉數(shù)據(jù)。真正的隱患在另一處若接口因超時或截?cái)嗯紶柗祷夭蛔阋豁搮s并非末頁按條數(shù)判斷就會提前收尾丟掉后面的記錄。此外也有接口在返回體里帶了是否有下一頁的標(biāo)記只是這個字段沒有被讀取系統(tǒng)轉(zhuǎn)而依賴并不穩(wěn)妥的條數(shù)推斷。與其從條數(shù)上反復(fù)推敲不如顯式依賴接口給出的結(jié)束標(biāo)記或下一頁游標(biāo)。更隱蔽的是缺失條目沒有對賬。任務(wù)的進(jìn)度記錄往往只寫已處理多少條卻沒有先登記本批的目標(biāo)范圍或?qū)~基線。沒有范圍基線少做了多少就無從發(fā)現(xiàn)完成狀態(tài)與真實(shí)業(yè)務(wù)結(jié)果之間的差額被悄悄抹平。進(jìn)度寫成了成功對賬卻對不上業(yè)務(wù)側(cè)只能等外部反饋來暴露問題。對賬也不該只在任務(wù)結(jié)束時做一次異步返回或延遲落庫的結(jié)果可能在任務(wù)收尾之后才回來需要一次周期性的核對把它們重新納入統(tǒng)計(jì)。數(shù)據(jù)枚舉結(jié)束、業(yè)務(wù)動作處理結(jié)束與最終對賬通過是不同階段不應(yīng)共用同一個“完成”狀態(tài)。page exhausted ≠ enumeration complete ≠ processing complete ≠ reconciliation passed把其中任意一步當(dāng)成終點(diǎn)都會讓系統(tǒng)早于真實(shí)業(yè)務(wù)結(jié)果宣布成功。一種可行的做法是先登記本批的目標(biāo)范圍與可用的對賬基線再按游標(biāo)分批取數(shù)并在每批處理后把游標(biāo)位置與逐條狀態(tài)分片落庫中途中斷也能從記錄的位置續(xù)跑。如果數(shù)據(jù)源提供與本次查詢范圍一致且可作為權(quán)威基線的總數(shù)可以將其登記用于對賬如果沒有可靠總數(shù)則應(yīng)通過目標(biāo)清單、穩(wěn)定快照、游標(biāo)耗盡狀態(tài)或其他可核對機(jī)制確認(rèn)本批枚舉范圍。長批次還應(yīng)固定本批的數(shù)據(jù)邊界例如記錄快照版本、截止水位或查詢截止時間并使用穩(wěn)定且唯一的排序鍵這樣分頁期間新增或更新的數(shù)據(jù)不會悄悄進(jìn)入或移出當(dāng)前批次例如以 created_at batch_cutoff 為邊界再按 (created_at, id) 穩(wěn)定排序。每條記錄的處理結(jié)果區(qū)分成功、失敗、合法跳過與待確認(rèn)單條失敗被隔離并記錄原因不拖垮整批任務(wù)。整批結(jié)束后應(yīng)對目標(biāo)范圍內(nèi)每條記錄的終態(tài)進(jìn)行對賬確保每條記錄都能對應(yīng)到成功、失敗、合法跳過或待確認(rèn)等明確狀態(tài)只有滿足預(yù)先定義的完成條件任務(wù)才能進(jìn)入完成狀態(tài)失敗與待確認(rèn)記錄再進(jìn)入補(bǔ)處理隊(duì)列或人工清單。補(bǔ)處理同樣要帶上操作標(biāo)識避免同一批記錄被重復(fù)發(fā)送重復(fù)的副作用在通知類任務(wù)里尤其難以回收。通用模型與工作流編排平臺通常能提供批量調(diào)用與失敗重試能力但對賬基線的確定、分頁游標(biāo)的持久化以及漏項(xiàng)補(bǔ)處理的對賬規(guī)則仍需結(jié)合企業(yè)自身的數(shù)據(jù)接口與業(yè)務(wù)口徑單獨(dú)設(shè)計(jì)。在青山不語AI工作室的AI定制方案中任務(wù)執(zhí)行前先登記目標(biāo)范圍及可用的對賬基線取數(shù)游標(biāo)與逐條處理狀態(tài)分片持久化單條失敗被隔離并留痕任務(wù)收尾時對登記的目標(biāo)范圍與各記錄終態(tài)做完整對賬確認(rèn)成功、失敗、合法跳過和待確認(rèn)記錄均有明確歸屬只有滿足完成條件后才標(biāo)記任務(wù)完成。這套機(jī)制能減少少做了卻報(bào)完成的情況但它無法判斷登記的總數(shù)或基線是否可靠范圍應(yīng)當(dāng)怎么劃定仍然要由業(yè)務(wù)側(cè)確認(rèn)。驗(yàn)收時可以讓接口返回一個能被頁大小整除的總數(shù)再讓中間某一頁超時觀察任務(wù)是否只對成功、失敗、合法跳過與待確認(rèn)記錄分別給出明確終態(tài)多出來的空頁有沒有被正確識別合法跳過是否未被誤判為漏項(xiàng)、失敗與待確認(rèn)記錄有沒有進(jìn)入補(bǔ)處理或人工清單還可以構(gòu)造一個不返回可靠總數(shù)的接口觀察系統(tǒng)是否改用目標(biāo)清單或游標(biāo)耗盡狀態(tài)來確認(rèn)本批范圍而不是卡在缺失的 total 上。在我看來批量任務(wù)里更值得警惕的不是某一條失敗而是系統(tǒng)對自己做了多少并不清楚。一個連范圍都沒數(shù)清就宣布完成的任務(wù)比一個明確報(bào)出失敗的任務(wù)更難排查也更難向業(yè)務(wù)交代。