기계 번역은 훌륭한 첫 초안입니다. 많은 콘텐츠에는 그것만으로도 충분합니다. 하지만 실제 배포 전에는 더 많은 과정이 필요한 콘텐츠도 있습니다. 먼저 오타를 정리한 소스 텍스트가 필요할 수도 있고, 사람 번역가의 검토가 필요할 수도 있으며, 원어민이 직접 쓴 듯한 카피가 필요할 수도 있습니다. 왕복 번역을 거친 뒤에도 의미가 그대로 유지됐는지 확인해야 하는 경우도 있습니다.
이런 단계들을 직접 붙일 수도 있습니다. translate를 호출하고, 문법 검사를 돌리고, 결과를 검토자에게 보내고, 답변을 기다렸다가, 의미가 달라졌는지 확인하려고 다시 번역하고, 차이를 조정하는 식입니다. 번역 자체는 쉬운 부분입니다. 어려운 건 그 단계들 사이의 대기, 순서, 실패를 오케스트레이션하는 일입니다. 그리고 응답까지 이틀이 걸리는 검토자는 그중에서도 가장 까다롭습니다.
파이프라인은 그런 단계들을 이미 연결해 둔 구성입니다. 각 단계는 핵심 번역 단계를 감싸는 선택형 래퍼로, 로컬라이제이션 엔진에서 켜고 끌 수 있고(또는 요청별로 재정의할 수 있으며), 재시도와 실패 격리를 이미 책임지는 내구성 있는 비동기 작업 안에서 실행됩니다. 필요한 단계만 고르면 플랫폼이 순서대로 실행하고, 무엇이 일어났는지 기록합니다. 이 클러스터가 남기는 단 하나의 확신은 이것입니다. 번역 단계를 정확히 필요한 단계로만 감싸세요.
비동기 API 전용
파이프라인 단계는 Async Localization API로 생성된 작업에만 적용됩니다. 동기식 /localize 엔드포인트는 핵심 번역 단계만 실행하고 그 외에는 아무것도 하지 않습니다. 엔진에 설정된 파이프라인 구성도 모두 무시됩니다. 사람 검토 단계는 이틀 동안 멈춰 있을 수도 있는 워크플로가 필요하지만, 단일 요청/응답 호출에는 그런 대기를 담아둘 곳이 없습니다. 파이프라인은 작업이 내구성을 갖는 곳에서만 동작합니다.
이 페이지에서 다루는 내용
왜 파이프라인이 필요한가#
기본 번역은 지금 번역하는 콘텐츠가 어떤 성격인지까지는 고려하지 않습니다. 법률 문서는 원문에 최대한 충실해야 합니다. 마케팅 카피는 번역투가 아니라 원어민이 직접 쓴 것처럼 읽혀야 합니다. 사용자 생성 소스 텍스트는 소스의 작은 실수 하나가 모든 대상 로캘에 퍼지기 전에 먼저 오타를 정리해야 합니다. 규제 대상 콘텐츠는 자격을 갖춘 사람이 최종 승인해야 합니다.
이건 서로 다른 작업이고, 파이프라인은 하나의 행동만 강제하는 대신 단계를 조합해 하나의 엔진으로 모두 처리할 수 있게 해줍니다. 아무 단계도 켜지 않으면 일반 번역이 됩니다. 사람 검토 단계를 켜면 작업은 팀의 검토를 기다리며 일시 중지됩니다. 재작성 단계를 켜면 결과물은 원어민이 쓴 것처럼 읽히도록 다듬어집니다. 아래 각 단계 페이지에서는 어떤 콘텐츠에 적합한지, 그리고 그 못지않게 분명하게 어떤 콘텐츠에는 적합하지 않은지도 설명합니다. 목표에 어긋나는 단계를 실수로 켜지 않도록 하기 위해서입니다.
기본값은 엔진의 Pipeline 탭에서 한 번 설정해 둘 수 있고, 요청의 pipelineConfig 객체로 단일 제출에 한해 재정의할 수도 있습니다. 생략한 단계는 엔진 설정을 그대로 상속합니다. 두 계층의 동작 방식은 파이프라인 구성하기에서 확인할 수 있습니다.
단계 한눈에 보기#
파이프라인은 핵심 로컬라이제이션 단계를 감쌉니다. 어떤 조합이든 이 고정된 순서 안에서 단계별로 활성화할 수 있습니다. 비활성화된 단계는 완전히 건너뜁니다. 각 단계마다 전체 동작 방식, 실패 시 처리 방식, 활성화 호출을 설명하는 전용 페이지가 있습니다.
로컬라이제이션 전 AI 편집
선택 사항입니다. AI 에이전트가 번역에 들어가기 전에 소스 페이로드의 오타, 문법, 철자를 정리해, 소스의 오류 하나가 모든 대상 로캘로 퍼지는 일을 막습니다. 중요하지 않은 단계입니다. 로컬라이제이션 전 AI 편집을 참고하세요.
핵심 로컬라이제이션
항상 실행됩니다. 엔진이 model config, glossary, 브랜드 보이스, instructions를 적용해 번역을 생성합니다. 이 단계만은 끌 수 없고, 나머지 모든 단계는 이 단계를 감싸는 구조입니다.
로컬라이제이션 후 사람 검토
선택 사항입니다. 사람이 번역을 검토합니다. 대시보드에서 직접 검토하는 자체 팀(Internal Review)일 수도 있고, 외부 제공업체의 전문 번역가(External Review)일 수도 있습니다. 작업은 이벤트 기반 대기 상태에서 결과를 기다리며 일시 중지되므로, 검토가 오래 걸려도 기다리는 동안 컴퓨팅 자원을 소모하지 않습니다. Human review를 참고하세요.
로컬라이제이션 후 AI 평가
선택 사항이며, 사람 검토에서 결과가 나온 뒤에만 실행됩니다. AI 에이전트가 사람의 수정 사항을 엔진의 glossary, 브랜드 보이스, instructions에 맞게 조정합니다. 텍스트를 바꾸지 않고 품질만 점수화하는 AI 평가자와는 다른 기능입니다. AI 평가를 참고하세요.
자연스러운 카피로 재작성
선택 사항입니다. AI 에이전트가 의미, 플레이스홀더, 태그는 유지한 채 번역문을 대상 로캘에 맞는 자연스럽고 관용적인 카피로 다시 씁니다. 중요하지 않은 단계입니다. 마케팅 카피에는 적합하지만, 원문에 대한 문자 그대로의 정확성이 중요한 경우에는 건너뛰세요. 자연스러운 카피로 재작성을 참고하세요.
역번역 검사
선택 사항입니다. 결과물을 다시 원문으로 번역한 뒤 AI가 원문과 비교해 드리프트를 minor, major, 또는 critical로 표시하며, major와 critical 이슈는 자동으로 수정합니다. 고전적인 사람 QA 기법을 자동화한 방식입니다. 역번역 검사를 참고하세요.
단계 실패가 작업에 미치는 영향#
6단계 파이프라인에 대해 가장 먼저 떠오르는 반론은 이것일 겁니다. 단계를 하나 추가할 때마다 고장 날 수 있는 지점도 하나 늘어나는데, 그렇다면 단계를 켤수록 작업이 실패할 가능성도 커지는 것 아닐까요? 아닙니다. 중요하지 않은 단계에서 실패가 나더라도 작업 전체가 실패하지는 않습니다. 사전 편집과 재작성은 중요하지 않은 단계이기 때문에, 둘 중 하나가 실패하면 마지막으로 정상적으로 생성된 결과가 그대로 다음 단계로 넘어가고 작업은 계속 진행됩니다. 작업은 깨지는 대신 경고 상태로 저하되며, 활성화된 각 단계는 실제로 무엇이 실행됐는지 확인할 수 있도록 기록을 남깁니다.
이것이 파이프라인 전체의 형태입니다. 번역 단계를 정확히 필요한 단계로만 감싸고, 실패를 이미 관리하는 작업 안에서 실행하며, 각 단계별 기록을 다시 읽어볼 수 있습니다. 저하된 작업이 어떻게 보고되는지와 단계별 검사 표면은 파이프라인 실행 관찰에서 다룹니다. 아래 페이지들은 각 단계 자체를 설명합니다. 지금 번역하는 콘텐츠와 가장 잘 맞는 단계부터 시작하세요.
