Intégrer la relecture humaine aux tâches API

Transmettez les traductions aux évaluateurs, suivez leurs décisions et récupérez les documents finaux.

Ajoutez une relecture humaine lorsqu'une traduction nécessite le jugement d'une personne avant sa livraison. Le moteur dirige chaque document et chaque langue cible vers un groupe de décision. Les évaluateurs approuvent ou modifient les unités éligibles, puis le pipeline poursuit son exécution jusqu'à la création d'un fichier téléchargeable.

Commencez par une traduction via l'API qui fonctionne. Vous devez également disposer d'un forfait donnant accès aux fonctionnalités de relecture humaine, d'un groupe de décision et d'un évaluateur ayant accès aux traductions du moteur.

Configurer la relecture avant le démarrage #

Ouvrez l'onglet Pipeline du moteur et activez Relecture humaine. Sélectionnez un groupe de décision, les langues et, si nécessaire, les répertoires concernés. Le routage par répertoire s'appuie sur le key que vous envoyez pour chaque document ; utilisez donc des chemins stables, comme emails/order-confirmation.json.

Pour relire tout le contenu nouvellement traduit dans ce circuit, choisissez Tout : le contrôle qualité reste alors désactivé. Pour une relecture sélective, choisissez Strict, Modéré ou Souple. Le contrôle répertorie les erreurs, leur gravité et leur catégorie ; le niveau choisi détermine les degrés de gravité qui nécessitent une relecture. Toute traduction que le contrôle n'a pas pu vérifier est également soumise à une relecture. Consultez les niveaux du contrôle qualité pour connaître leurs descriptions. Les traductions réutilisées servent de contexte en lecture seule et ne deviennent pas automatiquement de nouveaux éléments à relire.

Choisissez un délai adapté à l'équipe de relecture. Il commence à courir lorsque la cible est prête. À son expiration, les unités sans réponse peuvent poursuivre le processus avec leurs traductions précédentes. Si chaque traduction publiée doit faire l'objet d'une décision humaine, le contrôle de publication de votre application doit garantir le respect de cette exigence.

Configurez le pipeline via l'API lorsque votre application prend en charge la configuration du moteur.

Soumettre le contenu #

Créez la tâche, téléversez les artefacts manquants et appelez /start. Enregistrez son ID avec la révision source et la politique de relecture prévue. La configuration du pipeline du moteur est figée au démarrage : les modifications ultérieures ne changent pas la politique de relecture de la tâche en cours.

Récupérez les ID des documents et les langues cibles de la tâche. Dans la progression des étapes de la cible, humanEdit identifie le travail de relecture, tandis que l'API de relecture fournit les unités et les décisions elles-mêmes. Une tâche peut rester à l'état Running pendant que les évaluateurs travaillent.

Fournir à l'évaluateur le contexte nécessaire #

Les évaluateurs peuvent accéder à File d'attente → Type → Relecture humaine dans le tableau de bord, où les résultats du contrôle qualité s'affichent à côté de la traduction. Ils peuvent approuver les traductions telles quelles ou les modifier avant de les soumettre. Veillez à ce que la source, la langue cible, les espaces réservés et la terminologie attendue restent visibles pour l'évaluateur.

Si votre application gère sa propre interface de relecture, listez les demandes de relecture ouvertes avec GET /v2/organizations/:orgId/localization/reviews, puis récupérez la relecture correspondant au document et à la langue sélectionnés. Authentifiez les décisions au nom de l'évaluateur à l'aide d'une clé personnelle ou d'une session utilisateur, et non de la clé d'organisation du service en arrière-plan.

Soumettez des décisions Approved ou Edited pour les unités requises. La relecture interne permet des soumissions partielles. Reprendre une relecture externe exige de soumettre en une seule fois une décision pour chaque unité requise restante, et le prestataire peut tout de même facturer sa prestation. La Référence de relecture détaille les structures exactes des données à envoyer et les erreurs.

Récupérer et valider le résultat final #

Une fois que l'évaluateur a soumis ses décisions, continuez à récupérer la tâche de localisation. Ne téléchargez la cible que lorsque son statut est Completed. La relecture et la finalisation du fichier se terminent à des moments distincts : la post-édition, la gestion de la longueur ou la rétrotraduction peuvent encore être en cours.

Si vous avez besoin de la formulation exacte approuvée par une personne, désactivez les étapes de réécriture ultérieures et examinez le résultat final. Si vous avez besoin d'une preuve d'approbation, vérifiez les décisions de relecture et les unités dont le délai a expiré. Une étape terminée ne prouve pas qu'une personne a approuvé chaque unité.

Ne publiez que si la révision source correspond toujours et si la politique de relecture requise a été respectée. Une traduction arrivée tardivement ne doit pas remplacer le résultat d'une révision source plus récente.

Reprendre après une interruption #

Conservez les identifiants d'origine de la tâche et de la relecture après l'expiration du délai côté client. Une nouvelle tâche lance un processus distinct de traduction et de relecture. Si la réponse à une décision est perdue, récupérez la relecture et vérifiez les décisions enregistrées ainsi que les ID des évaluateurs. Le même évaluateur peut soumettre à nouveau une décision identique tant que la cible accepte encore les soumissions. En revanche, une cible terminée peut renvoyer une erreur 409, même si la première soumission a réussi. Les décisions enregistrées avec succès sont définitives.

À l'échéance d'une relecture, examinez les décisions acceptées, les unités sans réponse et le fichier obtenu. Conservez le travail terminé et choisissez en connaissance de cause la suite à donner : suspendre la publication, obtenir une autre relecture ou accepter une solution de repli explicitement définie.