Configurar el proceso de traducción
Guarda las etapas del motor antes de iniciar un trabajo y comprueba cuáles se ejecutan realmente.
Cada trabajo de localización utiliza la configuración del proceso del motor guardada en el momento de iniciarlo. Configura el motor antes de llamar a /start. Los cambios posteriores en el motor afectan a los trabajos que se inicien después, no a la configuración guardada de un trabajo que ya esté en curso.
Abre la pestaña Canalización del motor en Studio o actualiza pipelineConfig mediante PATCH /v2/engines/:id. Quien realiza la llamada debe tener permiso para editar el motor. La organización debe tener acceso a las funciones necesarias para las etapas que puedan ejecutarse. Consulta acceso a las funciones y precios.
Guardar una configuración completa #
Consulta el motor con GET /v2/engines/:id antes de modificar una configuración existente. Al enviar pipelineConfig, se sustituye esa configuración; las etapas omitidas adoptan 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 }
}
}Utiliza un motor independiente cuando una aplicación necesite una política distinta para un determinado tipo de trabajo. Configura sus modelos y directrices y, después, selecciona su ID al crear esos trabajos.
Ajustes de las etapas #
Campo en pipelineConfig | Ajustes |
|---|---|
localize | enabled: true. La traducción es obligatoria. |
preEdit, rephrase, postEdit, backTranslation | enabled de tipo booleano. Valor predeterminado: false. |
qualityGate | enabled de tipo booleano y strictness: "strict", "medium" o "lax" (valor predeterminado: "medium"). |
humanEdit | enabled, timeoutHours de tipo entero positivo (valor predeterminado: 48) y routes de revisión. |
contentLength | enabled y un mode que se describe a continuación. |
La posedición requiere revisión humana. Una pasada de posedición se aplica al texto producido por una persona; si se omite la revisión o se agota el tiempo de espera, puede que no haya ningún texto de origen humano que perfeccionar.
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 anchura medidos en columnas de visualización, no límites en bytes ni garantías de que el texto quepa en la interfaz.
Dirigir la revisión humana #
Primero crea o selecciona grupos de decisión. Cada entrada de humanEdit.routes indica un grupo y los idiomas y directorios que abarca. Esta configuración envía todo el contenido recién traducido a un único grupo:
{
"pipelineConfig": {
"localize": { "enabled": true },
"humanEdit": {
"enabled": true,
"timeoutHours": 48,
"routes": [
{
"pool": "YOUR_DECISION_POOL_ID",
"match": { "locales": [] }
}
]
}
}
}Un array locales vacío abarca todos los idiomas. Añade "path": ["emails/**"] dentro de match para incluir los documentos de ese directorio; se compara con el key del documento. Las rutas especifican nombres literales de directorios seguidos de /**. Una ruta sin path se aplica a todos los directorios. Las coincidencias más específicas de directorio e idioma tienen prioridad; las rutas en conflicto se rechazan.
Para revisar de forma selectiva, activa la revisión humana y añade una ruta que cubra las traducciones que quieras revisar. Añade qualityGate dentro de pipelineConfig y conserva el resto de la configuración:
{
"qualityGate": { "enabled": true, "strictness": "medium" }
}Puedes guardar qualityGate activado mientras humanEdit.enabled sea false. Studio conserva el ajuste al desactivar y volver a activar la revisión humana. Si usas la API, incluye qualityGate cada vez que sustituyas pipelineConfig para conservarlo. El control solo se ejecuta si la revisión humana está activada en la configuración efectiva de la tarea.
El control guarda los problemas detectados en cada unidad. "strict" exige revisión ante cualquier problema, "medium" ante problemas graves o críticos, y "lax" solo ante problemas críticos. Una traducción que el control no haya podido 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 ruta. 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 problemas detectados. Cambiar el nivel de un motor afecta a los trabajos que se inicien después, no a la configuración guardada de un trabajo que ya esté en curso. Consulta niveles del control de calidad para ver las descripciones y las definiciones de gravedad.
La antigua API de localización asíncrona sigue aceptando humanEdit.qualityThreshold, pero lo ignora. Cada traducción en un idioma seleccionado para revisión humana se envía a una persona revisora. Para realizar una revisión selectiva en el proceso actual, establece 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 el proveedor. Al iniciar el trabajo, se desactivan las funciones de las etapas que no estén disponibles, junto con las etapas que dependan de ellas. Consulta las etapas de destino del trabajo para confirmar el flujo de trabajo que se aplicará realmente. Si la publicación requiere una decisión humana, asegúrate de que se cumpla esa política antes de entregar el resultado descargado.
Consultar 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 literal de la traducción que evaluó el control. reason es una única frase en inglés. Las categorías son accuracy, terminology, guidance, fluency y style; los niveles de gravedad son critical, major y minor. Un array findings vacío significa 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 problemas detectados junto a la traducción en La Cola.
Progreso de las etapas distingue entre tareas completadas, omitidas, fallidas y con advertencias. Revisión humana describe las decisiones y los plazos. La guía del proceso explica por qué puede resultar útil cada etapa y cómo las etapas posteriores pueden modificar el texto de las anteriores.