載入中
載入中

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

在聊天中,使用者要求為下週四的醫生預約設定提醒,這個目標需要 3 到 4 個自訂工具。

解決方案是建立能處理這些特定任務的自訂工具。對於提醒系統,您需要三個獨立的工具:一個用來取得目前的日期和時間,另一個用來為日期加上持續時間,第三個則用來實際設定提醒。

為什麼這具有挑戰性

在處理與時間相關的任務時,Claude 有一些限制:

  • Claude 可能知道目前的日期,但不知道確切的時間
  • Claude 不一定能妥善處理時間加法,特別是在推算未來許多天的情況下
  • Claude 不知道如何設定提醒

使用者問「幫我設定醫生預約的提醒,是下週四。」AI 回答「好的,我會提醒您。」

您需要的工具

為了解決這些問題,您將建立三個專用工具:

  • 取得目前的日期時間 - Claude 需要知道目前的日期和時間
  • 為日期時間加上持續時間 - Claude 在日期時間加法上不夠完美
  • 設定提醒 - 需要一種設定提醒的方式

提醒系統所需的三個工具及每個工具的理由,如上所列。

工具函式如何運作

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

工具使用流程,標示每個步驟對應的程式碼,依序為:JSON schema、ToolUse 部分、工具函式、ToolResult 部分。

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

get_weather 工具函式範例:如果 location 為空,它會引發 ValueError,然後以 JSON 格式回傳天氣 API 的回應。

撰寫工具函式

工具函式是一般的 Python 函式,會在 Claude 判斷需要額外資訊以協助使用者時被執行。以下說明如何有效地撰寫它們:

最佳實務

  • 使用命名良好、具描述性的引數(這在之後會變得重要)
  • 驗證輸入,如果驗證失敗就引發錯誤
  • 回傳有意義的錯誤 - 如果 Claude 收到錯誤,它會嘗試第二次呼叫您的函式

筆記本儲存格中建立了一個 bedrock-runtime 的 boto3 用戶端,接著定義了 add_user_message、add_assistant_message 和 chat。

建立您的第一個工具

讓我們從最簡單的工具開始——取得目前的日期和時間。這個函式接受一個日期格式參數,並回傳目前的時間戳記:

python
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 該函式需要哪些引數,並協助它理解何時以及如何使用該工具。

筆記本儲存格中以日期格式「lkajsflkajsfd」呼叫 get_current_datetime,其輸出為「lkajsflkajsfd」。

JSON Schema 有兩個用途:它協助 Claude 理解您的函式需要哪些引數,而且它不僅僅是 LLM 的概念——JSON Schema 在許多程式設計情境中都普遍用於資料驗證。有許多線上工具可以協助您產生 schema。

Schema 最佳實務

  • 說明這個工具做什麼、何時使用它,以及它回傳什麼
  • 描述內容盡量以 3 到 4 句話為目標
  • 為參數提供詳細的描述

撰寫好工具函式並定義好 schema 之後,您就準備好將它與 Claude 整合,並開始建構更複雜的 AI 互動,以處理像設定提醒這樣的真實世界任務。