配置翻译流水线
启动任务前,先保存引擎的阶段配置,再查看实际运行的阶段。
本地化任务使用启动时保存的引擎流水线配置。请在调用 /start 前配置好引擎。之后对引擎的修改只会影响后续启动的任务,不会改变正在运行的任务的配置快照。
在 Studio 中打开引擎的 流水线 选项卡,或通过 PATCH /v2/engines/:id 更新 pipelineConfig。调用方需要具备编辑引擎的权限。组织需要有权访问可运行阶段所需的功能。请参阅功能访问权限和定价。
保存完整配置 #
修改现有配置前,请先通过 GET /v2/engines/:id 读取引擎。发送 pipelineConfig 会替换该配置;未指定的阶段将采用默认值。请保留需要继续使用的设置。
以下请求为翻译配置了改写环节。请求中未指定的可选阶段均会禁用:
PATCH /v2/engines/:id
Content-Type: application/json
X-API-Key: YOUR_API_KEY{
"pipelineConfig": {
"localize": { "enabled": true },
"rephrase": { "enabled": true }
}
}如果应用需要对某类任务采用不同的策略,请使用独立的引擎。配置好模型和指导说明后,在创建这类任务时选择该引擎的 ID。
阶段设置 #
pipelineConfig 中的字段 | 设置 |
|---|---|
localize | enabled: true。翻译是必需阶段。 |
preEdit、rephrase、postEdit、backTranslation | enabled 为布尔值,默认为 false。 |
qualityGate | enabled 布尔值和 strictness:"strict"、"medium" 或 "lax"(默认为 "medium")。 |
humanEdit | enabled、正整数 timeoutHours(默认为 48)以及审核 routes。 |
contentLength | enabled 以及下文介绍的 mode。 |
译后编辑需要人工审核。译后编辑环节处理的是人工审核后的文本;如果审核被跳过或超时,可能就没有人工处理的文本可供优化。
内容长度模式可设为 { "_tag": "noLongerThanSource" }(默认)、{ "_tag": "fixedCap", "maxColumns": 40 } 或 { "_tag": "matchSource", "tolerancePct": 10 }。数值必须为正整数。这些值表示目标显示列数,并非字节数上限,也不保证文本一定能适配界面。
设置人工审核路由 #
请先创建或选择决策池。每个 humanEdit.routes 条目指定一个决策池,以及对应的语言和目录范围。以下配置会将所有新翻译的内容发送到同一个决策池:
{
"pipelineConfig": {
"localize": { "enabled": true },
"humanEdit": {
"enabled": true,
"timeoutHours": 48,
"routes": [
{
"pool": "YOUR_DECISION_POOL_ID",
"match": { "locales": [] }
}
]
}
}
}空的 locales 数组涵盖所有语言。在 match 中添加 "path": ["emails/**"],即可涵盖该目录下的文档;它会与文档的 key 匹配。路径使用目录的字面名称,后接 /**。未指定 path 的路由适用于所有目录。目录和语言区域匹配越具体,优先级越高;存在冲突的路由会被拒绝。
如需有选择地审核译文,请启用人工审核,并添加一条路由,覆盖你希望审核的译文。在 pipelineConfig 中添加 qualityGate,其他设置保持不变:
{
"qualityGate": { "enabled": true, "strictness": "medium" }
}当 humanEdit.enabled 为 false 时,你仍可保存已启用的 qualityGate。关闭人工审核后再重新开启,Studio 会保留已保存的设置。使用 API 时,请在每个用于替换的 pipelineConfig 中包含 qualityGate,以保留该设置。只有任务最终解析出的流水线启用了人工审核,质量门控才会运行。
质量门控会记录每个单元中发现的问题。"strict" 表示发现任何问题都需要审核,"medium" 表示发现重大或严重问题时需要审核,"lax" 表示仅发现严重问题时需要审核。质量门控无法检查的翻译仍需审核。将 qualityGate.enabled 设为 false 即可选择 全部,把路由覆盖范围内的每条新翻译都送交审核。复用的翻译不会产生新的审核工作。
判定结果不受严格程度影响;审核级别只用于决定发现的问题是否需要审核。更改引擎的级别只会影响后续启动的任务,不会改变正在运行的任务在启动时保存的配置。有关各级别的说明和严重程度定义,请参阅质量门控级别。
旧版异步本地化 API 仍接受 humanEdit.qualityThreshold,但会忽略它。凡是选定需要人工审核的语言,每条翻译都会交给审核者处理。如需在当前流水线中进行选择性审核,请在引擎的 人工审核 设置中配置 审核级别。
审核是否可用取决于组织的套餐和决策池的提供方连接。任务启动时,不可用的阶段功能及依赖这些功能的阶段都会关闭。请读取任务的目标阶段,确认实际生效的工作流。如果发布前必须由人工作出决定,请在交付下载的输出前落实这一策略。
查看结果 #
质量门控阶段会为每个已检查的单元保存以下输出:
{
"findings": [
{
"span": "Pay €20",
"reason": "The translation changes the source amount from €10 to €20.",
"category": "accuracy",
"severity": "critical"
}
]
}span 原样引用质量门控所评判的翻译文本。reason 是一句英文。类别包括 accuracy、terminology、guidance、fluency 和 style;严重程度包括 critical、major 和 minor。空的 findings 数组表示质量门控未发现错误。审核单元会以 quality 的形式返回此输出;请参阅人工审核。审核者可在 队列 中查看翻译旁列出的问题。
阶段进度区分已完成、已跳过、失败和有警告的工作。人工审核介绍审核决策和截止时间。流水线指南说明各阶段的用途,以及后续阶段如何修改前面阶段生成的文本。