Bring Your Own Engine

Le contenu est traduit de l’anglais par Phrase Language AI.

La fonctionnalité Bring Your Own Engine (BYO Engine) permet l'intégration de moteurs de traduction automatique (TA) externes dans Phrase pour être utilisés dans les flux de travail de traduction comme n'importe quel autre fournisseur de TA.

BYO Engine est adapté pour :

Les entreprises disposant de modèles de TA spécifiques à un domaine.
Les LSP avec des moteurs client personnalisés ou des piles IA privilégiées.
Les organisations ayant des politiques internes qui exigent l'utilisation de moteurs spécifiques (par exemple, Gemini, LLM internes, etc.).

Des moteurs personnalisés peuvent être utilisés ou les traductions peuvent être acheminées vers des LLM internes ou des fournisseurs de TA pour conserver un contrôle total sur la qualité, la confidentialité et les coûts tout en continuant à bénéficier des mémoires de traduction (MT), glossaires, QPS et du CAT Editor de Phrase.

Où un BYO Engine peut être utilisé

Une fois intégré, un BYO Engine est disponible pour la pré-traduction. Configurez-le dans un profil Language AI de Phrase et utilisez ce profil pour pré-traduire depuis des projets Phrase TMS, Phrase Portal, des projets Phrase Strings, Phrase Studio et Phrase Language AI via API.

Configurer un Bring Your Own Engine

Création de l'adaptateur

L'organisation doit créer et tester un adaptateur API léger. Cet adaptateur permet la communication entre Phrase et le moteur.

L'adaptateur doit prendre en charge :
- Les demandes de traduction
- La prise en charge des paires de langues
- La vérification du statut du moteur (Phrase envoie une demande de statut)
L'infrastructure sous-jacente (moteur de TA ou LLM) doit être hébergée et maintenue par l'organisation.
Phrase nécessite des autorisations pour se connecter à cette infrastructure.
L'adaptateur doit renvoyer des traductions avec le même nombre de segments et le même ordre.

Intégration du moteur dans un profil TA

Une fois l'adaptateur API implémenté et déployé, le BYO Engine devient disponible dans Phrase Language AI pour être sélectionné dans les profils TA et peut être assigné à des projets.

Pour connecter un BYO Engine à un profil TA :

Depuis la page de profil TA de Phrase Language AI, cliquez sur Connecter des moteurs de TA.

La page Connecter un moteur de TA s'affiche.
Sélectionnez Bring Your Own (BYO) Engine.

La page de configuration du BYO Engine s'ouvre.
Entrez l'URL de base du moteur.
Fournissez les informations d’identification en fonction de la méthode d'authentification (en-tête HTTP ou informations d’identification client (OAuth 2.0)).
Sélectionnez si vous souhaitez utiliser le cache de traduction. Activé par défaut.

Réduit le trafic et accélère la réponse de traduction en réutilisant les segments traduits au cours des 30 derniers jours. Il s'agit uniquement d'une optimisation des performances d'appel, cela ne réduit pas le coût de traduction. Gardez-le activé par défaut, désactivez-le uniquement pendant que l'adaptateur de moteur sous-jacent est en cours de développement actif.
Si nécessaire, fournissez toute information supplémentaire pour le moteur sous Étiquettes personnalisées.
Cliquez sur Valider la connexion pour vérifier si l'intégration du moteur fonctionne.
Cliquez sur Ajouter.

Le moteur est maintenant disponible pour être activé dans le profil.

Astuce

Lors de l'utilisation d'un BYO Engine, n'activez aucun autre moteur dans le profil TA. Cela garantit que le BYO Engine est sélectionné pour la pré-traduction.

Modifier un Bring Your Own Engine

Pour modifier un BYO Engine, cliquez sur l'icône modifier sur la tuile du moteur.

Supprimer un Bring Your Own Engine

Pour supprimer un BYO Engine :

Cliquez sur l'icône modifier sur la tuile du moteur.
Cliquez sur Retirer Bring Your Own Engine.

FAQ

Q :	Pourquoi la demande de statut est-elle requise ? Est-elle envoyée par Phrase au moteur, ou est-il attendu qu'elle soit gérée par le client ?
R :	Phrase envoie la demande pour vérifier si le moteur fonctionne ou non.
Q :	Une demande peut contenir 500 `maxItems` dans `segments`. Cela implique-t-il que 500 phrases source doivent être traduites en temps réel ?
R :	Les appels synchrones incluent seulement jusqu'à 5 segments, tandis que les appels asynchrones peuvent en inclure davantage, jusqu'à 500. De plus, le délai d'expiration asynchrone est d'environ 30 minutes.
Q :	Tous les termes d'un glossaire sont-ils envoyés dans une demande, ou seulement un sous-ensemble ?
R :	Tous les termes du glossaire sont envoyés.
Q :	Est-il possible de connecter un LLM ?
R :	Cela devrait être possible avec un wrapper. Tant que le moteur renvoie des segments tels que définis dans le schéma, Phrase ne nécessite pas de moteur ou de LLM spécifique.
Q :	Une évaluation de la qualité (QE) personnalisée est-elle possible ?
R :	La QE tierce n'est pas prise en charge.
Q :	Comment les balises sont-elles gérées ?
R :	Le contenu que Phrase reçoit est pré-traité. Les balises HTML sont converties en marques, et ces marques sont transmises telles quelles.
Q :	Pouvons-nous implémenter uniquement l'approche asynchrone ? Cela fonctionnera-t-il correctement dans toutes les zones de Phrase (pré-traduction, éditeur, etc.) ?
R :	Non, les deux approches (idéalement tous les points de terminaison) doivent être implémentées. Le point de terminaison synchrone est utilisé, par exemple, par l'éditeur, tandis que l'asynchrone est utilisé dans des zones telles que la pré-traduction.
Q :	Que se passe-t-il lorsque le moteur reçoit plusieurs requêtes en même temps ?
R :	Le moteur doit être capable de gérer cela. Assurez-vous d'une gestion appropriée de la concurrence et de la sécurité des threads sur tous les points de terminaison, en particulier les asynchrones.
Q :	Comment fonctionne les métadonnées de requête ?
R :	Elles doivent rester statiques, telles que définies lors de la configuration du moteur.
Q :	Comment fonctionne les métadonnées de segment ?
R :	Actuellement, elles doivent faire partie du schéma.
Q :	Lors du traitement TA, le BYOE utilise-t-il la RAG pour récupérer du contenu ?
R :	Non, le BYOE n'utilise pas la RAG. Les utilisateurs peuvent tirer parti des MT pour déterminer quels segments sont traduits, mais elles ne sont pas utilisées au sein du processus de MT lui-même. C'est parce que les moteurs de MT doivent être spécifiquement conçus pour intégrer les données de MT via RAG, et dans les scénarios BYOE, il n'y a aucun contrôle sur la façon dont les moteurs sont construits ou configurés.

Référence du schéma d'adaptateur

L'adaptateur doit renvoyer des réponses qui correspondent exactement aux noms de champ et aux valeurs enum suivants. Une non-correspondance entraîne une INTERNAL_ERROR générique de Phrase même lorsque l'adaptateur lui-même renvoie une réponse 200 OK.

POST /status doit renvoyer un champ statut avec une valeur enum stricte en minuscules, soit ok, soit not_ok. Exemple : { \"status\": \"ok\" }
POST /languages doit renvoyer un tableau languagePairs (camelCase), avec chaque entrée contenant un champ sourceLanguage et un champ targetLanguage. Exemple : { \"languagePairs\": [ { \"sourceLanguage\": \"en\", \"targetLanguage\": \"es\" } ] }
POST /translate et GET /translateAsyncResult/{id} doivent renvoyer des champs sourceLanguage et targetLanguage de haut niveau, ainsi qu'un tableau segments où chaque segment inclut à la fois un champ text (le texte source renvoyé) et un champ translatedText. Renvoyer uniquement translatedText, ou utiliser un nom de clé différent, provoque un échec de désérialisation.
POST /translateAsync nécessite uniquement un champ Identifiant dans sa réponse. Un champ statut ne fait pas partie de ce schéma de réponse et est ignoré s'il est présent.
GET /translateAsyncStatus/{id} doit renvoyer un champ statut utilisant l'une des trois valeurs enum : running pour une tâche toujours en cours de traitement, done pour une tâche terminée avec succès, ou failed pour une tâche ayant échoué. Pour une tâche ayant échoué, un champ detail optionnel peut décrire l'échec. Valeurs d'exemple : { \"status\": \"running\" }, { \"status\": \"done\" }, { \"status\": \"failed\", \"detail\": \"Description of translation failure\" }