Integra la revisión humana en los trabajos de la API

Envía las traducciones a los revisores, sigue sus decisiones y obtén los documentos finales.

Añade una 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 revisores aprueban o editan las unidades que admiten revisión y, después, el flujo de procesamiento continúa hasta generar un archivo descargable.

Empieza con una traducción mediante la API que ya funcione. También necesitas las funciones del plan que permiten la revisión humana, un grupo de decisión y un revisor con acceso a las traducciones del motor.

Configura la revisión antes de empezar #

Abre la pestaña Flujo de procesamiento del motor y activa Revisión humana. Selecciona un grupo de decisión, los idiomas y, si procede, el ámbito de directorios. El enrutamiento por directorios se basa en el key que envías para cada documento, así que utiliza rutas estables como emails/order-confirmation.json.

Para revisar todo el contenido recién traducido de la ruta, elige Todo; esta opción deja desactivado el control de calidad. Para revisar de forma selectiva, elige Estricto, Medio o Flexible. El control enumera los errores con su gravedad y categoría; el nivel elegido determina qué grados de gravedad requieren revisión. Las traducciones que el control no haya podido comprobar también pasan a revisión. Consulta las descripciones en niveles del control de calidad. Las traducciones reutilizadas aportan contexto de solo lectura y no se convierten automáticamente en nuevas tareas de revisión.

Elige un tiempo de espera adecuado para el equipo de revisión. El plazo empieza cuando el destino está listo y, una vez vencido, las unidades sin respuesta pueden seguir adelante con sus traducciones anteriores. Si todas las traducciones publicadas deben contar con una decisión humana, la comprobació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 el trabajo, sube los artefactos que falten y llama a /start. Guarda el ID del trabajo junto con la versión del texto de origen y la política de revisión prevista. La configuración del flujo de procesamiento del motor queda fijada al iniciar el trabajo; los cambios posteriores no modifican la política de revisión del trabajo en curso.

Consulta los ID de los documentos y los idiomas de destino del trabajo. humanEdit en el progreso de las etapas del destino identifica las tareas de revisión, mientras que la API de revisión proporciona las unidades y decisiones concretas. Un trabajo puede permanecer en Running mientras los revisores trabajan.

Proporciona al revisor el contexto necesario #

Los revisores pueden usar La Cola → Tipo → Revisión humana en el panel, donde los resultados del control de calidad aparecen junto a la traducción. Pueden aprobar las traducciones sin cambios o editarlas antes de enviarlas. Mantén visibles para el revisor el texto de origen, el idioma de destino, los marcadores de posición y la terminología prevista.

Si usas una interfaz de revisión propia de tu aplicación, consulta las revisiones abiertas con GET /v2/organizations/:orgId/localization/reviews y, después, recupera la revisión del documento y el idioma seleccionados. Autentica las decisiones con la identidad del revisor 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 Approved o Edited para las unidades que requieren revisión. Las revisiones internas permiten envíos parciales. Asumir una revisión externa exige enviar de una sola vez una decisión para cada unidad pendiente que requiera revisión y puede suponer que el proveedor cobre igualmente. La Referencia de revisión detalla los datos exactos que deben enviarse y los errores.

Obtén y valida el resultado final #

Después de que un revisor envíe sus decisiones, sigue consultando el trabajo 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 la redacción exacta que aprobó una persona, desactiva las etapas posteriores de reescritura y comprueba el resultado final. Si necesitas una prueba de aprobación, comprueba las decisiones de revisión y las unidades cuyo plazo haya vencido, en lugar de considerar una etapa completada como prueba de que una persona aprobó todas las unidades.

Publica solo cuando la versión del texto de origen siga coincidiendo y se haya cumplido la política de revisión exigida. Una traducción que llegue tarde no debe sustituir el resultado correspondiente a una versión más reciente del texto de origen.

Retoma el proceso tras una interrupción #

Conserva los identificadores originales del trabajo y de la revisión si se agota el tiempo de espera del cliente. Un nuevo trabajo inicia un proceso de traducción y revisión independiente. Si se pierde la respuesta a una decisión, recupera la revisión y comprueba las decisiones guardadas y los ID de los revisores. El mismo revisor puede repetir una decisión idéntica mientras el destino siga aceptando envíos, pero un destino completado puede devolver 409 aunque el primer envío se haya realizado correctamente. Las decisiones enviadas correctamente son definitivas.

Al vencer el plazo de revisión, comprueba las decisiones aceptadas, las unidades sin respuesta y el archivo resultante. Conserva el trabajo completado y decide expresamente el siguiente paso: dejar la publicación en espera, obtener otra revisión o aceptar una alternativa definida explícitamente.