Bring Your Own Engine

El contenido se traduce automáticamente del inglés por Phrase Language AI.

La función BYO engine permite la integración de motores de traducción automática (MT) externos en Phrase para utilizarlos en flujos de trabajo de traducción como cualquier otro proveedor de MT.

BYO engine es adecuado para:

Empresas con modelos de MT específicos de un dominio.
LSPs con motores personalizados del cliente o pilas de IA preferidas.
Organizaciones con políticas internas que requieren el uso de motores específicos (por ejemplo, Gemini, LLM internos, etc.).

Se pueden utilizar motores entrenados a medida o las traducciones se pueden dirigir a LLM internos o proveedores de MT para mantener un control total sobre la calidad, la privacidad y el coste, mientras se sigue beneficiando de las memorias de traducción (TM), glosarios, QPS y el editor CAT de Phrase.

¿Dónde se puede utilizar un BYO engine?

Una vez integrado, un BYO engine está disponible para la pretraducción. Configúrelo en un perfil de Phrase Language AI y utilice ese perfil para realizar la pretraducción desde proyectos de Phrase TMS, Phrase Portal, proyectos de Phrase Strings, Phrase Studio y Phrase Language AI a través de la API.

Configurar un Bring Your Own Engine

Creación del adaptador

La organización debe crear y probar un adaptador de API ligero. Este adaptador permite la comunicación entre Phrase y el motor.

El adaptador debe admitir:
- Solicitudes de traducción
- Compatibilidad con pares de idiomas
- Comprobación del estado del motor (Phrase envía una solicitud de estado)
La infraestructura de respaldo (motor de MT o LLM) debe estar alojada y mantenida por la organización.
Phrase requiere permisos para conectarse a esa infraestructura.
El adaptador debe devolver traducciones con el mismo recuento y orden de segmentos.

Integración del motor en un perfil de MT

Una vez que el adaptador de API esté implementado y desplegado, el BYO engine estará disponible en Phrase Language AI para su selección en los perfiles de MT y podrá asignarse a proyectos.

Para conectar un BYO engine a un perfil de MT:

Desde la página del perfil de MT de Phrase Language AI, haga clic en Conectar motores de MT.

Se mostrará la página Conectar motor de MT.
Selecciona BYO engine.

Se abrirá la página de configuración del BYO engine.
Introduzca la URL del motor base.
Proporcione las credenciales según el Método de autenticación (encabezado HTTP o credenciales de cliente (OAuth 2.0)).
Seleccione si desea usar la memoria caché de traducción. Habilitado por defecto

Reduce el tráfico y acelera la respuesta de traducción al reutilizar segmentos traducidos en los últimos 30 días. Esta es solo una optimización del rendimiento de las llamadas, no reduce el costo de la traducción. Manténgalo habilitado de forma predeterminada; desactívelo solo mientras el adaptador del motor subyacente esté en desarrollo activo.
Si es necesario, proporcione cualquier información adicional para el motor en Etiquetas personalizadas.
Haga clic en Validar conexión para comprobar si la integración del motor funciona.
Haz clic en Agregar.

El motor ya está disponible para habilitarse en el perfil.

Consejo

Al usar un BYO engine, no habilites ningún otro motor en el perfil de MT. Esto garantiza que el BYO engine se seleccione para la pretraducción.

Editar un BYO engine

Para editar un BYO engine, haz clic en el icono de edición en el mosaico del motor.

Eliminar un BYO engine

Para eliminar un BYO engine:

Haz clic en el icono de edición en el mosaico del motor.
Haz clic en Eliminar BYO engine.

PREGUNTAS FRECUENTES

P:	¿Por qué es necesaria la solicitud de estado? ¿La envía Phrase al motor, o se espera que la manejes?
A	Phrase envía la solicitud para comprobar si el motor funciona o no.
P:	Una solicitud puede contener 500 `maxItems` en `segmentos`. ¿Implica esto que 500 oraciones fuente deben traducirse en tiempo real?
A	Tanto las llamadas síncronas como las asíncronas aceptan de 1 a 500 segmentos. En la práctica, las llamadas síncronas desde el editor contienen un solo segmento, mientras que los flujos de trabajo de API y por lotes (pretraducción, análisis) pueden enviar muchos, hasta 500. El flujo asíncrono utiliza el mismo límite y solo separa el envío del trabajo de la obtención del resultado. El tiempo de espera asíncrono es de unos 30 minutos. No cambiamos automáticamente de síncrono a asíncrono si tu adaptador rechaza una solicitud. Para obtener más detalles sobre qué esperar de Phrase (recuentos de segmentos, la prueba de validación del motor, reintentos y límites de tiempo), consulta la guía de BYO engine.
P:	¿Se envían todos los términos de un glosario en una solicitud, o un subconjunto?
A	Se envían todos los términos del glosario.
P:	¿Es posible conectar un LLM?
A	Debería ser posible con un contenedor. Mientras el motor devuelva segmentos según lo definido en el esquema, Phrase no requiere un motor o LLM específico.
P:	¿Es posible la evaluación de calidad (QE) personalizada?
A	La QE de terceros no es compatible.
P:	¿Cómo se manejan las etiquetas?
A	El contenido que recibe Phrase es preprocesado. Las etiquetas HTML se convierten en marcas, y esas marcas se pasan tal cual.
P:	¿Podemos implementar solo el enfoque asíncrono? ¿Funcionará correctamente en todas las áreas de Phrase (pre-traducción, Editor, etc.)?
A	No, ambos enfoques (idealmente todos los puntos de conexión) deben ser implementados. El punto de conexión síncrono es utilizado, por ejemplo, por el Editor, mientras que el asíncrono se utiliza en áreas como la pre-traducción.
P:	¿Qué sucede cuando el motor recibe múltiples solicitudes al mismo tiempo?
A	El motor debe ser capaz de manejar esto. Asegure el manejo adecuado de la concurrencia y la seguridad de los hilos en todos los puntos de conexión, particularmente en los asíncronos.
P:	¿Cómo funciona Request Metadata?
A	Debe permanecer estático, tal como se definió durante la configuración del motor.
P:	¿Cómo funciona Segment Metadata?
A	Actualmente, necesita ser parte del esquema.
P:	Durante el procesamiento de MT, ¿utiliza el BYO engine RAG para recuperar contexto?
A	No, el BYO engine no utiliza RAG. Los usuarios pueden aprovechar las memorias de traducción (TM) para determinar qué segmentos están traducidos, pero no se utilizan dentro del proceso de MT en sí. Esto se debe a que los motores de MT deben estar diseñados específicamente para incorporar datos de TM a través de RAG, y en los escenarios del BYO engine no existe control sobre cómo se crean o configuran los motores.

Referencia del esquema del adaptador

El adaptador debe devolver respuestas que coincidan exactamente con los siguientes nombres de campo y valores de enumeración. Una discrepancia da como resultado un INTERNAL_ERROR genérico de Phrase, incluso cuando el propio adaptador devuelve una respuesta 200 OK.

POST /status debe devolver un campo status con un valor de enumeración estricto en minúsculas de ok o not_ok. Ejemplo: { "status": "ok" }
POST /languages debe devolver una matriz languagePairs (camelCase), donde cada entrada contiene un campo sourceLanguage y un campo targetLanguage. Ejemplo: { "languagePairs": [ { "sourceLanguage": "en", "targetLanguage": "es" } ] }
POST /translate y GET /translateAsyncResult/{id} deben devolver campos de nivel superior sourceLanguage y targetLanguage, además de una matriz segments donde cada segmento incluye tanto un campo text (el texto fuente repetido) como un campo translatedText. Devolver solo translatedText, o utilizar un nombre de clave diferente, provoca un error de deserialización.
POST /translateAsync solo requiere un campo id en su respuesta. Un campo status no forma parte de este esquema de respuesta y se ignora si está presente.
GET /translateAsyncStatus/{id} debe devolver un campo status utilizando uno de los tres valores de enumeración: running para un trabajo que aún se está procesando, done para un trabajo completado con éxito, o failed para un trabajo fallido. Para un trabajo fallido, un campo opcional detail puede describir el fallo. Valores de ejemplo: { "status": "running" }, { "status": "done" }, { "status": "failed", "detail": "Descripción del fallo de traducción" }