Flux d'enrichissement - Documentation Entity Enricher

Flux d'enrichissement

Une présentation pas à pas du traitement d'une entité par Entity Enricher — de l'entrée à la sortie structurée, en passant par la classification et l'exécution parallèle des modèles.

Le pipeline en un coup d'œil

Entrée
JSON de l'entité
+ schéma
Classification
Vérification de type
facultative
Modèles parallèles
Claude
financier
réglementaire
général
GPT-4
financier
réglementaire
général
Valider
Vérification de type
Auto-correction
Sortie
JSON structuré
par modèle

Étape 1 : Configurer l'enrichissement

Ouvrez la page Éditeur de schéma et configurez votre enrichissement. Un assistant par étapes vous guide à travers les phases du pipeline : Données d'exemple, Schéma, Enrichissement et Résultats.

Panneau du schéma (gauche)

Collez un exemple JSON pour générer automatiquement un schéma, puis explorez l'arborescence interactive des propriétés. Modifiez les propriétés, ajoutez des domaines d'expertise et marquez les champs comme clés de recherche ou préservés.

Panneau d'enrichissement (à droite)

Configurez les options d'enrichissement (stratégie, modèles, langues, classification, ainsi que le schéma de réponse et les options de sortie structurée stricte) et renseignez les clés de recherche de l'entité (nom, site web, pays, etc.) pour identifier l'entité.

Panneau des résultats

Affiche la progression et les résultats en temps réel pour chaque modèle. Lors de l'utilisation de plusieurs modèles, un bouton « Fusionner les résultats » apparaît pour la fusion.

Étape 2 : Classification préalable (facultative)

Si vous avez sélectionné un modèle de classification, un appel LLM rapide et peu coûteux s'exécute d'abord pour vérifier que l'entité correspond au type du schéma. Cela évite de gaspiller des tokens en enrichissement lorsque l'entité ne correspond pas. En savoir plus dans la documentation sur la classification.

Non bloquant : si la classification échoue pour une raison quelconque, l'enrichissement se poursuit normalement. La classification est purement indicative — elle ajoute du contexte aux prompts d'enrichissement mais ne bloque jamais le pipeline.

Étape 3 : Exécution de la stratégie

Chaque modèle sélectionné traite l'entité selon la stratégie que vous avez choisie. Lorsque plusieurs modèles sont sélectionnés, ils s'exécutent en parallèle entre les fournisseurs (Claude et GPT-4 s'exécutent simultanément), tandis que les modèles d'un même fournisseur s'exécutent séquentiellement pour respecter les limites de débit.

Exemple multi-expertise (3 domaines)
1
Découper le schéma par expertise
Les propriétés sont regroupées par domaine d'expertise : champs financiers, champs réglementaires, champs généraux.
2
Exécuter des appels LLM en parallèle
Chaque expertise reçoit son propre prompt ciblé contenant uniquement les propriétés pertinentes du schéma. Toutes s'exécutent simultanément.
3
Fusionner les résultats progressivement
À mesure que chaque expertise se termine, sa sortie est fusionnée dans le résultat accumulé. Vous voyez les résultats partiels en temps réel.
4
Appliquer la logique de préservation
Les valeurs d'origine des champs marqués comme « preserve » sont restaurées, garantissant que vos données d'entrée restent intactes.

Étape 4 : Validation et autocorrection

Chaque réponse du LLM est validée en temps réel par rapport à votre schéma. Lorsque la sortie ne correspond pas aux types ou contraintes attendus, le système renvoie automatiquement les erreurs au LLM pour correction.

Ce qui est corrigé automatiquement :
Chaîne au lieu de nombre
"42.2" devient 42.2
Objets indexés sous forme de tableaux
{"0": "a", "1": "b"} devient ["a", "b"]
Valeurs null en chaîne
"null" ou "None" devient un véritable null
Champs obligatoires manquants
L'erreur est renvoyée, le LLM les complète

Jusqu'à 5 nouvelles tentatives automatiques par appel LLM. Chaque nouvelle tentative inclut l'erreur de validation spécifique afin que le LLM sache exactement quoi corriger.

Application de la sortie à la source

Deux options facultatives demandent au provider de contraindre la sortie avant qu'elle ne soit renvoyée, afin de réduire le nombre de réponses à corriger. Les deux ne s'appliquent qu'aux modèles qui les prennent en charge ; tout le reste repose sur la boucle de validation et de nouvelle tentative décrite ci-dessus.

Schéma de réponse
Envoie votre schéma via le canal natif de schéma de réponse du fournisseur afin que le JSON soit appliqué côté serveur. Désactivé par défaut — les modèles compatibles utilisent sinon le canal d'appel d'outil.
Sortie structurée stricte
Contraint le décodage au schéma (aucune dérive) sur le canal structuré utilisé. Activé par défaut ; ignoré silencieusement par les modèles qui ne peuvent pas l'appliquer.

Étape 5 : Streaming en temps réel

Entity Enricher utilise les Server-Sent Events (SSE) pour diffuser la progression en temps réel. Vous n'avez pas à attendre que tous les modèles aient terminé — les résultats apparaissent progressivement à mesure que chaque domaine d'expertise ou modèle se termine.

Chronologie des événements (exemple avec 2 modèles, 3 expertises)
0.0sstartedLa tâche démarre, 2 modèles en file d'attente
0.1sclassification_startedLa vérification préalable commence
0.8sclassification_completedEntité confirmée comme « match » (95 %)
0.9smodel_startedClaude et GPT-4 démarrent en parallèle
1.2sexpertise_completedClaude : financier terminé, résultat partiel diffusé
1.5sexpertise_completedClaude : général terminé, résultat mis à jour
1.8sexpertise_completedClaude : réglementaire terminé, résultat complet prêt
1.9smodel_completedClaude a terminé avec une sortie structurée complète
2.5smodel_completedGPT-4 a terminé avec une sortie structurée complète
2.5scompletedTous les modèles ont terminé, le flux se ferme

Étape 6 : Examiner les résultats

Chaque modèle dispose de son propre panneau de résultats affichant la sortie JSON structurée, les badges de progression par expertise, l'utilisation de tokens, le coût et le temps de traitement. Avec la stratégie multi-expertise, les badges d'expertise se mettent à jour en temps réel à mesure que chaque domaine se termine.

Ce que vous voyez par modèle :
  • Badge de statut — En attente, En cours, Succès, Échec ou Partiel
  • Badges d'expertise — Pastilles colorées indiquant la progression par domaine (bleu = en cours, vert = terminé, rouge = échec)
  • JSON progressif — La sortie se met à jour à la fin de chaque expertise
  • Métriques — Temps de traitement, nombre de tokens, coût en USD
  • Journal de progression — Entrées horodatées pour chaque événement

Gestion des réussites partielles

Avec la stratégie multi-expertise, certaines expertises peuvent échouer tandis que d'autres réussissent. Plutôt que de tout rejeter, Entity Enricher renvoie la sortie fusionnée des expertises réussies avec le statut « Partiel ». Vous pouvez ensuite relancer uniquement les expertises en échec sans réexécuter tout l'enrichissement.

Exemple : si 2 expertises sur 3 réussissent, vous obtenez une sortie structurée couvrant les domaines réussis. L'expertise en échec peut être relancée, et ses résultats seront fusionnés dans la sortie existante.

Que se passe-t-il ensuite ?

Une fois l'enrichissement terminé, vos résultats sont enregistrés sur la page Enregistrements pour référence ultérieure. Si vous avez utilisé plusieurs modèles, vous pouvez fusionner les résultats avec la Fusion multi-modèles.