Configurer le pipeline de traduction
Enregistrez les étapes du moteur avant de lancer une tâche et vérifiez celles qui s’exécutent réellement.
Une tâche de localisation utilise la configuration du pipeline du moteur enregistrée au moment de son lancement. Configurez le moteur avant d’appeler /start. Les modifications ultérieures du moteur s’appliquent aux prochaines tâches, mais ne modifient pas l’instantané de configuration d’une tâche déjà en cours.
Ouvrez l’onglet Pipeline du moteur dans Studio, ou mettez à jour pipelineConfig via PATCH /v2/engines/:id. L’appelant doit disposer de l’autorisation de modifier le moteur. L’organisation doit avoir accès aux fonctionnalités requises par les étapes susceptibles de s’exécuter. Consultez l’accès aux fonctionnalités et les tarifs.
Enregistrer une configuration complète #
Lisez le moteur avec GET /v2/engines/:id avant de modifier une configuration existante. L’envoi de pipelineConfig remplace cette configuration ; les étapes omises prennent leurs valeurs par défaut. Veillez à conserver les paramètres que vous souhaitez garder.
Cette requête configure la traduction avec une passe de reformulation. Les étapes facultatives absentes de la requête sont désactivées :
PATCH /v2/engines/:id
Content-Type: application/json
X-API-Key: YOUR_API_KEY{
"pipelineConfig": {
"localize": { "enabled": true },
"rephrase": { "enabled": true }
}
}Utilisez un moteur distinct lorsqu’une application nécessite une politique différente pour une catégorie de tâches. Configurez ses modèles et ses consignes, puis sélectionnez son ID lors de la création de ces tâches.
Paramètres des étapes #
Champ dans pipelineConfig | Paramètres |
|---|---|
localize | enabled: true. La traduction est obligatoire. |
preEdit, rephrase, postEdit, backTranslation | enabled : booléen. Valeur par défaut : false. |
qualityGate | Booléen enabled et strictness : "strict", "medium" ou "lax" ("medium" par défaut). |
humanEdit | enabled, timeoutHours : entier positif (48 par défaut), et routes de relecture. |
contentLength | enabled et un mode décrit ci-dessous. |
La post-édition nécessite une relecture humaine. La passe de post-édition s’applique au texte issu de cette relecture ; si celle-ci est contournée ou si le délai expire, aucun texte relu ne sera nécessairement disponible pour être affiné.
Les modes de longueur du contenu sont { "_tag": "noLongerThanSource" } (par défaut), { "_tag": "fixedCap", "maxColumns": 40 } ou { "_tag": "matchSource", "tolerancePct": 10 }. Les valeurs numériques doivent être des entiers positifs. Il s’agit de cibles exprimées en colonnes d’affichage, et non de limites en octets ni d’une garantie que le texte tiendra dans l’interface.
Acheminer la relecture humaine #
Créez ou sélectionnez d’abord des groupes de décision. Chaque entrée humanEdit.routes désigne un groupe et précise les langues et les répertoires qu’il couvre. Cette configuration envoie tout le contenu nouvellement traduit à un seul groupe :
{
"pipelineConfig": {
"localize": { "enabled": true },
"humanEdit": {
"enabled": true,
"timeoutHours": 48,
"routes": [
{
"pool": "YOUR_DECISION_POOL_ID",
"match": { "locales": [] }
}
]
}
}
}Un tableau locales vide couvre toutes les langues. Ajoutez "path": ["emails/**"] dans match pour couvrir les documents situés sous ce répertoire ; la correspondance se fait avec le key du document. Les chemins désignent des répertoires littéraux suivis de /**. Une règle d’acheminement sans path s’applique à tous les répertoires. Les correspondances de répertoire et de langue les plus spécifiques sont prioritaires ; les règles d’acheminement contradictoires sont rejetées.
Pour cibler la relecture, activez la relecture humaine et ajoutez une route qui couvre les traductions que vous souhaitez faire relire. Ajoutez qualityGate dans pipelineConfig et conservez les autres paramètres :
{
"qualityGate": { "enabled": true, "strictness": "medium" }
}Vous pouvez enregistrer un qualityGate activé même si humanEdit.enabled est false. Studio conserve ce paramètre lorsque vous désactivez puis réactivez la relecture humaine. Avec l’API, incluez qualityGate dans chaque pipelineConfig de remplacement pour conserver ce paramètre. Le contrôle ne s’exécute que si la relecture humaine est activée dans le pipeline résolu de la tâche.
Le contrôle qualité enregistre les constats pour chaque unité. "strict" exige une relecture pour tout constat, "medium" pour les constats majeurs ou critiques, et "lax" pour les constats critiques uniquement. Une traduction que le contrôle n’a pas pu vérifier nécessite tout de même une relecture. Réglez qualityGate.enabled sur false pour Tout : chaque nouvelle traduction couverte par une règle d’acheminement est alors envoyée en relecture. Les traductions réutilisées ne génèrent pas de nouveau travail de relecture.
Le jugement ne dépend pas du degré d’exigence ; le niveau s’applique aux constats. Modifier le niveau d’un moteur affecte les tâches lancées par la suite, mais pas la configuration enregistrée d’une tâche déjà en cours. Consultez les niveaux du contrôle qualité pour découvrir leurs descriptions et les définitions des degrés de gravité.
L’ancienne API de localisation asynchrone accepte toujours humanEdit.qualityThreshold, mais l’ignore. Chaque traduction dans une langue sélectionnée pour la relecture humaine est envoyée à une personne chargée de la relecture. Pour une relecture sélective dans le pipeline actuel, réglez le Niveau de relecture dans les paramètres de Relecture humaine du moteur.
La disponibilité de la relecture dépend de l’offre de l’organisation et de la connexion du groupe à son fournisseur. Au lancement de la tâche, les fonctionnalités d’étape indisponibles sont désactivées, ainsi que les étapes qui en dépendent. Consultez les étapes cibles de la tâche pour confirmer le workflow réellement appliqué. Si la publication nécessite une décision humaine, faites respecter cette politique avant de livrer le résultat téléchargé.
Inspecter le résultat #
L’étape de contrôle qualité enregistre ce résultat pour chaque unité vérifiée :
{
"findings": [
{
"span": "Pay €20",
"reason": "The translation changes the source amount from €10 to €20.",
"category": "accuracy",
"severity": "critical"
}
]
}span est cité mot pour mot à partir de la traduction jugée par le contrôle qualité. reason est une seule phrase en anglais. Les catégories sont accuracy, terminology, guidance, fluency et style ; les degrés de gravité sont critical, major et minor. Un tableau findings vide signifie que le contrôle n’a trouvé aucune erreur. Les unités de relecture renvoient ce résultat sous la forme quality ; consultez la relecture humaine. Les personnes chargées de la relecture voient les constats à côté de la traduction dans la File d’attente.
La progression des étapes distingue les travaux terminés, ignorés, en échec ou ayant généré des avertissements. La relecture humaine décrit les décisions et les échéances. Le guide du pipeline explique en quoi chaque étape peut être utile et comment les étapes ultérieures peuvent modifier le texte produit par les précédentes.