Revisión humana
La mayor parte de tu contenido puede publicarse en cuanto el motor lo devuelve. Pero no siempre. Una divulgación regulada, una instrucción médica, un titular que representa a la marca: en esos casos, quieres que una persona lea la traducción y dé el visto bueno antes de que se publique, no después de que un cliente presente una queja.
La forma habitual de meter a una persona en un flujo automatizado suele ser la más dolorosa: dejar la solicitud abierta mientras alguien revisa, montar tu propia cola de revisión o conectar a mano la API de un proveedor de traducción. Esta etapa lo resuelve dentro del propio trabajo. Cuando humanEdit está activado, el trabajo asíncrono ejecuta el motor y luego se pausa para que intervenga una persona —tu equipo o un profesional externo— y se reanuda con su edición, trasladando ese resultado a cualquier etapa posterior.
Se ejecuta después de Rephrase y antes de Post-edit en la canalización de localización y, como cualquier otra etapa, solo se aplica a los trabajos creados mediante la API de localización asíncrona. ¿Es tu primera vez con la canalización? Empieza por la descripción general.
En esta página
- Cómo funciona la pausa
- Revisión interna
- Permisos
- Revisión externa
- Umbral de calidad
- Tiempo de espera
- Activar la etapa
Cómo funciona la pausa#
Después del paso principal de traducción —y, si está activada, después de Rephrase—, el trabajo entrega la traducción de IA a una persona para su revisión. La persona revisora la lee y luego la aprueba tal cual o envía una versión editada. Solo entonces continúa el trabajo. El resultado humano —aprobado o editado— se convierte en la entrada de todas las etapas posteriores y, en última instancia, en el outputData del trabajo.
La objeción evidente a pausar un trabajo durante minutos, horas o incluso un día es el coste: una solicitud abierta sigue consumiendo recursos aunque no esté pasando nada. Esta etapa no funciona así.
La espera se basa en eventos, no en mantener una conexión abierta
El flujo de trabajo se reanuda a partir de un evento: un revisor que envía su revisión desde el panel (Revisión interna) o una devolución de llamada del proveedor de traducción (Revisión externa). No hace sondeo en un bucle continuo ni mantiene una conexión abierta, así que un tiempo de espera largo no consume recursos en segundo plano. Un trabajo puede esperar 48 horas a una persona igual que espera a un modelo: está aparcado, no dando vueltas.
Hay dos modos de revisión disponibles, que se eligen por motor. Solo cambia quién hace la lectura: la pausa, la reanudación y el comportamiento posterior son idénticos.
Revisión interna#
Tu equipo revisa las traducciones directamente en el panel de Lingo.dev. Las revisiones pendientes aparecen en la Cola (/orgs/<org-id>/queue) como elementos de Revisión humana, y las personas revisoras reciben una notificación cuando llegan elementos nuevos. Una persona revisora abre un elemento, edita las claves que lo necesiten y luego hace clic en Aprobar tal cual o, una vez editado algo, en Aprobar con ediciones; el botón las cuenta, como en Aprobar con 2 ediciones. El trabajo se reanuda con ese resultado.
No hay asignación ni bloqueo. Una revisión abierta queda en un único grupo que cualquier persona revisora puede ver y resolver.
La revisión interna está disponible con el plan Enterprise. En un plan que la incluya, un motor nuevo empieza con Revisión interna; en uno que no, empieza con Revisión externa, y la opción Revisión interna lleva una etiqueta Enterprise. Recurre a ella cuando tu equipo tiene la experiencia lingüística dentro de la empresa y quieres un control total sobre la redacción final, sin terceros de por medio.
Permisos#
La revisión interna no está abierta a todo el mundo dentro de la organización: la cola de revisión está restringida por permisos, así que una traducción en revisión solo es visible para las personas a las que des acceso. Una persona administradora de la organización asigna ese acceso mediante roles (Settings → Roles):
| Permiso | Qué permite |
|---|---|
Revisar traducciones (engine:review_translations) | Ver elementos de Revisión humana en la Cola, editarlos y aprobarlos tal cual o con ediciones |
Gestionar revisiones (org:manage_reviews) | Historial y estadísticas de revisión de las revisiones internas. Sin ello, las revisiones resueltas siguen ocultas en la Cola |
Los dos permisos están separados a propósito. Una persona revisora solo necesita Revisar traducciones: ese único permiso cubre todo el trabajo: editar, aprobar tal cual y aprobar con ediciones. Gestionar revisiones es para quien supervisa la operación; añade el historial de revisión de toda la organización, pero no incluye por sí solo acceso a la cola. Concede ambos a una persona responsable que revisa e informa; concede solo el primero a alguien que solo gestiona la cola.
Revisión externa#
Cuando no tienes revisores internos para un idioma, la traducción se envía en su lugar a un traductor profesional cualificado a través de un proveedor externo. El trabajo se pausa exactamente igual; se reanuda cuando el proveedor devuelve la traducción editada. En tu código no cambia nada: la diferencia está en quién lee la cadena, no en cómo se comporta el trabajo.
No hay ningún nivel entre el que elegir: el marketplace evalúa al propio traductor. La revisión externa se factura por palabra.
Una revisión externa también aparece en la Cola; al abrirla, muestra a un Traductor cualificado como persona revisora. Cualquier persona con Revisar traducciones puede abrirla y hacerse cargo: elige Aprobar tal cual o Aprobar con ediciones, y el trabajo termina ahí en lugar de esperar al traductor. La confirmación Asumir esta revisión indica el coste antes de que confirmes: asumirla es gratis solo mientras ningún traductor haya empezado; una vez que uno lo ha hecho, se mantiene la tarifa del traductor uses o no su trabajo.
Conviene dejar esto claro: en la Revisión externa hay un traductor humano real al otro lado, con los plazos y el coste que eso implica. No es un modelo más rápido. Úsala cuando lo importante sea precisamente el criterio de una persona —texto regulado, contenido de alto riesgo— y apóyate en la vía solo de IA para la mayor parte del contenido que no lo necesite.
Umbral de calidad#
No todas las traducciones necesitan la intervención de una persona. Configura el Umbral de calidad (1–100) en los ajustes de Revisión humana y un evaluador de IA puntúa cada traducción antes de que pase a revisión. Si alcanza o supera el umbral, la traducción se entrega sin intervención humana y el paso humanEdit se registra como skipped; si queda por debajo, la traducción pasa a revisión como de costumbre. Deja el campo vacío para revisarlo todo. En la configuración es qualityThreshold en humanEdit.
Una traducción que se entrega de esta forma no tiene resultado humano, así que Post-edit no se ejecuta en ella.
Tiempo de espera#
Una etapa humana introduce un riesgo que las etapas de IA no tienen: que la persona nunca responda. El revisor está de vacaciones, el proveedor va con retraso, el elemento se olvida. Si no hubiese límite, el trabajo esperaría para siempre.
Así, la espera tiene un límite. Tú decides cuánto tiempo espera el flujo de trabajo el resultado humano: Tiempo de espera, en horas, en los ajustes de Revisión humana; timeoutHours en la configuración. Se aplica a ambos modos de revisión. Si el tiempo de espera vence sin respuesta, la etapa se marca como skipped y el trabajo continúa con la traducción de IA como resultado final. El valor predeterminado es de 48 horas. En la Cola, una revisión que ha superado el tiempo de espera aparece como Cerrada sin decisión.
Conviene decirlo sin rodeos: si se agota el tiempo, acabarás publicando la traducción de IA sin revisar. Para la mayoría de los contenidos, ese es el fallback correcto —más vale una traducción publicada que un trabajo bloqueado indefinidamente—, pero es una concesión real. Para contenido en el que una persona deba dar el visto bueno sí o sí, configura un tiempo de espera amplio y genera una alerta cuando se omita; para contenido en el que la revisión sea un extra deseable, un tiempo de espera corto mantiene la canalización en marcha.
El tiempo de espera es por etapa, no por trabajo
El tiempo de espera solo determina cuánto tiempo espera esta etapa a una persona. Es independiente de lo que tarde el resto del trabajo. Como la espera se basa en eventos, un tiempo de espera largo solo te cuesta latencia hasta el resultado final si el revisor va lento; nunca recursos en segundo plano.
Activar la etapa#
humanEdit se configura como cualquier otra etapa de la canalización: con un valor predeterminado a nivel de motor en la pestaña Pipeline del motor, que opcionalmente puede sobrescribirse por solicitud. El modelo completo de dos capas se explica en Configurar la canalización; la forma específica de esta etapa es la siguiente:
{
"humanEdit": {
"enabled": true,
"provider": "internal",
"tier": "standard",
"timeoutHours": 48,
"qualityThreshold": 85
}
}provider selecciona el modo: internal para tu equipo y external para un traductor profesional a través del marketplace externo. tier es opcional y solo acepta standard. timeoutHours es el límite de Tiempo de espera, y el valor opcional qualityThreshold (1–100) es el de Umbral de calidad. Para sobrescribirlo en un solo envío, pasa este bloque dentro de pipelineConfig en la llamada de creación; si lo omites, el trabajo hereda la configuración del motor.
Cuando la etapa se ejecuta, queda registrada en el trabajo en stepId: "humanEdit" con un estado de completed, failed o skipped: el mismo registro de paso que genera cada etapa. Cómo leer esos registros se explica en Observar ejecuciones de la canalización.
Una edición humana puede desviarse de las reglas de tu motor
Un traductor humano puede formular algo de una manera que entre en conflicto con tu glosario, voz de marca o reglas: traduce bien, pero no se aprende de memoria tu configuración. Para ajustar automáticamente la edición humana a las reglas de tu motor, activa la siguiente etapa, evaluación de IA, Post-edit en la pestaña Pipeline. Solo se ejecuta después de una etapa humana que realmente haya producido un resultado.