파이프라인 설정

실행할 파이프라인 단계를 두 레이어에서 설정합니다. 엔진의 기본값과, 단일 요청에 적용하는 선택적 재정의입니다.

이제 핵심 번역 단계 전후에 어떤 단계를 둘지는 정했습니다. 남은 질문은 두 가지입니다. 그 결정은 어디에 저장할지, 그리고 다른 작업과 다르게 처리해야 하는 작업이 하나 생기면 어떻게 할지입니다. 답은 두 개의 레이어입니다. 엔진에는 모든 비동기 작업이 상속하는 기본값이 있고, 단일 제출의 pipelineConfig 객체는 그 제출에 한해서만 이 기본값을 재정의합니다. 재정의에서 생략한 단계는 엔진 설정을 그대로 상속하므로, 요청에는 달라지는 내용만 명시하면 됩니다.

파이프라인이 처음이라면 먼저 파이프라인 개요에서 각 단계의 역할을 확인해 보세요. 이 페이지는 각 단계를 켜고 재정의하는 방법을 다루며, 활성화된 뒤 각 단계가 실제로 무엇을 하는지 설명하는 페이지는 아닙니다.

엔진 기본값#

대시보드에서 엔진의 Pipeline 탭을 열고 각 단계를 개별적으로 켜거나 끄세요. 이 설정이 해당 엔진의 기본값이 됩니다. 이 엔진으로 라우팅되는 모든 비동기 작업은 요청에서 따로 재정의하지 않는 한 이 단계 설정으로 실행됩니다. 한 번만 설정해 두면 호출할 때마다 파이프라인을 반복해서 지정할 필요가 없습니다.

Localization을 제외한 모든 단계에는 각각 전용 스위치가 있으며, 스위치를 바꾸는 즉시 저장됩니다. 아무 단계도 켜지 않게 하거나, 모두 켜거나, 그 사이의 어떤 조합이든 자유롭게 설정할 수 있습니다. 작업은 다음 순서대로 단계를 실행합니다:

• 사전 편집 – 번역 전에 원문을 다듬습니다.
• Localization – 핵심 번역 단계입니다. 항상 켜짐으로 표시되며 스위치는 없습니다.
• 재작성 – 원어민이 쓴 것처럼 자연스럽게 읽히도록 다시 다듬습니다. 다른 단계와는 독립적으로 작동합니다.
• 휴먼 리뷰 – 내부 검토 또는 외부 검토로 보냅니다. 이 단계의 설정 버튼을 누르면 제공업체, 시간 제한, 품질 기준값이 열립니다.
• 사후 편집 – 사람이 수정한 내용을 엔진 규칙에 다시 맞춥니다. 휴먼 리뷰가 켜져 있어야만 이 단계를 켤 수 있고, 휴먼 리뷰를 끄면 이 단계도 함께 꺼집니다.
• 콘텐츠 길이 – 글자 수가 아니라 표시 열 수를 기준으로 번역이 너비 예산 안에 들어오도록 유지합니다. 이 단계의 설정 버튼을 누르면 예산이 열리며, 고정 한도 이하로 유지(최대 길이 포함), 원문보다 길지 않게, 또는 원문 길이에 맞추기(허용 차이를 백분율로 설정) 중에서 선택할 수 있습니다.
• 역번역 – 왕복 번역 후에도 의미가 유지되는지 확인합니다. 다른 단계와는 독립적으로 작동합니다.

현재 요금제에 포함되지 않은 단계에는 Enterprise 태그가 표시되며, 켤 수 없습니다.

기본값은 모든 작업이 상속하는 값이므로, 엔진 설정은 pipelineConfig 재정의가 병합되는 기준 형태가 됩니다. 각 단계는 하나의 키로 표현됩니다.

{
  "preEdit": { "enabled": true },
  "humanEdit": {
    "enabled": true,
    "provider": "internal",
    "tier": "standard",
    "timeoutHours": 48,
    "qualityThreshold": 85
  },
  "postEdit": { "enabled": false },
  "rephrase": { "enabled": false },
  "contentLength": {
    "enabled": true,
    "mode": { "_tag": "fixedCap", "maxColumns": 40 }
  },
  "backTranslation": { "enabled": true }
}

각 필드가 무엇을 제어하는지—어떤 검토 제공업체를 쓰는지, 어떤 번역이 검토를 건너뛰는지, 얼마나 오래 대기하는지—는 해당 단계 페이지에 문서화되어 있습니다. 이 페이지는 설정이 어디에 있는지와 두 계층이 어떻게 함께 적용되는지를 설명합니다.

요청별 재정의#

대부분의 작업은 엔진 기본값으로 실행하면 됩니다. 예외는 다른 파이프라인이 필요한 단일 제출입니다. 예를 들어 엔진에서는 보통 꺼 두는 다듬기 단계를 원하는 일회성 마케팅 카피 배치가 있을 수 있고, 반대로 그 단계를 건너뛰어야 하는 법률 관련 페이로드가 있을 수도 있습니다. 한 번의 배치를 처리하려고 엔진 설정을 바꾸면 다른 모든 작업에도 그 변경이 적용됩니다.

그래서 차이점만 요청에 실어 보냅니다. pipelineConfig``POST /jobs/localization 본문에 객체를 추가하면 해당 제출에 한해서만 엔진 기본값을 재정의할 수 있습니다. 엔진 자체 설정은 바뀌지 않으며, 재정의 없는 다음 작업은 다시 기본값으로 실행됩니다.

{
  "sourceLocale": "en",
  "targetLocales": ["de", "fr"],
  "data": { "headline": "Ship in every language." },
  "pipelineConfig": {
    "rephrase": { "enabled": true },
    "backTranslation": { "enabled": false }
  }
}

이것이 상속 규칙이며, 오버라이드를 최소화하는 방식이기도 합니다: 명시한 단계는 오버라이드되고, 생략한 단계는 엔진 기본값을 상속합니다. 위 요청은 이번 작업에만 rephrase를 켜고 backTranslation를 끕니다. preEdit, humanEdit, postEdit, contentLength는 명시되지 않았으므로 엔진에 설정된 그대로 실행됩니다. 달라지는 부분만 지정하면 됩니다.

재정의가 하지 않는 일도 두 가지가 더 있습니다. 이 부분은 무엇이든 할 수 있을 것처럼 보이기 쉬워서 분명히 짚고 넘어가겠습니다.

• 재정의는 해당 제출에만 적용됩니다. 엔진에 다시 기록되지 않으므로, 영구적인 설정 변경을 만드는 방법은 아닙니다. 그런 변경은 Pipeline 탭에서 해야 합니다. 일회성 요청에는 재정의를, 새 기본 동작에는 탭 설정을 사용하세요.
• 이 규칙이 단계 자체의 런타임 규칙까지 완화해 주는 것은 아닙니다. 사후 편집은 사람이 하는 검토에서 결과가 나왔을 때만 실행되므로, 조정할 사람 단계가 없는 작업에서 postEdit를 활성화해도 아무 일도 일어나지 않습니다. 어느 계층에서 켰든 마찬가지입니다.

실행 결과 확인#

설정은 어떤 단계가 실행되어야 하는지를 정하고, 실제로 어떤 단계가 실행됐는지는 작업 레코드에서 확인합니다. 작업에는 steps[] 배열이 포함되며, 요청별 재정의가 실제로 적용됐는지 확인할 때는 단순히 전송했는지가 아니라 이 배열을 봐야 합니다.

이 레코드를 읽는 방법—각 단계의 stepId가 뜻하는 바, skipped 단계의 의미, 치명적이지 않은 실패가 어디에 표시되는지—는 별도 페이지에서 다룹니다.

다음 단계#

엔진에 기본값을 설정하고, 필요할 때는 요청에서 재정의할 수 있습니다. 이제 재정의를 포함한 작업을 제출해 보거나, 단계 레코드를 확인해 어떤 단계가 실행됐는지 살펴보세요.