KeyFrame內部研究專用

Building an ACP-Compatible Agent Live — Bennet Fenner, Zed

AI Engineer18 min英文
觀看原始影片

三句話摘要

Agent Client Protocol (ACP):統一AI編碼代理與編輯器通信的開源JSON RPC協議。 ACP透過統一的JSON RPC協議,使AI代理與編輯器實現無縫集成,開發者可快速構建支援多種客戶端的智能編碼代理,解決行業碎片化問題。 統一介面解決碎片化問題

重點整理

  1. 統一介面解決碎片化問題

  2. Zed面臨的核心痛點是每個AI模型供應商都推出自己的編碼代理,導致編輯器需要為每個代理單獨開發整合方案。ACP透過定義統一的JSON RPC協議,讓任何代理都能與任何支持ACP的客戶端通信,已有超過40個客戶端和多個主流代理支持該協議。

  3. 基於Session和非同步Updates的設計

  4. ACP引入session概念,每次客戶端連接建立新的session並獲得唯一ID。代理不再侷限於傳統request-response模式,可透過session updates在任何時候向客戶端發送notifications,包括文本chunks、工具調用進展、執行結果等,特別適合流式處理。

  5. 代理透過Capabilities存取客戶端資源

  6. ACP允許客戶端透過capabilities協商來宣告其支援的功能(如檔案系統proxy、終端管理等)。代理可利用這些能力存取編輯器buffer中未保存的內容,執行shell命令,甚至為自己動態添加新工具,大幅增強代理的互動性和靈活性。

  7. 最少四個核心函數實現完整代理

  8. 實現ACP代理只需要四個函數:initialize(協商協議版本)、create_session(生成session ID)、prompt(運行代理循環和工具調用)、cancel(支持取消操作),大幅降低開發複雜度。

實用技巧與重點

  • 官方資源:
  • 網站:agentclientprotocol.com
  • 技術基礎:JSON RPC協議
  • 已支持的代理:
  • OpenCode(內建ACP模式)
  • Cursor(內建ACP模式)
  • 其他代理通過adapter支持
  • 已支持的客戶端(40+):
  • OpenClaw(同時是客戶端和代理)
  • JetBrains
  • Obsidian
  • Zed
  • 核心概念與API:
  • Session:每次連接的對話執行緒
  • Session Updates類型:agent_message_chunk、tool_call、tool_call_update
  • 代理需實現的四個函數:initialize、create_session、prompt、cancel
  • Capabilities:檔案系統proxy、終端管理
  • 支援的操作:
  • 檔案系統:readFile(native)、proxy through ACP(編輯器buffer)
  • 文本流:real-time streaming chunks
  • 工具調用:初始化→執行→返回結果
  • 終端:命令執行與輸出流式傳輸

結論

ACP透過統一的JSON RPC協議,使AI代理與編輯器實現無縫集成,開發者可快速構建支援多種客戶端的智能編碼代理,解決行業碎片化問題。

完整解析

Zed是用Rust編寫的AI編碼編輯器,在去年面臨了一個日益嚴重的問題。隨著Claude、Gemini、OpenCode等主流AI模型供應商都開始推出自己的編碼代理和CLI工具,編輯器需要為每個代理單獨開發支援,導致集成工作碎片化且難以維護。Zed團隊認識到業界需要一個統一的協議,於是決定創建Agent Client Protocol (ACP)。

ACP的設計理念源自MCP和LSP的成功,採用JSON RPC作為通信基礎。其核心目標是建立一套統一的interface,使任何AI代理都能與任何支持ACP的客戶端(編輯器、IDE等)進行通信。這個想法獲得了業界廣泛支持——目前已有超過40個客戶端實現ACP支持,包括OpenClaw、JetBrains和Obsidian等知名編輯工具。許多代理也在參與,有的通過adapter將其原生協議轉換為ACP,有的直接在CLI中內建ACP模式。

在會議現場,講者Bennett進行了一場實時演示,展示如何從零開始在15分鐘內構建一個ACP兼容的編碼代理。他從一個最小化的TypeScript代理開始,該代理只支持讀檔案和編輯檔案兩個基本工具。實現ACP支持只需要四個核心函數:initialize用於協商協議版本和功能、create_session用於為每個客戶端連接生成唯一的session ID並初始化內部狀態、prompt用於接收用戶提示並運行代理循環(調用LLM、處理工具調用等)、cancel用於支持取消操作。

ACP的創新設計在於其session和非同步updates的機制。傳統的request-response模式中,客戶端必須等待代理的完整回應。但ACP允許代理在任何時候透過session updates向客戶端發送notifications,包括文本chunks(用於流式輸出)、tool_call updates(標記工具執行的開始和完成)等。這對於長時間運行的操作和實時反饋至關重要。

演示中,Bennett首先展示了如何整合Anthropic API的流式輸出。每當收到一個文本chunk時,代理發送一個type為agent_message_chunk的session update到客戶端,客戶端(Zed編輯器)即時顯示這些chunks。隨後,他為檔案操作添加了工具調用支持,分別在工具執行開始和結束時發送tool_call和tool_call_update,客戶端據此顯示工具執行的進度和結果。

特別值得注意的是ACP對Capabilities的支持。客戶端可以向代理宣告其支持的功能,例如檔案系統proxy和終端管理。檔案系統proxy允許代理存取編輯器buffer中未保存的內容,而不僅限於磁盤上的檔案——這對於編輯器的使用場景至關重要。演示的最後,Bennett展示了一個自舉(bootstrap)例子:他要求代理讀取自己的源碼,然後自動為自己添加一個新的終端工具來執行shell命令。代理成功地修改了自己的代碼,這清楚地展示了ACP的強大和靈活性。整個過程證明了實現一個功能完整的、支持流式輸出、多種工具調用和終端管理的AI編碼代理,並不需要複雜的工程工作。

11 min
AI 安全中文11月21日

防蒸餾的三道防線:OpenAI 怎麼保護 AI 的思考過程

一隻羊聊AI看原片 ↗
  • 思考過程是最值得保護的資產:完整的思維鏈(Chain-of-Thought)包含最終答案中沒有的中間步驟,蒸餾來的模型若學到完整思考過程,會多掌握超出預期的能力,包括原本應被防護的攻擊技巧。實驗顯示,學完整思考的學生在資安測驗中表現顯著優於
  • 三層防護結構應對單次請求與持續威脅:模型透過對抗訓練自我拒絕套話,分類器檢查請求意圖與回應內容(包括工具參數),API 層將思考過程與對話綁定,防止跨對話搬運。九月報告曾揭示的加密思考搬運攻擊已被修補。
10 min
AI 安全中文11月13日

The New AI Security Nightmare: Undetectable LLM Backdoors

Internet of Bugs看原片 ↗
  • LLM 可被訓練成在表面上表現正常,卻在特定條件(如在程式碼註釋中看到某個特定字串)觸發時執行訓練者指定的惡意行為,例如上傳環境變數檔案到遠端伺服器。這種後門是不可偵測的,研究者找不到檢測方法,且即使進行後續重新訓練也無法消除。
  • 任何參與模型創建或分發的人員都可能植入這類後門,不論模型是由知名 AI 廠商託管在雲端、還是自行部署。只要組織內有不可信任的人員,就無法完全排除這個風險。
22 min
AI 技術中文10月27日

Switch 2 宣告失守! AI 黑客 14 日暴力破解,唔使拆機、唔使焊晶片!任天堂今次真係驚咗?

大世界看原片 ↗
  • 漏洞來源出人意料:攻擊源於 iTunes 上售價約 25 美元的編程教學軟體 Small Basic。黑客利用其解釋器中的 32 位整數溢位漏洞穿過沙盒限制,再透過 ROP 鏈和緩衝區溢位層層深入,最終取得檔案系統完整權限。這套設計精妙的攻
  • AI 徹底改變破解生態:研究員 Pepsi Poo 坦承,破解工作大部分由 OpenAI 的 Codex AI 編碼代理執行。他搭建自動化測試裝置讓 AI 24 小時不間斷地觸發漏洞並自動重啟,兩週內完成原本需耗時數年的工程。這不是 AI