最近在給某跨平臺(tái)系統(tǒng)做 Agent 框架選型把 Coding Agent 和 Personal Agent 放到一起對(duì)比發(fā)現(xiàn)一個(gè)特別容易被忽略的斷層兩者看起來(lái)都是“AI 助手”可底層架構(gòu)的設(shè)計(jì)邏輯幾乎是兩條路線(xiàn)。Coding Agent 的核心是短周期執(zhí)行循環(huán)每次任務(wù)以分鐘級(jí)收斂Personal Agent 的核心則是長(zhǎng)期委托能力要能在跨會(huì)話(huà)的時(shí)間尺度上持續(xù)服務(wù)。這篇內(nèi)容把我這段時(shí)間踩過(guò)的坑和對(duì)比結(jié)論整理出來(lái)適合正在做 Agent 架構(gòu)選型、或者想把手上的工具改造成長(zhǎng)期 Agent 的開(kāi)發(fā)者參考。1. 先搞清楚兩類(lèi) Agent 的定位差異與核心矛盾1.1 Coding Agent 的典型場(chǎng)景與能力邊界Coding Agent 最常見(jiàn)的形態(tài)是“自動(dòng)寫(xiě)代碼助手”給它一段任務(wù)描述比如“修復(fù)登錄模塊的 token 過(guò)期問(wèn)題”它讀取代碼庫(kù)定位相關(guān)文件修改內(nèi)容跑測(cè)試最后輸出一個(gè) patch。整個(gè)過(guò)程通?？刂圃趲追昼妰?nèi)目標(biāo)是快速收斂到可驗(yàn)證的結(jié)果。這個(gè)場(chǎng)景有幾個(gè)鮮明特征。第一任務(wù)邊界清晰輸入是 bug 描述或功能需求輸出是代碼變更。第二驗(yàn)證機(jī)制現(xiàn)成編譯器、單元測(cè)試、lint 工具就是天然的裁判改得對(duì)不對(duì)可以自動(dòng)判斷。第三環(huán)境可控大部分操作發(fā)生在本地倉(cāng)庫(kù)或獨(dú)立的沙箱環(huán)境里。這三個(gè)特點(diǎn)決定了 Coding Agent 的架構(gòu)可以圍繞“短循環(huán)”來(lái)設(shè)計(jì)。任務(wù)拆細(xì)、快速執(zhí)行、自動(dòng)驗(yàn)證、失敗重試這套流程在編程場(chǎng)景里跑得通因?yàn)槊恳徊蕉加忻鞔_的對(duì)錯(cuò)標(biāo)準(zhǔn)。1.2 Personal Agent 的典型場(chǎng)景與能力邊界Personal Agent 是另一類(lèi)東西。它的典型任務(wù)是“幫我安排下周去某地的行程”“定期整理項(xiàng)目周報(bào)”“跟蹤某份合同到簽收為止”。這些任務(wù)的共同點(diǎn)是周期長(zhǎng)、目標(biāo)模糊、邊界開(kāi)放而且往往跨會(huì)話(huà)——不是一次對(duì)話(huà)能完成的需要 Agent 在數(shù)小時(shí)甚至數(shù)天的時(shí)間里持續(xù)跟進(jìn)。這里的能力邊界就完全不一樣了。Personal Agent 沒(méi)有編譯器這種即時(shí)裁判一個(gè)決策的對(duì)錯(cuò)往往要等真實(shí)世界反饋它也沒(méi)有封閉沙箱很多時(shí)候操作的是用戶(hù)的日歷、郵箱、支付賬戶(hù)之類(lèi)的真實(shí)系統(tǒng)。更關(guān)鍵的是任務(wù)目標(biāo)通常不是一次性指令而是帶約束的持續(xù)委托比如“盡量選早班機(jī)但別超過(guò)預(yù)算”。這種場(chǎng)景對(duì)架構(gòu)的要求不再是“單次循環(huán)多快能收斂”而是“下一次交互時(shí) Agent 還記不記得目標(biāo)、有沒(méi)有掌握足夠的上下文、能不能自主判斷該不該繼續(xù)”。1.3 核心矛盾確定性任務(wù)與開(kāi)放式任務(wù)的架構(gòu)權(quán)衡把兩類(lèi)場(chǎng)景擺在一起看核心矛盾就清楚了Coding Agent 處理的是確定性任務(wù)Personal Agent 處理的是開(kāi)放式任務(wù)。確定性任務(wù)可以設(shè)計(jì)成短循環(huán)因?yàn)槊恳徊降膱?zhí)行結(jié)果都有客觀(guān)標(biāo)準(zhǔn)來(lái)判斷開(kāi)放式任務(wù)則必須考慮長(zhǎng)期狀態(tài)因?yàn)閳?zhí)行路徑無(wú)法預(yù)先窮舉而且錯(cuò)誤代價(jià)可能很高。這個(gè)差異直接決定了架構(gòu)側(cè)重點(diǎn)。Coding Agent 的架構(gòu)重點(diǎn)是“工具調(diào)用能力”和“驗(yàn)證反饋速度”P(pán)ersonal Agent 的架構(gòu)重點(diǎn)則是“記憶持久化”“規(guī)劃拆解”和“人類(lèi)確認(rèn)機(jī)制”。如果只是給 Coding Agent 加一個(gè)定時(shí)器硬說(shuō)它是 Personal Agent大概率會(huì)在長(zhǎng)周期任務(wù)上失控反過(guò)來(lái)如果讓 Personal Agent 用 Coding Agent 那套“快速循環(huán)、頻繁重試”的邏輯去處理真實(shí)世界的委托用戶(hù)大概率會(huì)被攪得心力交瘁。架構(gòu)選型之前先想清楚自己到底要解決哪一類(lèi)問(wèn)題這是最重要的一步。2. Coding Agent 的短周期執(zhí)行循環(huán)如何運(yùn)轉(zhuǎn)2.1 標(biāo)準(zhǔn)執(zhí)行循環(huán)的五步拆解Coding Agent 的執(zhí)行循環(huán)行業(yè)里已經(jīng)形成了比較一致的拆法我一般把它分成五步理解任務(wù)、搜索上下文、制定計(jì)劃、執(zhí)行變更、驗(yàn)證結(jié)果。這五步構(gòu)成一個(gè)閉環(huán)跑完一輪如果驗(yàn)證不通過(guò)就回到第三步重新調(diào)整計(jì)劃直到通過(guò)或達(dá)到最大重試次數(shù)。第一步“理解任務(wù)”看起來(lái)簡(jiǎn)單其實(shí)最容易出問(wèn)題。模型需要把自然語(yǔ)言描述映射到具體的代碼意圖比如“修 bug”到底修的是邏輯錯(cuò)誤還是邊界條件這需要抽取關(guān)鍵實(shí)體。第二步“搜索上下文”是 Coding Agent 區(qū)別于普通聊天的核心能力它不能只靠對(duì)話(huà)里提供的信息必須主動(dòng)去倉(cāng)庫(kù)里檢索相關(guān)文件、函數(shù)定義、調(diào)用鏈。第三步的“制定計(jì)劃”決定了后續(xù)動(dòng)作的質(zhì)量這一步往往需要模型把大任務(wù)拆成多個(gè)原子步驟比如先加日志定位問(wèn)題、再改核心邏輯、最后補(bǔ)測(cè)試。執(zhí)行變更和驗(yàn)證結(jié)果是最后兩步也是最吃工具鏈的部分。執(zhí)行變更依賴(lài)文件編輯工具驗(yàn)證結(jié)果依賴(lài)測(cè)試框架、靜態(tài)檢查、構(gòu)建腳本。整個(gè)循環(huán)的粒度通?？刂圃趲资氲綆追昼娨淮瓮暾芡昃湍墚a(chǎn)出一個(gè)可評(píng)審的 diff。這個(gè)周期的選擇不是拍腦袋定的而是因?yàn)榫幊倘蝿?wù)的反饋信號(hào)足夠密集壓縮循環(huán)時(shí)間能顯著提升試錯(cuò)效率。注意Coding Agent 在制定計(jì)劃階段經(jīng)常犯一個(gè)錯(cuò)——跳過(guò)“搜索上下文”直接改代碼。模型憑訓(xùn)練時(shí)的記憶猜代碼結(jié)構(gòu)結(jié)果改錯(cuò)位置。我在實(shí)際項(xiàng)目中給 Agent 加了一條硬規(guī)則沒(méi)有完成倉(cāng)庫(kù)索引掃描之前不允許生成 diff效果立竿見(jiàn)影。2.2 為什么編程任務(wù)天然適合短循環(huán)編程任務(wù)適合短循環(huán)本質(zhì)原因是“驗(yàn)證成本極低反饋信號(hào)極強(qiáng)”。改一行代碼對(duì)不對(duì)跑一次測(cè)試就知道刪了一個(gè)函數(shù)會(huì)不會(huì)影響調(diào)用方靜態(tài)檢查立刻報(bào)警。這種即時(shí)反饋?zhàn)?Agent 可以在循環(huán)里反復(fù)試錯(cuò)不需要驚動(dòng)用戶(hù)。對(duì)比一下真實(shí)世界的任務(wù)就能感受到差距。讓 Agent 幫你訂一張機(jī)票它訂完了無(wú)法立即知道“這個(gè)選擇用戶(hù)是否滿(mǎn)意”更不可能在幾秒內(nèi)反復(fù)改方案而修一段代碼編譯失敗的報(bào)錯(cuò)就擺在眼前改到通過(guò)為止是合理的策略。另一個(gè)原因是錯(cuò)誤代價(jià)可控。代碼改錯(cuò)了版本回滾、git 恢復(fù)就能解決最大損失是幾分鐘時(shí)間而訂錯(cuò)機(jī)票、發(fā)錯(cuò)郵件這類(lèi)操作挽回成本要高得多。所以 Coding Agent 可以放心地把“自動(dòng)重試”寫(xiě)進(jìn)循環(huán)里Personal Agent 則必須謹(jǐn)慎設(shè)計(jì)每一步的確認(rèn)節(jié)點(diǎn)。2.3 上下文窗口與代碼庫(kù)檢索的博弈Coding Agent 的一個(gè)隱蔽難點(diǎn)是對(duì)抗上下文窗口的物理限制。代碼倉(cāng)庫(kù)動(dòng)輒幾萬(wàn)個(gè)文件模型上下文窗口再大也裝不下而程序邏輯又是高度網(wǎng)絡(luò)化的改一個(gè)函數(shù)往往牽涉調(diào)用鏈上下游。這迫使架構(gòu)里必須有“按需檢索”的層而不是把整個(gè)倉(cāng)庫(kù)塞給模型。我常用的做法是分三層檢索第一層是關(guān)鍵詞檢索定位可能相關(guān)的文件第二層是符號(hào)索引找到函數(shù)、類(lèi)、變量的定義和引用點(diǎn)第三層是調(diào)用鏈展開(kāi)把測(cè)試文件、配置里相關(guān)片段拉進(jìn)上下文。這個(gè)過(guò)程本質(zhì)上是把“短循環(huán)”和“大倉(cāng)庫(kù)”之間的鴻溝用檢索管道填平。設(shè)計(jì)這個(gè)管道時(shí)要特別注意控制每次檢索返回的信息量一次返回太多反而會(huì)讓模型失去焦點(diǎn)。實(shí)測(cè)下來(lái)把單次檢索結(jié)果限制在相關(guān)文件的前幾百行內(nèi)模型的修改準(zhǔn)確率比“一次性給一堆文件”要高不少這個(gè)數(shù)據(jù)在多個(gè)模擬項(xiàng)目上都能復(fù)現(xiàn)。3. Personal Agent 的長(zhǎng)期委托模型設(shè)計(jì)3.1 長(zhǎng)期委托到底“長(zhǎng)”在哪里很多人以為 Personal Agent 的“長(zhǎng)期”是指單次任務(wù)要執(zhí)行很久比如讓 Agent 跑一個(gè)耗時(shí)幾個(gè)小時(shí)的腳本。這其實(shí)是誤解。長(zhǎng)期委托的核心特征是跨會(huì)話(huà)、跨時(shí)間尺度地保持目標(biāo)一致性用戶(hù)周一委托了一個(gè)任務(wù)Agent 周三主動(dòng)回來(lái)匯報(bào)進(jìn)展周五需要根據(jù)中途變化調(diào)整方案。它要求 Agent 在使用者不在場(chǎng)的時(shí)間段里仍然保有目標(biāo)和狀態(tài)。這個(gè)“保有”說(shuō)起來(lái)容易做起來(lái)牽扯到一整套架構(gòu)。任務(wù)目標(biāo)、中間產(chǎn)物、用戶(hù)偏好、歷史決策記錄這些東西必須從上下文窗口里“卸載”到持久化存儲(chǔ)中并在下次會(huì)話(huà)時(shí)重新“裝載”。沒(méi)有這一步跨會(huì)話(huà)就是一個(gè)偽命題——每次重新開(kāi)始對(duì)話(huà)Agent 都是失憶的只能靠用戶(hù)重新把需求完整說(shuō)一遍。我見(jiàn)過(guò)不少團(tuán)隊(duì)試圖用“每次對(duì)話(huà)前把聊天記錄拼進(jìn) prompt”的辦法來(lái)解決問(wèn)題短期撐得住但對(duì)話(huà)超過(guò)十幾輪之后 token 成本和注意力丟失問(wèn)題就會(huì)一起爆發(fā)。3.2 三件套記憶層、規(guī)劃器、事件驅(qū)動(dòng)長(zhǎng)期委托的架構(gòu)我拆下來(lái)核心是三件套記憶層、規(guī)劃器、事件驅(qū)動(dòng)。記憶層負(fù)責(zé)持久化把每次交互的結(jié)論提煉成結(jié)構(gòu)化記錄包括用戶(hù)偏好、任務(wù)狀態(tài)、關(guān)鍵約束點(diǎn)。規(guī)劃器負(fù)責(zé)把高層目標(biāo)拆成可執(zhí)行的階段性計(jì)劃并維護(hù)“當(dāng)前進(jìn)行到哪一步”的進(jìn)度視圖。事件驅(qū)動(dòng)則是觸發(fā) Agent 行動(dòng)的機(jī)制它既可以被用戶(hù)消息觸發(fā)也可以被定時(shí)器、外部通知、任務(wù)里程碑觸發(fā)。這三個(gè)組件之間是強(qiáng)耦合的。規(guī)劃器拆分出的每個(gè)階段必須能從記憶層讀出足夠上下文事件系統(tǒng)收到的每個(gè)信號(hào)需要更新記憶層里的狀態(tài)。舉個(gè)例子用戶(hù)委托“跟進(jìn)供應(yīng)商合同”規(guī)劃器拆成“整理?xiàng)l款摘要—確認(rèn)審批流程—發(fā)出簽約提醒—?dú)w檔最終版本”四個(gè)階段。當(dāng) Agent 收到一封新郵件事件驅(qū)動(dòng)機(jī)制先判斷這封郵件是否與合同任務(wù)相關(guān)如果是就更新記憶層中的任務(wù)狀態(tài)然后推進(jìn)規(guī)劃器的下一階段。實(shí)操提示記憶層不是越大越好。我踩過(guò)幾次坑之后總結(jié)出的經(jīng)驗(yàn)是優(yōu)先記錄“約束條件”和“決策理由”而不是流水賬式的操作日志。比如記憶里應(yīng)該存“用戶(hù)對(duì)預(yù)算上限很堅(jiān)持超過(guò)三萬(wàn)的方案不用提”這比存“用戶(hù)說(shuō)了一串關(guān)于預(yù)算的話(huà)”有用得多。3.3 信任與安全邊界怎么畫(huà)長(zhǎng)期委托意味著 Agent 獲得了比單次助手更大的自主權(quán)這就帶來(lái)信任與安全問(wèn)題。Personal Agent 會(huì)在用戶(hù)授權(quán)范圍內(nèi)操作真實(shí)系統(tǒng)因此必須在架構(gòu)層面明確“什么能自主做、什么必須請(qǐng)示”的邊界。我的做法是為 Agent 配置三層權(quán)限梯度。第一層是純信息收集比如查日歷、讀郵件摘要這類(lèi)操作低風(fēng)險(xiǎn)可以自主執(zhí)行第二層是寫(xiě)入操作比如新建日程項(xiàng)、保存筆記這類(lèi)操作必須先經(jīng)過(guò)規(guī)則校驗(yàn)比如檢查時(shí)間沖突、確認(rèn)收件人列表第三層是外部動(dòng)作比如發(fā)送郵件、提交表單、預(yù)訂服務(wù)這類(lèi)操作必須顯式請(qǐng)示用戶(hù)等確認(rèn)之后才能執(zhí)行。把權(quán)限梯度寫(xiě)進(jìn) Agent 的提示詞還不夠要在工具調(diào)用的代碼層做硬校驗(yàn)否則模型一旦上下文漂移就可能越權(quán)操作。4. 兩類(lèi) Agent 的系統(tǒng)性架構(gòu)對(duì)比4.1 一張表看清循環(huán)粒度差異這里我把兩類(lèi) Agent 的關(guān)鍵差異整理成一張對(duì)比表方便直接對(duì)照。維度Coding AgentPersonal Agent任務(wù)周期分鐘級(jí)到小時(shí)級(jí)小時(shí)級(jí)到周級(jí)執(zhí)行循環(huán)粒度單次工具調(diào)用階段式任務(wù)步驟驗(yàn)證方式編譯器、測(cè)試、靜態(tài)檢查用戶(hù)確認(rèn)、規(guī)則校驗(yàn)、事實(shí)核查上下文策略滑動(dòng)窗口 按需代碼檢索分層持久化記憶 會(huì)話(huà)內(nèi)加載失敗處理自動(dòng)重試、快速調(diào)整方案上報(bào)用戶(hù)、等待授權(quán)、降級(jí)處理用戶(hù)介入頻率低生成 diff 后統(tǒng)一評(píng)審高關(guān)鍵決策點(diǎn)逐步確認(rèn)典型風(fēng)險(xiǎn)改錯(cuò)代碼、破壞構(gòu)建越權(quán)操作、隱私泄露、目標(biāo)漂移這張表最值得琢磨的是“執(zhí)行循環(huán)粒度”這一行。Coding Agent 的循環(huán)單位是“一次工具調(diào)用”比如編輯一個(gè)文件、跑一次測(cè)試Personal Agent 的循環(huán)單位則是“一個(gè)任務(wù)階段”比如完成一輪信息收集、產(chǎn)出一份摘要。粒度放大之后循環(huán)的每個(gè)節(jié)點(diǎn)都承載了更多不可逆操作所以必須在節(jié)點(diǎn)之間插入人工或規(guī)則的閘門(mén)。4.2 狀態(tài)管理短期上下文與長(zhǎng)期記憶的分工兩類(lèi) Agent 在狀態(tài)管理上的策略截然不同。Coding Agent 信奉“用完即走”每次循環(huán)的中間狀態(tài)都盡量留在上下文窗口里任務(wù)結(jié)束就丟棄最多保留一份 diff 供用戶(hù)審閱。這種策略的原因很現(xiàn)實(shí)代碼修改是一個(gè)可回溯、可重放的過(guò)程git 歷史本身就是狀態(tài)管理Agent 不需要額外負(fù)擔(dān)。Personal Agent 則不能這么干。它面對(duì)的任務(wù)沒(méi)有 git 這種天然持久化工具而且目標(biāo)本身會(huì)隨時(shí)間演化比如“安排旅行”在行程訂完后就變成“提醒用戶(hù)準(zhǔn)備簽證材料”狀態(tài)的流轉(zhuǎn)需要 Agent 自己跟蹤。我的方案是引入分層記憶第一層是工作記憶存在當(dāng)前上下文里對(duì)應(yīng)正在執(zhí)行的活動(dòng)步驟第二層是任務(wù)記憶存到本地?cái)?shù)據(jù)庫(kù)記錄每個(gè)任務(wù)當(dāng)前階段、依賴(lài)關(guān)系、阻塞項(xiàng)第三層是用戶(hù)元記憶記錄歷史偏好、長(zhǎng)期約束、常見(jiàn)決策模式。每次新會(huì)話(huà)啟動(dòng)時(shí)工作記憶從任務(wù)記憶和用戶(hù)元記憶中動(dòng)態(tài)加載而不是從零開(kāi)始。4.3 失敗處理與人類(lèi)介入策略的差異失敗處理策略最能體現(xiàn)兩類(lèi) Agent 的哲學(xué)差異。Coding Agent 的默認(rèn)策略是“自己搞定”測(cè)試掛了先看日志調(diào)整代碼再跑一遍連續(xù)幾次失敗后才考慮換方案。這種策略的高效前提是失敗成本低重試和調(diào)整不會(huì)造成額外負(fù)擔(dān)。Personal Agent 的失敗處理要復(fù)雜得多。某個(gè)外部操作失敗了直接重試可能造成重復(fù)扣款、重復(fù)發(fā)送等后果。在真實(shí)世界場(chǎng)景里Agent 首先要判斷失敗的類(lèi)型和可重試性。請(qǐng)求超時(shí)這種暫時(shí)性失敗可以自動(dòng)重試但要加冪等控制業(yè)務(wù)規(guī)則沖突這種確定性失敗正確做法是停下來(lái)把沖突點(diǎn)整理成一份帶選項(xiàng)的說(shuō)明發(fā)給用戶(hù)。我通常在 Personal Agent 的循環(huán)里增加一個(gè)“失敗分級(jí)”節(jié)點(diǎn)每類(lèi)失敗映射到不同的處置策略而不是讓模型自由發(fā)揮。5. 落地實(shí)踐怎么選型與改造5.1 技術(shù)棧選型的三個(gè)判斷標(biāo)準(zhǔn)面對(duì)一堆 Agent 框架如何判斷適不適合自己手上的項(xiàng)目我總結(jié)出三個(gè)判斷標(biāo)準(zhǔn)。第一個(gè)標(biāo)準(zhǔn)是看循環(huán)模型是否可配置。Coding Agent 框架通常把“工具調(diào)用—結(jié)果返回”這個(gè)循環(huán)寫(xiě)得很死改造 Personal Agent 時(shí)會(huì)發(fā)現(xiàn)很難插入長(zhǎng)期記憶節(jié)點(diǎn)。起碼要確認(rèn)框架的循環(huán)是圖結(jié)構(gòu)而不是線(xiàn)性結(jié)構(gòu)LangGraph 這類(lèi)基于圖編排的框架在這一點(diǎn)上有明顯優(yōu)勢(shì)。第二個(gè)標(biāo)準(zhǔn)是看記憶和存儲(chǔ)抽象是否成熟。Personal Agent 需要把狀態(tài)持久化到數(shù)據(jù)庫(kù)框架得提供清晰的記憶接口或者至少允許自定義存儲(chǔ)后端而不是把狀態(tài)全放在內(nèi)存里。第三個(gè)標(biāo)準(zhǔn)是看人類(lèi)介入原語(yǔ)設(shè)計(jì)得怎么樣。長(zhǎng)期委托任務(wù)需要“暫停—等確認(rèn)—恢復(fù)”這樣的機(jī)制框架是否原生支持這種交互模式直接決定了改造工作量。我在某跨平臺(tái)系統(tǒng)項(xiàng)目里對(duì)比過(guò)幾個(gè)方案最后選擇了支持有限狀態(tài)機(jī)和人工確認(rèn)節(jié)點(diǎn)的那些改造起來(lái)舒服很多。5.2 從 Coding Agent 改造成 Personal Agent 的關(guān)鍵步驟把現(xiàn)成的 Coding Agent 改造成 Personal Agent第一步不是加功能而是重構(gòu)循環(huán)粒度。Coding Agent 的循環(huán)是“感知—思考—行動(dòng)—驗(yàn)證”P(pán)ersonal Agent 要變成“感知—思考—行動(dòng)—存檔—確認(rèn)—行動(dòng)”。每次完成一個(gè)有獨(dú)立意義的行為后先存檔狀態(tài)再判斷是否需要用戶(hù)確認(rèn)。第二步是把上下文策略從“滑動(dòng)窗口”切換成“記憶分層”。需要確定哪些信息退出上下文轉(zhuǎn)成持久化數(shù)據(jù)哪些信息在每次會(huì)話(huà)開(kāi)始時(shí)要主動(dòng)裝載。這個(gè)決策可以做成一個(gè)篩選函數(shù)用規(guī)則判斷每條信息的去留。第三步是重新設(shè)計(jì)失敗處理分支。Coding Agent 的失敗分支是“重試或換個(gè)方案”P(pán)ersonal Agent 必須增加“上報(bào)、降級(jí)、忽略”的選項(xiàng)。特別是涉及外部系統(tǒng)操作時(shí)重試策略必須加冪等校驗(yàn)。改到這個(gè)程度原來(lái)的框架如果還是把每一步路由到同一個(gè)重試邏輯就說(shuō)明框架天花板到了。5.3 一個(gè)簡(jiǎn)化示例帶長(zhǎng)期委托能力的輕量 Agent下面是一個(gè)簡(jiǎn)化版 Personal Agent 的 Python 狀態(tài)機(jī)骨架體現(xiàn)長(zhǎng)期委托的核心控制邏輯。from enum import Enum class State(Enum): IDLE idle EXECUTING executing ARCHIVING archiving WAITING_CONFIRM waiting_confirm ENDED ended class PersonalAgent: def __init__(self, memory, planner): self.memory memory self.planner planner self.state State.IDLE self.task_context None def start(self, goal): # 目標(biāo)落到規(guī)劃器產(chǎn)出的計(jì)劃寫(xiě)入記憶 self.task_context self.planner.create_plan(goal) self.memory.save(active_plan, self.task_context) self.state State.EXECUTING return self._step() def _step(self): step self.planner.current_step(self.task_context) if step is None: self.state State.ENDED return {status: done} result self._execute(step[action]) self.memory.log(step, result) # 關(guān)鍵步驟強(qiáng)制等待用戶(hù)確認(rèn) if step.get(requires_confirmation): self.state State.WAITING_CONFIRM return {status: awaiting_confirmation, step: step} self.state State.ARCHIVING self.memory.commit(step) return self._advance() def confirm(self, approvedTrue): if self.state ! State.WAITING_CONFIRM: raise RuntimeError(not in confirmation state) if approved: self.memory.commit_current_step() return self._advance() else: self.planner.revise(self.task_context) return self._step() def _advance(self): self.planner.advance(self.task_context) self.state State.EXECUTING return self._step()這個(gè)骨架刻意把“存檔”和“確認(rèn)”做成循環(huán)里的顯式節(jié)點(diǎn)。ARCHIVING狀態(tài)保證每個(gè)動(dòng)作執(zhí)行后都先把上下文寫(xiě)進(jìn)記憶層WAITING_CONFIRM狀態(tài)保證高風(fēng)險(xiǎn)動(dòng)作不會(huì)自行放行。實(shí)際項(xiàng)目里你還需要在這個(gè)基礎(chǔ)之上掛事件驅(qū)動(dòng)入口比如定時(shí)器或者消息訂閱但核心的狀態(tài)流轉(zhuǎn)邏輯是不變的長(zhǎng)期委托不是讓 Agent 一次性把任務(wù)干完而是讓它在一個(gè)可控狀態(tài)機(jī)里按節(jié)奏推進(jìn)。6. 實(shí)戰(zhàn)中踩過(guò)的坑與排查心得6.1 記憶漂移Agent 做著做著忘了原始目標(biāo)跑長(zhǎng)周期任務(wù)時(shí)最常見(jiàn)的問(wèn)題是記憶漂移Agent 在逐個(gè)執(zhí)行子任務(wù)的過(guò)程中逐漸偏離最初的用戶(hù)目標(biāo)。原因并不神秘每一輪對(duì)話(huà)的模型注意力都有限中間過(guò)程產(chǎn)生的信息會(huì)把最初的約束條件“擠”出上下文窗口。我的解決方案是引入“意圖錨點(diǎn)”機(jī)制。在新會(huì)話(huà)或任務(wù)啟動(dòng)時(shí)把原始目標(biāo)和不可變更的約束單獨(dú)存成一個(gè)固定文件每次循環(huán)開(kāi)始前強(qiáng)制加載到上下文最前面。無(wú)論中間過(guò)程新增多少內(nèi)容Agent 每次決策前都會(huì)重新看到原始目標(biāo)。實(shí)測(cè)下來(lái)這個(gè)改動(dòng)讓目標(biāo)漂移率下降得非常明顯。避坑心得被擠掉的通常不是任務(wù)主體而是“隱式約束”比如“不要?jiǎng)右延械臏y(cè)試邏輯”“這塊代碼需要保持向后兼容”。這種約束在原始任務(wù)描述里經(jīng)常只是一句話(huà)丟了就很難發(fā)現(xiàn)。我的習(xí)慣是讓規(guī)劃器拆解時(shí)專(zhuān)門(mén)抽出一層“約束列表”跟目標(biāo)錨點(diǎn)一起固定加載。6.2 循環(huán)失控?zé)o意義的迭代重試Personal Agent 接入真實(shí)系統(tǒng)后會(huì)遇到循環(huán)失控的變體同一個(gè)操作反復(fù)失敗、反復(fù)重試每次失敗原因都一樣Agent 卻總是換湯不換藥地試下去。根源是模型的失敗分析不夠深只看到了表層異常沒(méi)有定位到根本原因。應(yīng)對(duì)辦法是給循環(huán)設(shè)置多維熔斷條件。除了最常見(jiàn)的迭代次數(shù)上限我更推薦加“同類(lèi)失敗次數(shù)”和“驗(yàn)證失敗比例”兩個(gè)指標(biāo)。比如連續(xù)三次失敗在同一工具調(diào)用直接停止自動(dòng)重試生成一份排查報(bào)告提交用戶(hù)。另外每次失敗的信息要結(jié)構(gòu)化返回給 Agent包括錯(cuò)誤類(lèi)型、狀態(tài)碼、可能的修復(fù)建議讓下一次循環(huán)的起點(diǎn)信息足夠充足。6.3 工具鏈斷裂權(quán)限與外部依賴(lài)的暗坑Agent 的工具調(diào)用鏈條非常脆弱。常見(jiàn)斷點(diǎn)包括環(huán)境變量缺失、外部 API 變更、目標(biāo)系統(tǒng)權(quán)限調(diào)整、以及模型生成的參數(shù)不兼容。這些斷點(diǎn)單個(gè)看都不算嚴(yán)重但在長(zhǎng)周期任務(wù)里任何一處斷裂都會(huì)讓整個(gè)計(jì)劃阻塞。我在實(shí)際項(xiàng)目里有兩層防護(hù)。第一層是給每個(gè)外部工具定義一份顯式的調(diào)用協(xié)議包括輸入輸出 schema、鑒權(quán)要求和常見(jiàn)錯(cuò)誤碼Agent 在調(diào)用工具前先“讀取協(xié)議”而不是靠模型記憶去猜。第二層是對(duì)外部調(diào)用做一次“預(yù)檢”檢查必要參數(shù)、令牌是否過(guò)期、目標(biāo)服務(wù)是否可達(dá)預(yù)檢通過(guò)后才真正發(fā)起調(diào)用。預(yù)檢成本很低但能把大量“假失敗”攔截在正式執(zhí)行之前。6.4 匯報(bào)時(shí)機(jī)長(zhǎng)期任務(wù)要不要頻繁同步長(zhǎng)期委托還有一個(gè)容易被忽視的體驗(yàn)問(wèn)題Agent 應(yīng)該在什么時(shí)機(jī)向用戶(hù)匯報(bào)進(jìn)度。太頻繁會(huì)讓用戶(hù)煩比如每五分鐘推送一條“我在做什么”太少會(huì)讓用戶(hù)焦慮擔(dān)心 Agent 是不是卡住了。我采用的策略是“里程碑式匯報(bào) 異常即時(shí)匯報(bào)”。正常執(zhí)行期間Agent 只在完成一個(gè)獨(dú)立階段后匯報(bào)概要遇到需要決策、出現(xiàn)異常、或者等待外部反饋超過(guò)閾值時(shí)才即時(shí)聯(lián)系用戶(hù)。把匯報(bào)節(jié)奏寫(xiě)進(jìn)架構(gòu)而不是交給模型臨場(chǎng)發(fā)揮能省掉大量通知噪音。尤其要注意取消“過(guò)程直播”式的匯報(bào)大部分用戶(hù)要的是結(jié)果和關(guān)鍵選擇點(diǎn)不關(guān)心工具被調(diào)用了幾次。這幾次折騰下來(lái)我最大的體會(huì)是做 Coding Agent 時(shí)腦子要快循環(huán)要短能用工具驗(yàn)證就不要問(wèn)用戶(hù)做 Personal Agent 時(shí)則反過(guò)來(lái)狀態(tài)要先落盤(pán)動(dòng)作要先想邊界確認(rèn)節(jié)點(diǎn)寧多勿少。兩類(lèi) Agent 本質(zhì)上是不同物種拿一邊的架構(gòu)經(jīng)驗(yàn)直接套另一邊遲早會(huì)在真實(shí)場(chǎng)景里栽跟頭。