回想那次事故,我的 OneUp 自动发文管线在凌晨两点重复送出了同一篇贴文。我早上起来看到手机通知,花了四十分钟手动删文。

那天的教训是:做出能跑的原型,和让它在界线内可靠地做事,是两段不同的工作。

我当时做过三套系统:辩论引擎让 GPT-4o、Gemini、Grok 辩论,再由 Perplexity 查核;OneUp 管线从 Google Sheet 读排程、用 DALL-E 生图,发到八个平台;另一套用于产线监控。这些是当时的配置,各自让我学到不同的事;有查核环节,也不等于每份输出都已正确。

这篇不是理论。是我从踩坑中归纳出的五个原则。

先回答三个问题再动手

在写任何一行程式之前,我现在会强迫自己回答三个问题:这个 Agent 解决什么问题?它的权限范围在哪里?我怎么知道它做对了?

听起来很基本,但我的辩论引擎第一版就是没想清楚第二个问题。我让模型自由决定辩论轮数,某次跑了二十七轮,把 API 额度烧光。后来加上最多五轮、超过就强制收敛的硬性上限。这能限制轮数,不能保证模型真的达成共识或结论正确。

边界不清楚,会让 Agent 更难验收或停止。先把允许的动作、投入上限与停止条件写清楚,再开始实作。

先评估合适的 API,再决定工具介面

Agent 调用工具完成多步骤任务时,工具越多,需要处理的权限、状态与失败模式通常也越多。

我一开始用浏览器自动化排程,UI 改版时流程常会中断,后来改走 API。我的原则是先评估是否有合适、具文件与清楚授权边界的 API;若无法完成必要工作,再考虑浏览器自动化。两者都需要检查回应、介面变动与停止条件,不能只凭介面名称保证稳定。

资料处理也一样。输入缺漏或格式不符,后续判断就可能受影响。〈从 AI 风暴中突围〉谈到我对协作分工的思考;放到 Agent 规划里,我会先确认资料来源、格式与可使用的范围。

拆成模组,出错才能定位

我采用的拆法是四个模组:Input 处理 → 决策逻辑 → 工具调用 → 结果后处理,尽量让各部分能单独测试。涉及已发文、改资料等外部动作时,还要另设停止、对帐与补救方式;切成模组,不代表外部效果就能回滚。

辩论引擎就是这样设计的。Input 模组负责解析主题和模式(dialogue/duo/adversarial)。决策模组负责轮次控制和收敛判断。工具调用模组处理四个模型的 API 呼叫。后处理模组把结果存成 markdown。这样比较容易定位问题、缩小影响,但共享状态或错误资料仍可能跨模组传递。

这也是我在记忆里记下的协作原则:复杂工程必须先拆 Phase,每个 Phase 独立可验证。一次性处理的结果,通常是中途卡住然后连前面做对的部分一起搞坏。

让每一步可追踪,也让重试安全

Agent 的运作过程必须透明,否则出错时你根本不知道哪里坏了。

重复发文让我注意到:timeout 只表示没有及时收到回应,不等于外部操作没有成功。日志可以帮助追查,但若直接把同一工作再送一次,仍可能造成重复。AWS 的〈让幂等 API 安全重试〉也说明这个问题。我的规划建议是为工作建立唯一识别、记录提交状态,重试前先查询或对帐;若 API 支援幂等键,重试沿用同一键。无法确认效果时,就先停止自动重送。

我用三层纪录整理监控:操作日志、选择理由与成本追踪。模型写出的理由不是内部推理的完整纪录;操作是否成功,还要核对实际结果。纪录也要控制存取与内容,避免把凭证或不必要的敏感资料写进日志。

从最小场景开始

最后一个原则最简单也最常被忽略:从小开始。

当时的监控系统先只看一条产线的一个参数,试跑两周后才逐步扩展。试跑时间本身不能证明全产线或自动调整已安全。〈想开始却迟疑时:先把风险与下一步说清楚〉谈的是能承担、能回头的小步尝试。Agent 也可以先从低风险、可停止、可观察的 POC 取得回馈;正式交付、真实资料与实体操作,仍有各自的授权和验证要完成。

我希望 Agent 扩展人的能力,而不是把结果责任藏起来。定位、工具选择、模组化、可追踪与小步验证,是我从失败整理出的五个提醒;每一项都要回到具体任务与外部影响检查。

把理解与结果接起来

能跑的 Agent,还需要能验收、能停止的界线。

timeout 的结果可能未知,不直接当成操作失败。

日志帮助追查,重试前仍要核对外部效果。

若 API 支援幂等键,同一工作重试沿用同一键。

模组与小步试跑,不能保证外部效果可回滚。

先确认发生了什么,再决定是否重试。

四格漫画:能跑的 Agent,还需要能验收、能停止的界线。timeout 的结果可能未知,不直接当成操作失败。日志帮助追查,重试前仍要核对外部效果。若 API 支援幂等键,同一工作重试沿用同一键。模组与小步试跑,不能保证外部效果可回滚。先确认发生了什么,再决定是否重试。

2026 年 11 月 5 日修订。 系统与事故记录的是当时的工作经验;安全重试原则参考文中连结的 AWS 工程文章。五个原则是规划建议,不代表特定服务支援所有机制或试跑已证明安全。