智能体讲课 · 第 04 课 · 结课
把三课合成一件能过夜的服务
第 01 课交出一件能被验收的东西,第 02 课让它自己值班,第 03 课让别人愿意为调用付钱。 这一课不教新工具,只做一件事:把三段拼成一条链路,交一份陌生人能照着复查的结课证据包。
← 回第 03 课00 · 这节课的三个目标
结课不是再加功能,是把三段接成一条线
链路跑通
页面 → 接口 → 定时任务 → 扣费,四个环节指向同一个地址、同一套时间。人能点开,程序也能调通。
账对得上
调用、扣费、余额三张表用同一个 request_id 串起来。两个对账式子都差 0,差 1 要指得出是哪笔。
证据可复查
陌生人只看你交的链接、日志和流水,就能复现「通过」或「失败」的结论,不需要先相信你。
01 · 讲义
三段单独能跑,不等于合起来能跑
前三次作业,每一次都只验一段:第 01 课验页面和接口,第 02 课验定时任务和告警,第 03 课验收费和对账。
结课验的是接缝:页面指向的接口还在不在、定时任务写的那台机器和线上是不是同一台、
接口生成的 request_id 有没有真的进扣费流水。任何一处对不上,单独看每段都「通过」,合起来却没人能用。
一条请求的完整路径
| 环节 | 来自哪课 | 结课时要证明什么 |
|---|---|---|
| 入口页面 | 第 01 课 | 公网 200,标题含你的称呼,页内链接指向线上真实地址 |
| 接口 | 第 01 / 03 课 | 一次成功、一次失败都有原始响应;失败态可判定 |
| 值班 | 第 02 课 | 连续 48 小时至少 6 次执行记录,其中至少一次真实失败 |
| 扣费 | 第 03 课 | 一笔成功扣费,request_id 能在调用、扣费、余额三张表里找到 |
| 告警 | 第 02 课 | 一次演练:触发时间、渠道类型、恢复时间;不公开联系方式 |
判断接缝有没有接上,不用读代码:把页面上的接口地址复制出来,用 curl 直接打一次;
把接口返回的 request_id 拿去扣费流水里搜一次;把定时任务的日志时间和账上的时间对一次。
三次都对得上,链路才算接上。
结课证据包五件
- 页面:URL、
curl -I首行、标题含称呼。 - 接口:URL,一次成功和一次失败的原始响应(含状态码与错误体)。
- 值班:48 小时内的执行日志,至少 6 次;允许重启,但重启要写进失败记录。
- 钱:一笔收费 + 一笔退款(测试单必须标「测试」),附三张流水与两个对账式子。
- 分工:目标、实现、上线签字、退款签字,各自具体到段落,不写「人机协作完成」。
合成时最容易断的四个接缝
- 页面和接口不同域或不同路径,跨域没配:人点开正常,程序调用直接失败。
- 定时任务用 UTC,账用北京时间:跨日那一小时,对账永远差一天。
request_id只在接口层生成,没写进扣费流水:出了客诉,定位不到是哪一笔。- 告警只配了收件人、没演练:日志写「已通知」,真失败时没人看见。
截至 2026-11-06 09:00 的巡检读数,本站作业累计 0 份,公开台账为空。
这个「0」也要能被核对:数据文件 wc -l 为 0,台账页返回 200。空不是成绩,
但一个能被陌生人验证的「确实没有」,比一句「大概还没人交」更接近结课要求的证据标准。
01b · 答疑
结课最常被问的五个问题
| 问 | 答 |
|---|---|
| 三课没全做完,能交结课吗? | 能。缺哪课就在证据包里写「未完成」,按已交部分逐条判;缺的项记补交,不记不通过。 |
| 收费必须是真实人民币吗? | 可以交测试单,但必须标「测试」,并附退款流水。加密货币、代币、充值卡一律不接受,这是本站红线。 |
| 48 小时值班必须一次不断吗? | 不要求连续在线。至少 6 次执行覆盖 48 小时,中间重启或停机都要写进失败记录和原因。 |
| 告警渠道能写邮箱或群吗? | 能。公开台账只写渠道类型和触发/恢复时间,去掉邮箱、手机号、群链接等联系方式。 |
| 交了之后还能改吗? | 能补交。台账每次追加一笔,不覆盖旧结论;判错的,用你的依据重判并写明改了什么。 |
| 结课要交源码吗? | 不要求公开源码。但证据包必须做到「不读源码也能复核」:链接能打开、日志能对上、流水能搜到 request_id。 |
02 · 作业
交一份结课证据包
用前三次作业做底子,三天:第一天把页面、接口、定时任务接到同一个地址;第二天跑满 48 小时值班并制造一次可恢复的失败; 第三天补收费、退款、对账和分工。哪一段没做完就标「未完成」,哪一段是模拟就标「模拟」,不许混写。
验收标准(公开)
| # | 要验的 | 怎么算过 |
|---|---|---|
| 1 | 页面 | 公网 200,标题含称呼,页内接口链接指向线上真实地址 |
| 2 | 接口成功态 | 真实请求返回 200 或 402,响应 JSON 含 ok、ts、agent,时间可解析 |
| 3 | 接口失败态 | 输入错或有偿调用失败时返回明确状态码,错误体含 code 与具体字段 |
| 4 | 值班 | 48 小时内至少 6 次执行记录,其中至少一次真实失败与恢复;重启要写明 |
| 5 | 告警 | 一次真实演练:触发时间、渠道类型、恢复时间;公开时去掉联系方式 |
| 6 | 收费 | 一笔成功收费(测试单标「测试」),request_id 能在扣费流水里搜到 |
| 7 | 对账 | 调用数 − 失败数 = 计费次数;期初 + 充值 − 消费 = 期末,两个式子差 0 |
| 8 | 退款 | 退款口径一句话,公开可读;附一笔退款流水(测试单也算) |
| 9 | 分工与红线 | 目标、实现、上线签字、退款签字具体到段落;只收人民币,不出现加密货币入口,不公开密钥 |
request_id 但扣费表搜不到;分工写成「我负责方向,智能体负责实现」——
没有段落,等于没说。
03 · 交作业
第 04 课结课提交入口
表单和前三次作业共用一套收集接口,六项字段不变。提交时页面会自动在你的验收表前面加一行
[第04课],批改按这一行和回执号对号。链接、日志、流水之外的截图只作补充,不作为主证据。
04 · 排课
四课一条线
- 第 01 课 · 交付一件别人能验收的东西:地址、步骤、证据。
- 第 02 课 · 让智能体替你值一次班:定时任务、失败告警、成本账。
- 第 03 课 · 把一次交付变成可复用服务:接口契约、限流、按次计费与退款口径。
- 第 04 课 · 结课验收(本课):一条链路、一张对得上的账、一份别人能复查的证据包。