Como funciona

Acompanhe uma alteração de conteúdo desde a origem, passando pelas orientações de tradução salvas, até chegar a um resultado que você pode usar e verificar.

Ao escrever e revisar conteúdo, você decide o que quer que os leitores entendam, o que merece mais explicações e quais argumentos podem convencê-los. A tradução deve transmitir esse significado e essa intenção de convencer com a mesma precisão em outro idioma. O Lingo.dev usa modelos de linguagem para traduzir seu conteúdo com orientações salvas sobre seu produto, sua terminologia e sua voz.

Você fornece o conteúdo de origem e os idiomas de que precisa e seleciona o engine de localização responsável pela tradução. Quem faz a chamada à API identifica o engine com engineId; a CLI ou uma integração usa o engine de localização selecionado em sua configuração. Essa escolha determina os modelos e as orientações compartilhadas disponíveis para a solicitação. O conteúdo traduzido retorna pela ferramenta que o solicitou, e as medições de qualidade e a revisão humana seguem os caminhos que você configurar.

Comece pelo conteúdo e pelo idioma de destino #

O conteúdo que você fornece é a origem. Cada versão traduzida é um destino. O conteúdo de origem pode vir de um arquivo, de dados estruturados em uma aplicação ou de um sistema de conteúdo conectado. Os idiomas de origem e de destino solicitados identificam as línguas envolvidas.

Um idioma identifica a língua e, quando necessário, sua região ou sistema de escrita. Defina explicitamente o público pretendido: uma solicitação para pt-BR especifica o português brasileiro, em vez de deixar a região indefinida. Os idiomas de origem e de destino também ajudam o Lingo.dev a selecionar as orientações de tradução aplicáveis. Resolução de idiomas explica essas regras de correspondência.

A estrutura do conteúdo importa tanto quanto o idioma. Uma aplicação usa chaves de mensagem para localizar textos e variáveis para inserir valores. Um documento contém títulos, links e formatação. Quem faz uma chamada à API fornece dados estruturados diretamente; a CLI e os processadores de formato extraem dos arquivos o texto que pode ser traduzido e reconstroem as versões de destino. Cada caminho precisa retornar conteúdo que o sistema que o recebe continue conseguindo usar.

Ao armazenar traduções ou analisá-las mais tarde, mantenha a versão do conteúdo de origem junto com o resultado. Se o autor mudar o significado, uma tradução que estava correta para a versão anterior pode deixar de expressar a mensagem pretendida.

Salve o conhecimento necessário para as próximas solicitações #

Um modelo de linguagem sabe trabalhar com a linguagem. Isso não significa que ele conheça a terminologia do seu produto, os requisitos definidos pela sua equipe ou a forma como sua empresa conversa com os leitores. Um engine de localização armazena as escolhas de modelos e os vínculos com orientações reutilizáveis, para que cada solicitação possa usar esse conhecimento sem que você precise enviá-lo todo novamente.

Diferentes tipos de orientação respondem a diferentes perguntas:

  • Um glossário registra termos, seus significados pretendidos e as formas preferidas de escrevê-los ou os nomes que devem permanecer sem tradução. Ele ajuda o modelo a distinguir um conceito do produto de outro uso da mesma palavra.
  • Um conjunto de regras contém instruções de tradução. Ele pode expressar requisitos recorrentes que uma lista de termos não consegue abranger, incluindo distinções de significado que o conteúdo traduzido deve preservar.
  • Uma voz da marca descreve como a empresa se comunica com seus leitores, incluindo o tom e o grau de formalidade.

Glossários, conjuntos de regras e vozes da marca pertencem à sua organização e podem ser vinculados a vários engines de localização. Workflows relacionados podem compartilhar terminologia e manter escolhas diferentes de modelo ou voz quando necessário. Editar um recurso compartilhado pode afetar todos os engines de localização que o utilizam. Por isso, verifique seus vínculos ao alterar as orientações.

Para cada solicitação, o Lingo.dev seleciona termos relevantes do glossário, instruções aplicáveis, uma variação de voz e modelos candidatos a partir do engine de localização escolhido. Um documento JSON também pode fornecer format.options.context para descrever o público ou a finalidade e format.options.hints para chaves individuais. Assim, você mantém o conhecimento compartilhado no engine de localização e explica as particularidades do conteúdo que está sendo traduzido. Contexto de tradução aborda essas opções em detalhes.

Configurações padrão do formulário de criação #

O formulário de criação da aplicação web vem com as configurações padrão abaixo. Você pode alterar os modelos e selecionar orientações existentes antes de concluir a criação.

ConfiguraçãoPadrão do formulário
ModelosUm modelo principal recomendado e um modelo alternativo atendem a todos os pares de idiomas. Você pode alterar os modelos ou configurar um par específico separadamente.
Glossários, conjuntos de regras e voz da marcaNenhum recurso vinculado por padrão. Selecione recursos existentes durante a criação ou vincule-os depois.
Fluxo de processamentoSomente tradução. As etapas opcionais de reescrita e revisão humana começam desativadas.
Pontuação de glossário e instruções; sugestõesA pontuação automática, a geração de sugestões e a aplicação automática de sugestões começam desativadas.

Engines de localização existentes podem ter outras configurações salvas. Verifique o engine que será usado na chamada, em vez de presumir que ele ainda mantém as configurações padrão. Criar e configurar um engine de localização aborda as escolhas de modelos e os vínculos.

Gere a versão de destino e retorne-a a quem fez a chamada #

O modelo de linguagem selecionado recebe o conteúdo de origem e o contexto aplicável. Se o primeiro modelo configurado não conseguir concluir a solicitação, o engine de localização poderá tentar o modelo alternativo. Esse modelo permite uma nova tentativa; ele não compara as duas traduções para escolher a que tiver a maior pontuação de qualidade.

Com a API, você cria e inicia uma tarefa de tradução e depois baixa as versões de destino concluídas. A saída JSON mantém as chaves de mensagem do documento, e sua aplicação decide onde armazená-la ou usá-la. Com a CLI, os comandos push e pull executam esse workflow de arquivos para você. Cada integração tem sua própria forma de gravar os resultados, como abrir uma solicitação de incorporação com as traduções. Integrações explica o que cada conexão lê e grava.

A estrutura retornada conecta a tradução ao restante do seu trabalho. Verifique se a aplicação consegue carregar o catálogo, substituir suas variáveis ou renderizar os links e a formatação do documento. Essas verificações confirmam que o resultado pode ser usado pelo sistema que o recebe; medir sua qualidade linguística exige outro tipo de evidência.

Verifique o resultado no workflow que o utiliza #

Escolha medições com base no que importa no seu conteúdo. Verificar se o significado foi preservado exige o conteúdo de origem e sua tradução, com contexto suficiente para entender a intenção do autor. Já uma verificação ortográfica pode usar apenas a versão de destino. As evidências são diferentes porque as perguntas são diferentes. O resultado é útil quando você consegue ver o que foi verificado e examinar o trecho que fundamenta a resposta.

O fluxo de processamento do engine pode incluir revisão humana antes que a tarefa produza seu resultado final. Leia a política de revisão para entender a abrangência, o encaminhamento e o que acontece quando o tempo limite é atingido: uma versão de destino concluída pode não ter passado por revisão ou ter prosseguido após o tempo limite. As medições independentes de qualidade são executadas separadamente. Portanto, a conclusão da tradução não equivale a um relatório de qualidade concluído nem comprova a aprovação de uma pessoa.

As medições também podem examinar traduções produzidas fora do Lingo.dev. Você pode manter seu sistema de geração atual e consultar Medir para conhecer a forma disponível de examinar seus resultados. A medição responde a uma pergunta definida sobre o texto fornecido; sua equipe decide o que o resultado significa para o uso desse texto.

Se uma revisão revelar um problema recorrente de terminologia, corrija a tradução atual e considere, separadamente, alterar o glossário ou uma instrução para os próximos trabalhos. Atualizar as orientações compartilhadas não reescreve todas as traduções anteriores. Sugestões descreve como são tratadas as propostas de alteração nas orientações.

Para traduzir conteúdo de uma aplicação, faça sua primeira solicitação à API. O guia usa um pequeno conjunto de dados para percorrer as etapas de configuração, tradução e inspeção de um arquivo de destino salvo. Se o conteúdo de origem já estiver em arquivos, o guia de início rápido da CLI percorre esse caminho até a obtenção dos resultados.