在 API 作业中集成人工审核
将翻译交给审核者,跟踪审核决定,并获取最终输出文档。
如果翻译在交付前需要人工判断,可以添加人工审核。引擎会将每个文档及其目标语言路由到决策池;审核者批准或编辑符合条件的单元后,流水线会继续运行,最终生成可下载的文件。
首先,确保 API 翻译已能正常运行。你还需要支持人工审核的套餐功能、一个决策池,以及一名有权访问该引擎翻译内容的审核者。
启动前配置审核 #
打开引擎的流水线选项卡,启用人工审核。选择决策池、语言,以及适用的目录范围。目录路由会匹配你为每个文档发送的 key,因此请使用固定的路径,例如 emails/order-confirmation.json。
要审核该路由下所有新翻译的内容,请选择全部,此时质量门禁保持关闭。要选择性地审核,请选择严格、中等或宽松。质量门禁会列出错误及其严重程度和类别;所选级别决定哪些严重程度的错误需要审核。质量门禁无法检查的翻译也会进入审核。各级别的说明请参阅质量门禁级别。复用的翻译仅提供只读上下文,不会自动成为新的审核任务。
选择适合审核团队的超时时长。时限从目标就绪时开始计算;到期后,尚未收到审核决定的单元可以沿用此前的翻译继续执行。如果每条发布的翻译都必须有人工审核决定,你的应用就必须在发布检查中强制执行这一要求。
如果引擎配置是应用的一部分,请通过 API 配置流水线。
提交内容 #
创建作业,上传缺失的产物,然后调用 /start。将作业 ID、源内容版本和预期的审核策略一并保存。引擎的流水线配置会在作业启动时确定;后续更改不会影响正在运行的作业的审核策略。
读取作业的文档 ID 和目标语言区域。目标的阶段进度中的 humanEdit 用于标识审核任务,而 审核 API 则提供实际的审核单元和决定。审核者处理任务期间,作业可能仍处于 Running 状态。
为审核者提供所需上下文 #
审核者可以在控制台中选择队列 → 类型 → 人工审核,质量门禁发现的问题会显示在翻译旁边。审核者可以不做修改直接批准,也可以编辑翻译后再提交。请确保源内容、目标语言、占位符和预期使用的术语始终对审核者可见。
如果使用应用自有的审核界面,请通过 GET /v2/organizations/:orgId/localization/reviews 列出待处理的审核,再获取所选文档/语言区域的审核详情。提交审核决定时,请使用个人密钥或用户会话,以审核者身份进行验证,而不要使用后台服务的组织密钥。
为必审单元提交 Approved 或 Edited 决定。内部审核允许分批提交。接管外部审核时,必须一次性为所有剩余的必审单元提交决定,并且仍可能需要支付服务提供商的费用。具体的请求载荷和错误说明请参阅审核参考。
获取并验证最终结果 #
审核者提交后,继续获取本地化作业的信息。只有当目标状态为 Completed 时,才下载目标文件。审核完成不等于文件已生成,因为译后编辑、长度处理或回译可能仍在进行。
如果必须保留人工批准的原文措辞,请禁用后续改写阶段,并检查最终输出。如果需要批准凭证,请检查审核决定和超时单元,而不要将阶段已完成视为每个单元都已获得人工批准的证据。
只有在源内容版本仍然匹配,且已满足所要求的审核策略时,才能发布。延迟完成的翻译不得覆盖较新源内容版本对应的输出。
中断后恢复 #
客户端超时后,请保留原始作业和审核的标识信息。新作业会启动独立的翻译和审核流程。如果提交审核决定后的响应丢失,请获取审核详情,检查已保存的决定和审核者 ID。只要目标仍接受提交,同一审核者就可以重复提交完全相同的决定;但目标完成后,即使首次提交已成功,再次提交也可能返回 409。成功提交的决定不可更改。
审核时限到期时,请检查已接受的决定、尚未收到决定的单元,以及生成的文件。保留已完成的工作,并审慎选择下一步:暂缓发布、再进行一次审核,或接受明确定义的备用方案。