Deep Agents 入门指南：5 分钟跑通你的第一个智能代理

Deep Agents 入门指南5 分钟跑通你的第一个智能代理【免费下载链接】deepagentsThe batteries-included agent harness.项目地址: https://gitcode.com/GitHub_Trending/de/deepagents如果你让 AI 干过多步骤的活儿——查资料、改代码、整理文档——多半见过它干到一半忘了目标、越做越乱。Deep Agents 就是冲着这个问题来的一个基于 LangChain 和 LangGraph 的开箱即用智能代理框架把长任务需要的规划、文件读写、子代理、上下文管理全部内置拿来就能跑。长任务翻车根子在哪普通对话模型没有干活骨架长任务翻车通常卡在三点上下文爆仓上下文窗口有限多轮工具调用攒下的信息很快把它塞满模型开始遗忘、跑偏一个代理包打天下主线任务和支线细节混在一起注意力被稀释没有权限边界代理能直接写文件、执行命令一步错就可能搞乱你的环境Deep Agents 的定位就是补齐这层骨架它不造新运行时而是在 LangChain 的create_agent之上打包一套为长任务调优的默认配置——官方叫它 batteries-included电池全含。Deep Agents 把长任务必备件一次配齐规划加文件系统自己列清单、自己存中间结果代理会先自主拆解大任务、写下待办清单再把中间结果写进文件系统后端而不是全塞在脑子里。文件系统是可插拔的本地、沙箱或远端都能接仓库里已内置 Daytona、Modal、Vercel 等沙箱供应商的集成。子代理与技能按需组队、按需加载子代理主代理可以把子任务派给专职子代理它有独立的上下文窗口干完只回报最终结果不污染主线。技能Skills可复用的行为包提示词里只放名称和简介需要时才加载完整说明长提示词不会撑爆上下文。再加上 human-in-the-loop代理每次调用工具前你可以批准、修改或拒绝。两条路径上手路径一用 SDK 搭一个自己的代理一行uv add deepagents装好核心 SDK再用create_deep_agent指定模型、工具和系统提示词几行代码就能得到会规划、会读写文件的智能代理。它模型无关云端 API、开源模型、本地 Ollama只要支持工具调用就能接。路径二直接用现成的终端编码代理 不想写代码的话仓库里有一个现成的终端编码代理dcode体验类似 Claude Code。按 README 里的一条安装命令装好后直接得到能对话、改文件、执行命令的交互式智能代理想学组装方式可以看 libs/deepagents/ 核心包和 示例目录——text-to-sql、深度研究等示例都是可直接运行的完整项目。上手前绕不开的 3 个坑权限别靠模型自觉官方安全立场是信任 LLM代理能做工具允许的一切。正确姿势是在工具/沙箱层做边界约束再叠加 human-in-the-loop 审批兜底详见 THREAT_MODEL.md。让每一步都看得见长任务默认是黑盒接入 LangSmith 追踪后每次规划、工具调用、token 开销都有完整链路可查排查问题效率完全不同分层选型别搞混LangGraph 是运行时create_agent是轻量骨架Deep Agents 是它之上配齐的完整骨架。要全套默认能力选 Deep Agents只要轻骨架用create_agent代理循环本身不合适时再下沉到 LangGraph。一句话上手路线先跑一遍 dcode 感受配齐的代理长什么样再用 SDK 搭一个自己的垂直代理。想深入可以从 文档索引 和 架构总览 读起。【免费下载链接】deepagentsThe batteries-included agent harness.项目地址: https://gitcode.com/GitHub_Trending/de/deepagents创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考