查看流水线进度
查看每个文档翻译目标的阶段状态、单元数量、警告和失败原因。
查看作业响应中的 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 的运行视图,深入查看某个阶段背后的模型尝试和详细执行情况。