Configurar o pipeline

Defina que etapas do pipeline são executadas em duas camadas: uma predefinição no motor e uma substituição opcional num único pedido.

Já decidiu quais as etapas que pretende à volta da etapa principal de tradução. Agora há duas perguntas: onde fica essa decisão e o que fazer quando uma tarefa precisa de algo diferente das restantes? A resposta são duas camadas. O motor guarda a predefinição que todas as tarefas assíncronas herdam. Um objeto pipelineConfig numa única submissão substitui essa predefinição apenas para essa submissão. As etapas que deixar de fora da substituição herdam do motor, por isso o pedido indica apenas o que é diferente.

Ainda não conhece o pipeline? Comece pela Visão geral do pipeline para perceber o que faz cada etapa. Esta página explica como ativá-las e substituí-las — não o que fazem depois de ativadas.

Predefinições ao nível do motor#

Abra o separador Pipeline do motor no dashboard e ative ou desative cada etapa de forma independente. Essa configuração é a predefinição do motor: todas as tarefas assíncronas encaminhadas para ele são executadas com estas etapas, a menos que um pedido as substitua. Defina-a uma vez e não precisa de voltar a indicar o pipeline em todas as chamadas.

Cada etapa tem o seu próprio interruptor. Pode ativar qualquer combinação — nenhuma, todas ou qualquer opção intermédia:

• Edição por IA pré-localização — limpa o texto de origem antes da tradução.
• Revisão humana pós-localização — encaminha para revisão Interna ou Externa. Escolhe o modo, o nível e o tempo limite no mesmo painel.
• avaliação por IA pós-localização — permanece desativada até a revisão humana estar ativada; concilia a edição humana com as regras do seu motor.
• Reformular para soar natural — reescreve para soar nativo. Independente das outras etapas.
• Verificação por retrotradução — verifica se o significado se manteve no processo de ida e volta. Independente das outras etapas.

Localização principal não é um interruptor — é sempre executada. As etapas ficam à sua volta.

A predefinição é aquilo que todas as tarefas herdam, por isso a configuração do motor é a estrutura sobre a qual se aplica uma substituição pipelineConfig. Cada etapa corresponde a uma chave:

{
  "preEdit": { "enabled": true },
  "humanEdit": {
    "enabled": true,
    "provider": "internal",
    "tier": "standard",
    "timeoutHours": 48
  },
  "postEdit": { "enabled": false },
  "rephrase": { "enabled": false },
  "backTranslation": { "enabled": true }
}

O que cada campo controla — que fornecedor de revisão, que nível, quanto tempo de espera — está documentado na página da própria etapa. Esta página explica onde fica a configuração e como as duas camadas se combinam.

Substituição por pedido#

A maioria das tarefas deve executar a predefinição do motor. A exceção é uma única submissão que precisa de um pipeline diferente — um lote pontual de texto de marketing que quer a etapa de reformulação que o seu motor normalmente deixa desativada, ou uma carga jurídica que a deve ignorar. Editar o motor para tratar um único lote também alteraria todas as outras tarefas.

Por isso, passa a diferença no próprio pedido. Adicione um objeto pipelineConfig ao corpo de POST /jobs/localization e isso substitui a predefinição do motor apenas para essa submissão. Nada muda no motor; a tarefa seguinte sem substituição volta à predefinição.

{
  "sourceLocale": "en",
  "targetLocales": ["de", "fr"],
  "data": { "headline": "Ship in every language." },
  "pipelineConfig": {
    "rephrase": { "enabled": true },
    "backTranslation": { "enabled": false }
  }
}

Esta é a regra de herança, e é isso que mantém a substituição pequena: uma etapa que indicar é substituída; uma etapa que omitir herda a predefinição do motor. O pedido acima ativa rephrase e desativa backTranslation para esta única tarefa. preEdit, humanEdit e postEdit não são indicadas, por isso são executadas exatamente como estão configuradas no motor. Indica apenas o que é diferente.

Mais duas coisas que a substituição não faz, ditas de forma clara porque esta é a parte que parece poder fazer tudo:

• Altera apenas essa submissão. Não escreve de volta no motor, por isso não é a forma de fazer uma alteração de configuração duradoura — para isso serve o separador Pipeline. Use a substituição para o caso pontual; use o separador para a nova configuração normal.
• Não flexibiliza as regras de execução de uma etapa. avaliação por IA pós-localização só é executada quando a revisão humana produz resultado, por isso ativar postEdit não faz nada numa tarefa que não tenha uma etapa humana para conciliar — independentemente da camada em que a ativou.

Confirmar o que foi executado#

A configuração define que etapas devem ser executadas; o registo da própria tarefa diz-lhe quais foram realmente executadas. A tarefa inclui um array steps[], e esse array é a forma de confirmar que uma substituição por pedido teve mesmo efeito — não apenas que a enviou.

A leitura desses registos — o stepId de cada etapa, o que significa uma etapa skipped, onde surgem falhas não críticas — tem a sua própria página.

Próximos passos#

Pode definir a predefinição no motor e substituí-la num pedido. A partir daqui, submeta uma tarefa com uma substituição ou consulte as etapas para confirmar quais foram executadas.