為 Claude 建構工具需要解決幾個不是一眼就能看出來的挑戰。當您想讓 Claude 為未來的日期設定提醒時,您很快就會發現,雖然 Claude 知道目前的日期,但它不一定知道確切的時間,在複雜的日期運算方面也有困難,而且沒有內建的方式可以實際設定提醒。

解決方案是建立能處理這些特定任務的自訂工具。對於提醒系統,您需要三個獨立的工具:一個用來取得目前的日期和時間,另一個用來為日期加上持續時間,第三個則用來實際設定提醒。
為什麼這具有挑戰性
在處理與時間相關的任務時,Claude 有一些限制:
- Claude 可能知道目前的日期,但不知道確切的時間
- Claude 不一定能妥善處理時間加法,特別是在推算未來許多天的情況下
- Claude 不知道如何設定提醒

您需要的工具
為了解決這些問題,您將建立三個專用工具:
- 取得目前的日期時間 - Claude 需要知道目前的日期和時間
- 為日期時間加上持續時間 - Claude 在日期時間加法上不夠完美
- 設定提醒 - 需要一種設定提醒的方式

工具函式如何運作
工具系統在您的伺服器與 Claude 之間遵循特定的流程。您撰寫函式,讓 Claude 在需要額外資訊時可以呼叫,而 Claude 會收到結果以協助它擬定回應。

這個流程包含數個步驟:撰寫工具函式、建立 JSON schema 規格、用該 schema 呼叫 Claude、在 Claude 要求時執行工具,以及將結果回傳給 Claude。

撰寫工具函式
工具函式是一般的 Python 函式,會在 Claude 判斷需要額外資訊以協助使用者時被執行。以下說明如何有效地撰寫它們:
最佳實務
- 使用命名良好、具描述性的引數(這在之後會變得重要)
- 驗證輸入,如果驗證失敗就引發錯誤
- 回傳有意義的錯誤 - 如果 Claude 收到錯誤,它會嘗試第二次呼叫您的函式

建立您的第一個工具
讓我們從最簡單的工具開始——取得目前的日期和時間。這個函式接受一個日期格式參數,並回傳目前的時間戳記:
from datetime import datetime, timedelta
def get_current_datetime(date_format="%Y-%m-%d %H:%M:%S"):
return datetime.now().strftime(date_format)這個函式很簡單,但遵循了幾項關鍵原則:它有一個具描述性的名稱,接受一個命名良好且具有合理預設值的參數,並且確切地回傳它所承諾的內容。
JSON Schema 規格
一旦您有了函式,就需要撰寫一個 JSON Schema 來向 Claude 描述它。這個 schema 告訴 Claude 該函式需要哪些引數,並協助它理解何時以及如何使用該工具。

JSON Schema 有兩個用途:它協助 Claude 理解您的函式需要哪些引數,而且它不僅僅是 LLM 的概念——JSON Schema 在許多程式設計情境中都普遍用於資料驗證。有許多線上工具可以協助您產生 schema。
Schema 最佳實務
- 說明這個工具做什麼、何時使用它,以及它回傳什麼
- 描述內容盡量以 3 到 4 句話為目標
- 為參數提供詳細的描述
撰寫好工具函式並定義好 schema 之後,您就準備好將它與 Claude 整合,並開始建構更複雜的 AI 互動,以處理像設定提醒這樣的真實世界任務。