查看流水线进度

查看每个文档翻译目标的阶段状态、单元数量、警告和失败原因。

查看作业响应中的 documents[].targets[].stages,了解特定文件在特定语言下的处理进展。作业启动时记录引擎配置后,各阶段才会显示;在此之前,数组可能为空。

每个条目都包含 stage、status 和 units。以下是进度信息片段:

json
{
  "stage": "humanEdit",
  "status": { "_tag": "Running" },
  "units": { "finished": 3, "total": 8 }
}

在此示例中,该翻译目标的八个单元中,有三个已完成或跳过人工审核。查看审核,了解哪些单元仍待作出决定。

阶段标识符 #

标识符工作内容
preEdit翻译前优化源文本。
localize生成目标译文。
rephrase优化目标译文的措辞。
qualityGate查找错误,并根据错误的严重程度判断是否需要人工审核。
humanEdit等待内部或外部审核。
postEdit优化审核后的输出。
contentLength调整措辞,使文本长度更接近配置的限制。
backTranslation通过回译和修正确认含义。

在引擎中配置阶段。列表仅显示作业启动时保留的已启用阶段。

阶段状态 #

status._tag含义及附加字段
Pending工作尚未开始。
Planning工作准备中。
Waiting等待前序工作完成。
Running工作进行中;人工审核在等待决定期间可能保持此状态。
Completed已完成;包含 finishedAt。
CompletedWithWarnings已完成,仍有警告;包含 finishedAt 和非空的 warnings。
Skipped无需执行;包含 finishedAt 和非空的 reasons。
Cancelled工作已停止;包含 finishedAt 和非空的 reasons。
Failed阶段失败;包含 finishedAt 和非空的 messages。

finishedAt 是 ISO 时间戳。units.finished 表示已完成或跳过的单元数量,units.total 表示该翻译目标的单元总数。文档准备前,两者都可能为零。这些数值统计的是内容单元数量,而非模型请求次数、耗时或预估费用。

判断是否接受输出 #

必需的翻译阶段一旦失败,受影响的输出便无法完成。可选阶段则可以保留前序文本,并附带警告。因此,如果您的发布策略取决于审核、长度或其他质量要求,即使作业已完成,也仍需检查各阶段的警告。

人工审核超时后,未经人工批准的 AI 生成文本可能仍会保留。后续阶段也可能修改人工撰写的措辞。请阅读审核策略,并在发布前核查最终下载的文件。

API 在此返回进度信息。使用 Studio 的运行视图,深入查看某个阶段背后的模型尝试和详细执行情况。