載入中
載入中

既然我們已經有一個工具可以運作了,現在該是時候新增其餘兩個工具以完成我們的專案:add_duration_to_datetime 和 set_reminder。好消息是,一旦您建立好基礎架構,新增工具就會變得很直接。

需要三個工具:取得目前日期時間、為日期時間加上持續時間(Claude 並不完全擅長此項操作),以及設定提醒。

預先建立的函式與結構描述

為了節省時間,我們已經提供了這兩個額外函式的實作,以及它們的 JSON 結構描述規格。您可以在先前的程式碼儲存格中找到它們:

  • add_duration_to_datetime - 處理各種時間單位的日期運算
  • set_reminder - 建立提醒(目前僅會列印輸出,但可以擴充以整合實際的提醒系統)

定義 add_duration_to_datetime 的筆記本儲存格,包含「seconds」、「days」和「months」等單位的分支。

每個函式都附有一個對應的 JSON 結構描述,用來定義預期的參數及其型別。

將工具新增到對話中

第一步是將新的工具結構描述納入您的對話函式中。在 run_conversation 函式中,將額外的結構描述新增到 tools 陣列裡:

python
tools=[
    get_current_datetime_schema,
    add_duration_to_datetime_schema,
    set_reminder_schema
]

run_conversation 儲存格將上述三個結構描述傳遞給 chat,然後持續迴圈直到停止原因不是「tool_use」為止。

連接工具函式

接下來,您需要更新 run_tool 函式以處理新的工具名稱。新增兩個額外的條件分支:

python
def run_tool(tool_name, tool_input):
    if tool_name == "get_current_datetime":
        return get_current_datetime(**tool_input)
    elif tool_name == "set_reminder":
        return set_reminder(**tool_input)
    elif tool_name == "add_duration_to_datetime":
        return add_duration_to_datetime(**tool_input)
    else:
        raise Exception(f"Unknown tool name: {tool_name}")

筆記本儲存格顯示上述的 run_tool 函式,接著是一個會收集 toolUse 部分的 run_tools 函式。

測試完整系統

在所有工具都連接完成後,您現在可以測試需要多次工具呼叫的複雜工作流程。舉例來說,要求 Claude「設定一個去看醫生的提醒。約診是在 100 天後」將會觸發一連串的操作:

  1. 使用 get_current_datetime 取得今天的日期
  2. 使用 add_duration_to_datetime 為該日期加上 100 天
  3. 使用 set_reminder 建立提醒

筆記本輸出:Claude 規劃步驟,然後印出 2025-07-12T00:00:00 的提醒「去看醫生約診」。

Claude 會自動將請求拆解為合乎邏輯的步驟,並在執行每個工具呼叫之前說明其計畫。輸出顯示了完整的工作流程,包括計算出的未來日期以及提醒已設定的確認訊息。

重點整理

一旦您建立好基礎的工具使用架構,新增工具就只需要兩個簡單的步驟:將結構描述納入您的 tools 陣列,以及在您的路由函式中新增一個案例來處理該工具名稱。初始設定可能會讓人感覺複雜,但擴展到多個工具之後,一切就會變得非常容易管理。