這家公司讓AI當CEO：我們摸清了Agent原生架構的5條鐵律

大多數AI應用只是套了個殼的聊天機器人。智能體是事后才想到的東西——一個硬塞進現有代碼的聊天界面。用戶讓它做事，它道歉，然后解釋自己做不到什么。

Agent原生架構完全顛覆了這個邏輯。

在Agent原生應用里，功能不是你寫的函數，而是你描述的結果，由一個帶著工具的Agent在循環中實現。我們在ClawGear就是這樣開發的——運營著一家8個Agent的AI公司，CEO、CFO、CMO和工程團隊全是AI Agent，通過Paperclip協調。以下是我們總結出的五條核心原則。

一、對等性

用戶通過UI能做的任何事，Agent必須通過工具也能達成。

這是基礎原則。沒有對等性，其他都無從談起。

假設你做了一個筆記應用，有漂亮的界面來創建、整理和打標簽。用戶讓Agent："創建一條筆記，總結我的會議，并標記為緊急。"

如果你做了創建筆記的UI，卻沒給Agent同樣的能力，Agent就被卡住了。它可能道歉，或者問澄清問題——但它幫不上忙，盡管對人類用戶來說這個動作 trivial 至極。

解決方案不是把UI按鈕1:1映射成工具。而是確保Agent能達成同樣的結果。有時需要專用工具（create_note），有時是組合原子能力（用write_file寫到筆記目錄并格式化）。

測試方法：任選用戶能在UI里做的動作，描述給Agent。它能完成嗎？如果不能，你就沒有對等性。

二、顆粒度

優先使用原子原語。功能是Agent在循環中達成的結果——不是你寫的函數。

工具是原語：讀文件、寫文件、運行命令、存儲記錄、發送通知。

功能不是函數。它是你在提示詞里描述的結果，由擁有原語的Agent運行直到達成。

陷阱是制造"上帝工具"——classify_and_organize_files(files)、process_and_summarize_documents(docs)。這些看起來方便，但摧毀了可組合性。Agent無法 remix 上帝工具，只能按既定方式使用。

原子原語可以組合。read_file + write_file + search_files 能完成Agent能推理的任何文件操作。

三、透明性

暴露Agent狀態，讓用戶能夠信任和驗證。

當用戶看不到Agent在做什么，信任就崩塌了。"正在思考……"轉30秒，然后給結果——這是黑箱。用戶對結果沒有 ownership。

透明意味著暴露：

? Agent當前在做什么（當前步驟）
? 它已經做了什么（已完成步驟、已創建產物）
? 它決定了什么以及為什么（決策軌跡）
? 它不確定什么（暴露不確定性，而非隱藏）

目標不是用日志淹沒用戶。而是讓Agent的工作足夠可讀，讓用戶能在錯誤累積前抓住它們。

四、可控性

用戶必須能夠在關鍵決策點介入。

完全自主的Agent是可怕的。用戶需要能暫停、檢查、覆蓋。這不是為了微觀管理每一次操作，而是為了在重要節點保有 veto 權。

可控性意味著：

? 在不可逆操作前確認（發送郵件前、刪除數據前）
? 在歧義處澄清（"你說的是A還是B？"）
? 在偏離時糾正（"不，用這種方式做"）
? 在完成后審閱（"這是草稿，批準嗎？"）

關鍵是設計介入的時機——不是每一步，而是后果嚴重的節點。

五、可進化性

架構必須允許Agent隨使用而改進，無需重寫代碼。

傳統軟件：發現bug → 修復代碼 → 部署。Agent原生軟件：發現失敗模式 → 調整提示詞或工具 → 觀察。

可進化性要求：

? 工具描述可熱更新（無需重啟）
? 提示詞版本化與A/B測試
? 執行軌跡可回放分析
? 失敗案例自動收集用于迭代

Agent不是寫完就完的軟件。它是持續學習的系統。架構要為這種持續學習提供基礎設施。

這五條原則不是理論。它們是我們在Paperclip和ClawGear的血淚中磨出來的。從讓AI當CEO到協調整個"公司"運轉，每一次崩潰都指向同一個教訓：別把Agent當聊天機器人 wrapper，把它當需要完整能力、透明度和控制權的協作者。

Agent原生架構不是未來 tense 的設想。它是現在進行時——只是大多數人還在用舊地圖找新大陸。