配置翻译流水线

启动任务前,先保存引擎的阶段配置,再查看实际运行的阶段。

本地化任务使用启动时保存的引擎流水线配置。请在调用 /start 前配置好引擎。之后对引擎的修改只会影响后续启动的任务,不会改变正在运行的任务的配置快照。

在 Studio 中打开引擎的 流水线 选项卡,或通过 PATCH /v2/engines/:id 更新 pipelineConfig。调用方需要具备编辑引擎的权限。组织需要有权访问可运行阶段所需的功能。请参阅功能访问权限和定价。

保存完整配置 #

修改现有配置前,请先通过 GET /v2/engines/:id 读取引擎。发送 pipelineConfig 会替换该配置;未指定的阶段将采用默认值。请保留需要继续使用的设置。

以下请求为翻译配置了改写环节。请求中未指定的可选阶段均会禁用:

http
PATCH /v2/engines/:id
Content-Type: application/json
X-API-Key: YOUR_API_KEY
json
{
  "pipelineConfig": {
    "localize": { "enabled": true },
    "rephrase": { "enabled": true }
  }
}

如果应用需要对某类任务采用不同的策略,请使用独立的引擎。配置好模型和指导说明后,在创建这类任务时选择该引擎的 ID。

阶段设置 #

pipelineConfig 中的字段设置
localizeenabled: true。翻译是必需阶段。
preEdit、rephrase、postEdit、backTranslationenabled 为布尔值,默认为 false。
qualityGateenabled 布尔值和 strictness:"strict"、"medium" 或 "lax"(默认为 "medium")。
humanEditenabled、正整数 timeoutHours(默认为 48)以及审核 routes。
contentLengthenabled 以及下文介绍的 mode。

译后编辑需要人工审核。译后编辑环节处理的是人工审核后的文本;如果审核被跳过或超时,可能就没有人工处理的文本可供优化。

内容长度模式可设为 { "_tag": "noLongerThanSource" }(默认)、{ "_tag": "fixedCap", "maxColumns": 40 } 或 { "_tag": "matchSource", "tolerancePct": 10 }。数值必须为正整数。这些值表示目标显示列数,并非字节数上限,也不保证文本一定能适配界面。

设置人工审核路由 #

请先创建或选择决策池。每个 humanEdit.routes 条目指定一个决策池,以及对应的语言和目录范围。以下配置会将所有新翻译的内容发送到同一个决策池:

json
{
  "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,其他设置保持不变:

json
{
  "qualityGate": { "enabled": true, "strictness": "medium" }
}

当 humanEdit.enabled 为 false 时,你仍可保存已启用的 qualityGate。关闭人工审核后再重新开启,Studio 会保留已保存的设置。使用 API 时,请在每个用于替换的 pipelineConfig 中包含 qualityGate,以保留该设置。只有任务最终解析出的流水线启用了人工审核,质量门控才会运行。

质量门控会记录每个单元中发现的问题。"strict" 表示发现任何问题都需要审核,"medium" 表示发现重大或严重问题时需要审核,"lax" 表示仅发现严重问题时需要审核。质量门控无法检查的翻译仍需审核。将 qualityGate.enabled 设为 false 即可选择 全部,把路由覆盖范围内的每条新翻译都送交审核。复用的翻译不会产生新的审核工作。

判定结果不受严格程度影响;审核级别只用于决定发现的问题是否需要审核。更改引擎的级别只会影响后续启动的任务,不会改变正在运行的任务在启动时保存的配置。有关各级别的说明和严重程度定义,请参阅质量门控级别。

旧版异步本地化 API 仍接受 humanEdit.qualityThreshold,但会忽略它。凡是选定需要人工审核的语言,每条翻译都会交给审核者处理。如需在当前流水线中进行选择性审核,请在引擎的 人工审核 设置中配置 审核级别。

审核是否可用取决于组织的套餐和决策池的提供方连接。任务启动时,不可用的阶段功能及依赖这些功能的阶段都会关闭。请读取任务的目标阶段,确认实际生效的工作流。如果发布前必须由人工作出决定,请在交付下载的输出前落实这一策略。

查看结果 #

质量门控阶段会为每个已检查的单元保存以下输出:

json
{
  "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 的形式返回此输出;请参阅人工审核。审核者可在 队列 中查看翻译旁列出的问题。

阶段进度区分已完成、已跳过、失败和有警告的工作。人工审核介绍审核决策和截止时间。流水线指南说明各阶段的用途,以及后续阶段如何修改前面阶段生成的文本。