Integra la revisión humana en las tareas de la API
Envía las traducciones a los evaluadores, da seguimiento a sus decisiones y recopila los documentos finales.
Agrega la revisión humana cuando una traducción necesite el criterio de una persona antes de entregarse. El motor envía cada documento e idioma de destino a un grupo de decisión; los evaluadores aprueban o editan las unidades que cumplen los requisitos y luego el flujo de procesamiento continúa hasta generar un archivo descargable.
Comienza con una traducción mediante la API que ya funcione. También necesitas un plan con las funciones de revisión humana, un grupo de decisión y un evaluador con acceso a las traducciones del motor.
Configura la revisión antes de iniciar #
Abre la pestaña Flujo de procesamiento del motor y activa Revisión humana. Selecciona un grupo de decisión, los idiomas y el alcance por directorio, si corresponde. El enrutamiento por directorio se basa en el key que envías para cada documento, así que usa rutas estables como emails/order-confirmation.json.
Para revisar todo el contenido recién traducido que sigue esa ruta, elige Todo; esta opción mantiene desactivado el filtro de calidad. Para revisar de forma selectiva, elige Estricto, Medio o Flexible. El filtro muestra los errores con sus niveles de gravedad y categorías; el nivel seleccionado determina qué niveles de gravedad requieren revisión. Si el filtro no puede comprobar una traducción, esta también se envía a revisión. Consulta las descripciones en niveles del filtro de calidad. Las traducciones reutilizadas sirven como contexto de solo lectura y no generan automáticamente nuevas tareas de revisión.
Elige un tiempo de espera adecuado para el equipo de revisión. El plazo comienza cuando el destino está listo y, una vez vencido, las unidades sin respuesta pueden continuar con sus traducciones anteriores. Si todas las traducciones publicadas deben contar con una decisión humana, la verificación previa a la publicación de tu aplicación debe garantizar que se cumpla ese requisito.
Configura el flujo de procesamiento mediante la API cuando la configuración del motor forme parte de tu aplicación.
Envía el contenido #
Crea la tarea, carga los artefactos faltantes y llama a /start. Guarda el ID de la tarea junto con la versión del contenido de origen y la política de revisión prevista. La configuración del flujo de procesamiento del motor se registra al iniciar la tarea; los cambios posteriores no modifican la política de revisión de la tarea en curso.
Consulta los ID de los documentos y los idiomas de destino de la tarea. humanEdit en el progreso de las etapas del destino identifica el trabajo de revisión, mientras que la API de revisión proporciona las unidades y las decisiones concretas. Una tarea puede permanecer en Running mientras los evaluadores trabajan.
Dale al evaluador el contexto necesario #
Los evaluadores pueden usar Cola → Tipo → Revisión humana en el panel, donde los hallazgos del filtro de calidad aparecen junto a la traducción. Pueden aprobar las traducciones sin cambios o editarlas antes de enviarlas. Mantén visibles para el evaluador el contenido de origen, el idioma de destino, los marcadores de posición y la terminología prevista.
Si tu aplicación tiene su propia interfaz de revisión, obtén la lista de revisiones abiertas con GET /v2/organizations/:orgId/localization/reviews y luego recupera la revisión del documento y el idioma seleccionados. Autentica las decisiones con la identidad del evaluador mediante una clave personal o una sesión de usuario, no con la clave de organización del servicio en segundo plano.
Envía decisiones de Approved o Edited para las unidades requeridas. Las revisiones internas permiten envíos parciales. Asumir una revisión externa requiere enviar de una sola vez una decisión para cada unidad requerida que siga pendiente y puede generar un cargo del proveedor de todos modos. La Referencia de revisión detalla las estructuras exactas de los datos de envío y los errores.
Recopila y valida el resultado final #
Después de que un evaluador envíe sus decisiones, sigue consultando la tarea de localización. Descarga el destino solo cuando su estado sea Completed. La revisión y el archivo se completan por separado, ya que aún pueden ejecutarse la posedición, el ajuste de longitud o la traducción inversa.
Si necesitas conservar la redacción exacta que aprobó una persona, desactiva las etapas posteriores de reescritura y verifica el resultado final. Si necesitas una prueba de aprobación, comprueba las decisiones de revisión y las unidades cuyo plazo venció, en lugar de tomar una etapa completada como evidencia de que una persona aprobó todas las unidades.
Publica solo si la versión del contenido de origen sigue coincidiendo y se cumplió la política de revisión requerida. Una traducción que llegue tarde no debe reemplazar el resultado de una versión más reciente del contenido de origen.
Retoma el proceso tras una interrupción #
Conserva los identificadores originales de la tarea y de la revisión después de que se agote el tiempo de espera del cliente. Una tarea nueva inicia un proceso independiente de traducción y revisión. Si se pierde la respuesta a una decisión, recupera la revisión y comprueba las decisiones guardadas y los ID de los evaluadores. El mismo evaluador puede repetir una decisión idéntica mientras el destino siga aceptando envíos, pero un destino completado puede devolver 409 incluso si el primer envío se realizó correctamente. Las decisiones enviadas correctamente son definitivas.
Al vencer el plazo de una revisión, verifica las decisiones aceptadas, las unidades sin respuesta y el archivo resultante. Conserva el trabajo completado y decide cómo continuar: suspender la publicación, solicitar otra revisión o aceptar una alternativa definida explícitamente.