載入中
當 Claude 以工具使用請求回應時,您的伺服器需要實際執行所請求的工具並將結果傳回。此步驟涉及從 Claude 的回應中擷取工具使用部分、執行適當的函式,以及正確格式化結果。
處理多個工具請求
Claude 可以在單次回應中傳送多個工具使用部分。您的程式碼需要以防禦性的方式處理這種可能性。一則助理訊息可能包含一個文字部分,後面接著一個、兩個,甚至更多的工具使用部分。

整個流程是這樣運作的:Claude 傳送一個帶有 JSON schema 的請求、收到一個工具使用部分,接著您的伺服器執行該工具並傳回一個工具結果部分,讓 Claude 提供最終回應。

擷取工具使用部分
首先,建立一個函式來處理聊天請求所回傳的所有部分:
python
def run_tools(parts):
tool_requests = [part for part in parts if "toolUse" in part]
tool_result_parts = []
for tool_request in tool_requests:
tool_use_id = tool_request["toolUse"]["toolUseId"]
tool_name = tool_request["toolUse"]["name"]
tool_input = tool_request["toolUse"]["input"]這個推導式會篩選部分清單,只保留包含「toolUse」鍵的字典,忽略文字部分。
執行實際的工具
建立一個輔助函式來執行所請求的工具:
python
def run_tool(tool_name, tool_input):
if tool_name == "get_current_datetime":
return get_current_datetime(**tool_input)
else:
raise Exception(f"Unknown tool name: {tool_name}")這裡的關鍵細節是使用 **tool_input 將參數字典展開傳入您的工具函式。Claude 總是以字典物件的形式回傳引數,因此您需要正確地將其解包。
建立工具結果部分
執行工具後,您需要將回應格式化為工具結果部分:

工具結果部分需要三個關鍵屬性:
- toolUseId - 必須與原始工具使用部分的 ID 相符
- content - 您的工具輸出,序列化為字串
- status - 「success」或「error」其中之一
了解工具使用 ID
當 Claude 平行請求多個工具時,工具使用 ID 系統就變得很重要。舉例來說,如果 Claude 想要執行計算機工具兩次:

每次工具使用都會取得一個唯一的 ID(例如「ab3」和「po9」),而您的工具結果必須包含相符的 ID,以便 Claude 知道哪個結果對應哪個請求。
錯誤處理
將您的工具執行包裝在 try-catch 區塊中。Claude 對工具錯誤很聰明,如果您回傳適當的錯誤資訊,它可能會調整其做法:
python
try:
tool_output = run_tool(tool_name, tool_input)
tool_result_part = {
"toolResult": {
"toolUseId": tool_use_id,
"content": [{"text": json.dumps(tool_output)}],
"status": "success"
}
}
except Exception as e:
tool_result_part = {
"toolResult": {
"toolUseId": tool_use_id,
"content": [{"text": f"Error: {e}"}],
"status": "error"
}
}完整實作
以下是處理工具請求並回傳格式化結果的完整函式:
python
def run_tools(parts):
tool_requests = [part for part in parts if "toolUse" in part]
tool_result_parts = []
for tool_request in tool_requests:
tool_use_id = tool_request["toolUse"]["toolUseId"]
tool_name = tool_request["toolUse"]["name"]
tool_input = tool_request["toolUse"]["input"]
try:
tool_output = run_tool(tool_name, tool_input)
tool_result_part = {
"toolResult": {
"toolUseId": tool_use_id,
"content": [{"text": json.dumps(tool_output)}],
"status": "success"
}
}
except Exception as e:
tool_result_part = {
"toolResult": {
"toolUseId": tool_use_id,
"content": [{"text": f"Error: {e}"}],
"status": "error"
}
}
tool_result_parts.append(tool_result_part)
return tool_result_parts一旦您取得了工具結果部分,就可以在下一次聊天請求中將它們傳回給 Claude,完成工具使用循環。