載入中

傳送工具結果

第 25 課10 分鐘
載入中

當 Claude 請求呼叫工具後,您需要執行該函式並將結果傳回。這會透過提供 Claude 所要求的資訊,完成整個工具使用流程。

執行工具函式

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

python
response.content[1].input

這會提供您一個字典,內含 Claude 想要傳遞給您函式的引數。由於您的函式預期接收的是關鍵字引數而非字典,因此您可以使用 Python 的解包語法:

python
get_current_datetime(**response.content[1].input)

筆記本儲存格執行上述解包呼叫,並回傳時間字串「14:41:05」。

工具結果區塊

執行完工具函式後,您需要使用工具結果區塊將結果傳回給 Claude。此區塊會放在使用者訊息中,並告知 Claude 執行該工具時發生了什麼事。

工具結果 JSON 範例,type 為「tool_result」,content 為「12:47:13」,is_error 為 False,並帶有相符的 tool_use_id。

工具結果區塊有幾個重要的屬性:

  • tool_use_id - 必須與此 ToolResult 所對應的 ToolUse 區塊的 id 相符
  • content - 執行您工具後的輸出,以字串形式序列化
  • is_error - 若發生錯誤則為 True

處理多個工具呼叫

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

Claude 傳送計算機工具使用區塊 ab3(用於 10 + 10)與 po9(用於 30 + 30);結果依序為 po9 輸出 60,接著 ab3 輸出 20。

每個工具呼叫都會取得一個唯一的 ID,而您在傳回結果時必須比對這些 ID。這可確保 Claude 知道哪個結果對應哪個請求,即使結果是以不同順序到達也一樣。

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

建立後續請求

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

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

完整的訊息歷史記錄現在包含:

  • 原始使用者訊息
  • 含有工具使用區塊的助理訊息
  • 含有工具結果區塊的使用者訊息

發出最終請求

在傳送後續請求時,即使您並不預期 Claude 會再次呼叫工具,您仍必須包含工具結構描述(tool schema)。Claude 需要此結構描述才能理解您對話歷史記錄中所提及的工具。

python
client.messages.create(
    model=model,
    max_tokens=1000,
    messages=messages,
    tools=[get_current_datetime_schema]
)

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

Claude 接著會回應一則最終訊息,將工具結果整合成自然的回覆呈現給使用者。此時工具使用流程已完成——您已成功讓 Claude 能透過您的自訂函式存取即時資訊。