dalaoyang技术手记

Agent 是什么:让模型借助工具完成一件事

从“回答一句话”到“完成一个目标”,差别在于能否取得外部事实、采取动作,并依据结果决定下一步。先认清模型、工具和运行环境,再判断你的任务是否需要 Agent。

Agent 入门 · 阅读路线

先带走这三个判断

  1. Agent 可以根据环境反馈选择下一步,目标仍要由人和产品定义清楚。
  2. 工具返回的是事实与状态;模型建议调用工具,不等于动作已经发生。
  3. 固定任务先用简单流程,只有路径需要动态调整时,再引入更多自主性。
从第一个问题开始
文章目录

一句回答与一个任务

假设你想整理书房里的技术资料:“找出关于 Agent 的三篇入门文章,按概念、实践和工程边界分类,留下原文链接。”一个聊天模型可以直接写出三段介绍;但如果它没有读取网页,链接和分类依据就未必真实。资料整理助手需要搜索、打开页面、记录来源,最后检查结果是否满足要求。

本文把这样的系统称为 Agent:模型参与决定下一步,运行程序执行获准动作,再把外部反馈交回模型。Agent 并没有统一到所有产品都接受的定义。Anthropic 在 Building effective agents 中用“路径由预定义代码组织”与“模型动态决定过程”区分 workflow 和 agent;这里借用这个区别来说明自主性,而不是给产品贴等级标签。

先拆开四个部分

资料整理 Agent:从目标到外部事实;模型请求动作后,运行程序检查并执行;外部结果作为证据回到下一轮。
模型请求动作后,运行程序检查并执行;外部结果作为证据回到下一轮。放大图表

模型理解需求、选择动作、解释结果;工具提供搜索、读取、计算或写入能力;环境是网页、文件、业务系统等真实对象;运行程序连接三者,管理状态、权限、错误与停止条件。把这四部分分开,你才能知道问题发生在哪里。

例如,页面无法打开可能是网络问题;原文打开了却分类错误可能是模型判断问题;助手越权写入文件则是执行边界问题。升级模型不能自动修复全部情况。对用户自定义工具,模型产生调用信息,应用程序负责实际执行,这一执行边界在 Claude 官方工具调用文档中有明确说明。某些平台提供托管工具,则由平台完成执行;仍应查看它的具体契约。

循环的意义是取得新证据

助手先读取搜索结果,发现标题相似但内容不同,于是再打开正文。它不是为凑够轮数而调用工具,而是因为当前证据不足以完成分类。每轮应回答三个可检查的问题:新增了什么事实?哪些要求仍未满足?下一次动作能消除哪一个具体缺口?

一个页面明确介绍 ReAct,另一个页面只泛谈 AI,前者可用于概念材料,后者未必值得纳入。模型生成“这篇适合入门”的文字,只是一项判断;支撑判断的标题、章节、原文链接和读取时点才是可核对依据。最终答案需要把这些依据与用户要求连起来。

自主性可以有不同范围

同一个整理需求:回答、固定流程与动态 Agent;三种实现各有用途;选择应看任务的不确定性和可验证结果。
三种实现各有用途;选择应看任务的不确定性和可验证结果。放大图表

如果三个地址已经给定,只要统一提取标题并分类,一个固定流程就可能足够。如果来源未知、页面可能失效、不同文章需要不同判断,动态选择路径会更有用。Agent 可以自主搜索,也可以被限制为只读取你提供的几个域名;自主性不意味着拥有全部工具或无限时间。

尤其要区分“计划做”与“已经做”。助手可以准备一份分类结果,但是否写到博客、覆盖本地资料或发送给别人,要由目标范围和执行权限决定。产品界面也应说明已读取哪些资料、哪些动作只是草稿、哪些动作改变了外部状态,避免一句“处理好了”包住所有阶段。

哪些任务值得尝试

适合起步的任务通常有可访问资料、可控动作、明确交付物和可核对的完成条件。整理公开文章就是一个例子:来源可读,输出可以检查,错误可纠正。代码修复也可能适合,但需要测试、差异审阅和受限执行环境来核实行为,不能只看回复是否自信。

对于格式转换、明确公式计算、固定字段提取,先用确定程序或一次模型调用,通常更容易理解和维护。若完成条件含糊、系统无法返回实际状态、错误代价高却没有复核路径,增加自主循环可能只让错误发生得更远。选择 Agent 应从任务缺口出发,不从流行术语出发。

三类常见误解

“能调用工具就可靠。”工具也会过期、失败或返回不完整数据;返回格式合法不代表事实充分。“有记忆就记得准确。”记录可能陈旧、摘要可能遗漏,新的任务应核对会影响结论的旧信息。“会自我反思就能纠错。”没有新增事实的重复检查,可能把同一个错误解释得更流畅。

资料助手若只找到两篇合格文章,应报告两篇和缺口,而不是把第三篇凑成结果。若查找预算耗尽,应留下已读来源、尚缺主题和继续条件。可交接的不完整结果,比没有证据的完整答案更便于下一步处理。

把第一个 Agent 做小

第一版可以只开放搜索和读取两种只读工具,限制来源范围与调用次数,要求输出三项内容:分类表、原文链接、未确认事项。用一组固定材料先验证链路,再加入失效页面、相似标题和互相矛盾的解释,观察它是否区分“查不到”与“无法读取”。

日志可以保留工具名、参数范围、返回状态、简短决策摘要和结果引用;不需要把模型内部隐藏推理当作必须展示的产品内容。验收时检查链接能否打开、分类是否得到正文支持、缺口是否如实说明。只有确认这些环节有效,再考虑写入、长期记忆或多 Agent 协作。

动手练习:定义完成,而非定义气氛

选一个你熟悉的主题,写下“整理三篇适合新手的资料”。再把它改成可验证的任务:每篇包含原文地址、一个核心概念、一个适用场景;来源不可读时跳过并说明;不自动发布。想一想,哪些要求可由程序检查,哪些仍需要人工判断?

展开一个可比较的答案

地址格式、条目数量和必填字段可机械检查;“适合新手”需要根据术语解释、先备知识和例子判断。三篇不应只是三个搜索结果。若只有两篇得到正文支持,任务还未完全完成,结果应写明范围和缺口。

参考资料与阅读边界

以上案例为用于解释概念的构造场景;图中结构属于通用示意,不代表某个产品的线上架构或验收结论。资料核对日期为 2026 年 10 月 7 日,框架接口会演进,具体实现请以所用版本的官方文档为准。

记录可验证的工具事实与简短决策摘要,不展示模型隐藏推理;方法名称不构成效果或成功保证。

模型提出下一步,工具提供事实,完成要由证据证明。

读完,留一句在书桌上

回书桌看看

仅保存在当前浏览器。

图表

窄屏可在图内横向滑动查看细节。