Claude Platform Docs
Messages工具基礎架構

工具組合

適用於研究代理、程式開發代理與長時間執行代理的常見 Anthropic 工具搭配。

Anthropic 提供的工具在設計上即可相互搭配運作。常見的代理模式會將涵蓋工作流程中互補階段的工具配對使用:一個工具負責蒐集或探索,另一個工具負責處理或執行動作。以下的組合是起點,而非硬性規定。請依您的任務需求自由混搭。

每個程式碼片段僅顯示 tools 陣列。完整的請求結構請參閱處理工具呼叫

研究代理:web_search + code_execution

搜尋負責尋找來源;程式碼執行負責分析與彙整。Claude 會先搜尋資料,接著撰寫 Python 來處理、製表或視覺化這些資料。這個搭配非常適合同時需要最新資訊以及對該資訊進行非簡單運算的問題,例如「比較本季前五大雲端供應商的營收」。

{
  "tools": [
    { "type": "web_search_20260209", "name": "web_search" },
    { "type": "code_execution_20260521", "name": "code_execution" }
  ]
}

流程通常是先搜尋、再執行,若第一輪發現資訊缺口,則可選擇再次搜尋。程式碼執行在伺服器端運行,因此無需管理用戶端沙箱。

程式開發代理:text_editor + bash

文字編輯器負責讀取與修改檔案;bash 負責執行測試與建置指令。這是典型的軟體開發循環:檢視程式碼、進行編輯、執行測試、重複。這兩個工具皆由用戶端執行,因此您的應用程式可控制哪些檔案與指令可供存取。

{
  "tools": [
    { "type": "text_editor_20250728", "name": "str_replace_based_edit_tool" },
    { "type": "bash_20250124", "name": "bash" }
  ]
}

若代理會操作不受信任的程式碼,請搭配受限的工作目錄與指令允許清單使用。執行契約請參閱文字編輯器工具Bash 工具

先引用後擷取:web_search + web_fetch

搜尋負責找出候選 URL;擷取負責取得相關網頁的完整內容。這可避免一開始就擷取所有內容。Claude 會執行搜尋、檢視摘要片段、挑選出兩三個看起來確實相關的結果,然後只擷取這些結果。

{
  "tools": [
    { "type": "web_search_20260209", "name": "web_search" },
    { "type": "web_fetch_20260209", "name": "web_fetch" }
  ]
}

當答案存在於搜尋摘要片段無法完整呈現的長篇內容(文件頁面、文章、規格書)中時,這個搭配特別有用。擷取會取回完整頁面,讓 Claude 能夠引用特定段落。

長時間執行代理:memory + 任何其他工具

記憶體負責跨對話保存狀態;其他工具負責執行工作。任何需要記住先前工作階段的代理都可加入記憶體,例如能回想客戶先前問題的客服代理,或追蹤上週所做決策的專案助理。

{
  "tools": [{ "type": "memory_20250818", "name": "memory" }]
}

請將您的其他工具與 memory 一同加入同一個陣列中。

記憶體與您的其他工具彼此獨立。它不會改變其他工具的行為;它為 Claude 提供一個地方,可以記下並在之後取回那些原本會在「context window」(上下文視窗)重置時遺失的事實。儲存模型請參閱記憶體工具

全方位:computer_use

電腦使用工具透過操作完整的桌面環境,涵蓋了大多數其他工具的功能。Claude 會查看螢幕截圖並發出滑鼠與鍵盤動作,這表示它可以操作任何人類能操作的應用程式。當任務需要更專門的工具無法觸及的任意 GUI 互動時,請使用此工具:沒有 API 的舊版軟體、視覺驗證步驟,或橫跨多個桌面應用程式的工作流程。

{
  "tools": [{ "type": "computer_toolset_20260801" }]
}

此工具集項目不需要 name 或顯示尺寸:座標以您回傳的螢幕截圖之像素空間表示,且您可以透過該項目的 configs 欄位關閉個別動作。

電腦使用是最通用的選項,同時也是最慢的,因為 Claude 通常在每批動作之後都需要一張新的螢幕截圖。當較專門的工具能涵蓋您的使用情境時,請優先使用它們;當沒有其他工具適用時,再採用電腦使用。若任務完全在網頁瀏覽器內進行,請使用下一節的瀏覽器代理模式。沙箱設定請參閱電腦使用工具

瀏覽器代理:browser_use

當整個任務都在網頁內進行(填寫表單、讀取頁面內容、跨分頁作業)時,瀏覽器使用工具比電腦使用更為合適。您的應用程式驅動一個由其控制的瀏覽器,並回傳螢幕截圖或頁面狀態;Claude 除了點擊與輸入之外,還會呼叫具備頁面感知能力的成員工具,例如 read_pagefindform_inputget_page_text,因此除了像素座標之外,它也能針對元素參照進行操作。

{
  "tools": [{ "type": "browser_toolset_20260801" }]
}

與電腦使用工具集相同,此項目不需要 name,且您可透過其 configs 欄位關閉個別成員工具。執行契約請參閱瀏覽器使用工具

後續步驟

Anthropic 提供之工具的完整目錄,包含類型字串與參數。

工具使用的運作方式,以及何時該使用 Anthropic 工具、何時該自行定義工具。

Was this page helpful?