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