載入中
當您需要從 Claude 取得結構化資料時,有兩種主要方法可供選擇:使用訊息預填與停止序列的基於提示的技術,或是使用工具的更穩健方法。雖然基於提示的方法設定較為簡單,但工具能提供更可靠的輸出,代價是增加了一些複雜性。
用於結構化資料的工具
基於工具的方法是透過建立一個 JSON schema 來定義您想要擷取的資料的確切結構。您不必寄望 Claude 能正確格式化其回應,而是實際上給予 Claude 一個可以呼叫的函式,該函式帶有符合您所需輸出結構的特定參數。

以下是此流程的運作方式:
- 撰寫一個描述您所需資料結構的 schema
- 使用
tool_choice參數強制 Claude 使用工具 - 從工具使用回應中擷取結構化資料
- 不需要提供後續回應——一旦取得資料就完成了
舉例來說,如果您想從一份報表中擷取財務餘額與關鍵見解,您的 schema 會分別將它們定義為整數與字串陣列。
控制工具使用
此技術的一個關鍵部分是確保 Claude 確實會呼叫您的工具。您可以使用 tool_choice 參數來控制此行為:

{"type": "auto"}- 模型自行決定是否需要使用工具(預設值){"type": "any"}- 模型必須使用工具,但可以選擇使用哪一個{"type": "tool", "name": "TOOL_NAME"}- 模型必須使用指定的工具
對於結構化資料擷取,您通常會想要第三個選項,以保證 Claude 會呼叫您的特定 schema 工具。
實作範例
假設您想從一篇文章中擷取標題、作者以及關鍵見解。首先,您要建立一個工具 schema:
python
article_summary_schema = {
"name": "article_summary",
"description": "Extracts structured data from articles",
"input_schema": {
"type": "object",
"properties": {
"title": {"type": "string"},
"author": {"type": "string"},
"key_insights": {
"type": "array",
"items": {"type": "string"}
}
}
}
}接著您要呼叫 Claude 並帶上該工具,強制使用它:
python
response = chat(
messages,
tools=[article_summary_schema],
tool_choice={"type": "tool", "name": "article_summary"}
)回應中會包含一個工具使用區塊,其中您的結構化資料位於 input 欄位。您可以直接存取它:
python
structured_data = response.content[0].input何時使用各種方法
當您需要快速且簡單的方式時,選擇基於提示的結構化輸出。當您需要保證可靠性,並且能承擔額外的設定複雜性時,就使用工具。這兩種技術各有其價值,取決於您的特定使用情境與需求。