載入中
當您使用 Claude 的工具功能時,您會遇到一種與先前所見的簡單文字回應不同的新回應結構類型。Claude 現在不會只回傳單一的文字區塊,而是可以回傳包含文字和工具使用資訊的多區塊訊息。
發出啟用工具的 API 呼叫
若要讓 Claude 能夠使用工具,您需要在 API 呼叫中包含 tools 參數。以下是如何建構該請求:
python
messages = []
messages.append({
"role": "user",
"content": "What is the exact time, formatted as HH:MM:SS?"
})
response = client.messages.create(
model=model,
max_tokens=1000,
messages=messages,
tools=[get_current_datetime_schema],
)tools 參數接受一份 JSON schema 清單,用於描述 Claude 可以呼叫的可用函式。
了解多區塊訊息
當 Claude 決定使用工具時,它會回傳一則助理訊息,該訊息的內容清單中包含多個區塊。這與您先前所使用的簡單純文字回應相比,是一項重大的改變。

多區塊訊息通常包含:
- 文字區塊——說明 Claude 正在做什麼的人類可讀文字(例如「我可以幫您查詢目前的時間。讓我為您查一下這項資訊」)
- 工具使用區塊——提供給您的程式碼的指示,告知應呼叫哪個工具以及應使用哪些參數
工具使用區塊包含:
- 用於追蹤該次工具呼叫的 ID
- 要呼叫的函式名稱(例如「get_current_datetime」)
- 以字典格式呈現的輸入參數
- 類型標示「tool_use」
在多區塊訊息中管理對話歷史
請記住,Claude 並不會儲存對話歷史——您需要手動管理它。在處理工具回應時,您必須保留完整的內容結構,包括所有區塊。
以下是如何將多區塊的助理訊息正確附加到對話歷史中的方法:
messages.append({
"role": "assistant",
"content": response.content
})這會保留文字區塊和工具使用區塊兩者,這對於您在後續發出 API 呼叫時維持對話的上下文脈絡至關重要。
完整的工具使用流程

工具使用流程遵循以下模式:
- 將含有工具 schema 的使用者訊息傳送給 Claude
- 接收包含文字區塊和工具使用區塊的助理訊息
- 擷取工具資訊並執行實際的函式
- 將工具結果連同完整的對話歷史一起傳送回 Claude
- 接收來自 Claude 的最終回應
每個步驟都需要謹慎處理訊息結構,以確保 Claude 擁有提供準確回應所需的完整上下文。
更新輔助函式
如果您一直在使用像 add_user_message() 和 add_assistant_message() 這樣的輔助函式,您需要更新它們以處理多區塊內容。目前的版本可能只支援單一文字區塊,但現在它們需要能夠容納更複雜的內容結構,包括工具使用區塊。
這種多區塊訊息處理方式,對於建構能夠無縫整合 Claude 工具能力、同時維持正確對話流程的強健應用程式而言,是不可或缺的。