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 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 dominio.
LSP con motores de cliente personalizados 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 dirigir las traducciones a LLM internos o proveedores de MT para mantener un control total sobre la calidad, la privacidad y el coste sin dejar de aprovechar 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úralo en un perfil de Phrase Language AI y usa 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 implementado y desplegado el adaptador de API, el BYO engine estará disponible en Phrase Language AI para seleccionarlo en los perfiles de MT y asignarlo 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 mostrará la página Conectar motor de MT.
Selecciona Bring Your Own (BYO) 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 quieres usar la memoria caché de traducción. Activado 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 coste de la traducción. Mantén esta opción activada de forma predeterminada. Desactívala solo mientras el adaptador del motor subyacente esté en desarrollo activo.
Si es necesario, proporciona cualquier información adicional sobre 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 activarse en el perfil.

Consejo

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

Editar un Bring Your Own Engine

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

Eliminar un Bring Your Own Engine

Para eliminar un BYO engine:

Haz clic en el icono de edición del mosaico del motor.
Haz clic en Eliminar Bring Your Own Engine.

PREGUNTAS FRECUENTES

P:	¿Por qué es necesaria la solicitud de estado? ¿La envía Phrase al motor o se espera que la gestione el cliente?
R:	Phrase envía la solicitud para comprobar si el motor funciona o no.
P:	En una solicitud, `maxItems` puede tener un valor de 500 en `segments`. ¿Implica esto que 500 oraciones de origen deben traducirse en tiempo real?
R:	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 pasamos automáticamente del modo síncrono al asíncrono si tu adaptador rechaza una solicitud. Para obtener más detalles sobre qué esperar de Phrase (recuento de segmentos, 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?
R:	Se envían todos los términos del glosario.
P:	¿Es posible conectar un LLM?
R:	Debería ser posible mediante una capa de adaptación. Siempre que 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?
R:	La QE de terceros no es compatible.
P:	¿Cómo se manejan las etiquetas?
R:	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 (pretraducción, Editor, etc.)?
R:	No, se deben implementar ambos enfoques (idealmente todos los puntos finales). El punto final síncrono lo utiliza, por ejemplo, el Editor, mientras que el asíncrono se utiliza en áreas como la pretraducción.
P:	¿Qué sucede cuando el motor recibe múltiples solicitudes al mismo tiempo?
R:	El motor debe ser capaz de manejar esto. Asegúrate de gestionar correctamente la concurrencia y la seguridad de los hilos en todos los puntos finales, especialmente en los asíncronos.
P:	¿Cómo funcionan los metadatos de solicitud?
R:	Los metadatos de solicitud, configurados como etiquetas personalizadas en la configuración de BYO engine, admiten marcadores de posición dinámicos que se resuelven antes de que la solicitud llegue al adaptador: `{project_uid}`, `{job_uid}` y `{idm_organization_uid}`. Por ejemplo, una etiqueta personalizada con la clave `project_uid` y el valor `{project_uid}` envía al adaptador el UID real del proyecto de Phrase TMS. La resolución de marcadores de posición solo se aplica dentro de los valores de texto. Un marcador de posición desconocido se envía al adaptador tal cual, sin resolución.
P:	¿Cómo funcionan los metadatos de segmento?
R:	Actualmente, debe ser parte del esquema.
P:	Durante el procesamiento de MT, ¿usa BYOE RAG para recuperar contexto?
R:	No, BYOE no usa RAG. Los usuarios pueden aprovechar las memorias de traducción (TMs) para determinar qué segmentos se traducen, pero estas no se utilizan durante el proceso de traducción automática (MT) en sí. Esto se debe a que los motores de traducción automática (MT) deben estar diseñados específicamente para incorporar datos de memorias de traducción (TM) mediante RAG y, en escenarios de BYOE, no se tiene control sobre cómo se desarrollan 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 provoca un INTERNAL_ERROR genérico de Phrase, incluso cuando el propio adaptador devuelve una respuesta 200 OK.

POST /status debe devolver un campo status cuyo valor debe ser exactamente uno de los siguientes valores de enumeración en minúsculas: ok o not_ok. Ejemplo : { "status": "ok" }
POST /languages debe devolver un arreglo languagePairs (en camelCase), en el que cada entrada contenga un campo sourceLanguage y un campo targetLanguage. Ejemplo: { "languagePairs": [ { "sourceLanguage": "en", "targetLanguage": "es" } ] }
POST /translate y GET /translateAsyncResult/{id} deben devolver los campos sourceLanguage y targetLanguage en el nivel superior, además de un arreglo segments en el que cada segmento incluya un campo text (el texto de origen devuelto sin modificar) y un campo translatedText. Devolver solo translatedText o utilizar otro nombre de clave provoca un error de deserialización.
POST /translateAsync requiere solo 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 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 opcional detail puede describir el fallo. Valores de ejemplo: { "status": "running" }, { "status": "done" }, { "status": "failed", "detail": "Description of translation failure" }