系統整合 · 實作指南
AI 譯文好順，訂單編號卻填唔返
保留翻譯範本嘅欄位識別名稱，分開檢查程式規格約定同語言意思，避免通知漏咗訂單編號。
AAHouse 原創解說影片，採用 AI 輔助概念畫面、合成旁白及原創音樂。
英文逐字稿 · 簡體中文普通話逐字稿 · 台灣華語逐字稿 · 澳門粵語逐字稿
審稿枱上嘅一對花括號
假設一間美國維修店，將訂單通知交畀 AI 翻譯。原句係「Order {order_id} is ready.」，譯稿變成「訂單 {订单号} 已準備好。」中文好順，但可能填唔到系統提供嘅 order_id。呢度嘅括號唔係畀顧客睇嘅文字，而係程式同文案之間嘅介面。本文用虛構通知做一次編輯演練。
- 輸入資料：order_id = A-104
- 原始欄位：{order_id}
- 錯誤譯稿：訂單 {订单号} 已準備好。
說明圖重繪 · 合成資料，唔係實際業務結果
第一張退稿單：欄位名畀人譯咗
喺本文採用嘅 Python str.format 語法入面，花括號包住替換欄位，名稱一定要同傳入資料相符。[1] 我哋用合成編號 A-104 做咗本地測試：保留 {order_id} 嘅譯稿，正確填入編號；改成 {订单号} 就出現 KeyError。唔可以將呢個結果推廣成所有範本引擎嘅行為，但已經足以說明，讀起嚟順唔順，唔係程式驗收。
- 保留 {order_id} → 填入 A-104
- 改成 {订单号} → KeyError
- 結果只限本文嘅 Python 合成測試
說明圖重繪 · 合成資料，唔係實際業務結果
第二張退稿單：行得通，但漏咗編號
另一份譯稿淨係寫「訂單已準備好」。佢冇語法錯誤，但漏咗顧客分辨訂單需要嘅編號。本地測試確認，佢仍然可以產生文字，所以淨係檢查程式有冇回報錯誤係唔夠嘅。呢類簡單通知，要先列出一定要保留嘅欄位，再對照解析結果同實際輸出。欄位存在，都唔保證放喺正確位置，仍然要由人手檢查意思。
- 譯稿：訂單準備好喇。
- 程式行得到，但係冇 A-104
- 必填欄位檢查 ≠ 淨係檢查有冇錯誤
說明圖重繪 · 合成資料，唔係實際業務結果
語序可以改，但唔好拆散上下文
保留欄位名，唔等於要求譯文照搬英文語序。ICU 文件建議，將訊息當成完整單元翻譯，等變數位置可以按目標語言調整；佢嘅 MessageFormat 亦支援按語言規則揀複數分支。[2] 畀 AI 完整句子、欄位意思同示例值，比逐段翻譯碎片更有用。Python 同 ICU 嘅語法唔可以混用，驗收一定要用產品實際採用嘅解析器。
- 可以：跟目標語言調整語序
- 保留：欄位名稱同業務意思
- 驗證：用產品實際採用嘅範本解析器
說明圖重繪 · 合成資料，唔係實際業務結果
一張交得出去嘅驗收單
將「訂單 {order_id} 已準備好。」連同示例資料交畀審核人，輸出應該包括 A-104，意思仍然係訂單已經準備好。之後再測試冇提供資料、較長編號，同產品支援嘅語言分支。我哋建議，將欄位規格約定檢查同語言審核分開記錄；任何一項失敗，都保留草稿。本文只執行咗簡單嘅 Python 合成測試，冇接入客戶系統，亦冇傳送通知。
- 欄位契約：必填欄位、範例輸出
- 語言審核：語序、意思、上下文
- 任何一項失敗 → 保留草稿，唔寄出去
說明圖重繪 · 合成資料，唔係實際業務結果