做完一个 Agent 项目，你应该拿得出什么？

假设你已经做出了一个 Agent 工作台。打开页面，输入要求，屏幕上的文字一点点出现。你录了一段演示，准备把它放进作品集。

有人看完，问了一句：“为什么要做这个？”

你能介绍它支持什么功能，却忽然不太确定，该从哪里讲起。接着，对方又问：“如果中间做错了怎么办？你试过哪些办法？最后为什么选现在这一种？”

这些问题没有出现在那段顺畅的演示里。它们却提醒我们，开始一个项目之前，值得先想清楚：除了一个能打开的页面，这段学习还应该留下什么？

我希望你带着这个问题往下读。因为决定收获多少的，除了项目最后长什么样，还有你愿不愿意弄明白，它为什么长成这样。

能介绍功能，还不等于能解释自己的作品

“支持对话、整理材料、生成内容”，可以是一款产品的介绍。但别人看完，很难知道其中哪些部分是你理解过、选择过、改进过的。

不妨把介绍换一种讲法。

假设你做的是一个帮人准备每周工作回顾的工具。起初，你让 AI 读完所有记录，直接写出周报。试过之后发现，它把还没完成的事情写成了成果。于是，你让工具先把“完成”“进行中”“需要确认”的内容分开，交给用户检查，再组织成文。

这段话不需要多少新名词，却已经能说明好几件事：你观察到了什么问题，第一种办法为什么不够用，后来改了哪里，以及为什么要让人参与确认。

它也留下了可以继续讨论的地方：材料里没有写清楚的事情怎么办？用户不确认就离开了怎么办？这一次改动是不是让整理更费时间了？

一个值得留下的项目，应该容得下这些追问。 你不必每次都能立即回答，但能知道答案要去哪里找，愿意拿实际过程检验自己的解释。

把熟悉的经验，变成能解释的选择

做过业务页面，你大概已经习惯考虑输入、等待、错误和修改。到了 Agent 应用里，这些经验能帮助你发现不顺手的地方，但还要继续追问：请求成功以后，用户要做的事情真的做好了吗？

一份周报正常生成了，却把计划写成成果，接口可以没有报错，任务仍然没有做好。允许工具读取工作记录，也不等于允许它自行把周报发给所有同事。为什么加入人工确认、确认前允许修改什么，都需要你想清楚。

试着留下一次选择的来由。最初的结果哪里不合适，你为什么增加这个确认动作，修改以后又有什么变化？把同一份材料和前后两份结果放在一起，别人就能看到这次决定针对的问题，你自己也更容易发现它是否有效。

这样的记录，会把熟悉的前端经验连接到新的任务判断上。讲项目时，你有了一个具体的例子；下次修改时，也能回到当时的理由，而不必重新猜测。

最舍不得删掉的，可能是一次失败记录

做项目时，谁都希望演示顺利。遇到失败，第一反应可能是换一个问题，再录一次。

用于展示的片段可以短一些，但学习时，别急着把不顺利的那次丢掉。

例如，周报工具第一次整理得不错，换成另一周的记录却漏了重要事项。你检查后发现，那条记录写在一段闲聊中。第一次材料比较整齐，掩盖了这个问题。

接下来，你可以改变整理方式，也可以先要求用户补充说明。无论选择哪一种，都用原来的那份材料再试一次，看看漏掉的内容能不能被发现。之后还要找别的材料确认，避免只为这一个例子修出一条特殊规则。

到这里，你留下的就不只是“修好了”。你知道失败发生在什么条件下，修改针对什么，也知道哪些情况还没有试过。

这种记录不用写得很正式。几句话、一份改动前后的结果，都可以。重要的是，隔一段时间再看，你还能明白自己为什么这样决定。如果让别人复查，对方也有东西可看。

它会让“我学过 Agent”慢慢变成更具体的话：“这个地方我确实遇到过问题，我知道怎样把它查清楚。”

能演示，与愿意一直用，中间还有一段路

一次演示通常会从准备好的材料开始，沿着预想的过程结束。日常使用却未必配合。

用户会少给一段背景，会中途离开，会对结果不满意。工作台还可能遇到服务暂时不可用、等待超过预期、一次任务反复尝试后花费变多的情况。

把这些情况考虑进去，会让项目慢下来。你可能不得不推迟一个新功能，先弄清楚任务失败后该保留什么。这种进度不如首页多出一个入口醒目，却关系到别人下次还愿不愿意打开它。

因此，我更愿意把“做完”理解成一件可以继续检查的事：你选定的任务，已经能让自己或一位实际使用者认真走完；遇到已知问题，能够说明发生了什么；还没有解决的地方，也能讲清楚。

这不代表一个人必须把所有商业产品的要求都做齐。练习项目可以有明确范围。只是范围要由你理解过以后决定，不能因为演示碰巧没出错，就默认其他情况也成立。

这些经历，怎样变成你自己的能力

如果你关心求职，当然可以展示这个项目。但不要把“多了一个 AI 项目”直接当作获得面试的保证。岗位要求、过去的经历和招聘条件都会影响结果，一个作品无法替你控制这些因素。

你能认真准备的，是让别人看见你在其中做过的工作。

讲清楚它帮助谁、为什么从这个任务开始；挑一个你亲自比较过的选择；拿出一次失败和修改后的结果。对方未必认同你的每个决定，但能沿着你的说明继续问，你也能继续解释。

即使暂时不求职，这样的经历也值得留下。下次遇到另一个 AI 应用需求，你不必从“应该用哪个热门工具”开始猜。你会先问，用户究竟想做完什么，怎样算做好，哪里需要保留人的决定。

回到开头：做完一个 Agent 项目，除了页面，你应该拿得出一段自己说得明白的实践经历。你知道为什么做，做过什么选择，在哪里失手，又怎样让它往前走了一点。

如果这正是你想得到的，下一篇我们就具体谈谈：这个专栏，准备陪你走到哪一步？