營運與維護 · 實作指南
AI 報告讀到第一頁，不等於讀完全部
比較完整、部分與空結果，讓收集範圍先於結論。
AAHouse 原創解說影片，採用 AI 輔助概念畫面、合成旁白及原創音樂。
簡體中文普通話逐字稿 · 英文逐字稿 · 台灣華語逐字稿 · 香港粵語逐字稿 · 澳門粵語逐字稿
同一份報告，三種結局
想像一家美國服務團隊讓 AI 彙總未完成工單。第一批記錄已經返回，屏幕也出現了流暢的總結，但後台可能還有下一頁。我們用三個假設結局比較這一流程：完整收集、部分收集和確認沒有記錄。它們不應共享同一個「完成」標籤。本文討論數據收集邊界，不是已發生的客戶事故。
結局甲：第一批看起來很完整
若連接器只把第一頁交給模型，文字再準確也可能漏掉後面的工單。GitHub 文件說明，分頁接口返回結果的子集，並通過連結標頭提供後續頁面入口。[1] 這是一種具體產品行為，不是所有系統的統一格式。我們的建議是先核對連接器是否持續跟進後續頁，再評價摘要質量。
結局乙：中途失敗，卻被寫成完成
第二種情況是已讀幾頁，下一次請求失敗。可用的部分資料仍有價值，但不能冒充全部。建議保留已確認記錄、範圍和停止原因，並顯示「部分結果」。業務負責人可以決定等待或審閱部分內容；模型不應自行把缺頁解釋為沒有更多工單。恢復時繼續原收集任務，避免把重試記錄重複計入。
結局丙：空頁不一定是終點
Google 的 AIP-158 指南允許服務在尚未結束時返回少於請求數量、甚至零條記錄；它用空的下一頁代碼（token）表示集合結束。[2] 因而不能僅憑「這一頁很短」或「這一頁為空」停止。應讀取實際服務的文件，按其結束信號執行，而不是把這份設計指南當成每個接口都會遵守的保證。
比較依據：範圍保持一致
每次收集都應寫清篩選條件、賬號範圍、排序及報告涵蓋的時段。Google 指南要求翻頁時保持其他參數一致，每頁記錄數另有規定。[2] 對實際產品，還要核實記錄變化時的行為。讀完所有頁面並不自動獲得某一時刻的快照；如果沒有快照保證，應在報告中說明這個限制，不偽造精確截止時刻。
證據卡：比一句「已讀完」更可靠
建議讓連接器輸出一張證據卡：已讀頁數、不重複記錄數、繼續位置、結束依據和異常狀態。原始續頁代碼留在受控狀態中，不必展示給讀者。模型只接收獲准使用的記錄與範圍說明。頁數與記錄數用於核對，不是對完整性的獨立證明，更不是讓模型自行猜測總量的提示。
對照實驗：先寫預期，再生成文字
用虛構數據準備單頁、多頁、空頁仍可繼續、重複記錄和中斷恢復五類樣本。先寫明應收集哪些記錄、何時結束以及哪些情況必須標為部分結果，再檢查摘要。這裏提出的是驗收計劃，不宣稱已測試任何正式運作環境的接口。測試還應確認權限和篩選範圍不會因恢復流程而擴大。
選擇：先保證範圍，再潤色結論
優先改造一份經常使用的報告，讓完整、部分與確認空結果分別顯示。把翻頁規則及測試樣本留給維護者，接口變化後重跑。這樣，審核者知道自己面對的是哪一類證據，再決定是否採用結論。收集完整不等於分析正確，但跳過這一關，語言再自然也無法補回沒有讀到的資料。
