작동 방식

원문이 바뀌면 어떤 과정을 거쳐 번역될까요? 저장된 번역 지침을 적용해 실제로 사용하고 확인할 수 있는 결과를 얻기까지의 흐름을 살펴보세요.

콘텐츠를 작성하고 다듬을 때는 독자가 무엇을 이해해야 할지, 어디에 설명이 더 필요할지, 어떤 논거가 설득력을 가질지 고민합니다. 번역도 그 의미와 설득 의도를 다른 언어로 똑같이 정확하게 전달해야 합니다. Lingo.dev는 제품, 용어, 말투에 관해 저장된 지침을 바탕으로 언어 모델을 활용해 콘텐츠를 번역합니다.

원문과 필요한 언어를 제공하고 번역에 사용할 로컬라이제이션 엔진을 선택하세요. API를 호출할 때는 engineId로 엔진을 지정하고, CLI나 연동 기능에서는 설정에 지정된 로컬라이제이션 엔진을 사용합니다. 어떤 엔진을 선택하느냐에 따라 요청에 사용할 수 있는 모델과 공유 지침이 결정됩니다. 번역된 콘텐츠는 요청한 도구로 반환되며, 품질 측정과 휴먼 리뷰는 설정한 경로에 따라 진행됩니다.

콘텐츠와 번역할 언어부터 정하기 #

제공하는 콘텐츠가 원문이고, 이를 번역한 각 버전이 번역문입니다. 원문은 파일, 애플리케이션의 구조화된 데이터, 연결된 콘텐츠 시스템에서 가져올 수 있습니다. 요청에 지정한 원본 로캘과 대상 로캘은 어떤 언어에서 어떤 언어로 번역할지를 나타냅니다.

로캘은 언어를 식별하며, 필요한 경우 지역이나 문자 체계까지 구분합니다. 대상 독자를 명확히 지정하세요. pt-BR를 요청하면 지역이 지정되지 않은 포르투갈어가 아니라 브라질 포르투갈어를 명시하게 됩니다. 원본 로캘과 대상 로캘은 Lingo.dev가 적용할 번역 지침을 선택하는 기준이기도 합니다. 지침을 연결하는 규칙은 로캘 결정에서 설명합니다.

콘텐츠는 언어만큼 구조도 중요합니다. 애플리케이션은 메시지 키로 텍스트를 찾고 변수에 값을 넣습니다. 문서에는 제목, 링크, 서식이 있습니다. API를 호출할 때는 구조화된 데이터를 직접 제공하며, CLI와 형식 처리기는 파일에서 번역할 텍스트를 추출한 뒤 번역된 파일을 재구성합니다. 어떤 경로를 사용하든 결과를 받는 시스템에서 그대로 활용할 수 있는 콘텐츠를 반환해야 합니다.

번역을 저장하거나 나중에 살펴볼 때를 대비해 결과물과 함께 해당 원문 버전도 보관하세요. 작성자가 원문의 의미를 바꾸면 이전 버전에서는 정확했던 번역도 더 이상 의도한 메시지를 전달하지 못할 수 있습니다.

이후 요청에 필요한 지식 저장하기 #

언어 모델은 언어를 다루는 방법을 알고 있습니다. 하지만 제품 용어, 팀에서 합의한 요구 사항, 회사가 독자에게 말하는 방식까지 저절로 알지는 못합니다. 로컬라이제이션 엔진은 사용할 모델과 재사용 가능한 지침의 연결 정보를 저장합니다. 덕분에 요청할 때마다 모든 정보를 다시 보내지 않아도 이 지식을 활용할 수 있습니다.

지침은 종류에 따라 서로 다른 질문에 답합니다.

  • 용어집에는 용어와 그 의미, 권장 표현, 번역하지 않고 유지할 이름을 기록합니다. 모델이 제품 개념을 나타내는 단어와 같은 단어의 다른 쓰임을 구분하도록 돕습니다.
  • 규칙 세트에는 번역 지침이 담깁니다. 번역문에서 반드시 유지해야 하는 의미의 차이 등 용어 목록만으로는 담기 어려운 반복적인 요구 사항을 명시할 수 있습니다.
  • 브랜드 보이스는 어조와 격식 수준을 비롯해 회사가 독자에게 말하는 방식을 설명합니다.

용어집, 규칙 세트, 브랜드 보이스는 조직에 속하며 여러 로컬라이제이션 엔진에 연결할 수 있습니다. 관련 워크플로끼리 용어를 공유하되, 필요에 따라 모델이나 브랜드 보이스는 다르게 선택할 수 있습니다. 공유 리소스를 수정하면 이를 사용하는 모든 로컬라이제이션 엔진에 영향을 줄 수 있으므로, 지침을 변경할 때는 어떤 엔진에 연결되어 있는지 확인하세요.

Lingo.dev는 요청마다 선택된 로컬라이제이션 엔진에서 관련 용어집 항목, 조건에 맞는 지침, 브랜드 보이스 변형, 모델 후보를 선택합니다. JSON 문서에는 대상 독자나 목적을 설명하는 format.options.context와 개별 키에 대한 format.options.hints도 제공할 수 있습니다. 이렇게 하면 공통 지식은 로컬라이제이션 엔진에 보관하면서 번역할 콘텐츠만의 특성도 전달할 수 있습니다. 각 선택 사항은 번역 맥락에서 자세히 설명합니다.

생성 양식의 기본값 #

웹 앱의 생성 양식에는 다음 기본값이 적용되어 있습니다. 생성을 완료하기 전에 모델을 변경하거나 기존 지침을 선택할 수 있습니다.

설정양식 기본값
모델권장 기본 모델과 대체 모델이 모든 로캘 쌍에 적용됩니다. 모델을 변경하거나 특정 로캘 쌍을 별도로 설정할 수 있습니다.
용어집, 규칙 세트, 브랜드 보이스기본적으로 연결할 리소스가 선택되어 있지 않습니다. 생성할 때 기존 리소스를 선택하거나 나중에 연결하세요.
파이프라인번역만 수행합니다. 선택 사항인 재작성과 휴먼 리뷰 단계는 기본적으로 비활성화되어 있습니다.
용어집 및 지침 준수 점수 평가, 제안자동 점수 평가, 제안 생성, 제안 자동 적용은 기본적으로 비활성화되어 있습니다.

기존 로컬라이제이션 엔진에는 다른 설정이 저장되어 있을 수 있습니다. 여전히 기본값이 적용되어 있다고 가정하지 말고, 호출에 사용할 엔진의 설정을 직접 확인하세요. 모델 선택과 리소스 연결은 로컬라이제이션 엔진 생성 및 구성에서 설명합니다.

번역문을 생성해 호출자에게 반환하기 #

선택한 언어 모델은 원문과 적용할 맥락을 받습니다. 첫 번째로 설정된 모델이 요청을 완료하지 못하면 로컬라이제이션 엔진이 대체 모델로 다시 시도할 수 있습니다. 대체 모델은 요청을 한 번 더 시도하기 위한 수단이지, 두 번역을 비교해 품질 점수가 더 높은 쪽을 고르는 기능은 아닙니다.

API를 사용할 때는 번역 작업을 생성하고 시작한 뒤 완료된 번역문을 다운로드합니다. JSON 결과물에는 문서의 메시지 키가 유지되며, 이를 어디에 저장하고 사용할지는 애플리케이션에서 결정합니다. CLI에서는 푸시와 풀이 이 파일 작업 흐름을 대신 처리합니다. 연동 기능은 번역 풀 리퀘스트를 여는 등 각기 정해진 방식으로 결과를 원래 시스템에 반영합니다. 각 연결이 무엇을 읽고 쓰는지는 연동에서 설명합니다.

반환된 결과물의 구조는 번역을 이후 작업과 이어줍니다. 애플리케이션에서 카탈로그를 불러오고 변수에 값을 넣을 수 있는지, 문서의 링크와 서식을 표시할 수 있는지 확인하세요. 이런 점검은 결과를 받는 시스템에서 출력물을 사용할 수 있는지 확인하는 과정입니다. 언어 품질을 측정하려면 다른 종류의 근거가 필요합니다.

결과를 사용하는 워크플로에서 확인하기 #

콘텐츠에서 중요한 요소를 중심으로 측정 항목을 선택하세요. 의미가 유지되었는지 확인하려면 원문과 번역문은 물론, 작성자의 의도를 이해할 수 있을 만큼 충분한 맥락이 필요합니다. 반면 맞춤법은 번역문만으로도 검사할 수 있습니다. 확인하려는 질문이 다르면 필요한 근거도 달라집니다. 무엇을 확인했는지 알 수 있고, 그 판단의 근거가 된 구절을 직접 살펴볼 수 있어야 결과를 유용하게 활용할 수 있습니다.

엔진의 파이프라인에는 작업의 최종 결과물을 생성하기 전 휴먼 리뷰 단계가 포함될 수 있습니다. 적용 범위, 처리 경로, 시간 초과 시 동작은 검토 정책을 확인하세요. 완료된 번역문이라도 검토를 건너뛰었거나 시간 초과 후 다음 단계로 진행되었을 수 있습니다. 독립적인 품질 측정은 별도로 실행됩니다. 따라서 번역이 완료되었다고 해서 품질 보고서까지 완성되었거나 사람이 승인했다는 뜻은 아닙니다.

Lingo.dev 외부에서 생성한 번역도 측정할 수 있습니다. 기존 생성 시스템을 그대로 사용하면서 측정에서 해당 결과물을 검사할 수 있는 지원 방법을 확인하세요. 측정은 제공된 텍스트에 대해 정해진 질문에 답합니다. 그 결과가 실제 사용에 어떤 의미를 갖는지는 팀에서 판단합니다.

검토 과정에서 반복되는 용어 문제가 발견되면 현재 번역을 수정하고, 향후 작업을 위해 용어집이나 지침도 별도로 변경할지 고려하세요. 공유 지침을 업데이트한다고 이전의 모든 번역이 다시 작성되지는 않습니다. 지침 변경 제안의 처리 방식은 제안에서 설명합니다.

애플리케이션에서 콘텐츠를 번역하려면 첫 API 요청을 보내보세요. 이 실습 안내에서는 소량의 데이터로 설정과 번역을 진행한 뒤 저장된 번역문 파일을 확인합니다. 원문이 이미 파일로 준비되어 있다면 CLI 빠른 시작에서 파일 기반으로 번역문을 가져오는 단계까지 따라 해보세요.