Configure o fluxo de tradução

Salve as etapas do engine antes de iniciar um trabalho e confira quais são realmente executadas.

Um trabalho de localização usa a configuração do fluxo do engine registrada no momento em que é iniciado. Configure o engine antes de chamar /start. Alterações posteriores no engine afetam apenas os próximos trabalhos, não a configuração registrada de um trabalho já em execução.

Abra a aba Pipeline do engine no Studio ou atualize pipelineConfig por meio de PATCH /v2/engines/:id. Quem faz a chamada precisa ter permissão para editar o engine. A organização precisa ter acesso aos recursos exigidos pelas etapas que podem ser executadas. Consulte acesso a recursos e preços.

Salve uma configuração completa #

Consulte o engine com GET /v2/engines/:id antes de alterar uma configuração existente. O envio de pipelineConfig substitui essa configuração; as etapas omitidas assumem os valores padrão. Preserve as configurações que deseja manter.

Esta solicitação configura a tradução com uma etapa de reformulação. As etapas opcionais omitidas ficam desabilitadas:

http
PATCH /v2/engines/:id
Content-Type: application/json
X-API-Key: YOUR_API_KEY
json
{
  "pipelineConfig": {
    "localize": { "enabled": true },
    "rephrase": { "enabled": true }
  }
}

Use um engine separado quando uma aplicação precisar de uma política diferente para uma categoria de trabalhos. Configure os modelos e as orientações desse engine e selecione o ID dele ao criar esses trabalhos.

Configurações das etapas #

Campo em pipelineConfigConfigurações
localizeenabled: true. A tradução é obrigatória.
preEdit, rephrase, postEdit, backTranslationenabled booleano. O valor padrão é falso.
qualityGateenabled do tipo booleano e strictness: "strict", "medium" ou "lax" (padrão: "medium").
humanEditenabled, timeoutHours como inteiro positivo (padrão 48) e routes de revisão.
contentLengthenabled e um mode descrito abaixo.

A pós-edição exige revisão humana. Essa etapa é executada sobre o resultado da revisão humana; se a revisão for ignorada ou o prazo expirar, pode não haver um resultado humano para refinar.

Os modos de comprimento do conteúdo são { "_tag": "noLongerThanSource" } (o padrão), { "_tag": "fixedCap", "maxColumns": 40 } ou { "_tag": "matchSource", "tolerancePct": 10 }. Os valores numéricos devem ser inteiros positivos. São metas de largura em colunas de exibição, não limites em bytes nem garantias de que o texto caberá na interface.

Direcione a revisão humana #

Primeiro, crie ou selecione grupos de decisão. Cada entrada de humanEdit.routes indica um grupo e seu escopo de idiomas e diretórios. Esta configuração envia todo o conteúdo recém-traduzido para um único grupo:

json
{
  "pipelineConfig": {
    "localize": { "enabled": true },
    "humanEdit": {
      "enabled": true,
      "timeoutHours": 48,
      "routes": [
        {
          "pool": "YOUR_DECISION_POOL_ID",
          "match": { "locales": [] }
        }
      ]
    }
  }
}

Um array locales vazio abrange todos os idiomas. Adicione "path": ["emails/**"] dentro de match para abranger os documentos desse diretório; a correspondência é feita com o key do documento. Os caminhos indicam diretórios literais seguidos de /**. Uma rota sem path se aplica a todos os diretórios. Correspondências mais específicas de diretório e idioma têm precedência; rotas conflitantes são rejeitadas.

Para revisar apenas algumas traduções, ative a revisão humana e adicione uma rota que abranja as traduções que você quer revisar. Adicione qualityGate dentro de pipelineConfig e mantenha as demais configurações:

json
{
  "qualityGate": { "enabled": true, "strictness": "medium" }
}

Você pode salvar um qualityGate ativado enquanto humanEdit.enabled estiver false. O Studio preserva a configuração salva quando você desativa e reativa a revisão humana. Ao usar a API, inclua qualityGate em cada pipelineConfig de substituição para preservar essa configuração. A etapa de aprovação só é executada se a revisão humana estiver ativada no pipeline resolvido da tarefa.

O controle armazena os problemas encontrados em cada unidade. "strict" exige revisão para qualquer problema, "medium" para problemas graves ou críticos e "lax" apenas para problemas críticos. Uma tradução que o controle não conseguiu verificar também exige revisão. Defina qualityGate.enabled como false para selecionar Tudo, enviando para revisão toda nova tradução abrangida por uma rota. Traduções reutilizadas não geram novas tarefas de revisão.

A avaliação não depende do rigor; o nível é aplicado aos problemas encontrados. Alterar o nível de um engine afeta apenas os próximos trabalhos, não a configuração registrada de um trabalho já em execução. Consulte níveis do controle de qualidade para ver as descrições e as definições de gravidade.

A API legada de localização assíncrona ainda aceita humanEdit.qualityThreshold, mas ignora esse parâmetro. Toda tradução em um idioma selecionado para revisão humana é enviada a um revisor. Para revisar de forma seletiva no fluxo atual, defina o Nível de revisão nas configurações de Revisão humana do engine.

A disponibilidade da revisão depende do plano da organização e da conexão do grupo com o provedor. Quando o trabalho é iniciado, os recursos indisponíveis das etapas são desativados, assim como as etapas que dependem deles. Consulte as etapas de destino do trabalho para confirmar o workflow efetivo. Se a publicação exigir uma decisão humana, garanta o cumprimento dessa política antes de entregar o resultado baixado.

Inspecione o resultado #

A etapa de controle de qualidade armazena esta saída para cada unidade verificada:

json
{
  "findings": [
    {
      "span": "Pay €20",
      "reason": "The translation changes the source amount from €10 to €20.",
      "category": "accuracy",
      "severity": "critical"
    }
  ]
}

span reproduz exatamente o trecho da tradução avaliada pelo controle. reason é uma frase em inglês. As categorias são accuracy, terminology, guidance, fluency e style; os níveis de gravidade são critical, major e minor. Um array findings vazio significa que o controle não encontrou erros. As unidades de revisão retornam essa saída como quality; consulte revisão humana. Os revisores veem os problemas encontrados ao lado da tradução na Fila.

Progresso das etapas diferencia tarefas concluídas, ignoradas, com falha e com avisos. Revisão humana descreve decisões e prazos. O guia do fluxo de tradução explica por que cada etapa pode ser útil e como as etapas posteriores podem alterar o texto das anteriores.