Claude Fable 5.2 結構化輸出:無需強制使用工具即可生成可靠的 JSON
使用 Claude Fable 5.2 生成符合 schema 的 JSON 和可靠的工具參數,搭配 JSON 輸出、嚴格的工具使用與本地語意驗證

Claude Fable 5.2 不支援將 tool_choice 設為 any 或指定 tool 名稱的強制工具選擇;這些設定會回傳 400 錯誤。但這並不影響可靠的自動化。請根據您需要的合約使用正確的功能:
- JSON 輸出限制了模型的最終回應。
- 嚴格的工具使用會驗證 Claude 選擇進行的任何工具呼叫的名稱和輸入。
- 當代理需要可靠的函數參數和結構化的最終結果時,兩者皆可使用。
結構有效性不等於事實或業務有效性。您的應用程式仍須檢查權限、識別碼、日期、總計,以及某項動作是否允許。
選項 1:JSON 輸出
當回應本身必須遵循 JSON Schema 時,請使用 output_config.format。
from anthropic import Anthropic
client = Anthropic()
schema = {
"type": "object",
"properties": {
"風險等級": {
"type": "字串",
"enum": ["低", "中等", "高"]
},
"findings": {
"type": "array",
"items": {
"type": "object",
"properties": {
"claim": {"type": "字串"},
"source": {"type": "字串"}
},
"必填": ["聲明", "來源"],
"additionalProperties": False
}
}
},
"必填": ["risk_level", "發現"],
"additionalProperties": False
}
= client.messages.create(
model="claude-fable-5-2",
max_tokens=4096,
messages=[{
"role": "使用者",
"content": "評估所提供的變更日誌,並為每項發現引用證據。"
}],
output_config={
"format": {
"type": "json_schema",
"schema": 結構描述
}
}
)
目前的正式欄位是 output_config.format。較舊的測試版範例可能使用 output_format;請更新 SDK 和請求格式,而非複製過渡時期的程式碼。
選項 2:嚴格的工具使用
在工具定義中設定 strict: true,以確保 Claude 呼叫工具時,工具輸入與其架構相符。將 tool_choice 保持為 auto。
tools = [{
"name": "create_review_ticket",
"description": "僅在使用者批准後才建立審核單。",
"strict": True,
"input_schema": {
"type": "object",
"properties": {
"title": {"type": "字串"},
"severity": {
"type": "字串",
"enum": ["低", "中等", "高"]
},
"evidence_ids": {
"type": "陣列",
"items": {"type": "字串"}
}
},
"必填": ["標題", "嚴重程度", "evidence_ids"],
"additionalProperties": False
}
}]
嚴謹性保證形狀,而非授權。伺服器仍須確認使用者已核准該動作,且每個證據ID皆存在。
請勿隨意模擬強制工具使用
若當前回合需要特定工具,請明確指示模型,並在可用的情況下使用支援的對話中系統引導。您的編排層應隨後驗證是否發生了預期的呼叫。請勿將自由格式文字作為備用方案執行。
如果真正的需求是「回傳有效的 JSON」,請使用 JSON 輸出,而不是自創一個虛假的工具。
為模型與應用程式可靠性設計架構
保持綱要狹窄
使用有意義的列舉、必填欄位,以及 additionalProperties: false。避免使用通用的「中繼資料」物件,以免隱藏任意內容。
將證據與結論分開
要求提供來源識別碼或摘錄以佐證發現。若無佐證資料,即使 high 值有效,仍視為不支援。
明確表示不確定性
使用如 status: confirmed | inferred | unresolved 等欄位,而非將不確定的證據強制轉為明確的布林值。
解析後驗證語意
在應用程式碼中檢查範圍、資料庫是否存在、權限、貨幣一致性及跨欄位規則。目前的結構化輸出支援存在 JSON Schema 限制,包括不支援遞迴結構,以及對數值、字串、陣列和正則表達式的約束有所限制。
快取與代幣考量
結構化輸出會將格式指引注入系統提示中,略微增加輸入令牌。變更 output_config.format 會使該對話的提示快取失效。請對架構進行版本管理,並避免為每個請求產生略有差異的架構。
加密金鑰限制
Anthropic 文件指出,使用客戶管理加密金鑰的組織無法在 Claude Fable 5.2 或 Mythos 5.2 中使用結構化輸出。這包括 JSON 輸出和嚴格的工具使用。在該配置下,請使用自動工具選擇、省略 strict、在本機驗證輸入,並設計安全的重試或修復路徑。
錯誤處理策略
- 在發送前驗證該架構。
- 將不支援的結構描述功能視為開發錯誤,而非暫時性失敗。
- 在檢查 API 結果後,才解析回應。
- 在本機端驗證業務規則。
- 絕不單因 JSON 已解析就執行工具。
- 記錄日誌結構版本與請求 ID。
常見問題
為什麼 tool_choice: {"type":"工具"}在 Fable 5.2 上失敗?
不支援強制 tool 和 any 選項。請使用帶有嚴格工具使用的自動模式、JSON 輸出,或支援的編排指令。
有效的 JSON 是否代表答案正確?
不。它保證的是格式,而非真實性、證據、授權或安全的商業行為。
能否同時使用 JSON 輸出與嚴格工具?
是的,在帳戶配置支援結構化輸出的情況下。它們控制互動的不同部分。


















































































































