用 OpenRouter 將客戶回饋轉成工單:讓路由規則配合 JSON 驗收
將客戶回饋轉成工單欄位時,OpenRouter 的模型選擇只是其中一步。先定義驗收結構,再限制使用支援所需參數的供應商,並將失敗項目留在待處理佇列,才能避免格式正確、內容卻有誤的結果直接進入業務系統。
營運團隊若要將客戶回饋自動整理成工單,真正需要的是穩定的欄位與可追溯的原文,而不是一段流暢的摘要。OpenRouter 可以為模型請求選擇供應商,但接收系統仍須決定哪些結果能寫入資料庫。適合先建立一條受控流程:去識別化的回饋進入佇列,由模型擷取欄位、程式驗收、人工處理例外,最後才建立工單。以下依據官方文件設計這條流程,並非實際執行測試的結果。
先由工單系統定義交付內容
以一則「匯出失敗,請盡快處理」的回饋為例,可以要求輸出來源編號、問題類別、摘要與原文依據。未明確指定負責人或截止日期時,應保留空值,不能讓模型自行補成承諾。欄位名稱、允許的類別、必填項目與空值規則,應先由接收工單的團隊確認,再寫入 JSON Schema。
這裡有兩層驗收。結構層檢查結果是否為合法 JSON,以及欄位型別與列舉值是否符合約定;業務層檢查摘要是否忠於原文、來源編號是否相符,以及是否憑空提高緊急程度。建議先準備一小組已去識別化的樣本,涵蓋一般回饋、資訊不足與內容互相矛盾的情況,並由人工標示可接受的結果。樣本數量應由業務風險決定,不應將某個固定數量視為可靠性的證明。
將結構要求納入路由
OpenRouter 的結構化輸出文件指出,支援情況取決於個別端點;同一模型由不同供應商提供時,能力也可能不同。因此應在模型頁面查看供應商的 structured_outputs 支援資訊,而不是只記錄模型名稱。
若採用 Chat Completions API,請在請求中使用 response_format,將 type 設為 json_schema,並在 json_schema 中提供名稱、strict 與具體的 schema。接著將供應商偏好設定中的 require_parameters 設為 true。官方指南建議採用這個組合,將參數支援納入路由條件。這有助於排除不支援所需參數的端點,但無法代替你判斷工單內容是否屬實。
先用選定的模型與核准的供應商執行樣本,保存請求設定與驗收結果;更換模型、供應商或 schema 後,應重新檢查。這些是上線前的建議作法,並非本文已取得的測試成果。
為故障切換設定界線
供應商路由文件中,allow_fallbacks 預設為 true,order 則用於指定嘗試順序。優先順序清單本身不應被視為採購核准名單。若只有指定供應商可以處理這些資料,請用 only 限定允許範圍;若需要關閉向其他供應商備援切換的功能,再明確設定 allow_fallbacks: false。
這會縮小可用端點的範圍。官方錯誤說明列出了沒有供應商符合路由條件的失敗情況,因此業務流程必須接受「暫時沒有結果」,不能只為了清空佇列就自動放寬限制。待處理紀錄應保留來源編號、嘗試次數與錯誤原因,交由負責人員判斷要等待重試、修正輸入,還是人工建立工單。特定資料是否獲准傳送給 OpenRouter 與對應供應商,也必須遵循團隊本身的資料審核要求。
通過驗收後才寫入,重試前先檢查是否重複
API 回傳後,先檢查錯誤,再解析並驗證內容。OpenRouter 的錯誤文件提醒,模型開始生成之後發生的錯誤,可能出現在回應本文或串流事件中,不能只憑 HTTP 狀態判斷成功。對於批次整理回饋,初版可以先採用非串流呼叫,減少因不完整內容而誤觸發後續動作的機會。
建議將「擷取完成」與「工單建立完成」分成兩個狀態。只有結構與業務檢查都通過,才能進入建立步驟;以來源編號記錄對應工單,寫入結果不明確時,先查詢接收系統,再決定是否重試,避免同一則回饋產生重複工單。缺少欄位、依據不足或互相矛盾的結果應留給人工處理,不要用自動重試掩蓋內容問題。
這條流程的好處,是將多供應商選擇與工單驗收分開管理。代價是仍須維護 schema、樣本與例外佇列。如果回饋量很少,也沒有人維護驗證邏輯,繼續由人工整理可能更划算;如果只需要固定的單一供應商,也應比較直接串接的維護成本。採用 OpenRouter 的前提,是團隊確實需要路由選擇,並願意將驗收責任留在自己的業務流程中。
內容說明:本文基於公開資料整理,僅供工具選型參考。產品功能、價格及相關政策可能隨時調整,請以官方最新資訊為準。
原文出處:openrouter.ai