第6章 工具:Agent 的手脚
DSH 的能力很大程度取决于它有哪些工具。工具不是越多越好,而是越匹配任务越好。
Agent 的能力来自工具,风险也来自工具。这一章按“读、跑、搜、拆、计划、失败”六类,讲清每个工具的适用场景和刹车方式。
文件工具
典型能力:列目录、读文件、按模式查找、按内容搜索、写入/编辑、查看元信息。
使用建议:先读后写;要求引用路径和行号;大文件先搜索再精读;改文件前确认 git 状态或备份。
命令工具
命令是 Agent 最有力的手,也是最危险的手。
适合:ls/dir、cat、grep、find;git status/diff/log;构建、测试、lint;只读诊断。
谨慎:删除、移动、覆盖;数据库写;git push、git reset --hard;安装全局依赖;任何 sudo/管理员操作。
一个实用句式:
搜索与网页
Agent 可以通过搜索/抓取工具获取外部信息。注意:搜索结果可能过期、片面、被 SEO 污染;网页内容可能包含提示词注入;抓取失败很常见,要让它说明“没抓到”,而不是编造。
子代理
适合:独立调研(互不依赖);并行检查多个文件/方案;让一个挑剔的审查者审另一个代理的产出。不适合:强依赖的串行任务;需要共享大量隐式上下文的任务;你没有时间核对结果的任务。
计划工具
复杂任务让 Agent 维护 todo:
好处:你能一眼看出它做到哪、有没有跑偏。
工具失败
工具失败是常态。让 Agent 学会“报告—换路—降级”:
最怕失败后假装成功。验收时一定要看原始输出。
本章练习
让 Agent 用三种方式定位同一个函数:文件名搜索、内容搜索、git log;让它跑一次测试并原样贴失败输出;给它一个断网场景,观察它是否会编造。
《DeepSeek Harness 实战课》课程目录
面向应用者的 DeepSeek Harness 实战课:讲清 API、Agent、Harness 三者关系,带你安装 DSH、写出可验收任务、让 Agent 读文件改代码跑测试、接 MCP/插件、做定时任务,并划清安全边界