KeyFrame內部研究專用

The 100-Tool Agent Is a Trap - Sohail Shaikh & Ankush Rastogi, Prosodica

AI Engineer·6月28日週日·28 min英文

三句話摘要

AI Agent 中的「100 工具陷阱」——為什麼一次提供所有工具會導致性能崩潰,以及如何用語義路由解決。 當 AI Agent 的工具目錄超過 50 個時,語義路由和即時上下文注入是必要的架構優化——不是為了讓系統更複雜,而是為了停止強迫模型在無關工具中推理。 準確性崩潰的根本原因

重點整理

重點
  • 1

    準確性崩潰的根本原因

  • 2

    Fat Agent 在工具數到達 100 時,準確率從 78% 降至 40%,741 個工具時僅剩 13.6%。這不是因為個別工具寫得差,而是因為模型被迫在無數工具中選擇,在「Lost in the Middle」問題下,對中間位置的內容注意力不足。

  • 3

    成本與延遲的實際影響

  • 4

    741 個工具的完整描述需要 127,000 tokens。若日均 100,000 請求,每月會發送數十億個純用於描述工具的 tokens。Fat Agent 的首 token 延遲可達 5 秒以上,而語義路由則保持穩定,因為只需要 1,000 tokens。

  • 5

    語義路由的核心設計

  • 6

    語義路由是工具版本的 RAG:離線建立工具目錄、嵌入描述並存於向量數據庫;運行時嵌入用戶查詢、檢索最相關的 3-5 個工具、注入其模式到模型調用。模型只看到焦點列表而非龐大目錄。

  • 7

    實現的關鍵權衡

  • 8

    K=5(返回 5 個工具)是可靠的起點。工具描述品質至關重要——模糊的描述會導致嵌入較弱。需要監控路由失敗並持續改進描述。少於 20 個工具時不需路由。

實用技巧與重點

乾貨
  • 量化指標
  • Fat Agent 準確率:10 工具 78%;100 工具 40%;741 工具 13.6%
  • 語義路由準確率:保持 83% 以上(全部工具數範圍內)
  • Token 成本:741 工具需 127,000 tokens;語義路由僅需 1,000 tokens(減少 99%)
  • 首 token 延遲:Fat Agent 500 工具時超過 5 秒;語義路由保持穩定
  • Anthropic MCP 實例:150K 減少至 2K tokens(98.7% 降幅)
  • 工具準確率對標
  • 10 工具:78%
  • 50 工具:約 55-60%
  • 100 工具:40%
  • 200 工具:約 25%
  • 741 工具:13.6%
  • 實現步驟
  • 離線:編目工具(名稱、描述、模式、擁有者、版本)→ 嵌入描述 → 存入向量數據庫
  • 運行時:嵌入用戶查詢 → 向量搜索 → 取前 K 個工具 → 取得其模式 → 注入到模型調用
  • 評估參數:K 值測試(3、5、10)選擇滿足準確率目標的最小 K
  • 監控:日誌記錄選中工具、實際工具調用、失敗與回退使用情況
  • 推薦工具與平台
  • 向量數據庫:Pinecone、Quadrant、Chroma DB
  • 開源項目:Semantic Router(來自 Rlo Labs)、Tool Bench、MCP
  • 測試基準:Berkeley Function Calling Leaderboard
  • 參考資源:Anthropic MCP 官方寫作
  • 調試策略
  • 路由失敗時:增加 K 值、執行二次路由、路由至更廣泛工具組
  • 工具描述撰寫:使用用戶實際用語,包含意圖、動作、關鍵實體
  • 稀有工具優化:監控遺漏,在描述中加入正確的關鍵字
  • 日誌記錄:追蹤所有選擇決策,計算失敗率

結論

結論

當 AI Agent 的工具目錄超過 50 個時,語義路由和即時上下文注入是必要的架構優化——不是為了讓系統更複雜,而是為了停止強迫模型在無關工具中推理。

完整解析

詳細

在生產環境中構建 AI Agent 時,一個看似無害的做法會隱藏著陷阱:將所有工具定義一次性載入每個請求。這種「Fat Agent」方法在工具數少於 10 個時運作良好,演示看起來完美無缺,但當產品成長、工具目錄擴展至 50、100 甚至 741 個時,系統開始崩潰。

Sohail 和 Ankush 的研究揭示了這個問題的嚴重程度。使用 Berkeley Function Calling Leaderboard 和合成工具池進行的基準測試顯示,Fat Agent 的工具選擇準確率隨著工具數指數級下降:10 個工具時達 78% 的準確率,到 100 個工具時跌至 40%,在 741 個工具的完整目錄中僅剩 13.6%——平均每 8 個工具調用中只有 1 個正確。根本原因並非模型本身變差,而是一個已知的 LLM 問題:Lost in the Middle。當數百個工具描述全部塞入提示中時,模型對開頭和結尾的內容注意力更強,而中間位置的工具定義被忽略。

成本維度上更加令人吃驚。741 個工具的完整描述需要 127,000 個 tokens。在日均 100,000 次請求的生產系統中,這意味著每天數十億個 tokens 純粹用於描述工具,而用戶的實際問題還未被處理。首 token 延遲也隨之增長,Fat Agent 在工具數達 500 時可能需要超過 5 秒才能生成第一個回應,這在實時產品中是不可接受的。

解決方案是語義路由結合即時上下文注入。這個思路並非全新,而是將檢索增強生成(RAG)的模式應用於工具選擇。實現分為三個階段:首先在離線階段,工程團隊對每個工具進行編目(記錄名稱、描述、JSON 模式),嵌入這些描述並存入向量數據庫;在運行時,系統嵌入用戶的查詢、在向量空間中進行鄰近搜索、返回最相關的 K 個工具(通常為 3-5 個);最後,只有這些篩選出的工具模式被注入到模型調用中。關鍵是模型永遠看不到整個目錄,只看到當前請求相關的小型列表。

基準測試證明了這種方法的有效性。語義路由在測試的全部工具數範圍內保持 83% 以上的準確率,因為模型始終從一個小的、專注的工具集中選擇,而非巨大的完整目錄。即時上下文注入將每次請求的工具描述 tokens 從 127,000 減少至約 1,000,達到 99% 的成本降幅。首 token 延遲保持平穩,用戶體驗變得更加實時且可預測。Anthropic 在其 MCP(Model Context Protocol)文檔中報告了類似的成果:tokens 從 150,000 降至 2,000,驗證了這一架構在生產級別的可行性。

實施這個模式的成本很低。對於大多數團隊來說,這不是六個月的平台重構,而是一次聚焦衝刺。如果團隊已有 RAG 基礎設施,向量數據庫和嵌入模型都已就位,語義路由只是將既有工具重新應用於工具選擇問題。Pinecone、Quadrant 等託管向量庫可用,或者可以從本地 Chroma DB 開始。評估時應在 K 值為 3、5、10 的配置下運行測試集,選擇滿足準確率目標的最小 K。K=5 是實踐推薦的起點。生產環境中的日誌記錄極為重要,需要追蹤路由選擇、實際工具調用、失敗和回退情況,以便持續改進工具描述。

關鍵時刻

Pipeline v2

帶時間戳的重點,會在逐字稿層級分析上線後產生。目前請先透過原始影片觀看。

事實查核

Pipeline v2

說法查證是下一次管線升級的一部分。KeyFrame 只會顯示它真正能驗證的內容。

更多「AI 技術」的內容

Between Two Nerds: Attribution is dead, long live attribution
32 min
AI 技術英文PODCAST8月25日

Between Two Nerds: Attribution is dead, long live attribution

Risky Business

  • 工具成本的破壞性下降 — 傳統上,攻擊者必須重複使用昂貴自製的惡意軟體或工具組,因為開發和維護成本極高。這種成本結構使得安全研究人員可以通過工具特徵和程式碼簽名來追蹤攻擊者。LLM 自動化了代碼生成與維護工作流,使得攻擊者可以輕易為每個目標生成新工具,或改用通用系統工具,導致傳統的工具特徵分析失效。
  • 所有取證證據都在攻擊者掌控之中 — 無論是使用的 IP 位址、惡意軟體類型或戰術流程,這些都是攻擊者的主動選擇。即使看似是隨機巧合,攻擊者仍有能力在事前決定留下什麼痕跡。因此,所有可恢復的取證證據本質上都是攻擊者願意暴露的信息。
  • LLM 削弱工具簽名但保留高階行為特徵 — LLM 經過公開駭客技術訓練,使不同使用者產生相似的攻擊模式。然而,勒索軟體集團、國家級行為者的受害者選擇、贖金要求方式或目標模式等高階特徵仍具有識別價值。例如,鎖定加密交易所的攻擊幾乎只能指向朝鮮。
Everything Goldman Sachs Taught Me About AI (In 10 minutes)
AI 技術英文8月24日

Everything Goldman Sachs Taught Me About AI (In 10 minutes)

Nate Herk

  • 驗證優於相信:看起來完整的AI輸出不等於正確答案,需在提示中要求模型重新檢查數字、引用來源,並對無把握的部分標記。
  • 區分AI與自動化:確定步驟且答案已知的任務用傳統自動化更便宜快速;只在需要判斷力、靈活性或處理複雜資訊時才用AI,兩者結合效果最佳。
  • 以問題驅動選型:先寫清楚「要解決的問題是什麼、成功的樣子是什麼」,再決定用什麼工具,許多失敗項目是從技術而非問題出發。
Mu: a self-hosted personal agent where the interface is an email address you can write to
AI 技術英文8月23日

Mu: a self-hosted personal agent where the interface is an email address you can write to

GitHub Awesome

  • Mu 是自主代理人系統,具有實際網址與獨立伺服器,用戶可透過多種方式與其互動——網頁應用、電子郵件或程式化介面。
  • 架構完整覆蓋日常工作流程的多個層面,整合郵件收發(SMTP/IMAP)、檔案管理、行事曆、新聞聚合、市場數據與搜尋功能於一個 Go 伺服器內。
  • 支援自帶模型與多種通訊協定,用戶可選擇不同的 AI 模型,並透過 MCP、HTTP API 或命令列工具整合到其他系統。