从零构建Coding Agent：Deuz SDK写代码、跑测试、自愈循环完整教程-北京尧图网络

【免费下载链接】Deuz-SDKTypeScript AI SDK and agent framework with zero dependencies. Build production AI agents and multi-agent swarms: durable execution, long-term memory, hybrid RAG, MCP client/server, A2A, human-in-the-loop approvals, CodeAct sandboxes, realtime voice. One streaming API, 29 providers: Claude, GPT, Gemini, Grok, DeepSeek, Ollama. Node, Bun, Deno, edge.项目地址https://gitcode.com/gh_mirrors/de/Deuz-SDK点击查看免费下载本文带你使用 Deuz SDK 从零构建一个 Coding Agent编码智能体它会读文件、改代码、跑测试在工具报错时自愈重试全程受预算与审批门禁控制。Deuz SDK 是一个零运行时依赖的 TypeScript AI Agent 框架一个流式 API 即可接入 Claude、GPT、Gemini、Grok 等主流模型跑在 Node、Bun、Deno 与 Edge 之上。一、为什么选 Deuz SDK 来搭 Coding Agent 构建 Coding Agent 通常需要自己拼一堆积木工具循环、子代理、错误恢复、预算控制、上下文压缩。Deuz SDK 把这些都变成了现成原语官方 cookbook 里甚至有一份完整的 Coding Agent 构建手册架构图长这样orchestrator编排者generateText / streamChat └─ tools: { coder: agentTool(...) } ← 子代理 └─ coder 子代理 └─ tools: readFile / writeFile / applyPatch / runTests / runShellCommand编排者orchestrator只负责和用户对话、拆任务绝不直接碰文件系统coder 子代理负责真正的动手干活读写文件、打补丁、跑测试、执行 shell 命令审批策略、token/成本预算、自动压缩compaction在每一层都生效官方基准测试中Deuz SDK 在 Coding 场景拿到 76 分见上方图表并且核心包体积只有 10 MB是同类框架里最轻的之一。二、安装与第一个 Agent5 分钟上手先安装并配置一个模型 API Key以 Anthropic 为例npm install deuz-sdk/coreimport { runAgent } from deuz-sdk/core/agent; import { createAnthropic } from deuz-sdk/core/anthropic; const anthropic createAnthropic({ apiKey: process.env.ANTHROPIC_API_KEY }); const result await runAgent({ model: anthropic(claude-opus-4-8), prompt: 解释一下彩虹是怎么形成的, maxSteps: 4, });⚠️ 新手最容易踩的坑maxSteps默认是1。带了工具却不设步数上限循环只跑一轮工具调用就停了模型根本看不到工具结果。任何真实工具场景请把它设大于 1。三、定义 5 个编码工具让 Agent 会读码、改码、跑测试工具Tool就是模型能按名字调用的函数descriptionparameters参数 schema execute执行体。Coding Agent 需要 5 个核心工具工具作用是否破坏性操作readFile读工作区文件否writeFile覆盖写文件✅ 需审批applyPatch应用 unified diff✅ 需审批runTests跑测试套件返回 pass/fail 与输出否runShellCommand在工作区沙箱执行命令✅ 需审批关键写法只有一个原则破坏性工具全部标记needsApproval: true例如writeFile: { description: Write (overwrite) a UTF-8 text file in the workspace., parameters: z.object({ path: z.string(), content: z.string() }), needsApproval: true, // 破坏性操作需要审批 execute: async ({ path, content }, ctx) { /* 只写在沙箱工作区内 */ }, };另外三条工程铁律来自官方 cookbook输出必须截断——一次不受限的runTests长日志就能撑爆上下文窗口和你的账单stdout 和 stderr 分开捕获不要混成一坥无法推理的 blob把ctx.signal传给所有子进程这样编排者一 abort测试/命令真正会被杀掉四、用 agentTool 把 coder 包成子代理 agentTool能套娃一个完整的多步循环包成一个普通工具供编排者调用import { agentTool } from deuz-sdk/core; const coder agentTool({ name: coder, description: Writes and tests code changes: reads/writes files, applies patches, runs the test suite., model: coderModel, tools: codingTools, system: Read before you write, run tests after every change, keep diffs minimal., maxSteps: 20, // 子代理天然多步预算要比编排者更宽 });然后编排者调用时只需要tools: { coder }——它唯一知道的就是 coder 这个工具。完整可参考 coding-agent cookbook 第 4、5 节。五、自愈循环工具抛错为什么不会崩这是 Coding Agent 与普通调用的本质区别。Deuz SDK 的 agentic loop 是**自愈self-healing**的工具抛异常、参数校验失败、甚至模型幻觉出工具名统统不会把整个调用炸掉而是变成一条isError: true的tool_result喂回给模型让它换参数重试或换工具。失败原因模型看到的信息execute抛错错误本身的 message参数 schema 校验失败Invalid arguments: …工具名不存在No such tool: x. Available tools: a, b, c.超时Tool x timed out after Nms and was abandoned.同时内置失控保护runaway guard同一个工具连续 3 步报错循环直接硬停避免模型对着坏工具死循环烧掉整个步数预算。细节见 tool-loop.mdx 自愈章节。对 Coding Agent 来说这意味着测试失败、命令打错、路径写错都是模型看得见的反馈而不是进程崩溃——这就是标题里自愈循环的来源。六、预算、压缩与审批让长任务跑得完、烧不起三个选项组合起来让多文件、多轮的长会话既不超支也不失控stopWhen: [totalTokensExceed(500_000), costExceeds(5.0)]——真实花费的硬上限且统计的是编排者 coder 的合并用量跑完后result.providerMetadata?.deuz.stoppedBy会告诉你到底是预算还是模型自然结束的compaction: auto——自动分层压缩历史长时间会话不会撑爆上下文approveToolCall——一个策略函数继承到 coder 的每一层深度runShellCommand、writeFile、applyPatch在每一层都被同一规则门禁️ 重要提醒审批不是沙箱。needsApproval只决定允不允许跑不管跑起来能碰到什么。文件与 shell 工具必须放进真实沙箱/受限工作区命令走白名单拒绝..路径穿越且绝不要把主机密钥暴露给 shell 工具。七、流式观察与持久化看着 coder 干活、崩了能续上流式渲染把generateText换成streamChatcoder 子代理的完整规范流会以带agentPath标签的sub-agentparts 转发进fullStream你在终端里就能实时看到[coder] calling runTests这样的逐代理活动流持久化断点给任一入口传session: { store, runId }循环会在每个完成的步骤边界存一个AgentCheckpoint进程挂了之后用resumeFromCheckpoint从最后边界继续。审批挂起的状态也能通过approvalResponses续上官方还提供了一个可直接运行的完整示例Manus 风格的自治代理含 plan → executor 子代理 →verifyStep验证器CodeAct 沙箱里写码跑码示例入口examples/06-autonomous-agent/自治手册autonomous-agent cookbook其中verifyStep会驱动编排者直到子任务可验证完成是自愈循环的上层形态工具循环参考The Agentic Tool Loop工具定义参考Defining Tools八、小结你的 Coding Agent 已经跑起来了 ✅回顾一下这套组合拳5 个工具读/写/补丁/测试/shellagentTool子代理自愈工具循环token/成本预算自动压缩审批门禁持久化断点。没有任何新运行时全部由generateText/streamChatstopWhencompaction: auto组合而成——这就是 Deuz SDK 作为零依赖生产级 Agent 框架的用法。下一步建议直接跑 06-autonomous-agent 示例把ANTHROPIC_API_KEY配好观察它如何在.agent-workspace/里真正读写文件、执行命令并自验证结果。赞分享【免费下载链接】Deuz-SDKTypeScript AI SDK and agent framework with zero dependencies. Build production AI agents and multi-agent swarms: durable execution, long-term memory, hybrid RAG, MCP client/server, A2A, human-in-the-loop approvals, CodeAct sandboxes, realtime voice. One streaming API, 29 providers: Claude, GPT, Gemini, Grok, DeepSeek, Ollama. Node, Bun, Deno, edge.项目地址https://gitcode.com/gh_mirrors/de/Deuz-SDK点击查看免费下载相关推荐从零构建类型化AI AgentDeuz SDK createAgent 完整指南从零构建类型化AI AgentDeuz SDK createAgent 完整指南 Deuz SDK 是一款零运行时依赖的 TypeScript AI Agen打造Manus风格自主AgentDeuz SDK CodeAct代码沙箱与规划-验证循环实战打造Manus风格自主AgentDeuz SDK CodeAct代码沙箱与规划验证循环实战 Deuz SDK 是一个零依赖的 TypeScript AI AMPC-HC 图标定制实操内置主题切换、SVG 替换与源码编译MPC HC 图标定制实操内置主题切换、SVG 替换与源码编译默认的工具栏图标走极简路线放到一个高度个性化的桌面上常常显得没存在感也谈不上和整体主题桌面应用音视频上一篇Codex桌面端接入auto-gtm完整教程沙箱配置与Cookie踩坑指南下一篇如何快速跑通数据清洗与EDA标准流程Beginner-Data-Science-Projects三件套Notebook使用指南创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考

从零构建Coding Agent：Deuz SDK写代码、跑测试、自愈循环完整教程

相关推荐

class-validator 验证的5个开关：如何让错误只出现在该出现的地方

March7thAssistant 上手指南：3 步跑通星穹铁道日常自动化

Boxer CLI参数速查表：从阈值到精度，所有命令行选项一次讲透

更多资讯

AMD MI250部署DeepSeek-V4-Flash：先修正确性再谈性能

会用AI工具不等于具备AI实力：完整项目才是能力证明

CUDA手写SGEMM优化实战：从0.4到10.23 TFLOPS的完整优化链路

WordPress博客贡献热力图开发指南

拆解 Agent Harness：大模型智能体的七个核心模块与最小实现

ArcGIS外业质检插件开发：提升农田调查效率的解决方案

今日更新

AI辅助技术栈评估：提升研发决策效率60%

从生成Token到直接决策：Jev如何重塑AI Agent工程实践

32G统一内存跑大模型：内存账、TPS实测与端云分流

本周精选

面向复杂光照与角度的宠物面部识别鲁棒性增强策略

基于DRV8818与STM32的双极步进电机驱动方案实战解析

DRV8818PWPR+PIC18F45K80双极步进电机控制方案实战

本月热门

面向复杂光照与角度的宠物面部识别鲁棒性增强策略

基于DRV8818与STM32的双极步进电机驱动方案实战解析

DRV8818PWPR+PIC18F45K80双极步进电机控制方案实战

读完文章，想聊聊您的网站？