Revisión humana
La mayor parte de tu contenido puede publicarse en cuanto lo devuelve el motor. Pero no todo. Una divulgación regulada, una instrucción médica, un titular que lleva el peso de la marca: en esos casos, quieres que una persona lea la traducción y la apruebe antes de que salga en producción, 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: mantener la solicitud abierta mientras alguien lee, crear tu propia cola de revisión o conectar a mano la API de un proveedor de traducción. Esta etapa lo resuelve dentro del trabajo. Cuando humanEdit está habilitado, el trabajo asíncrono ejecuta el motor y luego se pausa en una persona —tu propio equipo o un profesional externo— para reanudarse con su edición y arrastrar ese resultado a cualquier etapa posterior.
Se ejecuta después de Rephrase y antes de Post-edit en el pipeline de localización y, como cualquier etapa, solo se aplica a los trabajos creados mediante la API de localización asíncrona. ¿Es tu primera vez con el pipeline? 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
- Cómo habilitar la etapa
Cómo funciona la pausa#
Después del paso principal de traducción —y también después de Rephrase, si esa etapa está activada—, el trabajo pone la traducción de IA en manos de 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 el trabajo continúa. 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 obvia a pausar un trabajo durante minutos, horas o un día es el costo: una solicitud abierta consume recursos aunque no esté pasando nada. Esta etapa no funciona así.
La espera funciona por eventos, no con una conexión abierta
El flujo de trabajo se reanuda con un evento: un revisor que envía desde el panel (Revisión interna) o una devolución de llamada del proveedor de traducción (Revisión externa). No hace polling en un bucle cerrado ni mantiene una conexión abierta, así que un tiempo de espera largo no consume cómputo en segundo plano. Un trabajo puede esperar 48 horas por una persona igual que espera a un modelo: queda estacionado, no girando en vacío.
Hay dos modos de revisión disponibles, que se eligen por motor. La única diferencia es quién hace la lectura: la pausa, la reanudación y el arrastre del resultado funcionan exactamente igual.
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 nuevos elementos. Una persona revisora abre un elemento, edita las claves que haga falta y luego hace clic en Aprobar tal cual o, cuando ya editó 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 mismo grupo que cualquier persona revisora puede ver y decidir.
La revisión interna está disponible con el plan Enterprise. En un plan que la incluye, un motor nuevo empieza con revisión interna; en uno que no, empieza con revisión externa, y la opción Revisión interna muestra una etiqueta de Enterprise. Elígela cuando tu equipo tenga la experiencia lingüística dentro de la empresa y quieras control total sobre la redacción final, sin terceros de por medio.
Permisos#
La revisión interna no está abierta a todas las personas de la organización: la cola de revisión está restringida por permisos, por lo que una traducción en revisión solo es visible para las personas a las que les otorgues acceso. Una persona administradora de la organización asigna ese acceso mediante roles (Settings → Roles):
| Permiso | Qué habilita |
|---|---|
Revisar traducciones (engine:review_translations) | Ver elementos de Revisión humana en La Cola, editarlos y aprobarlos tal cual o con ediciones |
Administrar revisiones (org:manage_reviews) | Historial y estadísticas de las revisiones internas. Sin esto, las revisiones resueltas permanecen 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. Administrar revisiones es para quien supervisa la operación; agrega el historial de revisiones de toda la organización, pero no incluye acceso a la cola por sí solo. Otorga ambos a una persona líder que revisa y reporta; otorga solo el primero a alguien que solo trabaja en la cola.
Revisión externa#
Cuando no tienes revisores internos para un idioma, la traducción se envía a un traductor profesional calificado a través de un proveedor externo. El trabajo se pausa de la misma manera y se reanuda cuando el proveedor devuelve la traducción editada. No cambia nada en tu código: la diferencia es quién lee la cadena, no cómo se comporta el trabajo.
No hay ningún nivel para elegir: el marketplace califica al traductor en sí. La revisión externa se factura por palabra.
Una revisión externa también aparece en La Cola; al abrirla, figura un Traductor calificado como persona revisora. Alguien con Revisar traducciones puede abrirla y tomar el control: elige Aprobar tal cual o Aprobar con ediciones, y el trabajo termina ahí en lugar de esperar al traductor. La confirmación de Tomar el control de esta revisión muestra el costo antes de que confirmes: tomar el control es gratis solo mientras ningún traductor haya comenzado; una vez que alguien ya empezó, la tarifa del traductor se mantiene uses o no su trabajo.
Conviene decirlo con total claridad: la Revisión externa implica que del otro lado hay un traductor humano real, con los tiempos de entrega y el costo que eso conlleva. No es un modelo más rápido. Úsala cuando el criterio de una persona sea justamente lo importante —texto regulado, copy de alto impacto— y apóyate en la ruta solo con IA para la mayor parte del contenido que no lo necesita.
Umbral de calidad#
No todas las traducciones necesitan intervención humana. Configura el Umbral de calidad (1–100) en la configuración 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 revisar todo. En la configuración, aparece como qualityThreshold en humanEdit.
Una traducción que se entrega de esta manera 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: la persona podría no responder nunca. El revisor está de vacaciones, el proveedor está saturado, el elemento se olvida. Si no se limita, el trabajo esperaría para siempre.
Así, el tiempo de espera queda acotado. Tú defines cuánto tiempo espera el flujo de trabajo el resultado humano: Tiempo de espera, en horas, en la configuración 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 48 horas. En La Cola, una revisión que agotó el tiempo de espera aparece como Cerrada sin decisión.
Vale la pena decir el costo sin rodeos: cuando vence el tiempo de espera, publicas la traducción de IA sin revisión humana. Para la mayoría del contenido, ese es el fallback correcto —más vale una traducción publicada que un trabajo bloqueado indefinidamente—, pero el tradeoff es real. Para contenido en el que una persona debe aprobar sí o sí, configura un tiempo de espera amplio y crea una alerta cuando se omita; para contenido en el que la revisión es deseable pero no esencial, un tiempo de espera corto mantiene el pipeline en movimiento.
El tiempo de espera es por etapa, no por trabajo
El tiempo de espera solo controla cuánto aguarda esta etapa a una persona. Es independiente de cuánto tarde el resto del trabajo. Como la espera funciona por eventos, un tiempo de espera largo solo te cuesta latencia hasta el resultado final si el revisor tarda, nunca cómputo en segundo plano.
Cómo habilitar la etapa#
humanEdit se configura como cualquier etapa del pipeline: con un valor predeterminado a nivel de motor en la pestaña Pipeline del motor, que opcionalmente puedes reemplazar por solicitud. El modelo completo de dos capas está en Configurar el pipeline; la forma específica de esta etapa es:
{
"humanEdit": {
"enabled": true,
"provider": "internal",
"tier": "standard",
"timeoutHours": 48,
"qualityThreshold": 85
}
}provider selecciona el modo: internal para tu propio equipo, 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) corresponde a 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 produce cada etapa. Cómo leer esos registros se explica en Observar ejecuciones del pipeline.
Una edición humana puede desviarse de las reglas de tu motor
Una persona traductora puede redactar algo de una forma que entre en conflicto con tu glossary, tu voz de marca o tus reglas: traduce bien, no memoriza tu configuración. Para volver a alinear automáticamente la edición humana con las reglas de tu motor, habilita 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 produjo un resultado.