Deep Agents 部署完整指南：5 步从快速上手到生产上线

Deep Agents 部署完整指南5 步从快速上手到生产上线【免费下载链接】deepagentsThe batteries-included agent harness.项目地址: https://gitcode.com/GitHub_Trending/de/deepagents摸清定位这个 Agent Harness 替你干了什么Deep Agents 是 LangChain 团队开源的电池全含式 Agent 框架构建在 LangGraph 之上文件系统读写、子代理委派、长上下文自动压缩、技能加载、人工审批这些能力全部内置不用自己拼中间件。它解决的核心问题是——多步骤、长程任务的 Agent 默认行为太弱而你要从零搭一套生产级 Agent通常得手写几十行规划、记忆、上下文管理代码。这篇笔记带你完成 Deep Agents 部署全流程本地跑通、验证三个核心场景、最后给出一条不折腾的上线路径。适用人群与前提条件都满足再往下看Python 3.9uv 会自动帮你拉合适版本装过 uv 最省心任一支持 tool calling 的大模型 API KeyOpenAI / Anthropic / Google 任选其一能访问 PyPI 的网络环境磁盘剩余空间 1GB 以上含示例项目依赖生产场景建议再备一个 LangSmith Key 做追踪可后补熟悉基本的 bash 操作无需其他前置知识一条命令装好 dcode再验证环境没翻车仓库里其实有两层东西deepagentsSDKPython 库写代码用和dcode预编译的终端编码 Agent开箱即用。上手推荐直接装 dcode一条命令不用碰工程目录# 全局安装 dcode脚本来自官方安装入口 curl -LsSf https://langch.in/dcode | bash装完跑一下这句确认没翻车能打印版本号即安装成功dcode --version如果只需要 SDK 自己在项目里拼 Agent备选方案一条命令uv add deepagents想从源码研究的话clone 仓库后进入各包目录uv sync即可。密钥配置就放在这一步别留到后面——在项目根目录建.env# 二选一取决于你用的模型 export OPENAI_API_KEYYOUR_API_KEY # 可选追踪与调试 export LANGSMITH_API_KEYYOUR_API_KEY然后起一次会话冒烟测试输入任意问题能流式返回答案环境就算通了。跑通三个最有代表性的场景场景一长程研究任务委派给子代理。价值一句话——复杂任务不用塞满主上下文create_deep_agent会自动规划、拆子任务、把中间产物落盘。最小可运行片段from deepagents import create_deep_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})预期效果Agent 会自己建 TODO、读写工作区文件、长对话时自动摘要压缩你拿到的result里直接是最终答复和文件产物。场景二终端编码 Agent替代手工调试。dcode就是干这个的流式输出、跨会话续接、工具调用前人工审批Human-in-the-loop、远程沙箱执行。直接在项目目录敲dcode进入 TUI让 Agent 修 bug、跑测试、写文档危险操作会先弹审批。注意官方安全模型不要在不可信目录裸跑配一个沙箱后端更稳。场景三自定义工具 技能扩展。不想用内置行为时把任意函数或 MCP Server 塞进tools参数即可仓库examples/下有一整套参考实现深度研究、Text-to-SQL、内容写作例如 examples/deep_research/ 就演示了 Tavily 搜索工具加子代理分工的完整配法照着抄最快。上生产前的检查清单一项项勾掉再发车.env密钥已配置且无明文提交到 Gituv sync依赖已锁定uv.lock随代码走dcode doctorSDK 场景则跑一次最小 invoke输出无红项模型与沙箱选型确定不可信代码走远程沙箱别跑在宿主机LangSmith 追踪已接入trace 能查失败重试与超时策略确认生产建议对 429/5xx 做退避资源上限限制并发子代理数与单次迭代轮数防账单失控服务化推荐 systemd不铺开讲其他选项。假设你的入口是项目里的main.py单元文件放/etc/systemd/system/deepagents.service[Unit] DescriptionDeep Agents service Afternetwork.target [Service] UserYOUR_USER WorkingDirectory/opt/deepagents/app EnvironmentFile/opt/deepagents/app/.env ExecStart/opt/deepagents/app/.venv/bin/python main.py Restarton-failure [Install] WantedBymulti-user.targetdcode 本身也内置了 headless 模式适合脚本和 CI 场景具体参数以官方文档为准。日志与状态三条命令够用systemctl status deepagents # 看服务状态 journalctl -u deepagents -f # 实时跟踪日志 dcode doctor # dcode 环境诊断配置、版本、追踪网关踩过的坑和解法以及往哪深挖高频问题四则现象uv: command not found→ 原因uv 没装 → 解法curl -LsSf https://astral.sh/uv/install.sh | sh现象模型调用 401/鉴权失败 → 原因环境变量没导出或导到了别的 shell → 解法echo $OPENAI_API_KEY确认为空就是没生效现象模型报 does not support tool calling → 原因选的小模型不支持函数调用 → 解法换成支持 tool calling 的模型换model参数即可框架对模型无锁定现象示例依赖冲突、版本解析失败 → 原因本地环境残留 → 解法uv clean后uv sync重装进阶方向换模型任何 LangChain chat model 对象都能传入、用 skills 和斜杠命令扩展 dcode 行为、接 MCP Server 挂内部系统、配 Daytona/Modal 等沙箱伙伴包——这些在 libs/deepagents/README.md 和 openwiki/ 里有更细的说明。延伸阅读libs/code/README.mddcode 完整能力与安全模型examples/深度研究、Text-to-SQL、内容写作等可直接参考的示例openwiki/architecture/overview.md三层架构职责划分openwiki/concepts/subagents-skills.md子代理与技能机制libs/ARCHITECTURE.md多包仓库结构总览【免费下载链接】deepagentsThe batteries-included agent harness.项目地址: https://gitcode.com/GitHub_Trending/de/deepagents创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考