TypeSafe Python SDK 0.7.0 為 Jev 加入型別化回覆，序列化改用 Pydantic

TypeSafe AI 在 9 月 18 日發布 Python SDK 0.7.0，替 Jev 決策模型加入可指定回覆型別的介面，同時將序列化與反序列化由 msgspec 改為 Pydantic。官方將後者列為破壞性變更，PyPI 也確認同日上架套件；已串接分類、路由或評分流程的開發者需要檢查相容性。[版本紀錄](https://docs.typesafe.ai/sdk/python/changelog)、[套件發布資料](https://pypi.org/project/typesafe-sdk/0.7.0/)

Jev 接收一份文字或結構化狀態，以及程式預先定義的問題。Choice 從選項中選擇並回傳機率分布，Score 對有序等級評分，Noul 則回傳命題成立的機率；三種問題可以放在同一次請求，各自對同一份狀態求值。這種介面適合把語意判斷接入既有程式分支。[模型介面](https://docs.typesafe.ai/introduction)

新版的具體變化，是 `system_one` 多了 `response_model` 參數。開發者可繼承 `SystemOneResponse` 宣告具名答案欄位，也可自行定義 Pydantic 模型，將原本透過字典索引取得的答案轉成型別化屬性，方便後續檢查與使用。這改善的是客戶端資料契約，判斷內容的正確性仍需另外評測。[使用範例](https://docs.typesafe.ai/sdk/python/usage)

遷移時還有兩個容易忽略的細節。0.7.0 修正字串子類別被編碼成字元列表的錯誤；若從更早版本跨級升級，也會遇到 0.6.0 已把 Score 的評分標準改為有序序列，不再接受整數鍵字典。既有請求樣本、回覆處理與自訂序列化流程都值得重播驗證。[相容性變更](https://docs.typesafe.ai/sdk/python/changelog)

型別化輸出也不能取代決策門檻校準。官方說明，Choice 與 Score 的信心值是由機率分布計算出的統計量；Noul 沒有同樣欄位。已知限制更指出，相同問題改用不同原語，數值未必可直接比較，否定問題的機率也不保證與原問題相加為一。[信心值定義](https://docs.typesafe.ai/confidence)、[已知限制](https://docs.typesafe.ai/model-jaggedness/jev-1.13)

中文應用尤其需要自建測試集：官方明列英文是主要訓練語言，中文等語言表現並不相同，對抗性輸入也可能改變判斷。工程上應保留拒絕或轉人工路徑，把算術與日期比較留給程式，並在調好門檻後固定模型版本，避免別名更新改變行為。驗收時應分別量測分類誤差、轉人工比例與端到端延遲，才能判斷這次介面更新對實際工作流的價值。[語言與版本政策](https://docs.typesafe.ai/models)、[輸入風險](https://docs.typesafe.ai/model-jaggedness/jev-1.13)