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:
PATCH /v2/engines/:id
Content-Type: application/json
X-API-Key: YOUR_API_KEY{
"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 pipelineConfig | Definições |
|---|---|
localize | enabled: true. A tradução é obrigatória. |
preEdit, rephrase, postEdit, backTranslation | enabled booleano. O valor predefinido é false. |
qualityGate | enabled de tipo booleano e strictness: "strict", "medium" ou "lax" (valor predefinido: "medium"). |
humanEdit | enabled, timeoutHours como inteiro positivo (valor predefinido: 48) e routes de revisão. |
contentLength | enabled 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:
{
"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:
{
"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:
{
"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.