블로그로 돌아가기

Reliability · 2026년 8월 19일

AI 번역에서 플레이스홀더, 링크, 식별자 보호하기

토큰이 변경되어 페이지가 깨질 수 있다면 자연스러운 출력만으로는 충분하지 않습니다. 번역 워크플로는 생성이 시작되기 전에 기능적 콘텐츠를 보호해야 합니다.

AI 번역에서 플레이스홀더, 링크, 식별자 보호하기

번역에서 가장 중요한 요소들 중 일부는 아예 번역되지 않아야 합니다.

변수, URL, 엔트리 ID, 에셋 참조, 코드 예제, 서식 마커는 문장 자체보다 기능을 담당합니다. 모델은 자연스러운 문장을 만들어낼 수 있지만, 그 요소들 중 하나를 조용히 변경해 주변 경험을 망가뜨릴 수 있습니다.

신뢰할 수 있는 AI 번역은 언어와 구조를 분리하는 것에서 시작합니다.

프롬프트 전에 보호 대상 콘텐츠 식별하기

"플레이스홀더를 보존하라" 같은 일반적인 지시에 의존하지 마세요. 먼저 반드시 유지되어야 하는 정확한 토큰과 노드를 식별해야 합니다.

보호 대상 콘텐츠에는 일반적으로 다음이 포함됩니다:

  • {first_name} 또는 {{ total }} 같은 보간 변수
  • ICU 메시지 구문 및 복수 선택자
  • URL, 이메일 주소, 라우트 프래그먼트
  • HTML 속성 및 markdown 링크 대상
  • Contentful 엔트리 및 에셋 참조
  • 인라인 코드, fenced code block, API 값
  • 번역 불가로 표시된 제품명

콘텐츠 모델과 필드 유형은 보호 규칙을 결정하는 데 도움이 되어야 합니다. 리치 텍스트 문서는 일반 텍스트 제목과는 다른 구조적 처리가 필요합니다.

위험한 값을 안정적인 토큰으로 대체하기

일반 문자열의 경우, 견고한 접근 방식 중 하나는 번역 전에 보호된 값을 추출하고 명확한 임시 토큰으로 대체하는 것입니다.

모델은 주변 언어를 보지만 대상 URL이나 식별자를 실수로 다시 쓰지는 못합니다. 생성 후 워크플로는 서버 측 맵에서 원래 값을 복원합니다.

토큰은 고유해야 하고, 자연어와 혼동되기 어려워야 하며, 복원 전에 검증되어야 합니다. 모델이 맵 자체를 재현할 것이라고 절대 믿지 마세요.

리치 텍스트를 구조로서 번역하기

리치 텍스트 트리를 markdown이나 HTML로 평탄화하면 중요한 구분이 사라질 수 있습니다.

텍스트 노드는 번역 대상입니다. 링크, 임베디드 엔트리, 노드 유형, 마크는 구조적 요소입니다. 문서 트리를 순회하면서 번역 가능한 텍스트 리프만 번역하고, 참조는 그대로 둔 채 원래 계층 구조를 다시 구성하세요.

이 방식은 검토도 개선합니다. 편집자는 누락되거나 재정렬된 노드를 숨길 수 있는 직렬화된 근사 표현을 검토하는 대신, 두 로캘에서 동일한 구조를 비교할 수 있습니다.

저장하기 전에 출력 검증하기

보호에는 닫힌 루프가 필요합니다.

번역 후에는 예상된 모든 토큰이 형식이 허용하는 정확한 위치에 나타나는지, 그리고 알 수 없는 토큰이 새로 도입되지 않았는지 확인하세요. 구조화된 형식은 느슨한 문자열 비교 대신 파싱해서 검사해야 합니다.

유용한 실패 메시지는 구체적입니다:

  • 플레이스홀더 {total} 누락
  • ctaBody 필드의 링크 대상 변경됨
  • de 로캘에서 ICU 구문이 유효하지 않음
  • 예상치 못한 리치 텍스트 노드 수

이 경계에서 잘못된 출력을 거부하는 편이, 렌더링 중 또는 더 나쁘게는 게시 후에 문제가 드러나게 두는 것보다 안전합니다.

검토에서 보호된 요소 표시하기

검토자는 기능적 콘텐츠를 인식할 수 있어야 하지만, 그것 때문에 주의가 분산되어서는 안 됩니다.

플레이스홀더와 보호된 용어에는 은은한 스타일을 사용하세요. 링크 텍스트는 편집 가능하게 두되 대상은 보이도록 하고 별도로 제어하세요. 임베디드 콘텐츠의 경우 변경 불가능한 ID와 함께 사람이 읽을 수 있는 레이블을 표시하세요.

검토자가 대상 시장용 URL을 의도적으로 변경해야 한다면, 이를 문장 번역의 우발적 부작용이 아니라 별도의 로컬라이즈된 필드 결정으로 다루어야 합니다.

적대적 예제로 테스트하기

정상 경로만으로는 충분하지 않습니다. 반복되는 변수, 인접한 구두점, 중첩된 markdown, 복수형, 오른쪽에서 왼쪽으로 쓰는 텍스트, 일반 단어처럼 보이는 플레이스홀더가 포함된 문자열을 넣으세요.

보호 로직은 실제 운영 콘텐츠에 신뢰를 부여하기 전에 이러한 사례들을 손실 없이 왕복 처리할 수 있음을 입증해야 합니다.

핵심 요점

번역 품질에는 기능적 무결성도 포함됩니다.

보호된 콘텐츠를 추출하고, 번역 가능한 언어만 번역하며, 리치 텍스트 구조를 보존하고, 결과를 검증하고, 검토 중 기능적 요소를 명확히 보여주세요. 자연스러운 문장도 게시 후 페이지가 여전히 제대로 작동할 때에만 가치가 있습니다.