A tradução automática é uma excelente primeira versão. Para muito conteúdo, chega perfeitamente. Mas há conteúdo que precisa de mais antes de seguir para publicação: texto de origem limpo de gralhas à partida, um tradutor humano no circuito, copy que soe a escrita por um nativo, uma verificação de que o significado sobreviveu à viagem de ida e volta.
Pode sempre acrescentar essas etapas por sua conta — chamar a tradução, fazer uma revisão gramatical, encaminhar o resultado para um revisor, esperar pela resposta, traduzir de volta para detetar desvios, reconciliar as diferenças. Traduzir é a parte fácil. O difícil é orquestrar as esperas, a ordem e as falhas entre essas etapas — e a parte mais difícil de todas é mesmo um revisor que demora dois dias a responder.
O pipeline reúne essas etapas, já ligadas entre si. Cada fase é um invólucro opcional à volta da etapa central de tradução, ativado no motor de localização (ou substituído por pedido), e executado dentro da tarefa assíncrona durável que já gere repetições e isolamento de falhas. Escolhe as fases; a plataforma executa-as pela ordem certa e regista o que aconteceu. A ideia central deste cluster é simples: envolva a etapa de tradução exatamente com as fases de que precisa.
Apenas API assíncrona
As fases do pipeline aplicam-se apenas a tarefas criadas através da Async Localization API. O endpoint síncrono /localize executa apenas a etapa central de tradução — qualquer configuração de pipeline no motor é ignorada. Uma fase de revisão humana precisa de um workflow que possa ficar em pausa durante dois dias; uma chamada única de pedido/resposta não tem onde alojar essa espera. O pipeline vive onde a tarefa é durável.
Nesta página
- Porquê um pipeline
- Fases num relance
- O que acontece à tarefa quando uma fase falha
- Para onde ir a seguir
Porquê um pipeline#
A tradução em bruto não distingue o tipo de conteúdo que está a traduzir. Um texto jurídico precisa de se manter literalmente fiel ao original. Um texto de marketing precisa de soar a algo escrito por um nativo, não a algo traduzido. Um texto de origem gerado por utilizadores precisa de ver as gralhas corrigidas antes de um único erro na origem contaminar todos os idiomas de destino. Conteúdo regulamentado exige validação por parte de um humano qualificado.
São necessidades diferentes, e o pipeline permite que um único motor trate de todas, compondo fases em vez de impor um único comportamento. Se não ativar nenhuma, obtém tradução simples. Se ativar uma fase de revisão humana, a tarefa fica em pausa para a sua equipa. Se ativar a fase de reformulação, o resultado é reescrito para soar nativo. Cada página de fase abaixo explica claramente para que tipo de conteúdo serve — e, com a mesma clareza, para que tipo de conteúdo não serve, para que não ative uma fase que trabalhe contra o seu objetivo.
Configura os padrões uma vez no separador Pipeline do motor, ou substitui-os para uma única submissão com um objeto pipelineConfig no pedido — as fases omitidas herdam a definição do motor. A mecânica destas duas camadas está em Configure the pipeline.
Fases num relance#
O pipeline envolve a etapa central de localização. Pode ativar qualquer combinação de fases, sempre nesta ordem fixa. As fases desativadas são totalmente ignoradas. Cada fase tem a sua própria página com o comportamento completo, o modo de falha e a chamada para a ativar.
Edição por IA pré-localização
Opcional. Um agente de IA limpa a carga útil de origem — gralhas, gramática, ortografia — antes de qualquer tradução, para que um único erro na origem não se propague a todos os idiomas de destino. Não crítica. Consulte Pre-localization AI edit.
Localização central
Executa-se sempre. O seu motor aplica a respetiva model config, glossary, voz da marca e instructions para produzir a tradução. Esta é a única fase que não pode desativar — tudo o resto existe à sua volta.
Revisão humana pós-localização
Opcional. Um humano revê a tradução — a sua própria equipa no dashboard (Internal Review) ou um tradutor profissional de um fornecedor externo (External Review). A tarefa fica em pausa à espera do resultado num mecanismo orientado por eventos, pelo que uma revisão demorada não consome computação enquanto espera. Consulte Human review.
avaliação por IA pós-localização
Opcional, e só é executada depois de a revisão humana produzir resultado. Um agente de IA reconcilia as edições do humano com o glossário, a voz da marca e as instruções do seu motor. Isto não é o mesmo que AI Reviewers, que pontuam a qualidade sem alterar o texto. Consulte AI review.
Reformular para copy natural
Opcional. Um agente de IA reescreve a tradução para que soe a copy nativa e idiomática no idioma de destino, preservando significado, placeholders e etiquetas. Não crítica. Para texto de marketing; ignore-a quando a exatidão literal for importante. Consulte Rephrase for natural copy.
Verificação por retrotradução
Opcional. O resultado é traduzido de volta para a origem, uma IA compara-o com o original e o desvio é assinalado como minor, major ou critical — os problemas graves e críticos são corrigidos automaticamente. Uma técnica clássica de QA humano, automatizada. Consulte Back-translation check.
O que acontece à tarefa quando uma fase falha#
A objeção óbvia a um pipeline de seis fases é esta: cada fase adicional é mais uma coisa que pode falhar — por isso, ativá-las torna a tarefa mais propensa a falhar? Não. Uma falha numa fase não crítica não faz falhar a tarefa. A pré-edição e a reformulação são não críticas: se qualquer uma falhar, o último resultado válido segue em frente sem alterações e a tarefa continua. Em vez de falhar, a tarefa passa para um estado de aviso, e cada fase ativada deixa um registo que pode consultar para ver exatamente o que foi executado.
É essa a lógica de todo o pipeline: envolva a etapa de tradução exatamente com as fases de que precisa, execute-as dentro de uma tarefa que já gere as falhas e consulte um registo para cada fase. A forma como uma tarefa degradada se apresenta e a superfície de inspeção por fase estão em Observe pipeline runs. As páginas abaixo são as próprias fases — comece pela que corresponde ao conteúdo que está a traduzir.
