系列回顧主循環(huán) · 代碼庫工具 · REPL · 項目上下文 · Skills · 權(quán)限 Write · MCP 概念 · MCP 實現(xiàn) · Context Budget · Bash · compact 2.0 · autocompact · Hooks · Memory主會話一路 Read / Grep / Bash細(xì)節(jié)全堆進(jìn)messages[]——下一輪還要帶著這些噪音繼續(xù)聊。人會說「你去旁邊查一下回來只告訴我結(jié)論?！惯@篇講v6-subagents內(nèi)置Agent工具同步嵌套一次query()子任務(wù)用獨立消息列表跑完只把摘要塞回父會話的tool_result——父循環(huán)骨架仍是原來的 ReAct。為什么需要「旁邊那間屋」主會話適合定目標(biāo)、做決策、改代碼。不適合一次性掃半個倉庫、跑一長串探索工具卻把每一步軌跡永久留在父歷史里。主會話自己干Agent子代理消息歷史寫進(jìn)QueryEngine.messages獨立數(shù)組不寫回父回給主模型的整段 tool 軌跡末條 assistant 文本摘要上下文污染高低費用/延遲少一次嵌套多一次完整子循環(huán)所以子代理不是「另一個產(chǎn)品」而是同一套query()換一間干凈房間干完只交報告。工具長什么樣Agent({description:Find auth entrypoints,// 必填3–5 詞短描述TRACE / 狀態(tài)prompt:在倉庫里找出登錄相關(guān)入口文件只列路徑與一句理由。,// 必填子任務(wù)全文tool_names:[Glob,Grep,Read],// 可選子工具白名單})字段必填作用description是給人看的短標(biāo)簽不當(dāng)子推理正文prompt是子會話的第一條 user 消息tool_names否白名單缺省 父工具表去掉Agent后的全部父側(cè)tool_result成功時大致是[Agent: Find auth entrypoints] src/auth/login.ts — 登錄表單入口 …中間子工具的tool_use/tool_result不會進(jìn)入父messages。一張圖嵌套怎么跑父 querydepth0 → 模型 tool_use: Agent → AgentTool.call → createSubagentContextdepth1新 AbortController 鏈到父 → toolsForSubagent去掉 Agent可選白名單 → 嵌套 query({ messages: [prompt], depth: 1, … }) → 子自己 ReActcallModel → 工具 → … → 取最后一條 assistant 的 text≤32KB超長留尾 → 父 tool_result [Agent: description] 摘要 → 父繼續(xù)下一輪對應(yīng)實現(xiàn)src/tools/AgentTool.tssrc/utils/subagent.ts。防遞歸兩道閘子代理若還能再調(diào)Agent就會無限套娃。mini 用雙保險子工具池排除AgenttoolsForSubagentdepth上限默認(rèn) 1父為 0 時可 spawn depth1已在 depth≥1 再調(diào) → 直接錯誤tool_result不啟嵌套depth 0主會話──Agent──? depth 1子 └── 再 Agent→ 拒絕 / 池子里根本沒有depth與 Stop hooks共用同一語義只有depth 0跑 Stop子代理收尾不跑 Stop也不做單獨的SubagentStop。權(quán)限、中止、失敗主題行為權(quán)限默認(rèn)復(fù)用父canUseTool父 deny 對子生效寫操作仍可能彈 REPLy/NAbort子有獨立AbortController但鏈到父父中止 → 子中止失敗異常 /aborted/ 無文本 → 父側(cè)is_error的tool_resultfail-soft不炸主循環(huán)Compact子用同一套 deps子歷史獨立不寫回父 EngineAgent標(biāo)成非只讀、非并發(fā)安全派生子任務(wù)有副作用與串行成本不跟只讀工具搶并發(fā)。和 Skills / Memory / Hooks 怎么區(qū)分機制一句話Skills往主會話注入說明書仍在同一 messagesMemorysystem 里跨會話偏好Hooks工具前后攔 / 記Stop 只在頂層Agent另開一輪嵌套 query只交摘要Skills 是「給當(dāng)前大腦多讀一頁紙」Agent 是「派一個實習(xí)生去查回來交紀(jì)要」。30 秒感受一下bun run dev# 或 mock需能走到真實工具時再試 Agent自然語言示例用 Agent 工具在倉庫里找與 MCP 配置相關(guān)的文件只返回路徑列表。 description 用 Locate MCP config。TRACE1時 stderr[trace] agent.start descriptionLocate MCP config depth1 [trace] agent.end descriptionLocate MCP config oktrue reasoncompleted和主循環(huán)的關(guān)系L1 主 query / QueryEngine → 照舊Agent 只是多一個 Tool L2 AgentTool.call → 嵌套 query獨立 messages L3 createSubagentContext → depth1、abort 鏈、工具池裁剪 L4 摘要回傳 → 父 tool_result子軌跡不進(jìn)父歷史子代理復(fù)用query()不另寫一套循環(huán)隔離的是消息列表與深度不是換引擎?？桃鉀]做什么沒做意味著什么swarm / 多 worker / Coordinator一次一個同步子任務(wù)worktree / 后臺 fork子跑完才回父無并行隔離目錄subagent_type命名 agent 目錄不按角色配置多套 agentSubagentStop子收尾不跑 Stop頂層 Stop 另算完整 resume UI / 換模型字段入?yún)⒅挥?description / prompt / tool_names這一刀驗證的是「隔離調(diào)研」的最小面Agent 工具 → 嵌套 query → depth≤1 排除 Agent → 權(quán)限派生 → 摘要回父 → TRACE 可觀測系列拼圖篇能力主循環(huán)單會話 ReActcompact / Memory主會話怎么瘦、怎么記住Hooks工具生命周期本篇旁路子任務(wù)結(jié)論回傳Harness 再多一根柱子循環(huán)、工具、會話、上下文、技能、權(quán)限、MCP、預(yù)算、hooks、memory、subagent。你可以從這里帶走什么子代理 嵌套query() 獨立 messages——不是新框架。父只要摘要——中間工具軌跡留在子會話里。防遞歸靠池子 depth——去掉Agent且默認(rèn) maxDepth1。權(quán)限與中止要繼承——派生canUseToolabort 鏈到父。depth 是全局語義——頂層才 Stop子不跑 Stop。失敗 fail-soft——錯誤進(jìn)父tool_result主循環(huán)繼續(xù)。倉庫與相關(guān)文檔GitHubhttps://github.com/jimchou-h/react-agent-mini上一篇Memory源碼AgentTool.ts · subagent.ts術(shù)語src/tools/CONTEXT.md歡迎 Star、Issue 和 PR。本文基于 react-agent-mini 變更v6-subagents同步Agent工具 depth/防遞歸 摘要回傳撰寫。