Deep Agents 实战指南：内置文件工具与子代理，快速跑通第一个深度智能体
Deep Agents 实战指南内置文件工具与子代理快速跑通第一个深度智能体【免费下载链接】deepagentsThe batteries-included agent harness.项目地址: https://gitcode.com/GitHub_Trending/de/deepagentsDeep Agents 是基于 LangGraph 构建的开源智能体开发框架。一次create_deep_agent调用即获得内置文件工具、子任务委派与上下文压缩解决多步长任务智能体开发中的上下文失控和工具缺失问题适合刚上手 LLM Agent 应用的个人开发者与小团队。项目定位长任务 Agent 最难的两块它默认就补上了新手搭 Agent通常不卡在思考—调工具—看结果这个循环上而是卡在后两件事任务一长上下文窗口就爆掉模型开始丢信息想让 Agent 读写文件又得自己写工具和存储。Deep Agents 把这两件事做成了默认行为。它架在 LangChain 的create_agent之上LangGraph 是图运行时create_agent是轻量骨架Deep Agents 则是把文件系统、子代理、摘要压缩整套中间件捆进一个函数里的完整脚手架任何一块都可以按名字覆盖替换不用 fork。三层关系见 README 的 FAQ 章节。核心机制拆解三个内置中间件文件系统工具与可插拔后端FilesystemMiddleware一次性注册ls、read_file、write_file、edit_file、glob、grep六个文件工具和execute命令工具。存储层由 backends/ 目录下的可插拔后端承担默认StateBackend把文件存在会话状态里换成FilesystemBackend就直接读写磁盘接入沙箱后端后才激活execute工具。切换只需在create_deep_agent里传一个backend参数组装逻辑见 核心源码。上下文自动压缩与历史外置SummarizationMiddleware盯住 token 用量超过阈值如 85%自动把旧消息摘要并把完整历史以 markdown 形式落到后端的/conversation_history/{session_id}.md随时可回查也可以靠compact_conversation工具按需触发。长任务不再被窗口上限卡住实现在 middleware/summarization.py。task 工具把子任务拆给独立子代理middleware/subagents.py 里的SubAgentMiddleware对外只暴露一个task工具。主 Agent 自己判断何时委派每个子代理拥有独立上下文窗口可单独指定模型、工具集和文件权限。不配置子代理时会自动补一个 general-purpose 默认子代理委派能力始终可用。上手路径从获取代码到跑通第一个功能第一步获取代码。装 SDK 只需一条命令想看源码和样例就克隆仓库git clone https://gitcode.com/GitHub_Trending/de/deepagents第二步关键配置。三个参数决定行为model收provider:model格式的字符串system_prompt定义角色tools是追加式的不会挤掉内置工具。API 模型、开源模型、Ollama 本地模型都支持前提是模型支持工具调用。第三步跑通第一个功能。建一个 Agent让它调研并把结果写进文件agent create_deep_agent(modelopenai:gpt-5.5, system_promptYou are a research assistant.) result agent.invoke({messages: Research LangGraph and write a summary to report.md}) print(result[messages][-1].content)对话末尾出现摘要、目标文件被写出来说明文件读写和上下文管理链路已经跑通。仓库 libs/code/ 目录还有预置终端代理dcode不写代码也能先体验一把场景走查一次调研任务的完整执行以 deep_research 示例 为参照。输入一句调研向量数据库的现状。处理主 Agent 按系统提示把主题拆成若干子课题逐个调用task派给 researcher 子代理子代理用tavily_search工具检索、整理成结构化要点后返回。子代理上下文独立主 Agent 窗口始终干净长调研不会撑爆它。输出主 Agent 汇总各子代理结果用write_file落成报告文件同时留下可回放的调用链路想动手先按上面的步骤把最小 Agent 跑起来。再对照 examples/ 里的现成代理换自己的工具和子代理提示词。最后用 middleware/ 里的扩展点接入业务逻辑就能从演示走到可用的产品。【免费下载链接】deepagentsThe batteries-included agent harness.项目地址: https://gitcode.com/GitHub_Trending/de/deepagents创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考