번역은 정확하고 용어집도 잘 맞았는데, 그래도 여전히 번역문처럼 읽힐 수 있습니다. Rephrase는 그 마지막 간극을 메우는 파이프라인 단계입니다. AI 에이전트가 현재 출력을 대상 로캘에서 원어민이 직접 쓴 카피처럼 읽히도록 다듬되, 의미와 플레이스홀더, 태그는 그대로 보존합니다.
이 페이지에서는 rephrase 단계만 집중해서 다룹니다. 무엇을 다듬고, 무엇은 그대로 두며, 이 단계가 실패하면 어떤 일이 일어나는지, 그리고 결국 활성화할지 건너뛸지라는 한 가지 선택을 어떻게 할지 설명합니다. 파이프라인이 처음이라면 각 단계가 어떻게 맞물리는지 Async Localization Pipeline overview부터 살펴보세요. Rephrase는 async 전용으로, Async Localization API를 통해 생성된 작업에만 실행되며 동기식 /localize 호출에는 적용되지 않습니다.
무엇을 하나요#
직역은 원문의 표현 방식까지 대상 로캘로 그대로 끌고 올 수 있습니다. 문법적으로는 맞아도, 번역투라는 느낌이 분명히 남을 수 있죠. rephrase 단계는 현재의 최선 출력을 대상 로캘에서 자연스럽고 관용적으로 읽히는 원어민 카피로 다시 다듬습니다. 즉, 단어 대 단어 번역보다 자연스러운 관용 표현을 우선합니다. 원래의 의미와 의도는 유지하면서, 엔진의 glossary, 브랜드 보이스, instructions도 그대로 반영합니다. 다시 말해, 번역을 만들어낸 동일한 설정이 이 재작성에도 적용됩니다.
이 단계는 AI 및 사람 정제 단계가 끝난 뒤, 그 시점까지 도달한 출력을 대상으로 실행됩니다. 따라서 human review와 AI post-edit가 활성화되어 있든 아니든 똑같이 동작하며, 어느 경우든 현재의 최선 버전을 다시 다듬습니다. back-translation check도 함께 활성화되어 있다면, rephrase 이전 출력이 아니라 rephrase된 출력을 검증합니다.
직역 패스는 원문 표현에 더 가깝게 머물고, rephrase는 원어민 작성자가 실제로 쓸 법한 표현으로 카피를 옮깁니다. 따라서 둘은 서로 대체할 수 없으며, 어느 쪽이 필요한지는 아래에서 결정하게 됩니다.
플레이스홀더와 태그는 그대로 유지됩니다#
텍스트를 다시 쓰는 단계라면 가장 먼저 드는 걱정은 이것일 겁니다. 문장 아닌 부분까지 건드리지는 않을까? 그렇지 않습니다. Rephrase는 플레이스홀더, 변수, 태그, 서식을 정확히 그대로 유지합니다. 앱이 의존하는 토큰은 건드리지 않고, 그 주변 문장만 다시 다듬습니다.
그래서 아래와 같은 문자열도 모든 보간과 태그는 그대로 유지되고, 사람이 읽는 카피만 바뀝니다:
Source (en): "Hi {firstName}, you have <b>{count}</b> new messages."
Translated (de): "Hallo {firstName}, du hast <b>{count}</b> neue Nachrichten."
After rephrase (de):"Hey {firstName}, <b>{count}</b> neue Nachrichten warten auf dich."{firstName}, {count}, 그리고 <b> 태그는 세 경우 모두 동일합니다. 카피는 독일어에서 더 자연스럽게 읽히지만, 런타임이 의존하는 구조는 바뀌지 않습니다.
실패해도 작업은 멈추지 않습니다#
Rephrase는 비핵심(non-critical) 단계입니다. AI 재작성은 실패하거나 시간 초과될 수 있습니다. 하지만 그렇다고 이미 비용을 들여 얻은 번역이 사라지지는 않습니다. 이전 출력은 변경 없이 그대로 다음 단계로 전달되고 작업도 계속 진행됩니다. 즉, 정확한 번역 결과를 스타일 개선 한 번에 걸고 모험하는 구조가 아닙니다.
Rephrase가 실패해도 작업 자체가 실패로 처리되지는 않습니다. 대신 status: failed가 포함된 단계 기록으로 남고, 작업은 completed_with_warnings 상태로 완료되며, rephrase 이전 번역이 outputData에 반영됩니다:
{
"id": "ljb_C3d4E5f6G7h8I9j0",
"status": "completed_with_warnings",
"outputData": {
"greeting": "Hallo {firstName}, du hast <b>{count}</b> neue Nachrichten."
},
"warnings": [
{ "step": "rephrase", "message": "<the failure reason for this step>" }
],
"steps": [
{ "stepId": "localize", "type": "action", "status": "completed" },
{ "stepId": "rephrase", "type": "action", "status": "failed" }
]
}de 번역은 그대로 배포됩니다. 여기서의 정확한 message 텍스트는 예시일 뿐이고, 고정되는 것은 형태입니다. 즉, warnings[] 엔트리에 step와 message가 포함되고, rephrase 단계는 failed로 기록되며, rephrase 이전 출력은 outputData에 보존됩니다. step 필드를 보면 이번 실행에서 카피가 다듬어지지 않았다는 것을 알 수 있으므로, 자연스러운 표현이 중요한 로캘이라면 해당 로캘만 다시 실행할 수 있습니다. 전체 steps[] 및 warnings 구조와 비핵심 실패가 어떻게 completed_with_warnings로 집계되는지는 Observe pipeline runs에서 확인하세요.
비핵심이라는 말 그대로, 기본은 최선 노력입니다
rephrase를 활성화해도 작업의 신뢰성이 떨어지지는 않습니다. 최악의 경우에도 이 단계가 없었을 때 배포했을 번역에 경고 하나가 추가될 뿐입니다. 그래서 폭넓게 켜 두고, 다듬어진 카피를 필수 의존성이 아니라 품질 향상으로 받아들일 수 있습니다.
언제 켜고, 언제 건너뛸까#
Rephrase가 최적화하는 건 한 가지입니다. 바로 처음부터 원어민이 쓴 글처럼 읽히게 하는 것. 어떤 콘텐츠에는 이게 정확히 맞고, 어떤 콘텐츠에는 정반대로 맞지 않습니다. 그래서 이것은 전역 기본값이 아니라 콘텐츠별로 내려야 하는 결정입니다.
이럴 때는 활성화하세요: 마케팅 카피, 랜딩 페이지, 제품 설명, 온보딩처럼 원문 표현에 가깝게 유지하는 것보다 원어민 카피처럼 읽히는 것이 더 중요한 경우.
이럴 때는 건너뛰세요: 직역의 정확성이 우선인 기술 및 법률 콘텐츠. Rephrase는 문장을 자연스럽게 들리도록 다시 씁니다. 계약 조항, API 레퍼런스, 컴플라이언스 문구처럼 표현 하나하나가 중요한 콘텐츠에서는 원문에 더 가까운 표현이 더 안전합니다. 이런 콘텐츠에서는 rephrase를 끄고 core localization 단계의 출력을 그대로 사용하세요.
자연스러움에는 언제나 트레이드오프가 따릅니다
Rephrase는 의도적으로 카피를 원문 표현에서 멀어지게 만듭니다. 마케팅에서는 그 점이 바로 장점이고, 정확한 문구 자체에 법적·기술적 무게가 실린 콘텐츠에서는 그 점이 위험이 됩니다. 특정 payload가 어느 쪽에 속하는지 확신이 없다면, 그 콘텐츠에는 rephrase를 건너뛰세요. 더 안전한 기본값은 직역입니다.
활성화 방법#
Rephrase는 다른 모든 단계와 마찬가지로 구성됩니다. 즉, 엔진 수준의 기본값과 요청별 선택적 override가 함께 있으며, 전체 설정 방식은 Configure the pipeline에서 다룹니다. 짧게 말하면, 모든 작업에 적용하려면 엔진의 Pipeline 탭에서 토글하고, 단일 제출에만 적용하려면 pipelineConfig로 설정하면 됩니다:
{
"sourceLocale": "en",
"targetLocales": ["de", "fr"],
"data": { "headline": "Ship global products faster." },
"pipelineConfig": {
"rephrase": { "enabled": true }
}
}생략한 단계는 엔진 설정을 그대로 상속합니다. 따라서 위 override는 다른 단계는 건드리지 않고 이번 제출에만 rephrase를 켭니다. 덕분에 직역이 필요한 콘텐츠를 위해 엔진에서는 rephrase를 꺼 두고, 마케팅 payload처럼 필요한 요청에만 요청별로 켤 수 있습니다.
