載入中
載入中

當 Claude 請求工具呼叫後,您需要執行該函式並將結果傳送回去。這樣便完成了工具使用的工作流程,為 Claude 提供其所請求的資訊。

執行工具函式

當 Claude 以工具使用區塊回應時,您需要擷取輸入參數並呼叫您的函式。以下說明如何存取工具參數:

python
# 存取工具使用區塊
tool_use_block = response.content[1]

# 取得輸入參數
input_params = tool_use_block.input

# 使用參數呼叫您的函式
result = get_current_datetime(**input_params)

雙星號(**)會將字典解包成您的函式所需的關鍵字引數。

工具結果區塊

執行工具後,您需要使用工具結果區塊將結果傳送回 Claude。此區塊有幾個重要屬性:

範例工具結果 JSON,類型為 "tool_result",內容為 "12:47:13",is_error 為 False,且 tool_use_id 相符。

  • tool_use_id - 必須與原始工具使用區塊中的 ID 相符
  • content - 您工具函式的輸出,已轉換為字串
  • is_error - 若執行過程中發生錯誤,則設為 true

處理多個工具呼叫

Claude 可以在單次回應中請求多個工具呼叫。舉例來說,若使用者詢問「10 + 10 是多少,30 + 30 又是多少?」,Claude 可能會傳送兩個獨立的工具使用區塊:

Claude 傳送計算機工具使用區塊 ab3(用於 10 + 10)與 po9(用於 30 + 30);結果先回傳 po9 的輸出 60,再回傳 ab3 的輸出 20。

每個工具使用區塊都會取得一個唯一的 ID,而您在傳回結果時必須將這些 ID 對應起來:

Claude 回傳工具使用 ab3(10 + 10)和 po9(30 + 30);我們的伺服器回應 po9 輸出 60,接著是 ab3 輸出 20。

此 ID 系統確保 Claude 能夠正確地將每個結果與其對應的請求配對,即使結果以不同的順序送達也是如此。

傳送後續請求

您傳送給 Claude 的後續請求,必須包含完整的對話歷史記錄,再加上新的工具結果:

python
messages.append({
    "role": "user",
    "content": [{
        "type": "tool_result",
        "tool_use_id": response.content[1].id,
        "content": result,
        "is_error": False
    }]
})

對話流程如下所示:

我們的伺服器傳送給 Claude 工具結構描述、問題「現在幾點?」、工具使用與工具結果區塊。

請記得在後續請求中包含工具結構描述,即使 Claude 很可能不需要再次呼叫工具。Claude 仍需要該結構描述,才能理解對話歷史記錄中所提及的工具。

完整工作流程

以下是完整流程:

  1. 使用者提出需要使用工具的問題
  2. Claude 以工具使用區塊回應
  3. 您執行所請求的工具函式
  4. 您傳送包含工具結果的後續請求
  5. Claude 使用工具輸出提供最終答案

最終的請求包含您完整的訊息歷史記錄、工具結果區塊,以及工具結構描述。接著,Claude 會以結合您工具執行結果資訊的一般文字訊息進行回應。