載入中

用於結構化資料的工具

第 31 課9 分鐘
載入中

當您需要從 Claude 取得結構化資料時,有兩種主要方法可供選擇:使用訊息預填與停止序列的基於提示的技術,或是使用工具的更穩健方法。雖然基於提示的方法設定較為簡單,但工具能提供更可靠的輸出,代價是增加了一些複雜性。

用於結構化資料的工具

基於工具的方法是透過建立一個 JSON schema 來定義您想要擷取的資料的確切結構。您不必寄望 Claude 能正確格式化其回應,而是實際上給予 Claude 一個可以呼叫的函式,該函式帶有符合您所需輸出結構的特定參數。

financial_analysis_schema 工具定義,包含一個整數「balance」以及一個字串陣列「key_insights」。

以下是此流程的運作方式:

  • 撰寫一個描述您所需資料結構的 schema
  • 使用 tool_choice 參數強制 Claude 使用工具
  • 從工具使用回應中擷取結構化資料
  • 不需要提供後續回應——一旦取得資料就完成了

舉例來說,如果您想從一份報表中擷取財務餘額與關鍵見解,您的 schema 會分別將它們定義為整數與字串陣列。

控制工具使用

此技術的一個關鍵部分是確保 Claude 確實會呼叫您的工具。您可以使用 tool_choice 參數來控制此行為:

三種 tool_choice 選項,「auto」、「any」與帶有工具名稱的「tool」,以及下方列出的每種選項對工具使用的影響。

  • {"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

何時使用各種方法

當您需要快速且簡單的方式時,選擇基於提示的結構化輸出。當您需要保證可靠性,並且能承擔額外的設定複雜性時,就使用工具。這兩種技術各有其價值,取決於您的特定使用情境與需求。