Bring Your Own Engine

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

La función Bring Your Own Engine (BYO Engine) permite la integración de motores de traducción automática (MT) externos en Phrase para ser utilizados 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 dominio.
LSPs con motores de cliente personalizados o stacks de IA preferidos.
Organizaciones con políticas internas que requieren el uso de motores específicos (p. ej., Gemini, LLM internos, etc.).

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

Dónde se puede usar un BYO Engine

Una vez integrado, un BYO Engine está disponible para pretraducción. Configúrelo en un perfil de Language AI de Phrase y use ese perfil para pretraducir desde proyectos de Phrase TMS, Phrase Portal, proyectos de Phrase Strings, Phrase Studio y Language AI de Phrase a través de 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
- Soporte de combinación de idiomas
- Verificació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 de segmentos y orden.

Integración del motor en un perfil de MT

Una vez implementado y desplegado el adaptador de API, el BYO Engine estará disponible en Phrase Language AI para su selección en 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, haz clic en Conectar motores de MT.

Se muestra la página Conectar motor de MT.
Selecciona Bring Your Own Engine.

Se abre la página de configuración del BYO Engine.
Introduce la URL base del motor.
Proporciona las credenciales según el método de autenticación (cabecera HTTP o credenciales de cliente (OAuth 2.0)).
Selecciona si usar caché de traducción. Opción activada por defecto.

Reduce el tráfico y acelera la respuesta de traducción al reutilizar segmentos traducidos en los últimos 30 días. Esto es solo una optimización del rendimiento de llamadas, no reduce el coste de traducción. Mantén habilitado por defecto, deshabilita solo mientras el adaptador del motor subyacente esté en desarrollo activo.
Si es necesario, proporciona cualquier información adicional para el motor en etiquetas personalizadas.
Haz clic en Validar conexión para comprobar si la integración del motor funciona.
Haz clic en Agregar.

El motor ya está disponible para habilitar 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 motor BYO, haz clic en el icono de editar en el mosaico del motor.

Eliminar un BYO Engine

Para eliminar un BYO Engine:

Haz clic en el icono de editar en el mosaico del motor.
Haz clic en Eliminar BYO Engine.

Preguntas frecuentes

Q:	¿Por qué es necesaria la solicitud de estado? ¿La envía Phrase al motor, o se espera que la gestione el cliente?
A:	Phrase envía la solicitud para comprobar si el motor funciona o no.
Q:	Una solicitud puede contener 500 `maxItems` en `segmentos`. ¿Implica esto que 500 oraciones fuente deben traducirse en tiempo real?
A:	Las llamadas síncronas incluyen solo hasta 5 segmentos, mientras que las llamadas asíncronas pueden incluir más, hasta 500. Además, el tiempo de espera asíncrono es de unos 30 minutos.
Q:	¿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.
Q:	¿Es posible conectar un LLM?
A:	Debería ser posible con un wrapper. Siempre que el motor devuelva segmentos tal como se define en el esquema, Phrase no requiere un motor o LLM específico.
Q:	¿Es posible una evaluación de calidad personalizada?
A:	La QE de terceros no es compatible.
Q:	¿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.
Q:	¿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 finales) deben ser implementados. El punto final síncrono es utilizado, por ejemplo, por el Editor, mientras que el asíncrono se utiliza en áreas como la pretraducción.
Q:	¿Qué sucede cuando el motor recibe múltiples solicitudes al mismo tiempo?
A:	El motor debe ser capaz de manejar esto. Asegure un manejo adecuado de la concurrencia y la seguridad de los hilos en todos los puntos finales, particularmente en los asíncronos.
Q:	¿Cómo funciona el Request Metadata?
A:	Debe permanecer estático, tal como se definió durante la configuración del motor.
Q:	¿Cómo funciona el Segment Metadata?
A:	Actualmente, necesita ser parte del esquema.
Q:	Durante el procesamiento de MT, ¿BYOE usa RAG para recuperar contexto?
A:	No, BYOE no usa RAG. Los usuarios pueden usar TM para determinar qué segmentos se traducen, pero no se usan 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 de BYOE no hay control sobre cómo se construyen 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 falta de concordancia resulta en un INTERNAL_ERROR genérico de Phrase incluso cuando el adaptador mismo devuelve una respuesta 200 OK.

POST /status debe devolver un campo estado 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), con cada entrada conteniendo un campo sourceLanguage y un campo targetLanguage. Ejemplo: { \"languagePairs\": [ { \"sourceLanguage\": \"en\", \"targetLanguage\": \"es\" } ] }
POST /translate y GET /translateAsyncResult/{id} deben devolver campos sourceLanguage y targetLanguage de nivel superior, además de una matriz segmentos donde cada segmento incluye tanto un campo text (el texto fuente repetido) como un campo translatedText. Devolver solo translatedText, o usar un nombre de clave diferente, causa un error de deserialización.
POST /translateAsync requiere solo un campo id en su respuesta. Un campo estado no forma parte de este esquema de respuesta y se ignora si está presente.
GET /translateAsyncStatus/{id} debe devolver un campo estado usando 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 detail opcional puede describir el fallo. Valores de ejemplo: { \"status\": \"running\" }, { \"status\": \"done\" }, { \"status\": \"failed\", \"detail\": \"Description of translation failure\" }