Integrar a revisão humana em tarefas da API

Encaminhe traduções para revisores, acompanhe as suas decisões e recolha os documentos finais.

Adicione uma revisão humana quando uma tradução precisar da apreciação de uma pessoa antes da entrega. O motor encaminha cada documento e idioma de destino para um grupo de decisão; os revisores aprovam ou editam as unidades elegíveis e o fluxo de processamento prossegue até gerar um ficheiro para descarregar.

Comece com uma tradução através da API já a funcionar. Também precisa de um plano com as funcionalidades de revisão humana, de um grupo de decisão e de um revisor com acesso às traduções do motor.

Configurar a revisão antes de iniciar #

Abra o separador Fluxo de processamento do motor e ative a Revisão humana. Selecione um grupo de decisão, os idiomas e, se aplicável, os diretórios abrangidos. O encaminhamento por diretório baseia-se no key que envia para cada documento, por isso use caminhos estáveis, como emails/order-confirmation.json.

Para rever todo o conteúdo recém-traduzido abrangido pelo encaminhamento, escolha Tudo, que mantém o controlo de qualidade desativado. Para uma revisão seletiva, escolha Rigoroso, Médio ou Flexível. O controlo apresenta os erros com os respetivos níveis de gravidade e categorias; o nível escolhido determina que níveis de gravidade exigem revisão. As traduções que o controlo não consiga verificar também são enviadas para revisão. Consulte as descrições em níveis de controlo de qualidade. As traduções reutilizadas servem de contexto só de leitura e não dão automaticamente origem a novo trabalho de revisão.

Escolha um tempo limite adequado à equipa de revisão. O prazo começa quando o destino está pronto. Depois de terminar, as unidades sem resposta podem prosseguir com as traduções anteriores. Se todas as traduções publicadas exigirem uma decisão humana, a verificação de publicação da sua aplicação tem de garantir o cumprimento desse requisito.

Configure o fluxo de processamento através da API quando a configuração do motor fizer parte da sua aplicação.

Enviar o conteúdo #

Crie a tarefa, carregue os artefactos em falta e faça a chamada a /start. Guarde o ID da tarefa juntamente com a versão do conteúdo de origem e a política de revisão pretendida. A configuração do fluxo de processamento do motor fica registada no início; as alterações posteriores não modificam a política de revisão da tarefa em execução.

Consulte os IDs dos documentos e os idiomas de destino da tarefa. No progresso das etapas do destino, humanEdit identifica o trabalho de revisão, enquanto a API de revisão fornece as unidades e as decisões em si. Uma tarefa pode manter o estado Running enquanto os revisores trabalham.

Dar ao revisor o contexto necessário #

Os revisores podem aceder a Fila → Tipo → Revisão humana no painel, onde os resultados do controlo de qualidade aparecem junto da tradução. Podem aprovar sem alterações ou editar as traduções antes de as submeter. Mantenha o conteúdo de origem, o idioma de destino, os marcadores de posição e a terminologia pretendida visíveis para o revisor.

Se a aplicação tiver uma interface de revisão própria, liste as revisões em aberto com GET /v2/organizations/:orgId/localization/reviews e obtenha depois a revisão do documento e idioma selecionados. Autentique as decisões em nome do revisor com uma chave pessoal ou uma sessão de utilizador, e não com a chave da organização utilizada pelo serviço em segundo plano.

Submeta decisões Approved ou Edited para as unidades obrigatórias. As revisões internas permitem submissões parciais. Para assumir uma revisão externa, é necessário submeter, de uma só vez, uma decisão para cada uma das unidades obrigatórias restantes, e o fornecedor poderá ainda cobrar o serviço. A Referência de revisão detalha os formatos exatos dos dados a enviar e os erros.

Recolher e validar o resultado final #

Depois de o revisor submeter as decisões, continue a consultar a tarefa de localização. Descarregue o destino apenas quando o respetivo estado for Completed. A conclusão da revisão e a conclusão do ficheiro são momentos distintos, pois a pós-edição, o ajuste do comprimento ou a retrotradução podem ainda estar em curso.

Se precisar de manter exatamente o texto aprovado por uma pessoa, desative as etapas posteriores de reescrita e verifique o resultado final. Se precisar de comprovar a aprovação, verifique as decisões de revisão e as unidades cujo prazo expirou, em vez de considerar uma etapa concluída como prova de que uma pessoa aprovou todas as unidades.

Publique apenas se a versão do conteúdo de origem ainda corresponder e a política de revisão exigida tiver sido cumprida. Uma tradução que chegue com atraso não pode substituir o resultado de uma versão mais recente do conteúdo de origem.

Retomar após interrupções #

Conserve os identificadores originais da tarefa e da revisão se o tempo limite do cliente expirar. Uma nova tarefa inicia um processo separado de tradução e revisão. Se a resposta a uma decisão se perder, obtenha a revisão e verifique as decisões guardadas e os IDs dos revisores. O mesmo revisor pode repetir uma decisão idêntica enquanto o destino ainda aceitar submissões, mas um destino concluído pode devolver 409 mesmo que a primeira submissão tenha sido bem-sucedida. As decisões submetidas com sucesso são definitivas.

Quando o prazo de revisão terminar, verifique as decisões aceites, as unidades sem resposta e o ficheiro resultante. Preserve o trabalho concluído e escolha de forma consciente a ação seguinte: suspender a publicação, obter outra revisão ou aceitar uma alternativa explicitamente definida.