載入中
載入中

一旦您具備核心的工具處理基礎架構,在 Claude 實作中加入多個工具就會變得輕而易舉。本教學將示範如何依循簡單的模式來整合額外的工具。

我們需要的三個工具:取得目前日期時間、將時間長度加到日期時間,以及設定提醒,說明如下。

我們要加入的工具

我們的提醒系統需要三項主要功能:

  • 取得目前日期時間 — Claude 需要知道目前的日期與時間
  • 將時間長度加到日期時間 — Claude 在日期時間的加法運算上並不完美
  • 設定提醒 — 需要一種方式來設定提醒

好消息是,大部分的實作工作都已經完成了。add_duration_to_datetime 函式與 set_reminder 函式都已提供,連同它們對應的結構描述(schema)。

在對話中加入工具

首先,更新 run_conversation 函式,將新的工具結構描述加入工具清單中:

python
response = chat(messages, tools=[
    get_current_datetime_schema,
    add_duration_to_datetime_schema,
    set_reminder_schema
])

這會告知 Claude 在對話過程中可以使用的全部三個可用工具。

更新工具路由器

接下來,修改 run_tool 函式以處理新的工具呼叫。為每個新工具新增 elif 分支:

python
def run_tool(tool_name, tool_input):
    if tool_name == "get_current_datetime":
        return get_current_datetime(**tool_input)
    elif tool_name == "add_duration_to_datetime":
        return add_duration_to_datetime(**tool_input)
    elif tool_name == "set_reminder":
        return set_reminder(**tool_input)

這個模式很簡單:檢查工具名稱,以提供的輸入呼叫對應的函式,然後回傳結果。

測試多個工具的使用

若要測試此系統,請嘗試需要使用多個工具的請求:「幫我設定一個看醫生預約的提醒。那是 2050 年 1 月 1 日之後的 177 天。」

這個請求會促使 Claude:

  1. 計算日期(使用 add_duration_to_datetime)
  2. 設定提醒(使用 set_reminder)

Notebook 輸出中,set_reminder 印出「Setting the following reminder for 2050-06-27T00:00:00: Doctor's appointment」。

Claude 的處理方式是先說明它需要做什麼,接著依序進行適當的工具呼叫。該對話顯示 Claude 計算出目標日期為 2050 年 6 月 27 日,然後將提醒設定在該日期。

了解訊息流程

當您檢視對話歷史時,會看到完整的訊息結構:

  • 包含請求內容的使用者訊息
  • 同時包含文字與工具使用區塊的助理訊息
  • 工具結果訊息
  • 後續的助理訊息

每則助理訊息都將一個 TextBlock 與一個 ToolUseBlock 配對,而其中一個工具結果為「Monday, June 27, 2050 12:00:00 AM」。

這示範了 Claude 如何在單一訊息中包含多個區塊——將說明性文字與工具使用請求結合在一起。

加入工具的簡單模式

一旦您具備核心的工具基礎架構,加入新工具就遵循以下模式:

  1. 建立工具函式的實作
  2. 定義工具結構描述
  3. 將該結構描述加入 run_conversation 中的工具清單
  4. 在 run_tool 中為該工具新增一個分支

這種模組化的做法讓您能輕鬆擴充 AI 助理的功能,而不需要重構現有的程式碼。每個新工具都能與現有的對話流程及工具處理邏輯無縫整合。