3 步跑通 Deepagents搭一個(gè)智能文檔處理代理【免費(fèi)下載鏈接】deepagentsThe batteries-included agent harness.項(xiàng)目地址: https://gitcode.com/GitHub_Trending/de/deepagents多步驟任務(wù)做到一半上下文先爆了這是構(gòu)建智能文檔處理代理時(shí)最常見的失敗點(diǎn)。Deepagents基于 LangChain/LangGraph 的智能體框架把規(guī)劃清單、文件讀寫后端和子代理委派默認(rèn)打進(jìn)同一個(gè)代理里你只管定義任務(wù)它自己拆解、執(zhí)行、落盤。30 秒跑通環(huán)境最短路徑是安裝加一個(gè)入口函數(shù)沒(méi)有額外配置項(xiàng)。uv add deepagentsfrom deepagents import create_deep_agent agent create_deep_agent(modelopenai:gpt-5.5) agent.invoke({messages: 把這份年報(bào)拆成 3 個(gè)要點(diǎn)})想先讀代碼再上手克隆倉(cāng)庫(kù)后從 libs/deepagents/deepagents/graph.py 的create_deep_agent開始默認(rèn)掛載的工具在 docstring 里列得很清楚。機(jī)制拆解規(guī)劃、后端、子代理怎么分工三個(gè)核心能力都落在中間件和后端兩層各看一小段實(shí)現(xiàn)就明白它怎么工作。規(guī)劃一張寫進(jìn)狀態(tài)的待辦清單代理拿到任務(wù)后先用規(guī)劃工具把目標(biāo)拆成待辦項(xiàng)執(zhí)行中逐條更新規(guī)劃結(jié)果存在狀態(tài)里而不是只活在對(duì)話中。效果是長(zhǎng)任務(wù)可追蹤、可中斷、可恢復(fù)——斷掉重連后代理能從清單知道干到哪一步了。文件系統(tǒng)后端讀寫搜索跑在可插拔的盤上ls、read_file、write_file、edit_file、glob、grep這組工具背后是一個(gè)BackendProtocol協(xié)議實(shí)現(xiàn)位于 libs/deepagents/deepagents/backends/filesystem.py接本地盤sandbox.py接沙箱store.py、state.py接遠(yuǎn)端或狀態(tài)存儲(chǔ)。后端可換工具面不變——這是文檔落盤能跨部署環(huán)境成立的原因。子代理主腦只收結(jié)論不收過(guò)程libs/deepagents/deepagents/middleware/subagents.py 通過(guò)一個(gè)task工具暴露子代理每個(gè)子代理有獨(dú)立上下文窗口干完只把最終結(jié)果回傳主代理。主代理的上下文因此保持輕量中間步驟的 token 消耗被隔離在子代理內(nèi)部。按步驟搭一個(gè)文檔處理代理以文檔入庫(kù)后自動(dòng)拆解、分析、匯總為例四步走完定義文檔工具把解析、檢索函數(shù)注冊(cè)為tools掛文件后端中間產(chǎn)物逐份文檔的分析片段寫盤聲明子代理一個(gè)負(fù)責(zé)單文檔分析主代理逐份派發(fā)匯總主代理讀盤上的片段合成最終報(bào)告。agent create_deep_agent( modelopenai:gpt-5.5, tools[doc_parse], subagents[dict(namedoc-analyst, description分析單份文檔, system_prompt…)], )行為細(xì)節(jié)由中間件棧接管目錄在 libs/deepagents/deepagents/middleware/summarization.py壓長(zhǎng)對(duì)話permissions.py控文件訪問(wèn)memory.py存跨會(huì)話記憶。其中FilesystemMiddleware與SubAgentMiddleware是必需項(xiàng)源碼里被標(biāo)記為不可剔除——剔除會(huì)直接拋錯(cuò)防止能力被靜默降級(jí)。常見坑與調(diào)優(yōu)四個(gè)實(shí)操結(jié)論來(lái)自源碼里的默認(rèn)行為與注釋。子代理的description決定主代理何時(shí)派單寫得模糊就會(huì)被跳過(guò)用動(dòng)作導(dǎo)向的短句描述職責(zé)長(zhǎng)會(huì)話靠summarization.py壓縮加工具輸出落盤不要手工截?cái)嘞踩吔缭诠ぞ吲c沙箱層倉(cāng)庫(kù)明確采用信任模型、邊界靠權(quán)限的模型用permissions規(guī)則加sandbox.py后端兜底子代理數(shù)量沒(méi)有魔法數(shù)字按任務(wù)可并行度來(lái)每個(gè)子代理只回傳結(jié)論成本天然受控規(guī)劃深度則保持待辦清單簡(jiǎn)短讓狀態(tài)自己滾動(dòng)。適合誰(shuí)還能延伸到哪這套 harness 適合長(zhǎng)鏈路多步驟的工作文檔流水線、調(diào)研綜述、報(bào)告生成任何上下文會(huì)先爆的任務(wù)。倉(cāng)庫(kù) examples 目錄里有 text-to-sql、內(nèi)容寫作等現(xiàn)成可跑的模式終端編碼代理 libs/code/ 也是同一 harness 的另一形態(tài)。下一步建議挑一批真實(shí)文檔照著上面四步把第一個(gè)文檔處理子代理跑通再對(duì)著中間件目錄逐個(gè)確認(rèn)它的行為是否符合預(yù)期。【免費(fèi)下載鏈接】deepagentsThe batteries-included agent harness.項(xiàng)目地址: https://gitcode.com/GitHub_Trending/de/deepagents創(chuàng)作聲明：本文部分內(nèi)容由AI輔助生成（AIGC），僅供參考