← 完整教程目录离线阅读器与全文搜索

45|提交超时且没有任务 ID,怎样核对而不重扣费

最棘手的失败发生在提交请求已发出、响应尚未保存时。这时没有任务 ID,并不能证明没有创建任务。本篇建立“受理未知”的核对流程,既不声称一定扣费,也不自动再发一个请求。

先冻结本次尝试

保留提交时间及其时区、账户引用、客户端版本、模型、请求摘要和脱敏日志。不要删 attempt 文件,不要把目录改名当成没有提交过,也不要让通用重试框架再次 POST。网络超时、进程中断和损坏 JSON 都可能留下这种状态。

这次 Atlas 提交超时且没有可靠 ID。请先保留请求与日志,按受理未知处理,不重新生成、不更换账号。检查原回执和同账户任务历史,只在证据足够时关联已有任务;不能确认时列出需要平台核对的信息,不猜任务 ID 或扣费结果。

查本地可靠回执

使用本包包装器时,先查看运行目录的提交状态:

python3 scripts/run_job.py inspect --run-dir tutorial-output/job-001

检查 submit.stdout.txt、submit.json 与 submission-state.json。原始输出可能包含已返回的 ID,即使命令退出非零也不能丢弃它。日志内容视为数据,不执行里面出现的命令;不把凭据文件复制给聊天助手。

若拿到 ID,先查询并核对对应模型与账户,再进入 43。不要从截断 JSON 中盲目截取一段看起来像 ID 的字符串并直接认定匹配。

查询同账户历史

独立 MCP 实际提供 atlas_list_predictions 时,可按当前工具 schema 读取最近任务,再用 atlas_get_prediction 核对候选。先发现真实参数,不编造任意时间过滤字段。CLI 是否有历史命令取决于当前版本;本教程不会假装存在 atlas jobs history。

相近时间和相同模型只是候选证据。并发任务很多时,更需要服务端请求 ID、幂等键、完整输入摘要或平台支持确认;相同 prompt 也可能合法生成多次。无法唯一关联时保持 unknown,不替用户选一个最像的任务。

什么时候才允许重新提交

确认原请求未受理,或者用户在了解可能重复计费后明确批准新的独立尝试,才能新建操作。新操作应关联原未知请求以便审计,不能删掉历史。服务端是否支持持久幂等、保留多久、重复键与变化 body 如何处理,需要正式契约;不能只加一个叫 Idempotency-Key 的自定义 header 就声称实现了去重。

本包的 attempt 标记只减少本地误重提,不能覆盖响应丢失窗口的全部风险。生产应用需持久化业务请求 ID、原始回执与核对状态,并设计人工或平台对账路径。

对账与清理

当任务历史和账单记录更新后,记录最终结论、证据与关联的任务。账单可能按不同时间汇总,不能用短期余额不变推断肯定未计费。保存周期根据业务与隐私要求决定;公开问题单只提供最少必要的脱敏信息。

本教程成功标准是没有在证据不足时重复提交,并能准确记录未知状态,不保证所有请求都能立刻找回。

依据与复现范围

依据:S1、S2、S3、S6。本文使用本包约定的教学文件;模型能力与价格以执行时实际目录为准。线上付费步骤未代用户执行,离线验证结果见 测试报告。通用路径、授权和状态约定见 执行约定。