載入中
載入中

現在我們來到工具使用工作流程的最後一步。在執行完工具並取得結果之後,我們需要將所有內容傳回給 Claude,讓它能夠為使用者提供完整的回應。

我們的伺服器傳送 Claude「現在幾點?」,助理文字與工具使用部分,接著是帶有工具結果的使用者訊息。

這個流程很直接:取出我們產生的所有工具結果部分,將它們打包成一則使用者訊息,並連同原始的工具架構一起,將整個對話歷史傳回給 Claude。

新增助理訊息

首先,我們需要確保我們的對話歷史是完整的。在 Claude 最初回應工具使用請求之後,我們需要使用 add_assistant_message() 將該回應加入到我們的訊息歷史中。

助理訊息包含一個文字部分和一個 toolUse 部分,在我們伺服器傳送給 Claude 的歷史中被標示出來。

這確保了我們擁有完整的對話流程:使用者問題 → 助理工具請求 → 工具結果 → 最終助理回應。

執行工具並建立工具結果

run_tools() 函式會處理 Claude 回應中所有的工具使用請求,並建立格式正確的工具結果部分。每個工具結果都包含:

  • 工具使用 ID(與原始請求相符)
  • 執行該工具所得到的實際輸出
  • 表示成功或錯誤的狀態

Notebook 程式碼在 try 區塊中呼叫 run_tool,並將輸出的 json.dumps 或錯誤文字放入每個 toolResult 中。

此函式能優雅地處理成功的工具執行和錯誤,將所有內容包裝成 Claude 所預期的正確 JSON 結構。

將工具結果加入對話

一旦我們有了工具結果,就使用 add_user_message() 將它們加入對話中:

python
add_user_message(messages, run_tools(parts))

這會建立一則包含所有工具結果部分的使用者訊息。現在對話已經具備 Claude 提供最終回應所需的完整往返內容。

列印出的訊息清單共有三則訊息,最後以使用者工具結果「2025-04-03 12:54:00」、狀態為「success」結束。

最後呼叫 Claude

最後一步是將所有內容傳回給 Claude。這需要兩個重要元素:

  • 完整的訊息歷史(使用者 → 助理 → 使用者)
  • 原始的工具架構
python
text, parts = chat(messages, tools=[get_current_datetime_schema])

包含工具架構至關重要。如果沒有它們,Claude 會對對話歷史中的工具引用感到困惑,也無法理解 get_current_datetime 實際上做了什麼。

訊息清單以工具結果「2025-04-03 12:54:00」和狀態「success」結束,接著該儲存格再次呼叫 chat。

成功

當一切運作正常時,Claude 會收到工具結果,並能提供完整且資訊充足的回應。在我們的範例中,Claude 成功取得了目前的時間,並以自然的方式在回應中呈現:「目前的日期與時間是 2025-04-03,12:54:00。」

這證明了我們的工具整合運作正常。雖然 Claude 知道目前的日期,但它並沒有取得即時資訊(例如確切的目前時間)的能力——而這正是我們的工具所提供的。

現在,完整的工具使用循環已經可以運作了:Claude 請求使用工具,我們執行它,回傳結果,然後 Claude 將這些資訊納入它給使用者的最終回應中。