파이프라인 설정

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

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

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

엔진 기본값#

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

각 단계는 개별 스위치로 제어됩니다. 모두 끄거나, 모두 켜거나, 그 사이 어떤 조합이든 자유롭게 선택할 수 있습니다.

• 사전 로컬라이제이션 AI 편집 – 번역 전에 원문을 정리합니다.
• 사후 로컬라이제이션 검토 – Internal 또는 External 검토로 전달합니다. 같은 패널에서 모드, 티어, 타임아웃을 선택합니다.
• 사후 로컬라이제이션 AI 평가 – 검토가 활성화되기 전까지는 비활성화 상태로 유지되며, 검토 결과를 엔진 규칙에 맞게 조율합니다.
• 자연스러운 카피로 다듬기 – 원어민이 쓴 것처럼 자연스럽게 다시 씁니다. 다른 단계와는 독립적으로 동작합니다.
• 역번역 확인 – 왕복 번역 후에도 의미가 유지됐는지 확인합니다. 다른 단계와는 독립적으로 동작합니다.

핵심 로컬라이제이션은 켜고 끄는 단계가 아닙니다. 항상 실행되며, 다른 단계는 그 전후를 감싸는 방식으로 동작합니다.

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

{
  "preEdit": { "enabled": true },
  "humanEdit": {
    "enabled": true,
    "provider": "internal",
    "tier": "standard",
    "timeoutHours": 48
  },
  "postEdit": { "enabled": false },
  "rephrase": { "enabled": false },
  "backTranslation": { "enabled": true }
}

각 필드가 제어하는 내용—어떤 검토 제공자를 쓸지, 어떤 티어를 선택할지, 얼마나 오래 대기할지—는 해당 단계의 전용 페이지에 문서화되어 있습니다. 이 페이지는 설정이 어디에 저장되는지와 두 레이어가 어떻게 결합되는지에 초점을 맞춥니다.

요청별 재정의#

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

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

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

이것이 상속 규칙이며, 재정의 객체를 작게 유지할 수 있는 이유이기도 합니다. 명시한 단계는 재정의되고, 생략한 단계는 엔진 기본값을 상속합니다. 위 요청에서는 이 한 작업에 대해 rephrase는 켜고 backTranslation는 끕니다. preEdit, humanEdit, postEdit는 명시하지 않았기 때문에 엔진에 설정된 그대로 실행됩니다. 즉, 달라지는 내용만 적으면 됩니다.

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

• 재정의는 해당 제출에만 적용됩니다. 엔진에 다시 기록되지 않으므로, 영구적인 설정 변경을 만드는 방법은 아닙니다. 그런 변경은 Pipeline 탭에서 해야 합니다. 일회성 요청에는 재정의를, 새 기본 동작에는 탭 설정을 사용하세요.
• 또한 각 단계의 런타임 규칙 자체를 완화하지도 않습니다. 사후 로컬라이제이션 AI 평가는 검토에서 결과가 나온 경우에만 실행되므로, 조율할 검토 단계가 없는 작업에서 postEdit를 켜도 아무 일도 일어나지 않습니다. 어느 레이어에서 활성화했는지와는 무관합니다.

실행 결과 확인#

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

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

다음 단계#

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