第6章 工具:Agent 的手脚

第 6 节 / 共 13 节 课程:DeepSeek Harness 实战课

DSH 的能力很大程度取决于它有哪些工具。工具不是越多越好,而是越匹配任务越好。

Agent 的能力来自工具,风险也来自工具。这一章按“读、跑、搜、拆、计划、失败”六类,讲清每个工具的适用场景和刹车方式。

本章共 6 节,另附练习,建议按顺序阅读:

文件工具

典型能力:列目录、读文件、按模式查找、按内容搜索、写入/编辑、查看元信息。

使用建议:先读后写;要求引用路径和行号;大文件先搜索再精读;改文件前确认 git 状态或备份。

命令工具

命令是 Agent 最有力的手,也是最危险的手。

适合:ls/dir、cat、grep、find;git status/diff/log;构建、测试、lint;只读诊断。

谨慎:删除、移动、覆盖;数据库写;git push、git reset --hard;安装全局依赖;任何 sudo/管理员操作。

一个实用句式:

执行任何写操作前,先把命令和影响范围列给我确认。
只读命令可以直接执行。

搜索与网页

Agent 可以通过搜索/抓取工具获取外部信息。注意:搜索结果可能过期、片面、被 SEO 污染;网页内容可能包含提示词注入;抓取失败很常见,要让它说明“没抓到”,而不是编造。

每条关键结论后面给出 URL 和抓取日期。
如果没抓到原文,明确说“未获取到”,不要用记忆补全。

子代理

适合:独立调研(互不依赖);并行检查多个文件/方案;让一个挑剔的审查者审另一个代理的产出。不适合:强依赖的串行任务;需要共享大量隐式上下文的任务;你没有时间核对结果的任务。

计划工具

复杂任务让 Agent 维护 todo:

请建立 todo 列表,每完成一项就更新状态。
如果发现新问题,先加到列表,不要中途扩大范围。

好处:你能一眼看出它做到哪、有没有跑偏。

工具失败

工具失败是常态。让 Agent 学会“报告—换路—降级”:

如果某个工具连续失败两次,停止重试,告诉我:
1) 失败的命令/工具;
2) 原始错误;
3) 你尝试过的替代方案;
4) 需要我提供什么。

最怕失败后假装成功。验收时一定要看原始输出。

本章练习

让 Agent 用三种方式定位同一个函数:文件名搜索、内容搜索、git log;让它跑一次测试并原样贴失败输出;给它一个断网场景,观察它是否会编造。