Configurar o pipeline de tradução

Guarde as etapas do motor antes de iniciar uma tarefa e consulte as etapas que são efetivamente executadas.

Uma tarefa de localização utiliza a configuração do pipeline do motor registada no momento em que é iniciada. Configure o motor antes de chamar /start. As alterações posteriores ao motor aplicam-se às tarefas iniciadas daí em diante, não à configuração registada de uma tarefa já em execução.

No Studio, abra o separador Fluxo de processamento do motor ou atualize pipelineConfig através de PATCH /v2/engines/:id. O autor da chamada tem de ter permissão para editar o motor. A organização tem de ter acesso às funcionalidades necessárias para as etapas que podem ser executadas. Consulte acesso às funcionalidades e preços.

Guardar uma configuração completa #

Consulte o motor 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 respetivos valores predefinidos. Mantenha as definições que pretende conservar.

Este pedido configura a tradução com uma etapa de reformulação. As etapas opcionais omitidas ficam desativadas:

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

Utilize um motor separado quando uma aplicação precisar de uma política diferente para uma categoria de tarefas. Configure os respetivos modelos e orientações e, em seguida, selecione o ID desse motor ao criar essas tarefas.

Definições das etapas #

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

A pós-edição requer revisão humana. A pós-edição é aplicada ao resultado da revisão humana; se esta for ignorada ou o prazo expirar, pode não haver um resultado de revisão humana para aperfeiçoar.

Os modos de comprimento do conteúdo são { "_tag": "noLongerThanSource" } (o predefinido), { "_tag": "fixedCap", "maxColumns": 40 } ou { "_tag": "matchSource", "tolerancePct": 10 }. Os valores numéricos têm de ser inteiros positivos. São valores-alvo em colunas de apresentação, não limites em bytes nem garantias de que o conteúdo cabe na interface.

Encaminhar a revisão humana #

Comece por criar ou selecionar os grupos de decisão. Cada entrada de humanEdit.routes indica um grupo e os idiomas e diretórios que abrange. 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 nesse diretório; a correspondência é feita com o key do documento. Os caminhos indicam diretórios literais seguidos de /**. Uma rota sem path aplica-se a todos os diretórios. As correspondências mais específicas de diretório e idioma têm prioridade; as rotas em conflito são rejeitadas.

Para escolher as traduções a rever, ative a revisão humana e adicione uma rota que abranja essas traduções. Adicione qualityGate dentro de pipelineConfig e mantenha as restantes definições:

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

Pode guardar um qualityGate ativado enquanto humanEdit.enabled está definido como false. O Studio mantém essa definição quando desativa e volta a ativar a revisão humana. Se utilizar a API, inclua qualityGate em cada pipelineConfig de substituição para manter a definição. O controlo só é executado se a revisão humana estiver ativada no fluxo de processamento determinado para a tarefa.

O controlo guarda as ocorrências detetadas em cada unidade. "strict" exige revisão para qualquer ocorrência, "medium" para ocorrências graves ou críticas e "lax" apenas para ocorrências críticas. Uma tradução que o controlo não tenha conseguido verificar continua a exigir revisão. Defina qualityGate.enabled como false para selecionar Tudo, enviando assim para revisão todas as novas traduções abrangidas por uma rota. As traduções reutilizadas não geram novo trabalho de revisão.

A avaliação não depende do nível de exigência; esse nível é aplicado às ocorrências detetadas. Alterar o nível de um motor afeta as tarefas iniciadas daí em diante, não a configuração registada de uma tarefa já em execução. Consulte níveis do controlo de qualidade para ver as descrições e as definições de gravidade.

A antiga API de Localização Assíncrona continua a aceitar humanEdit.qualityThreshold, mas ignora-o. Todas as traduções num idioma selecionado para revisão humana são enviadas para um revisor. Para rever seletivamente no pipeline atual, defina o Nível de revisão nas definições de Revisão humana do motor.

A disponibilidade da revisão depende do plano da organização e da ligação do grupo ao fornecedor. Quando a tarefa é iniciada, as funcionalidades das etapas que não estejam disponíveis são desativadas, juntamente com as etapas que delas dependem. Consulte as etapas de destino da tarefa 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 descarregado.

Inspecionar o resultado #

A etapa de controlo de qualidade guarda este resultado 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 é uma citação literal da tradução avaliada pelo controlo. 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 controlo não encontrou erros. As unidades de revisão devolvem este resultado como quality; consulte revisão humana. Os revisores veem as ocorrências detetadas junto da tradução na Fila.

Progresso das etapas distingue o trabalho concluído, ignorado, falhado e com avisos. Revisão humana descreve as decisões e os prazos. O guia do pipeline explica por que motivo cada etapa pode ser útil e como as etapas posteriores podem alterar o texto produzido nas anteriores.