Configura el flujo de procesamiento de traducción
Guarda las etapas del motor antes de iniciar un trabajo y consulta cuáles se ejecutan realmente.
Cada trabajo de localización usa la configuración del flujo de procesamiento del motor registrada al iniciarlo. Configura el motor antes de llamar a /start. Los cambios posteriores en el motor se aplican a los trabajos que se inicien después, no a la configuración registrada de un trabajo que ya está en ejecución.
Abre la pestaña Flujo de procesamiento del motor en Studio o actualiza pipelineConfig mediante PATCH /v2/engines/:id. Quien realiza la llamada necesita permiso para editar el motor. La organización necesita acceso a las funciones que requieren las etapas que pueden ejecutarse. Consulta acceso a las funciones y precios.
Guarda una configuración completa #
Consulta el motor con GET /v2/engines/:id antes de modificar una configuración existente. Al enviar pipelineConfig, se reemplaza esa configuración; las etapas omitidas toman sus valores predeterminados. Conserva los ajustes que quieras mantener.
Esta solicitud configura la traducción con una pasada de reformulación. Las etapas opcionales que no se incluyen quedan deshabilitadas:
PATCH /v2/engines/:id
Content-Type: application/json
X-API-Key: YOUR_API_KEY{
"pipelineConfig": {
"localize": { "enabled": true },
"rephrase": { "enabled": true }
}
}Usa un motor independiente cuando una aplicación necesite una política distinta para un tipo de trabajo. Configura sus modelos y pautas, y luego selecciona su ID al crear esos trabajos.
Configuración de las etapas #
Campo en pipelineConfig | Configuración |
|---|---|
localize | enabled: true. La traducción es obligatoria. |
preEdit, rephrase, postEdit, backTranslation | enabled de tipo booleano. Valor predeterminado: falso. |
qualityGate | enabled booleano y strictness: "strict", "medium" o "lax" (valor predeterminado: "medium"). |
humanEdit | enabled, timeoutHours como entero positivo (valor predeterminado: 48) y routes de revisión. |
contentLength | enabled y un mode descrito a continuación. |
La posedición requiere revisión humana. Una pasada de posedición trabaja sobre el resultado de esa revisión; si se omite la revisión o vence el plazo, puede no haber un resultado humano que mejorar.
Los modos de longitud del contenido son { "_tag": "noLongerThanSource" } (el predeterminado), { "_tag": "fixedCap", "maxColumns": 40 } o { "_tag": "matchSource", "tolerancePct": 10 }. Los valores numéricos deben ser enteros positivos. Son objetivos de longitud en columnas de visualización, no límites de bytes ni garantías de que el contenido quepa en la interfaz.
Dirige la revisión humana #
Primero crea o selecciona grupos de decisión. Cada entrada de humanEdit.routes especifica un grupo y su alcance por idioma y directorio. Esta configuración envía todo el contenido recién traducido a un solo grupo:
{
"pipelineConfig": {
"localize": { "enabled": true },
"humanEdit": {
"enabled": true,
"timeoutHours": 48,
"routes": [
{
"pool": "YOUR_DECISION_POOL_ID",
"match": { "locales": [] }
}
]
}
}
}Un arreglo locales vacío abarca todos los idiomas. Agrega "path": ["emails/**"] dentro de match para abarcar los documentos de ese directorio; se compara con el key del documento. Las rutas especifican directorios literales seguidos de /**. Una regla de enrutamiento sin path se aplica a todos los directorios. Las coincidencias más específicas de directorio e idioma tienen prioridad; las reglas de enrutamiento que entran en conflicto se rechazan.
Para revisar solo ciertas traducciones, habilita la revisión humana y agrega una ruta que abarque las traducciones que quieres revisar. Agrega qualityGate dentro de pipelineConfig y conserva las demás opciones de configuración:
{
"qualityGate": { "enabled": true, "strictness": "medium" }
}Puedes guardar un qualityGate habilitado mientras humanEdit.enabled esté en false. Studio conserva la configuración guardada cuando desactivas la revisión humana y luego vuelves a activarla. Si usas la API, incluye qualityGate en cada pipelineConfig de reemplazo para conservarla. El control solo se ejecuta si la revisión humana está habilitada en el flujo de procesamiento resuelto para el trabajo.
El control guarda los hallazgos de cada unidad. "strict" exige revisión ante cualquier hallazgo, "medium" ante hallazgos graves o críticos y "lax" solo ante hallazgos críticos. Una traducción que el control no pudo comprobar también requiere revisión. Establece qualityGate.enabled en false para seleccionar Todo, que envía a revisión cada traducción nueva cubierta por una regla de enrutamiento. Las traducciones reutilizadas no generan nuevas tareas de revisión.
La evaluación no depende del nivel de exigencia; el nivel se aplica a los hallazgos. Cambiar el nivel de un motor afecta a los trabajos que se inicien después, no a la configuración registrada de un trabajo que ya está en ejecución. Consulta niveles del control de calidad para ver las descripciones y las definiciones de gravedad.
La API de localización asíncrona heredada todavía acepta humanEdit.qualityThreshold, pero lo ignora. Cada traducción en un idioma seleccionado para revisión humana se envía a una persona revisora. Para revisar de forma selectiva en el flujo de procesamiento actual, configura el Nivel de revisión en los ajustes de Revisión humana del motor.
La disponibilidad de la revisión depende del plan de la organización y de la conexión del grupo con su proveedor. Al iniciar el trabajo, se desactivan las funciones de las etapas que no estén disponibles, junto con las etapas que dependen de ellas. Consulta las etapas de destino del trabajo para confirmar el flujo de trabajo que se ejecutará. Si la publicación requiere una decisión humana, asegúrate de cumplir esa política antes de entregar el resultado descargado.
Inspecciona el resultado #
La etapa de control de calidad guarda este resultado para cada unidad comprobada:
{
"findings": [
{
"span": "Pay €20",
"reason": "The translation changes the source amount from €10 to €20.",
"category": "accuracy",
"severity": "critical"
}
]
}span es una cita textual de la traducción que evaluó el control. reason es una oración en inglés. Las categorías son accuracy, terminology, guidance, fluency y style; los niveles de gravedad son critical, major y minor. Un arreglo findings vacío indica que el control no encontró errores. Las unidades de revisión devuelven este resultado como quality; consulta revisión humana. Las personas revisoras ven los hallazgos junto a la traducción en la Cola.
Progreso de las etapas distingue entre el trabajo completado, omitido, fallido y con advertencias. Revisión humana describe las decisiones y los plazos. La guía del flujo de procesamiento explica por qué cada etapa puede ser útil y cómo las etapas posteriores pueden modificar el texto de las anteriores.