載入中
載入中

在使用 Claude 建構 AI 應用程式時,您經常需要讓它存取即時資訊或執行操作的能力。這就是工具函數派上用場的地方——它們是 Claude 在需要額外數據來協助使用者時可以呼叫的 Python 函數。

Claude 需要知道目前的日期和時間,對日期時間的加法不太擅長,我們需要一種方式來設定提醒。

上圖顯示了我們將要實作的三個重要工具:取得目前日期/時間、在日期上加上一段時長,以及設定提醒。讓我們先從第一個開始。

什麼是工具函數?

工具函數是一個普通的 Python 函數,當 Claude 判斷需要額外資訊來協助使用者時,就會自動執行它。舉例來說,如果有人問「現在幾點?」,Claude 就會呼叫您的日期/時間工具來取得目前時間。

get_weather 函數:如果 location 為空,則會引發 ValueError,接著呼叫天氣 API 並回傳 JSON。

這是一個天氣工具函數的範例。請注意它是如何驗證輸入並提供清楚的錯誤訊息的——這些都是重要的最佳實踐。

工具函數的最佳實踐

撰寫工具函數時,請遵循以下準則:

  • 使用具描述性的名稱:您的函數名稱與參數名稱都應清楚表明其用途
  • 驗證輸入:檢查必要的參數是否為空或無效,若是則引發錯誤
  • 提供有意義的錯誤訊息:Claude 能看到錯誤訊息,並可能會以修正後的參數重新嘗試呼叫函數

驗證之所以特別重要,是因為 Claude 會從錯誤中學習。如果您引發一個清楚的錯誤,例如「Location cannot be empty」,Claude 就可能會嘗試使用正確的地點值再次呼叫該函數。

建構您的第一個工具函數

讓我們建立一個取得目前日期和時間的函數。這個函數會接受一個日期格式參數,好讓 Claude 能夠以不同的格式請求時間:

python
from datetime import datetime

def get_current_datetime(date_format="%Y-%m-%d %H:%M:%S"):
    if not date_format:
        raise ValueError("date_format cannot be empty")
    return datetime.now().strftime(date_format)

這個函數使用 Python 的 datetime 模組來取得目前時間,並依照提供的格式字串進行格式化。預設格式會給我們「年-月-日 時:分:秒」的結果。

您可以用不同的格式來測試它:

python
# 預設格式:「2024-01-15 14:30:25」
get_current_datetime()

# 僅小時與分鐘:「14:30」
get_current_datetime("%H:%M")

這項驗證檢查可確保 Claude 無法傳入空字串作為日期格式。雖然這個特定的錯誤不太可能發生,但它示範了驗證輸入並提供有助於 Claude 學習的錯誤訊息的模式。

後續步驟

建立函數只是第一步。接下來,您需要撰寫一個 JSON schema 來向 Claude 描述該函數,然後將其整合到您的聊天系統中。這種工具函數的做法讓 Claude 擁有強大的能力,同時也讓您的程式碼保持井然有序且易於維護。