作者 | Michael Redlich

譯者 | 劉雅夢

策劃 | 褚杏娟

構(gòu)建智能體工具帶中最困難的部分之一是構(gòu)建其動作空間。

Claude 通過工具調(diào)用來執(zhí)行操作，但是在 Claude API 中有很多方法可以使用原語，比如 bash、skills 和最近添加的代碼執(zhí)行來構(gòu)造工具（閱讀 @RLanceMartin 的新文章，了解更多關(guān)于 Claude API 的編程工具調(diào)用）。

考慮到所有這些選項，你如何設(shè)計智能體的工具？你是否只需要一個像代碼執(zhí)行或 bash 這樣的工具嗎？如果你有 50 個工具，每個工具對應(yīng)一個智能體可能遇到的用例，那會怎么樣？

為了將自己置于模型的思維中，我喜歡想象被給予一個困難的數(shù)學(xué)問題。你想用什么工具來解它？這要看你自己的技術(shù)了！

紙張是最基本的，但你將受限于手動計算。計算器會更好，但你需要知道如何操作更高級的選項。最快和最強大的選擇是計算機，但你必須知道如何使用它來編寫和執(zhí)行代碼。

這是一個設(shè)計智能體的有用框架。你想給它提供適合它自身能力的工具。但你怎么知道這些能力是什么呢？你要集中注意力，閱讀它的輸出，進行實驗。你要學(xué)著像智能體一樣看問題。

以下是我們在構(gòu)建 Claude Code 時從關(guān)注 Claude 中學(xué)到的一些經(jīng)驗教訓(xùn)。

改進 Elicitation 和

AskUserQuestion 工具

在構(gòu)建 AskUserQuestion 工具時，我們的目標是提高 Claude 提問的能力（通常稱為啟發(fā)）。

雖然 Claude 可以直接問問題，但我們發(fā)現(xiàn)回答這些問題似乎花費了不必要的時間。我們怎樣才能降低這種摩擦，增加用戶和 Claude 之間的交流帶寬呢？

嘗試 1：編輯 ExitPlanTool

我們首先嘗試的是向 ExitPlanTool 添加一個參數(shù)，以便在計劃旁邊放置一系列問題。這是最容易實現(xiàn)的事情，但這讓 Claude 感到困惑，因為我們同時要求制定一個計劃，并提出一系列關(guān)于計劃的問題。如果用戶的回答與計劃內(nèi)容相沖突怎么辦？Claude 需要調(diào)用 ExitPlanTool 兩次嗎？我們需要另一種方法。

（你可以在我們關(guān)于提示緩存的文章中閱讀更多關(guān)于我們?yōu)槭裁?要創(chuàng)建 ExitPlanTool 的信息）

嘗試 2：改變輸出格式

接下來，我們嘗試修改 Claude 的輸出指令，以使用稍微修改的 markdown 格式來提問。例如，我們可以要求它輸出一個帶有括號中替代選項的要點問題列表。然后，我們可以解析該問題并將其格式化為用戶的 UI。

雖然這是我們能做的最通用的更改，Claude 甚至似乎能夠很好地輸出這個，但這并不能保證。Claude 會附加額外的句子，省略選項，或者完全使用不同的格式。

嘗試 3：AskUserQuestion 工具

最后，我們決定創(chuàng)建一個 Claude 可以在任何時候調(diào)用的工具，但特別提示在計劃模式期間這樣做。當工具觸發(fā)時，我們會顯示一個模態(tài)框來顯示問題，并阻止智能體的循環(huán)直到用戶回答。

這個工具允許我們提示 Claude 進行結(jié)構(gòu)化輸出，并幫助我們確保 Claude 給用戶提供多個選項。它還為用戶提供了組合此功能的方法，例如在代理式 SDK 中調(diào)用它或在技能中引用它。

最重要的是，Claude 似乎很喜歡調(diào)用這個工具，我們發(fā)現(xiàn)它的輸出效果很好。即使是最好的設(shè)計工具，如果 Claude 不知道如何調(diào)用它，也是行不通的。

這是 Claude Code 中啟發(fā)的最終形式嗎？我們不確定。正如你將在下一個例子中看到的，適用于一個模型的方法可能不適用于另一個模型。

更新能力：任務(wù)和待辦事項

當我們第一次發(fā)布 Claude Code 時，我們意識到模型需要一個待辦事項列表來保持它的正常運行?？梢栽陂_始時編寫待辦事項，并在模型工作時進行檢查。為此，我們給了 Claude TodoWrite 工具，它可以編寫或更新待辦事項并將其顯示給用戶。

但即便如此，我們也經(jīng)?？吹?Claude 忘記了它的職責。為了適應(yīng)這種情況，我們每 5 個回合就會插入系統(tǒng)提醒，提醒 Claude 它的目標。

但隨著模型的改進，它們不僅不需要被提醒待辦事項列表，而且還會發(fā)現(xiàn)它的局限性。收到待辦事項清單的提醒使 Claude 認為它必須堅持而不是修改它。我們還看到 Opus 4.5 在使用子智能體方面做得更好，但是子智能體如何在共享的待辦事項列表進行協(xié)調(diào)呢？

看到這一點，我們用任務(wù)工具代替了 TodoWrite（閱讀更多 關(guān)于任務(wù)的內(nèi)容）。待辦事項的作用是保持模型的正常運行，而任務(wù)的作用更多的是幫助智能體相互溝通。任務(wù)可以包括依賴關(guān)系，在子智能體之間共享更新，模型可以更改和刪除它們。

隨著模型功能的增加，你的模型曾經(jīng)需要的工具現(xiàn)在可能會限制它們。重要的是要不斷地回顧之前關(guān)于需要什么工具的假設(shè)。這也是為什么堅持支持一小組具有相當相似的功能配置文件的模型是有用的。

設(shè)計一個搜索界面

對 Claude 來說，一組特別重要的工具是搜索工具，可以用來構(gòu)建自己的上下文。

當 Claude Code 首次推出時，我們使用了一個 RAG 向量數(shù)據(jù)庫來查找 Claude 的上下文。雖然 RAG 功能強大且速度快，但它需要索引和設(shè)置，并且在許多不同的環(huán)境中可能很脆弱。更重要的是，Claude 被賦予了這個上下文，而不是自己找到上下文。

但如果 Claude 能在網(wǎng)絡(luò)上搜索，為什么不搜索你的代碼庫呢？通過給 Claude 一個 Grep 工具，我們可以讓它自己搜索文件和構(gòu)建上下文。

這是我們看到的一個模式，隨著 Claude 變得越來越聰明，如果給它合適的工具，它就會越來越善于構(gòu)建它的環(huán)境。

當我們引入智能體技能時，我們正式定義了漸進式披露的概念，它允許智能體通過探索逐步發(fā)現(xiàn)相關(guān)的上下文。

Claude 可以讀取技能文件，然后這些文件可以引用模型可以遞歸讀取的其他文件。事實上，技能的一個常見用途是為 Claude 添加更多的搜索功能，比如告訴它如何使用 API 或查詢數(shù)據(jù)庫。

在一年的時間里，Claude 從不能真正建立自己的上下文，到能夠在幾層文件中進行嵌套搜索，以找到它所需要的確切上下文。

漸進式披露現(xiàn)在是我們在不添加工具的情況下添加新功能的常用技術(shù)。

漸進式披露：Claude Code 指南智能體

Claude Code 目前有大約 20 個工具，我們不斷地問自己是否需要所有這些工具。添加新工具的門檻很高，因為這給模型提供了更多的選擇。

例如，我們注意到 Claude 對如何使用 Claude Code 了解不夠。如果你問它如何添加 MCP 或者斜杠命令的作用，它將無法回答。

我們本可以將所有這些信息放在系統(tǒng)提示中，但考慮到用戶很少詢問這些信息，這將增加上下文的腐朽并干擾 Claude Code 的主要工作：編寫代碼。

相反，我們嘗試了一種漸進披露的形式。我們給了 Claude 一個文檔的鏈接，他可以下載這個鏈接來搜索更多的信息。這是有效的，但我們發(fā)現(xiàn) Claude 會把很多結(jié)果放到上下文中來找到正確的答案，而你真正需要的只是答案。

因此，我們構(gòu)建了 Claude Code 指南子智能體，當你詢問它自己時，Claude 會被提示調(diào)用，子智能體有關(guān)于如何很好地搜索文檔以及返回什么內(nèi)容的大量說明。

雖然這不是完美的，Claude 仍然會感到困惑，當你問它如何設(shè)置自己，它是比以前好得多！我們能夠在不添加工具的情況下向 Claude 的動作空間添加?xùn)|西。

是藝術(shù)，不是科學(xué)

如果你希望有一套關(guān)于如何構(gòu)建工具的嚴格規(guī)則，很遺憾，這不是本指南。為模型設(shè)計工具既是一門科學(xué)，也是一門藝術(shù)。這在很大程度上取決于你正在使用的模型，智能體的目標以及它所處的環(huán)境。

經(jīng)常實驗，閱讀你的成果，嘗試新事物。像一個智能體一樣看待問題。

https://x.com/trq212/status/2027463795355095314

會議推薦

QCon 全球軟件開發(fā)大會·2026 北京站將于 4 月 16 日 -18 日正式舉辦。本屆大會以“Agentic AI 時代的軟件工程重塑”為主題，聚焦 100+ 重磅議題，匯聚來自阿里、騰訊、字節(jié)跳動、小米、百度等一線科技企業(yè)與創(chuàng)新團隊的技術(shù)專家，圍繞 AI 工程化、系統(tǒng)架構(gòu)與研發(fā)模式演進展開深入探討。更多詳情可掃碼或聯(lián)系票務(wù)經(jīng)理 18514549229 進行咨詢。

今日薦文

你也「在看」嗎？