Deepagents快速实战：如何搭建一个能长跑任务的AI代理

Deepagents快速实战如何搭建一个能长跑任务的AI代理【免费下载链接】deepagentsThe batteries-included agent harness.项目地址: https://gitcode.com/GitHub_Trending/de/deepagentsDeepagents是一个MIT许可的开源AI代理框架构建在LangGraph提供流式、持久化能力的图运行时之上。它把规划、文件读写、子代理和上下文管理打包成开箱即用的深度代理专治任务跑不完、状态存不住的问题。 场景切入为什么demo代理活不过真实任务搭一个能答话的demo并不难难的是让代理干完真实的活。社区维护者常碰到的痛点任务跑了几十步上下文撑爆中途断掉重来前面做的全丢出问题时不知道卡在哪一步。Deepagents把这三件事一起解决LangGraph运行时负责流式与检查点持久化内置的上下文管理会把长对话压缩、把工具的大输出落盘子代理让每个子任务拥有独立的上下文窗口互不挤占。这些默认配置你不用自己拼装上就能用。 代理快速上手从安装到第一次调用一行命令完成安装uv add deepagents # 或者用 pip pip install deepagents三步创建第一个代理三步装依赖、传模型、写一句系统提示词。from deepagents import create_deep_agent agent create_deep_agent( modelopenai:gpt-5.5, system_prompt你是一个研究助理。, ) result agent.invoke({messages: 分析当前仓库结构并输出报告})调用之后这个代理已经会自己拆解任务、读写文件、管理上下文。不想写Python也行libs/code/ 里有一个终端编程代理装好就能在命令行里直接对话。这张截图展示了Deepagents终端AI代理的运行界面- 追踪状态、当前token用量和所用模型都摆在明面上帮你随时确认代理的运行情况。 Ralph循环详解让AI代理自己迭代到任务完成Ralph循环是一种长任务模式给它一个任务代理干一阵把进展写进文件系统然后开一轮全新上下文接着干同一个任务如此往复直到目标达成或你按下CtrlC。这张图展示了Deepagents中Ralph模式的完整闭环任务、代理与文件系统- 文件系统充当代理的外挂记忆每一轮都能接着上一轮的成果继续长任务不怕上下文溢出。每轮都用干净上下文起步天然绕开了长对话的两个坑token超限和错误累积。examples/ralph_mode/ 里的示例脚本还支持限制迭代次数和接入Modal、Daytona等远程沙箱代码执行都在隔离环境里跑。 三个真实应用场景Deepagents具体怎么干活自动代码审查让代理用内置的文件工具通读代码库按仓库规则跑lint检查然后输出改进清单。repo的examples目录里就有一个完整的编码代理示例照抄就能跑。智能文档维护代理先用grep、glob类工具定位相关文档再用文件编辑工具改内容、写变更说明。examples/content-builder-agent/ 把品牌语气写进AGENTS.md、把写作流程做成按需加载的skill连续写出一批风格统一的文档。自然语言转SQL的数据查询examples/text-to-sql-agent/ 先探索表结构再生成SQL并跑通验证最后给出结果。每一步都能在LangSmith记录代理执行轨迹的追踪平台里回放。这张截图展示了Deepagents AI代理执行SQL任务的完整轨迹- 中间步骤、时间戳和令牌消耗都可见出错时能直接定位到具体哪一步。️ 定制与扩展接入自己的模型、工具和提示词代理的三个入参就是你的三个扩展点换模型model参数接受任何支持工具调用的LangChain聊天模型前沿API、开源权重、本地部署都能接加工具tools参数传入你自己的函数也可以接入任何MCPModel Context Protocol一种让代理调用外部工具的标准协议服务器定行为system_prompt写清楚角色和边界配合memory、skills参数把长期约定落进文件系统⚠️ 避坑与最佳实践安全、性能与测试安全边界Deepagents遵循信任LLM模型代理会做工具允许的任何事。边界要在工具或沙箱层强制执行比如把代码执行放进远程沙箱别指望模型自我克制启动性能给CLI加功能时别在模块级或参数解析路径里导入重包这些导入会拉进整棵依赖树连--version都会变慢测试要求新功能和修复必须带单元测试测试可观测行为而不是复制实现逻辑警告即错误先修掉再谈过滤收尾Deepagents就是一个为长任务而生的AI代理框架模型、工具、提示词都是你的缺什么补什么。下一步很简单——把本文快速上手那段代码跑起来或者从examples目录挑一个示例跑通一个下午你就能体会到它和demo代理的差距。【免费下载链接】deepagentsThe batteries-included agent harness.项目地址: https://gitcode.com/GitHub_Trending/de/deepagents创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考