麦式参考 MickerBook Reference

AI Agent

AI Agent

也常被叫作:智能体代理会自己干活的AI

你可能会这么说

「我想要那种能自己看文件、自己改、自己跑起来的 AI,不是只会聊天的。」

AI Agent AI Agent

会调用工具、能看到结果、并根据结果决定下一步的 AI——它做事,不只是回答。

聊天型 AI 和 Agent 的区别只有一件事:Agent 的输出能改变现实,然后它能看到自己改变了什么。它读文件、跑命令、发请求,拿到结果,再决定下一步。这个「做—看—再决定」的循环,是 Agent 的全部。

但「它能自己跑」和「它跑成了」是两回事,我们对这个教训付过钱。有一次我们让几个自主代理并行跑独立审计,结果三个通道全灭:两个启动直接失败,两个跑完只返回空。如果只看它们的状态汇报,这场审计「已经结束」了;直到换了一条备用通道真跑通,才拿到一份真审计——还抓出 3 处文档瑕疵。每个环节都要看原始输出,不能只听环节自己报平安。

所以它强的地方和弱的地方都很具体。强的是:它能自己发现错误并修正,不用你一步步指路。弱的是:每一步的判断都可能错,而错误会往下累积。一个走了二十步的 Agent,可能在第三步就跑偏了,后面十七步都在错误的地基上认真施工。

这也解释了为什么和 Agent 协作最重要的不是提示词技巧,而是边界和验收:给它明确的范围、明确的不许动、明确的交付证据。它跑得越自动,你越需要在它停下来时能一眼看出到底做了什么。

还有一点要清楚:能力多不等于可靠。「有二十个工具」「能自己开子任务」这些是能力清单,不是可靠性证明。判断一个 Agent 好不好用,看它能不能诚实地说「这一步我没验证」。

长什么样 真实可交互,不是截图

你的目标它决定下一步调用工具看结果还没完成?回到第 2 步
聊天型你问它答。要改东西,你自己动手
Agent它动手,然后根据结果自己继续

循环里最关键的是「看结果」那一步。看不到真实结果的 Agent,只是在盲目地连续输出。

拆开看,里面有这几块

  1. 1
    目标 Goal

    你给的任务。越明确,它跑偏的空间越小。

  2. 2
    工具 Tools

    它能调用的动作:读写文件、跑命令、搜索、请求接口。

  3. 3
    循环 Loop

    决定 → 调用 → 看结果 → 再决定。直到完成或达到上限。

  4. 4
    停止条件 Stop condition

    什么时候算完、什么时候该问你、最多跑多少步。缺这一项它会一直转。

  5. 5
    权限边界 Permissions

    它能碰什么、不能碰什么。这是安全的唯一保障,靠叮嘱是不够的。

常见的有哪几种

只读 AgentRead-only

只能看,不能改。风险最低,适合先建立信任。

用在:分析代码、查资料、做诊断

可写 AgentWrite-enabled

能改文件、跑命令。效率高,需要边界和回滚。

用在:实际开发任务

多 Agent 协作Multi-agent

一个分派、多个执行。听起来强大,但验收难度也成倍上升。

用在:任务能被干净拆开时

容易搞混?这样区分

AI Agent 工具调用 Tool calling

工具调用是一次动作,Agent 是围绕目标反复调用直到完成的那个循环。有工具调用不等于是 Agent——关键在于它会不会根据结果决定下一步。

看 工具调用
AI Agent 自动化脚本 Script

脚本按固定步骤走,每次一样,出错就停;Agent 每步都重新判断,能应变,也能变着花样出错。判断方法:结果可预测的用脚本,需要判断的才用 Agent。

什么时候用得上

第一次用

从只读任务开始(分析、诊断、总结)。先看它靠不靠谱,再给写权限。

让它做长任务

要求它每完成一步就停下汇报。跑二十步再一起交付,你无法验收。

它跑偏了

别在错误方向上追加指令。停下来,让它先说清当前理解,再重新出发。

你可以这样跟 AI 说

直接复制下面这段,把【】里的换成你的情况。它比一句「帮我加个 X」多说清楚了:改哪里、不许动啥、做完交什么。

【任务】[具体目标]
【工作方式】
  - 分步执行,每完成一步停下来汇报,等我确认再继续
  - 涉及删除、数据结构、权限、新增依赖时先问我
  - 不确定就问,不要猜
【权限边界】只能改动 [具体目录/文件];不要读取或输出任何密钥、环境变量和真实用户数据
【每步汇报格式】
  1. 这一步实际做了什么(改了哪些文件 / 跑了哪些命令)
  2. 命令的原始输出
  3. 我怎么自己确认这一步的结果
  4. 这一步有没有你没验证的部分
【停止条件】如果连续两次尝试都没有进展,停下来告诉我卡在哪,不要继续换方法硬试。

最后那条停止条件很值钱:Agent 最浪费时间的模式就是「换一个方法再试一次」,连续十几轮,每轮都看起来在努力。

它说「做好了」,你怎么自己验

这是本站的重头戏。AI 最会的不是写代码,是说「已完成」。这一条,它通常最多做到「运行时」这层:真的跑起来了,能在本机看到结果。

要亲眼看到这些,才算数

  • 让它列出这一轮实际调用过的工具和命令,而不是它打算做什么。
  • 抽一步核对:它说改了某个文件,你打开看一眼是不是真改了、改成什么样。
  • 亲手跑一次它声称已经跑通的东西。Agent 的自我报告和真实结果之间经常有落差。
  • 确认权限边界生效:它有没有碰到范围外的文件(问「一共改了哪些文件」)。
  • 长任务结束后,确认系统处于可用状态,不是「改到一半」。

它常这么糊弄你

  • 「我已经完成了所有步骤」——但中间某一步失败了,它自己找了个替代方案继续往下走,没告诉你。
  • 汇报里出现大量「我将会」「接下来我会」,实际动作却很少。看动作,不看计划。
  • 工具调用失败后它转而凭推理继续,输出看起来一样完整。要看原始输出,不看总结。
  • 「有 N 个工具、支持多 Agent」——这是能力清单,不是可靠性证据。
  • 它绕过你设的边界完成任务,然后把这当成解决问题的能力来汇报。

Agent 类任务通常能验到「运行时」层:你亲手跑一次它做出来的东西。要到「主路径」层,得从真实入口走一遍。

考考你 选一个你觉得对的

Agent 跑完一个长任务说「全部完成」。最该先做什么?