La plupart de vos contenus peuvent être publiés dès que le moteur les renvoie. Mais pas tous. Une mention réglementaire, une consigne médicale, un titre qui porte votre marque — dans ces cas-là, vous voulez qu'une personne lise la traduction et la valide avant sa mise en ligne, pas après la plainte d'un client.
D'ordinaire, faire entrer un humain dans un flux automatisé est fastidieux : garder la requête ouverte pendant qu'une personne relit, construire votre propre file de relecture, ou brancher à la main l'API d'un prestataire de traduction. Cette étape gère tout cela dans le job lui-même. Quand humanEdit est activé, le job asynchrone exécute le moteur, puis se met en pause en attendant une personne — votre équipe ou un professionnel externe — avant de reprendre avec sa version, qui est ensuite transmise à toutes les étapes suivantes.
Il s'agit de la troisième étape du pipeline de localisation et, comme toutes les étapes, elle ne s'applique qu'aux jobs créés via l'API de localisation asynchrone. Vous découvrez le pipeline ? Commencez par la vue d'ensemble.
Sur cette page
- Comment fonctionne la pause
- Relecture interne
- Autorisations
- Relecture externe
- Délai d'expiration
- Activer l'étape
Comment fonctionne la pause#
Après l'étape principale de traduction, le job confie la traduction IA à une personne pour relecture. Le relecteur la lit, puis l'approuve telle quelle ou soumet une version modifiée. Ce n'est qu'à ce moment-là que le job reprend. Le résultat humain — approuvé ou modifié — devient l'entrée de toutes les étapes suivantes et, au bout du compte, le outputData du job.
L'objection évidente à l'idée de mettre un job en pause pendant quelques minutes, plusieurs heures ou une journée entière, c'est le coût : une requête maintenue ouverte consomme des ressources alors qu'il ne se passe rien. Ce n'est pas comme ça que fonctionne cette étape.
L'attente est pilotée par événements, pas par une connexion maintenue ouverte
Le workflow reprend lorsqu'un événement se produit — un relecteur qui soumet depuis le tableau de bord (Relecture interne) ou un callback du prestataire de traduction (Relecture externe). Il n'y a ni polling en boucle serrée, ni connexion maintenue ouverte. Résultat : un long délai d'expiration ne consomme aucune ressource de calcul en arrière-plan. Un job peut attendre 48 heures une intervention humaine exactement comme il attend un modèle : il est en attente, pas en train de tourner.
Deux modes de relecture sont disponibles, à choisir par moteur. La seule différence tient à la personne qui lit : le comportement de pause, de reprise et de transmission du résultat est strictement identique.
Relecture interne#
Votre équipe relit les traductions directement dans le tableau de bord Lingo.dev. Les relectures en attente arrivent sur la page Human Reviewer de votre organisation (/orgs/<org-id>/human-reviewer), et les relecteurs sont avertis lorsque de nouveaux éléments arrivent. Un relecteur prend un élément en charge, puis approuve la traduction telle quelle ou soumet une version modifiée. Le job reprend immédiatement avec son résultat.
Un deuxième relecteur ne peut pas récupérer un élément déjà pris en charge par quelqu'un d'autre. Les prises en charge sont exclusives : un seul relecteur peut détenir un élément à la fois, afin que deux personnes ne modifient jamais la même traduction en s'écrasant mutuellement sans le savoir. La chaîne reste verrouillée pour la personne qui l'a prise en charge jusqu'à ce qu'elle la libère ou la soumette.
La relecture interne est le mode par défaut pour les nouveaux moteurs. Privilégiez-la lorsque votre équipe dispose en interne de l'expertise linguistique nécessaire et que vous voulez garder la main sur la formulation finale, sans faire intervenir de tiers.
Autorisations#
La relecture interne n'est pas ouverte à toute l'organisation : l'accès à la page Human Reviewer est soumis à autorisation. Une traduction en cours de relecture n'est donc visible que par les personnes auxquelles vous donnez accès. Un administrateur de l'organisation attribue cet accès via les rôles (Paramètres → Rôles) :
| Autorisation | Ce que cela permet |
|---|---|
Relire les traductions (engine:review_translations) | Afficher et traiter la file de relecture — prendre en charge une traduction en attente, la modifier, l'approuver telle quelle ou soumettre la version modifiée |
Gérer les relectures (org:manage_reviews) | Accéder à l'historique des relectures et aux statistiques des relecteurs pour toutes les relectures internes de l'organisation |
Ces deux autorisations sont volontairement distinctes. Un relecteur n'a besoin que de Relire les traductions : cette seule autorisation couvre tout le travail — prise en charge, modification, approbation, soumission. Gérer les relectures est destinée à la personne qui pilote l'opération ; elle ajoute la vue historique et les statistiques à l'échelle de l'organisation, mais ne donne pas à elle seule accès à la file. Attribuez les deux à un responsable qui relit et suit l'activité ; attribuez uniquement la première à quelqu'un qui se contente de traiter la file.
Relecture externe#
Lorsque vous n'avez pas de relecteurs en interne pour une langue, la traduction est envoyée à un traducteur professionnel qualifié via un prestataire externe. Le job se met en pause exactement de la même manière, puis reprend lorsque le prestataire renvoie la traduction modifiée. Rien ne change dans votre code : la différence, c'est qui relit la chaîne, pas la manière dont le job se comporte.
La relecture externe propose deux niveaux, selon le degré d'exactitude exigé par le contenu :
| Niveau | Idéal pour |
|---|---|
| Standard | Une traduction précise avec une touche humaine — textes marketing, chaînes d'interface, contenu d'aide |
| Pro | Les usages professionnels avec une exigence d'exactitude encore plus élevée — contenus juridiques, médicaux et réglementés |
Autant être parfaitement clair : la relecture externe implique un vrai traducteur humain de l'autre côté, avec les délais et les coûts que cela suppose. Ce n'est pas un modèle plus rapide. Utilisez-la quand le jugement humain est précisément ce que vous recherchez — textes réglementés, contenus à forts enjeux — et réservez le parcours 100 % IA à la majeure partie de vos contenus qui n'en ont pas besoin.
Délai d'expiration#
Une étape humaine introduit un risque que les étapes IA n'ont pas : l'humain peut ne jamais répondre. Le relecteur est en vacances, le prestataire a du retard, l'élément est oublié. Sans garde-fou, le job attendrait indéfiniment.
L'attente est donc bornée. Vous définissez combien de temps le workflow attend le résultat humain — le même paramètre timeoutHours s'applique aux deux modes de relecture. Si le délai expire sans réponse, l'étape est marquée skipped et le job se poursuit avec la traduction IA comme résultat final. La valeur par défaut est de 48 heures.
Il faut le dire clairement : en cas d'expiration, vous publiez la traduction IA sans relecture humaine. C'est le bon repli pour la plupart des contenus — mieux vaut une traduction publiée qu'un job bloqué indéfiniment — mais c'est un vrai compromis. Pour les contenus qui exigent impérativement une validation humaine, prévoyez un délai généreux et déclenchez une alerte en cas de saut ; pour les contenus où la relecture est un plus, un délai court permet au pipeline d'avancer.
Le délai d'expiration s'applique à l'étape, pas au job
Le délai d'expiration régit uniquement le temps pendant lequel cette étape attend une intervention humaine. Il est indépendant de la durée du reste du job. Comme l'attente est pilotée par événements, un délai long n'a qu'un seul coût si le relecteur tarde : plus de latence avant le résultat final, jamais plus de calcul en arrière-plan.
Activer l'étape#
humanEdit se configure comme toutes les étapes du pipeline : avec une valeur par défaut au niveau du moteur dans l'onglet Pipeline du moteur, éventuellement remplacée par requête. Le modèle complet à deux niveaux est détaillé dans Configurer le pipeline ; pour cette étape, cela prend la forme suivante :
{
"humanEdit": {
"enabled": true,
"provider": "internal",
"tier": "standard",
"timeoutHours": 48
}
}provider sélectionne le mode — internal pour votre équipe, le prestataire externe dans le cas contraire. tier (standard ou pro) s'applique à la relecture externe et est ignoré pour la relecture interne. timeoutHours correspond à la limite décrite dans la section ci-dessus. Pour remplacer ce paramètre sur une seule soumission, passez ce bloc dans pipelineConfig lors de l'appel de création ; si vous l'omettez, le job hérite du paramètre du moteur.
Lorsque l'étape s'exécute, elle s'enregistre sur le job sous stepId: "humanEdit" avec le statut completed, failed ou skipped — le même enregistrement d'étape que produit chaque étape. La lecture de ces enregistrements est expliquée dans Observer les exécutions du pipeline.
Une modification humaine peut s'écarter des règles de votre moteur
Un traducteur humain peut formuler quelque chose d'une manière qui entre en conflit avec votre glossaire, votre voix de marque ou vos instructions — son rôle est de bien traduire, pas de mémoriser toute votre configuration. Pour réaligner automatiquement la modification humaine sur les règles de votre moteur, activez l'étape suivante, évaluation IA. Elle ne s'exécute qu'après une étape humaine qui a effectivement produit un résultat.
