最近在整理“靈境伴侶”這個(gè)產(chǎn)品時(shí)我翻到一年前的代碼庫當(dāng)時(shí)的架構(gòu)簡單得有點(diǎn)“原始”一個(gè)對(duì)話接口、一個(gè)向量數(shù)據(jù)庫、一套硬編碼的角色提示詞所有邏輯擠在一個(gè)單體服務(wù)里。早期的確跑得挺順但隨著角色增多、用戶長期記憶變厚、交互方式從純文本擴(kuò)展到語音和圖片這套單體的毛病開始集中爆發(fā)。用戶聊到第十天一個(gè)請(qǐng)求塞進(jìn)去的上下文能占掉大半token配額角色人格忽冷忽熱想加一個(gè)日程提醒功能都要?jiǎng)又髁鞒檀a。我意識(shí)到問題不在某個(gè)模型不夠強(qiáng)而在組織架構(gòu)錯(cuò)了。后來我把整個(gè)系統(tǒng)推倒重來改成了基于 DeepAgents 編排、MCP 統(tǒng)一接工具、A2A 做智能體互聯(lián)、Skills 沉淀專業(yè)能力的多智能體架構(gòu)。這篇文章就是這次改造的完整復(fù)盤把“為什么拆”“怎么拆”“拆完遇到哪些坑”都講清楚。如果你手里也有一個(gè)從對(duì)話機(jī)器人往多智能體方向演進(jìn)的系統(tǒng)或者正在被上下文失控、角色不穩(wěn)定、功能難擴(kuò)展的問題折磨這篇內(nèi)容應(yīng)該能給你一些可以直接上手的思路。1. 為什么靈境伴侶必須從單體走向多智能體很多團(tuán)隊(duì)對(duì)多智能體的第一反應(yīng)是“炫技”。我做技術(shù)選型之前也這么想直到單體架構(gòu)的痛點(diǎn)真實(shí)發(fā)生在自己項(xiàng)目里我才意識(shí)到多智能體不是目的而是復(fù)雜對(duì)話系統(tǒng)在某個(gè)階段繞不開的工程方案。靈境伴侶的定位是 AI 虛擬陪伴用戶會(huì)創(chuàng)建一個(gè)虛擬角色和它連續(xù)聊幾個(gè)星期甚至幾個(gè)月。這個(gè)場景天然需要長期記憶、穩(wěn)定人格、多模態(tài)交互和個(gè)性化反應(yīng)單靠一個(gè)模型實(shí)例運(yùn)行全部邏輯是撐不住的。1.1 單體實(shí)現(xiàn)的三個(gè)死穴第一是上下文失控。用戶在第一天創(chuàng)建角色時(shí)說的“我叫小林喜歡貓”系統(tǒng)記下來了到第十五天用戶已經(jīng)和角色聊了幾百輪所有歷史消息如果都塞進(jìn)上下文模型能處理的上限很快被擊穿。即便用滑動(dòng)窗口截?cái)嘁矔?huì)丟掉早期的重要設(shè)定用戶會(huì)明顯感覺到“角色忘了我是誰”。我在單體階段用過摘要壓縮把每日對(duì)話總結(jié)成幾條要點(diǎn)塞進(jìn)系統(tǒng)提示但還是存在信息損失而且摘要本身也要算token。第二是角色人格不穩(wěn)定。單體模式下角色設(shè)定、性格參數(shù)、說話風(fēng)格、當(dāng)前情緒、長期記憶全部堆在一個(gè)系統(tǒng)提示里幾千字的提示詞會(huì)讓模型注意力分散。實(shí)測下來非常明顯同樣是溫柔型角色上午回復(fù)還會(huì)用“嗯嗯、好的”下午就變得公事公辦用戶詢問角色喜好角色可能給出和之前矛盾的回答。這不是模型不夠聰明而是把所有互相干擾的信息塞進(jìn)同一個(gè)上下文窗口模型根本不知道該優(yōu)先遵循哪一條。第三是功能擴(kuò)展困難。靈境伴侶想加記憶檢索、天氣查詢、圖片生成、日程提醒這些能力單體架構(gòu)只能往對(duì)話主流程里不斷塞分支。每加一個(gè)功能主服務(wù)的復(fù)雜度就上一個(gè)臺(tái)階回歸測試的工作量翻倍而且任何一項(xiàng)工具調(diào)用失敗都會(huì)拖垮整個(gè)對(duì)話響應(yīng)。到后期我甚至不敢隨手改一個(gè)角色卡字段因?yàn)椴恢梨溌防锬亩芜壿嫊?huì)因此崩潰。一個(gè)小功能要評(píng)審半天。1.2 多智能體架構(gòu)帶來的回報(bào)拆成多智能體之后我最大的直觀感受是“失控被控制住了”。原來所有事都由一個(gè)Agent干現(xiàn)在是不同Agent各管一段角色人格Agent只回答“這個(gè)角色應(yīng)該怎么說話”記憶Agent只負(fù)責(zé)“把這件事存下來/把這件事想起來”情感Agent只做“用戶這句話背后的情緒是什么”工具Agent只執(zhí)行“調(diào)用天氣接口并返回結(jié)構(gòu)化結(jié)果”。每個(gè)Agent的上下文都精簡到只包含自己需要的字段模型每步都能聚焦不會(huì)背景信息過載。剛才舉的三個(gè)死穴都有了對(duì)癥解法。上下文方面長記憶被收斂到記憶服務(wù)里每次對(duì)話按需檢索而不是全量灌入token開銷直接砍掉一半以上人格穩(wěn)定方面角色卡字段作為獨(dú)立模塊由人格Agent在每次回復(fù)前讀取并固化為風(fēng)格約束不會(huì)再被其他信息稀釋擴(kuò)展能力方面新功能以“工具”或“Skill”的方式掛到總線上不需要改主流程代碼加一個(gè)MCP服務(wù)、注冊(cè)一條A2A路由就能上線。我還發(fā)現(xiàn)一個(gè)額外好處每個(gè)Agent獨(dú)立部署、獨(dú)立更新之后出問題了可以通過日志和鏈路追蹤精確定位。原來單體階段出現(xiàn)一次異?；貜?fù)根本不知道是哪段提示詞或哪個(gè)函數(shù)出了問題現(xiàn)在只要看任務(wù)鏈路就能判斷是記憶Agent檢索失敗還是人格Agent讀取角色卡超時(shí)。這個(gè)可觀測性在單體階段是不可能有的。我和原來的架構(gòu)做過一組對(duì)比放在這里很直觀。對(duì)比維度單體架構(gòu)多智能體架構(gòu)上下文管理全量或粗暴截?cái)嘁讈G失關(guān)鍵記憶按需檢索專Agent專用上下文片段人格穩(wěn)定性依賴系統(tǒng)提示詞注意力漂移嚴(yán)重角色卡獨(dú)立加載人格約束穩(wěn)定功能擴(kuò)展方式改主流程牽一發(fā)動(dòng)全身注冊(cè)MCP工具或Skill低侵入問題定位鏈路模糊難定位異常來源任務(wù)ID貫穿全鏈路可精確溯源單功能故障影響拖垮整個(gè)對(duì)話降級(jí)或重試不影響主流程資產(chǎn)復(fù)用全部耦合在項(xiàng)目中Skills、Agent能力可跨產(chǎn)品復(fù)用2. DeepAgents、MCP、A2A、Skills 四件套到底解決什么問題多智能體不是把一堆Agent塞進(jìn)系統(tǒng)就行它需要一套組織邏輯。我在靈境伴侶里用到的四個(gè)東西各管一塊DeepAgents負(fù)責(zé)整體編排推理MCP負(fù)責(zé)統(tǒng)一接工具A2A負(fù)責(zé)Agent之間協(xié)作通信Skills負(fù)責(zé)復(fù)用專業(yè)能力。它們不是平行關(guān)系而是疊在一起形成完整工程閉環(huán)。下面逐個(gè)拆開說每個(gè)都用靈境伴侶的實(shí)際場景來對(duì)應(yīng)。2.1 DeepAgents把“一次生成”變成“多階段推理”DeepAgents在我理解里核心不是“多個(gè)Agent排隊(duì)跑”而是一種深度編排方式先由規(guī)劃層把用戶請(qǐng)求拆成有依賴關(guān)系的子任務(wù)再由執(zhí)行層按圖推進(jìn)最后統(tǒng)一匯總驗(yàn)證結(jié)果。我把這類比成拍電影單個(gè)模型像是全能演員什么都會(huì)演一點(diǎn)但一場復(fù)雜戲不可能靠一個(gè)演員從頭演到尾需要導(dǎo)演分鏡頭、場記記錄、道具組配合、化妝師按場景調(diào)整形象最后剪輯合成。靈境伴侶里有個(gè)典型場景用戶對(duì)角色說“我下周要去面試你陪我練練吧”。單體架構(gòu)下這句話會(huì)被當(dāng)成普通聊天內(nèi)容直接生成回復(fù)但多智能體編排下DeepAgents會(huì)先規(guī)劃出幾個(gè)子任務(wù)讀取用戶日歷看看下周哪一天確實(shí)有面試安排需要MCP工具、把角色切換成面試官人格需要人格Agent、確認(rèn)面試崗位后從知識(shí)庫檢索該崗位常見問題需要Skills、再讓角色以面試官口吻進(jìn)行模擬問答需要生成Agent。每個(gè)子任務(wù)有獨(dú)立的輸入輸出契約規(guī)劃層只負(fù)責(zé)調(diào)度不親自干活。這樣編排有什么好處第一是每個(gè)子任務(wù)都小巧聚焦模型不必在同一個(gè)上下文里既看日歷又調(diào)人格還生成回答錯(cuò)誤率顯著下降。第二是鏈路可觀測用戶說了一句話之后系統(tǒng)做了什么、每一步耗了多少時(shí)間、哪一個(gè)環(huán)節(jié)失敗都能拆出來單獨(dú)看。第三是支持插入人工干預(yù)節(jié)點(diǎn)比如安全Agent可以在生成前對(duì)模擬面試內(nèi)容做合規(guī)檢查這在單體架構(gòu)里很難做到位。實(shí)現(xiàn)DeepAgents時(shí)我推薦把任務(wù)依賴畫成有向無環(huán)圖而不是簡單的流水線。流水線是1→2→3順序執(zhí)行但真實(shí)場景很多子任務(wù)可以并行比如“讀取日歷”和“檢索面試題庫”互不依賴應(yīng)該并行做。我的做法是給每個(gè)子任務(wù)標(biāo)注依賴列表調(diào)度器只在依賴全部完成時(shí)才觸發(fā)執(zhí)行這個(gè)模型往后的擴(kuò)展性會(huì)好很多。2.2 MCP統(tǒng)一外部工具接入?yún)f(xié)議MCPModel Context Protocol解決的是大模型如何標(biāo)準(zhǔn)、統(tǒng)一地訪問外部數(shù)據(jù)與工具的問題。在沒有MCP之前我每接一個(gè)工具都要寫一套自定義調(diào)用代碼接數(shù)據(jù)庫寫一套查詢封裝接圖片生成寫一套HTTP請(qǐng)求接搜索再寫一套。模型要使用這些工具只能通過提示詞把工具描述塞進(jìn)去工具返回的數(shù)據(jù)格式也五花八門主模型需要費(fèi)力理解。MCP的邏輯可以類比成USB-C過去每個(gè)設(shè)備有自己的充電接口現(xiàn)在是統(tǒng)一接口插上就能用。MCP把工具和外部數(shù)據(jù)包裝成標(biāo)準(zhǔn)化“資源”和“工具”通過統(tǒng)一的協(xié)議暴露給大模型。架構(gòu)上分三層MCP Host承載模型的應(yīng)用程序比如靈境伴侶的主服務(wù)、MCP Client負(fù)責(zé)與Server建立連接的客戶端組件、MCP Server實(shí)際提供工具或資源的服務(wù)端。模型在Host里通過Client發(fā)現(xiàn)Server提供的工具列表按需調(diào)用返回統(tǒng)一格式的結(jié)果。靈境伴侶里接入的第一個(gè)MCP服務(wù)是記憶服務(wù)。原來我的記憶讀寫邏輯散落在代碼各處有的地方直接查向量庫有的地方走內(nèi)部REST接口主模型拿到數(shù)據(jù)后格式不統(tǒng)一。接入MCP之后記憶檢索和記憶寫入變成兩個(gè)標(biāo)準(zhǔn)工具定義好工具描述、入?yún)?、出參協(xié)調(diào)者Agent就能統(tǒng)一調(diào)用。后面再接天氣、日歷、圖片生成、音樂播放都是同一套流程不用再為每個(gè)工具單獨(dú)寫適配層。另一個(gè)實(shí)用價(jià)值是工具返回結(jié)果的規(guī)范化。我給記憶服務(wù)規(guī)定了返回結(jié)構(gòu)的最大體積、字段順序、摘要優(yōu)先級(jí)MCP Server在返回前就做好裁剪主模型拿到的永遠(yuǎn)是“top3相關(guān)記憶一句話摘要”而不是一大段原生檢索結(jié)果。這一點(diǎn)對(duì)控制token、保持主模型注意力都特別關(guān)鍵。2.3 A2A讓智能體之間真正協(xié)作起來A2AAgent-to-Agent是智能體之間協(xié)作的通信協(xié)議。如果說MCP解決的是“智能體怎樣用工具”A2A解決的就是“智能體怎樣給其他智能體派活、索要結(jié)果”。沒有A2A之前我在單體里想讓兩個(gè)Agent配合只能把其中一個(gè)Agent的輸出拼到另一個(gè)Agent的輸入提示詞里。這種做法在Agent少的時(shí)候勉強(qiáng)能跑一旦超過三四個(gè)調(diào)用關(guān)系就變成意大利面根本無法維護(hù)。A2A原本解決的是Agent之間發(fā)現(xiàn)能力、發(fā)送任務(wù)、同步狀態(tài)與交換結(jié)果的問題核心概念包括Agent Card描述一個(gè)Agent能力清單也就是“我是誰、我能干什么”、Task一次具體的協(xié)作請(qǐng)求帶任務(wù)ID、Message承載體、Artifact任務(wù)產(chǎn)出的數(shù)據(jù)結(jié)果。我理解它就像企業(yè)內(nèi)部不同部門之間的工單系統(tǒng)A部門不直接指揮B部門的人怎么干活而是發(fā)一個(gè)工單寫明“我需要什么、期望什么時(shí)候拿到”B部門處理完再回傳結(jié)果中間狀態(tài)可通過工單號(hào)跟蹤。在靈境伴侶里最頻繁的A2A協(xié)作發(fā)生在角色Agent和記憶Agent之間。用戶和角色聊到“你還記得我們第一次見面那天嗎”時(shí)角色Agent自己不知道答案它需要向記憶Agent發(fā)起一個(gè)查詢?nèi)蝿?wù)把用戶ID、角色I(xiàn)D、要檢索的主題作為Payload發(fā)過去記憶Agent檢索完成后返回一組結(jié)構(gòu)化的記憶片段。整個(gè)過程對(duì)用戶無感但系統(tǒng)層面是標(biāo)準(zhǔn)的A2A通信而不是拿一個(gè)Agent的完整回復(fù)拼模板。A2A還有一個(gè)關(guān)鍵設(shè)計(jì)任務(wù)狀態(tài)。子任務(wù)進(jìn)行中、已完成、失敗、被取消這些狀態(tài)都帶在消息協(xié)議里。主Agent可以通過輪詢或回調(diào)感知結(jié)果。我做靈境伴侶時(shí)把A2A消息加上超時(shí)控制避免某個(gè)Agent掛起導(dǎo)致全鏈路阻塞這個(gè)細(xì)節(jié)后面在踩坑部分再展開。2.4 Skills把專業(yè)能力沉淀為可復(fù)用資產(chǎn)Skills在智能體體系里充當(dāng)?shù)氖恰皩I(yè)手冊(cè)SOP”的角色。它把某類任務(wù)需要的提示詞模板、工具調(diào)用規(guī)則、參考案例、輸出格式要求打包成一個(gè)可加載的單元智能體在特定場景下才動(dòng)態(tài)地把這個(gè)Skill加載進(jìn)運(yùn)行環(huán)境而不是把所有知識(shí)和規(guī)則永久堆在系統(tǒng)提示詞里。為什么需要Skills兩個(gè)原因。第一是token有限不可能把所有專業(yè)能力都塞進(jìn)上下文。靈境伴侶既要做面試陪練、又要做心理咨詢、還要會(huì)講睡前故事把這些話術(shù)全部寫進(jìn)提示詞還沒開始聊天就已經(jīng)超出預(yù)算了。按需加載Skill后模型平時(shí)只保留基礎(chǔ)指令識(shí)別到用戶需求時(shí)再加載對(duì)應(yīng)專業(yè)單元。第二是知識(shí)隔離不同Skill之間規(guī)則可能互相沖突如果把沖突的指令同時(shí)放在上下文里模型行為會(huì)變得不可預(yù)測觸發(fā)條件加上規(guī)則隔離能避免這個(gè)問題。一個(gè)Skill文件通常包括三個(gè)部分元數(shù)據(jù)頭Skill的ID、名稱、觸發(fā)條件、依賴工具、優(yōu)先級(jí)、主體規(guī)則角色設(shè)定、步驟SOP、說話風(fēng)格示例、資源引用比如需要調(diào)用的MCP工具清單、參考文檔路徑。運(yùn)行時(shí)協(xié)調(diào)者根據(jù)用戶請(qǐng)求判斷命中哪些Skill再按優(yōu)先級(jí)注入當(dāng)前Agent的執(zhí)行上下文。我在靈境伴侶里給面試陪練場景定義過一個(gè)Skill觸發(fā)條件是用戶提到“面試”“入職”“offer”等關(guān)鍵詞加載后會(huì)切換角色人格激活“面試官語氣”同時(shí)調(diào)用日歷工具確認(rèn)面試時(shí)間再根據(jù)崗位類型從知識(shí)庫檢索常見面試題。沒有這個(gè)Skill之前這些邏輯散落在聊天分支里維護(hù)成本極高有了Skill之后它是一個(gè)獨(dú)立文件可以直接測試、修改、復(fù)用甚至遷移到另一個(gè)產(chǎn)品中。3. 靈境伴侶的改造實(shí)錄從角色模塊到工具鏈理論講完說點(diǎn)實(shí)操。我給靈境伴侶做的多智能體改造不是一次性推倒重來的而是先拆邊界、再定協(xié)議、后補(bǔ)資產(chǎn)的三步走。如果你也要做類似改造可以參照我當(dāng)時(shí)的執(zhí)行路徑先把整體角色分清楚再逐個(gè)實(shí)現(xiàn)MCP工具、Skill文件和A2A協(xié)作消息。3.1 角色分工與一次請(qǐng)求的完整旅程先看我現(xiàn)在系統(tǒng)里的Agent分工這張表在開發(fā)階段一直貼在白板上每個(gè)Agent干什么、輸出格式是什么都很明確。Agent名稱核心職責(zé)主要輸出物依賴的Skill協(xié)調(diào)者Agent意圖識(shí)別、任務(wù)分解、結(jié)果聚合、兜底回復(fù)結(jié)構(gòu)化子任務(wù)清單、最終回復(fù)無負(fù)責(zé)調(diào)度角色人格Agent加載角色卡、生成符合人設(shè)的表達(dá)風(fēng)格人格約束字段、語氣指令角色扮演基礎(chǔ)Skill記憶Agent長期記憶的寫入、檢索、沖突消解結(jié)構(gòu)化記憶片段或更新確認(rèn)記憶管理Skill情感Agent識(shí)別用戶情緒狀態(tài)輸出情感標(biāo)簽與介入建議情緒標(biāo)簽、建議動(dòng)作情感陪伴Skill工具Agent統(tǒng)一通過MCP調(diào)用外部工具并處理返回結(jié)果工具執(zhí)行結(jié)果、結(jié)構(gòu)化摘要工具適配Skill安全Agent內(nèi)容合規(guī)檢查、越界行為攔截放行/攔截標(biāo)記內(nèi)容安全Skill一次典型請(qǐng)求的完整旅程是這樣的用戶發(fā)來“我明天面試好緊張你能當(dāng)面試官幫幫我嗎”協(xié)調(diào)者Agent先做意圖識(shí)別判斷這是“求職陪練”場景而不是普通閑聊。接著進(jìn)入DeepAgents規(guī)劃層把請(qǐng)求拆成并行子任務(wù)角色人格Agent讀取當(dāng)前角色設(shè)定并切換到面試官模式工具Agent通過MCP調(diào)用日歷服務(wù)確認(rèn)用戶明天的日程面試陪練Skill被加載提供面試流程話術(shù)。這些子任務(wù)通過A2A協(xié)議分派給對(duì)應(yīng)Agent各自執(zhí)行完成后把結(jié)果匯總給協(xié)調(diào)者協(xié)調(diào)者最后統(tǒng)一生成一段完整的模擬面試開場白并交給安全Agent做合規(guī)檢查通過后返回給用戶。請(qǐng)求鏈路里可以看到三個(gè)關(guān)鍵動(dòng)作編排分工、工具調(diào)用、智能體協(xié)同。那Memory Agent在這個(gè)鏈路里出現(xiàn)在哪用戶和虛擬角色處于“面試輔導(dǎo)”這個(gè)新情境系統(tǒng)會(huì)把這個(gè)新記憶寫入長期記憶庫等第二天用戶真的面試完再來找角色復(fù)盤時(shí)記憶Agent就能檢索到“我昨晚陪用戶做過模擬面試”讓角色說得像真記住了這件事。這就是長期記憶在角色陪伴里的黏性價(jià)值。3.2 通過 MCP 接入記憶服務(wù)MCP服務(wù)的實(shí)現(xiàn)方式有很多種我用的是Python生態(tài)的FastMCP框架因?yàn)樗鼘?duì)工具注冊(cè)的封裝比較簡潔幾行代碼就能把一個(gè)函數(shù)變成模型可發(fā)現(xiàn)的工具。下面是我當(dāng)時(shí)寫記憶服務(wù)的最核心版本刪掉了業(yè)務(wù)細(xì)節(jié)保留結(jié)構(gòu)和注釋。# memory_server.py from fastmcp import FastMCP mcp FastMCP(memory-service) mcp.tool() def memory_search(user_id: str, role_id: str, query: str, top_k: int 3): 檢索用戶與虛擬角色之間的長期記憶片段返回最相關(guān)的top_k條。 Args: user_id: 用戶唯一ID role_id: 虛擬角色唯一ID query: 用戶當(dāng)前引用的關(guān)鍵信息或問題 top_k: 返回的記憶條數(shù)建議默認(rèn)3 Returns: 結(jié)構(gòu)化記憶列表每條包含時(shí)間、摘要、情緒標(biāo)簽、原文片段。 vectors embed(query) hits vector_db.search(collectionfmemories_{user_id}_{role_id}, query_vectorvectors, top_ktop_k) results [ { time: hit.time, summary: hit.summary, emotion: hit.emotion_tag, snippet: hit.snippet, score: hit.score, } for hit in hits ] return results mcp.tool() def memory_write(user_id: str, role_id: str, content: str, emotion_tag: str): 將一段對(duì)話內(nèi)容壓縮摘要后寫入長期記憶庫并記錄情緒標(biāo)簽。 summary summarize(content) vector_db.insert(collectionfmemories_{user_id}_{role_id}, textsummary, metadata{emotion: emotion_tag, time: now()}) return {status: ok, memory_id: gen_id()}這個(gè)MCP Server跑起來后在協(xié)調(diào)者Agent的配置里把endpoint指向它工具列表就會(huì)自動(dòng)出現(xiàn)在模型可調(diào)用的列表里。我在工具描述里刻意寫清楚入?yún)⒑x和返回結(jié)構(gòu)這是因?yàn)槟Ｐ涂棵枋鰶Q定何時(shí)調(diào)用、傳入什么參數(shù)描述寫得越嚴(yán)謹(jǐn)實(shí)際調(diào)用成功率越高。接入MCP后的一個(gè)要點(diǎn)是返回裁剪。原始向量庫檢索可能返回幾百字的長文本如果完整塞給模型既浪費(fèi)token又干擾判斷。我在Server端就把返回結(jié)果壓縮成上面代碼里的短結(jié)構(gòu)每段記憶只保留摘要和關(guān)鍵字段。實(shí)測下來同樣一次記憶檢索接入前主模型要讀800字原始文本接入后只讀120字的精煉結(jié)果響應(yīng)質(zhì)量和速度都有提升。3.3 Skills 加載與 A2A 協(xié)作的關(guān)鍵實(shí)現(xiàn)Skill文件的格式?jīng)]有統(tǒng)一強(qiáng)制標(biāo)準(zhǔn)我用的是YAML頭Markdown正文。YAML頭負(fù)責(zé)讓系統(tǒng)識(shí)別這個(gè)Skill的元信息Markdown正文負(fù)責(zé)給模型提供可執(zhí)行的規(guī)則。這里展示當(dāng)時(shí)面試陪練Skill的簡化版。--- id: interview_coach name: 面試陪練 description: 當(dāng)用戶提到面試、offer、簡歷、HR等關(guān)鍵詞時(shí)切換到面試官角色進(jìn)行模擬面試 trigger_keywords: [面試, offer, 入職, HR, 簡歷, 崗位] dependencies: mcp_tools: [calendar_check, web_search] agents: [role_persona_agent] priority: 5 --- # 面試陪練執(zhí)行規(guī)則 ## 角色 你是一位經(jīng)驗(yàn)豐富的HR面試官語氣專業(yè)但有親和力。 你當(dāng)前是虛擬角色“林溪”請(qǐng)用該角色的語言風(fēng)格進(jìn)行模擬面試。 ## 流程 1. 先確認(rèn)用戶面試的崗位和目標(biāo)公司 2. 檢索該崗位的常見面試題優(yōu)先使用web_search工具 3. 從簡單問題開始逐題模擬每題結(jié)束后給一句正面鼓勵(lì) 4. 如果用戶表現(xiàn)出明顯焦慮調(diào)用情感Agent獲取安撫話術(shù) ## 約束 - 每次只問一個(gè)問題不要連續(xù)追問 - 不要針對(duì)用戶的私人生活性別、年齡、婚育提出任何問題 - 回答保持口語化不要輸出“以上就是……”這類總結(jié)句式這個(gè)Skill文件具體怎么用運(yùn)行時(shí)協(xié)調(diào)者會(huì)先把用戶消息跑一遍關(guān)鍵詞匹配命中“面試”“offer”等詞后把Skill的正文內(nèi)容注入角色Agent的上下文同時(shí)把依賴的MCP工具calendar_check、web_search臨時(shí)注冊(cè)到工具區(qū)。整個(gè)加載過程對(duì)用戶無感但角色Agent的“知識(shí)結(jié)構(gòu)”已經(jīng)完全不同了。A2A協(xié)作的實(shí)現(xiàn)我給每個(gè)Agent注冊(cè)了一個(gè)獨(dú)立endpoint統(tǒng)一走同樣的消息協(xié)議下面是面試場景里協(xié)調(diào)者發(fā)給記憶Agent的一條消息示例。{ protocol: A2A, version: 1.0, task_id: task_1024, from: coordinator, to: memory_agent, operation: query, payload: { namespace: story_beats, query: 用戶和角色第一次見面那天的細(xì)節(jié), user_id: u_2058, role_id: r_linxi, top_k: 3 }, timeout_ms: 5000, callback: coordinator://resolve/task_1024 }收到這條消息后記憶Agent會(huì)執(zhí)行檢索然后把結(jié)果格式化成Artifact回傳?；貍飨⒗锿瑯訋е鴗ask_id協(xié)調(diào)者根據(jù)task_id把結(jié)果對(duì)齊到對(duì)應(yīng)子任務(wù)。這套設(shè)計(jì)保證了即使某個(gè)Agent內(nèi)部換模型、換版本只要協(xié)議不變整個(gè)鏈路都能正常協(xié)作。我在實(shí)現(xiàn)A2A時(shí)遇到一個(gè)比較常見的選擇題Agent之間是“直接互調(diào)”還是“統(tǒng)一走協(xié)調(diào)者轉(zhuǎn)發(fā)”我的答案是初期統(tǒng)一走協(xié)調(diào)者轉(zhuǎn)發(fā)不要放開任意兩個(gè)Agent直接通信。原因很簡單直接互調(diào)會(huì)形成網(wǎng)狀依賴排錯(cuò)難、審計(jì)難、很容易出循環(huán)調(diào)用統(tǒng)一走協(xié)調(diào)者則所有通信都有日志、有據(jù)可查。等系統(tǒng)成熟穩(wěn)定之后再考慮把高頻、低風(fēng)險(xiǎn)的固定對(duì)話鏈路優(yōu)化成直連。4. 工程落地中的坑與排查速查表多智能體改造不是搭完框架就完事了真正的瑣碎問題都出現(xiàn)在運(yùn)行期。這一節(jié)把我踩過的最典型的坑都列出來每條都給排查思路和解決方向最后附一張速查表方便你直接對(duì)照。4.1 token 爆炸與上下文污染第一版多智能體我犯了一個(gè)很蠢的錯(cuò)誤每個(gè)Agent在收到任務(wù)時(shí)都把用戶輸入的原文本復(fù)制一份塞進(jìn)自己的上下文以為這樣“信息最完整”。結(jié)果是一個(gè)中長度的多智能體調(diào)用鏈總共消耗了相當(dāng)于原來單體三倍以上的token響應(yīng)延遲也翻了幾番。這本質(zhì)上不是模型的問題而是上下文設(shè)計(jì)出了問題。解決方向是引入“黑板模式”。協(xié)調(diào)者在任務(wù)開始時(shí)只保留必要的元信息和任務(wù)ID各Agent只在自己執(zhí)行階段讀取需要的字段可以看作不同部門的員工共用一個(gè)公司公告欄需要哪條公告自己去查而不是人手一份全量文檔。具體落地時(shí)我給協(xié)調(diào)者增加了一個(gè)全局上下文對(duì)象里面只有用戶原始意圖、當(dāng)前任務(wù)依賴關(guān)系、需要共享的最終結(jié)果子Agent調(diào)用時(shí)通過A2A消息傳入的payload只包含該子任務(wù)需要的最小字段絕不傳全量對(duì)話歷史。實(shí)測之后同樣的面試陪練功能token消耗從多智能體版初版的12萬降到4.5萬而且回復(fù)質(zhì)量反而更好。核心原因很簡單模型每次只需要看一小塊信息注意力更集中生成的文本就更貼合目標(biāo)。4.2 子任務(wù)死鎖與編排超時(shí)多智能體系統(tǒng)有一個(gè)很反直覺的現(xiàn)象單個(gè)Agent都很正常連起來卻有概率卡死。我遇到的一次典型問題是角色Agent在一次請(qǐng)求里需要同時(shí)向記憶Agent和工具Agent求助我在實(shí)現(xiàn)A2A時(shí)用了同步阻塞回調(diào)結(jié)果記憶Agent超時(shí)未響應(yīng)角色Agent一直等待而協(xié)調(diào)者又在等角色Agent整個(gè)鏈路掛起直到網(wǎng)關(guān)超時(shí)。這個(gè)問題的根子在于“協(xié)作鏈路上沒有超時(shí)預(yù)算”。解決方案是給每個(gè)A2A消息加兩層控制第一層是單次請(qǐng)求超時(shí)時(shí)間比如5000毫秒第二層是任務(wù)跳數(shù)限制每轉(zhuǎn)發(fā)一次跳數(shù)加一超過5層時(shí)強(qiáng)制回退給協(xié)調(diào)者處理。同時(shí)把阻塞式調(diào)用改成異步回調(diào)模式父Agent發(fā)出子任務(wù)后不干等先去處理其他分支子任務(wù)完成后再通過回調(diào)把結(jié)果帶回來。我在系統(tǒng)里加了一個(gè)“兜底心跳”協(xié)調(diào)者每隔固定時(shí)間檢查未完成任務(wù)清單發(fā)現(xiàn)超時(shí)任務(wù)就標(biāo)記為失敗并從備用Agent或規(guī)則引擎里生成降級(jí)回復(fù)。經(jīng)此改造后類似卡死的情況再?zèng)]出現(xiàn)過最壞情況只是某次回復(fù)質(zhì)量差一點(diǎn)但整個(gè)請(qǐng)求不會(huì)掛死。4.3 MCP 工具返回噪音與工具降級(jí)MCP工具上線初期工具返回什么樣的數(shù)據(jù)直接決定了主模型能不能正確使用。我遇到過搜索工具返回10條完整網(wǎng)頁摘要每條200字模型一下要處理2000字噪音信息結(jié)果生成的回復(fù)變得冗長且偏離重點(diǎn)。后來我在工具描述和Server端同時(shí)做約束返回最多3條結(jié)果每條只保留標(biāo)題、核心結(jié)論和信源鏈接其余全部截?cái)?。另一個(gè)容易忽略的問題是工具故障。MCP Server是獨(dú)立服務(wù)它不可能永遠(yuǎn)在線一旦記憶服務(wù)掛了整個(gè)系統(tǒng)如果原樣把異常拋給模型模型會(huì)困惑甚至胡言亂語。我的做法是給每個(gè)關(guān)鍵工具配置降級(jí)策略記憶服務(wù)不可用時(shí)角色Agent自動(dòng)切換到“從當(dāng)前對(duì)話中提取臨時(shí)印象”模式雖然無法引用長期記憶但至少讓對(duì)話冷啟動(dòng)不中斷日歷工具不可用時(shí)協(xié)調(diào)者直接跳過日程確認(rèn)步驟改為在回復(fù)中詢問用戶。工具調(diào)用失敗后不要重試超過兩次。重試會(huì)增加延遲且大概率同樣失敗不如直接降級(jí)。我把這個(gè)規(guī)則寫進(jìn)了工具Agent的Skill里第一次失敗檢查錯(cuò)誤類型第二次失敗立刻降級(jí)絕不無限重試。4.4 常見問題排查速查表我把實(shí)際運(yùn)行中最常遇到的問題整理成表格表里的排查思路都是我親手驗(yàn)證過的可以直接當(dāng)作戰(zhàn)場手冊(cè)用?，F(xiàn)象可能的根因排查方向解決辦法角色語氣突然改變?nèi)烁馎gent未讀取角色卡檢查角色卡的讀取鏈路是否有緩存未更新人格Agent每次執(zhí)行前強(qiáng)制重新加載角色卡用戶問“你還記得嗎”但角色毫無反應(yīng)記憶Agent未匹配到相關(guān)記錄查看A2A消息中的namespace是否對(duì)不上統(tǒng)一記憶檢索的命名空間增加同義關(guān)鍵詞擴(kuò)招一次請(qǐng)求token消耗異常大子Agent上下文復(fù)制了全量歷史追蹤A2A消息中payload字段體積改為黑板模式只傳最小必要字段工具返回了格式很亂的JSONMCP Server輸出未做規(guī)范化檢查Server端是否有后處理步驟在Server端統(tǒng)一結(jié)構(gòu)僅返回必要字段兩個(gè)Skill同時(shí)觸發(fā)且指令矛盾Skill沖突檢測缺失查看命中Skill的優(yōu)先級(jí)和關(guān)鍵詞重合度增加優(yōu)先級(jí)仲裁運(yùn)行時(shí)只激活最高優(yōu)先級(jí)Skill子Agent卡死導(dǎo)致整個(gè)請(qǐng)求超時(shí)缺少單次超時(shí)和任務(wù)跳數(shù)限制查看A2A消息中的timeout與hops字段加超時(shí)預(yù)算、異步回調(diào)、兜底Agent降級(jí)模型反復(fù)調(diào)用同一個(gè)工具工具描述觸發(fā)條件寫得太寬泛檢查工具Description是否夠精確細(xì)化觸發(fā)條件增加不適用場景說明Agent之間出現(xiàn)循環(huán)調(diào)用允許了不受約束的直連接通信查看A2A路由日志是否有重復(fù)task_id初期全部走協(xié)調(diào)者轉(zhuǎn)發(fā)禁止網(wǎng)狀直連有些坑看起來很小但寫在這里我是有過真實(shí)教訓(xùn)的。比如“人格Agent未讀取角色卡”這種問題看起來像是模型隨機(jī)出錯(cuò)實(shí)際是角色卡在做緩存時(shí)沒有帶版本號(hào)導(dǎo)致更新后的設(shè)定無法生效。排查這類問題別只看模型輸出先看數(shù)據(jù)鏈路有沒有正確貫通。多智能體改造走到這一步我的體會(huì)是這套東西真正的價(jià)值不在“Agent數(shù)量多”而在組織邏輯清晰、邊界明確、每一條消息和工具調(diào)用都可追溯。靈境伴侶從單體切到多智能體之后新功能上線速度明顯變快記憶相關(guān)的問題少了大半角色人格也不再“精神分裂”。如果讓我再從頭做一次我會(huì)更早把邊界拆清楚而不是先寫一堆聊天邏輯再回頭重構(gòu)。最后分享一個(gè)測試技巧每接入一個(gè)MCP工具或新增一個(gè)Skill先用一條最小化的A2A消息單獨(dú)驗(yàn)證該Agent的執(zhí)行鏈路確認(rèn)沒問題再連進(jìn)全流程。別嫌這一步麻煩它能幫你省下后面排查復(fù)雜問題的一大把時(shí)間。