Integre a revisão humana às tarefas da API
Encaminhe traduções para revisores, acompanhe suas decisões e obtenha os documentos finais.
Adicione a revisão humana quando uma tradução precisar do julgamento de uma pessoa antes da entrega. O engine encaminha cada documento e idioma de destino a um grupo de decisão; os revisores aprovam ou editam as unidades elegíveis, e o pipeline segue até disponibilizar um arquivo para download.
Comece com uma tradução via API já funcionando. Você também precisa dos recursos de revisão humana disponíveis no plano, de um grupo de decisão e de um revisor com acesso às traduções do engine.
Configure a revisão antes de começar #
Abra a aba Pipeline do engine e ative Revisão humana. Selecione um grupo de decisão, os idiomas e, se necessário, um escopo de diretórios. O roteamento por diretório faz a correspondência com o key que você envia para cada documento, então use caminhos estáveis, como emails/order-confirmation.json.
Para revisar todo o conteúdo recém-traduzido na rota, escolha Tudo, que mantém o controle de qualidade desativado. Para uma revisão seletiva, escolha Rigoroso, Médio ou Flexível. O controle lista os erros com suas gravidades e categorias; o nível escolhido determina quais gravidades exigem revisão. Traduções que o controle não conseguir verificar também são encaminhadas para revisão. Consulte as descrições em níveis do controle de qualidade. As traduções reutilizadas servem como contexto somente para leitura e não geram automaticamente novas tarefas de revisão.
Escolha um tempo limite adequado à equipe de revisão. O prazo começa quando o destino está pronto. Depois que ele expira, as unidades sem resposta podem seguir com as traduções anteriores. Se toda tradução publicada precisar de uma decisão humana, a verificação de publicação do seu aplicativo deverá garantir o cumprimento desse requisito.
Configure o pipeline pela API quando a configuração do engine fizer parte do seu aplicativo.
Envie o conteúdo #
Crie a tarefa, envie os artefatos ausentes e chame /start. Salve o ID da tarefa junto com a versão do conteúdo de origem e a política de revisão pretendida. A configuração do pipeline do engine é registrada no início; 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. humanEdit no progresso das etapas do destino identifica o trabalho de revisão, enquanto a API de revisão fornece as unidades e as decisões em si. Uma tarefa pode permanecer em Running enquanto os revisores trabalham.
Forneça o contexto necessário ao revisor #
Os revisores podem acessar Fila → Tipo → Revisão humana no painel, onde os problemas identificados pelo controle de qualidade aparecem ao lado da tradução. Eles podem aprovar sem alterações ou editar as traduções antes de enviá-las. Mantenha o conteúdo de origem, o idioma de destino, os placeholders e a terminologia pretendida visíveis para o revisor.
Para usar uma interface de revisão do próprio aplicativo, liste as revisões abertas com GET /v2/organizations/:orgId/localization/reviews e, em seguida, obtenha a revisão do documento e idioma selecionados. Autentique as decisões como o revisor, usando uma chave pessoal ou uma sessão de usuário, e não a chave da organização usada pelo serviço em segundo plano.
Envie decisões Approved ou Edited para as unidades obrigatórias. As revisões internas permitem envios parciais. Assumir uma revisão externa exige enviar, de uma só vez, uma decisão para cada unidade obrigatória restante e ainda pode gerar cobrança pelo provedor. A Referência de revisão detalha os payloads e os erros exatos.
Obtenha e valide o resultado final #
Após o envio pelo revisor, continue consultando a tarefa de localização. Baixe o arquivo de destino somente quando seu estado for Completed. A revisão e o arquivo são concluídos separadamente, pois a pós-edição, o ajuste de comprimento ou a retrotradução ainda podem estar em execução.
Se você precisar do texto exato aprovado por uma pessoa, desative as etapas posteriores de reescrita e inspecione o resultado final. Se precisar 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 somente se a versão do conteúdo de origem ainda for a mesma e a política de revisão exigida tiver sido cumprida. Uma tradução atrasada não deve substituir o resultado de uma versão mais recente do conteúdo de origem.
Retome o processo após interrupções #
Preserve os identificadores originais da tarefa e da revisão quando 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, consulte a revisão e verifique as decisões salvas e os IDs dos revisores. O mesmo revisor pode repetir uma decisão idêntica enquanto o destino ainda aceitar envios, mas um destino concluído pode retornar 409 mesmo que o primeiro envio tenha sido bem-sucedido. As decisões registradas com sucesso são definitivas.
Quando o prazo de revisão terminar, inspecione as decisões aceitas, as unidades sem resposta e o arquivo resultante. Preserve o trabalho concluído e escolha de forma consciente a próxima ação: suspender a publicação, obter outra revisão ou aceitar uma alternativa explicitamente definida.