Éditeur de workflow - Documentation Entity Enricher

Éditeur de workflow

La page où vous construisez un enrichissement de bout en bout : données d'échantillon, schéma, modèles, résultats. En son centre se trouve l'arbre du schéma, un éditeur visuel avec réorganisation par glisser-déposer, édition en ligne, navigation au clavier et modifications assistées par IA.

Vue d'ensemble

L'arborescence de schéma vous permet de consulter et de modifier vos schémas d'enrichissement sans écrire de JSON à la main. Les propriétés sont affichées sous forme d'arborescence interactive groupée par domaine d'expertise, ce qui vous permet de voir d'un coup d'œil quels champs relèvent de quelle spécialité. Chaque modification est suivie dans un historique annuler/rétablir et enregistrée automatiquement après un délai de 2 secondes.

Capacités clés

Regroupement par expertise

Propriétés regroupées par domaine d'expertise avec sections repliables. Activez ou désactivez le regroupement.

Glisser-déposer

Lorsque la vue Triée est désactivée, réorganisez les propriétés au sein d'un groupe ou entre les groupes par glisser-déposer — l'agencement est enregistré sur le schéma. Des indicateurs visuels de zone de dépôt montrent où les éléments seront placés.

Édition en ligne

Cliquez sur une propriété pour modifier son nom, son type, sa description et ses exemples directement dans l'arborescence.

Navigation au clavier

Les flèches pour naviguer et pour replier ou déplier, Entrée pour modifier, Suppr pour supprimer, Ctrl+A pour tout sélectionner. Annuler et rétablir sont des boutons de la barre d'outils, et l'historique est conservé même si vous changez de schéma ou rechargez la page.

Recherche et filtrage

Recherche textuelle pour trouver des champs dans les grands schémas : d’abord les noms de propriétés, puis les descriptions et les exemples lorsqu’aucun nom ne correspond. Les correspondances imbriquées ne révèlent que le chemin qui y mène.

Annuler / Rétablir

Historique complet pour les modifications manuelles. Les modifications générées par l'IA remplacent sans ajouter d'entrées d'annulation.

Types et ensembles de valeurs

Les onglets en haut contiennent les types nommés du schéma. Le bouton + crée soit un Objet (une entité imbriquée avec ses propres propriétés), soit un Enum (une liste fermée de valeurs autorisées vers laquelle vous pouvez pointer n'importe quelle propriété textuelle).

Vue diagramme

La vue DIAGRAMME, à côté de SCHÉMA et JSON, dessine le schéma sous forme de diagramme d'entités — les entités nommées sous forme de cartes avec titre, les objets imbriqués sous forme de cartes simples nommées d'après leur relation, avec les références (1–1) et les liens (1–N) en arêtes pointillées. Elle suit vos modifications en direct, et cliquer sur une carte d'entité l'ouvre dans la vue SCHÉMA.

L'arborescence des propriétés

Chaque ligne de l'éditeur représente une propriété du schéma avec ses attributs clés visibles d'un coup d'œil :

SélNom de la propriétéTypeDescription
□company_name
🔍
stringRaison sociale
□revenuenumberChiffre d'affaires annuel en USD
□headquartersobjectSiège social
□ citystringNom de la commune
□ country
🔍
stringPays où se situe le siège social
□gmp_statusbooleanStatut de certification GMP

Les propriétés imbriquées (comme city sous headquarters) sont indentées pour montrer la hiérarchie. L'icône de loupe signale les clés de recherche — les champs utilisés pour identifier l'entité.

Ensembles de valeurs (énumérations)

Un ensemble de valeurs restreint une propriété textuelle à une liste fixe de valeurs autorisées — un statut, une note, un code de classification. L'enrichissement ne peut alors rien renvoyer en dehors de cette liste, ce qui évite qu'un même concept n'arrive avec trois orthographes différentes d'une exécution à l'autre.

Utiliser les ensembles de valeurs

En créer un

Appuyez sur + dans les onglets de type, choisissez Enum, puis nommez-le. Le nouvel onglet ouvre sa liste de membres.

Modifier les membres

Ajoutez, renommez, réordonnez ou supprimez des valeurs. Ajoutez une note à un membre lorsque son sens n'est pas évident d'après son nom.

L'utiliser

Définissez le type de n'importe quelle propriété textuelle sur l'ensemble de valeurs (ou sur un tableau de celui-ci) depuis le groupe Ensembles de valeurs dans le menu déroulant de type.

Annuler

Rétablissez le type de la propriété sur string, ou supprimez l'ensemble de valeurs — les propriétés qui l'utilisent redeviennent des propriétés textuelles ordinaires.

N'utilisez un ensemble de valeurs que pour un vocabulaire que vous pouvez lister entièrement. Si une entité réelle nécessite une valeur que vous avez omise, le modèle est contraint de choisir la valeur erronée la plus proche au lieu de signaler le problème — un champ ouvert (un nom, une description, une catégorie en texte libre) doit donc rester en texte brut. La génération de schéma propose les ensembles de valeurs de façon prudente pour la même raison, et tout ce qu'elle propose est modifiable ici.

Modification des propriétés

Cliquez sur une ligne de propriété ou appuyez sur Entrée pour passer en mode édition. En mode édition, vous pouvez modifier :

NomLa clé de la propriété dans la sortie JSON. Utilisez le snake_case par souci de cohérence.
TypeChoisissez parmi string, number, integer, boolean, array ou object. Changer le type met à jour le format de sortie de l'enrichissement.
DescriptionDescription contextuelle qui guide l'IA pendant l'enrichissement. Plus de détails donnent de meilleurs résultats.
ExemplesDeux ou trois valeurs d'exemple réalistes. Elles aident l'IA à comprendre le format et le contenu attendus.
ExpertiseIndique quel expert de domaine fournit cette valeur. Détermine le regroupement dans l'enrichissement multi-expertise.
NullableIndique si une instance réelle peut réellement être dépourvue de cette valeur. Les champs non nullables sont requis pour l'admission en base de données — un enrichissement incapable de les renseigner est rejeté par le contrôle qualité. Indisponible sur une clé de base de données (une valeur null n'identifie aucune ligne) et sur un champ préservé (vos données d'entrée le fournissent toujours).
MultilingueIndique si le champ doit être enrichi dans plusieurs langues.
ConserverIndique s'il faut conserver la valeur d'entrée d'origine inchangée. Pour les valeurs qui appartiennent à votre propre système — un identifiant de base de données, un SKU interne, une référence client — et non pour les identifiants publics (CAS, ISBN, EAN, un ticker) que l'enrichissement peut rechercher pour vous. Chaque enrichissement doit alors fournir une valeur pour celle-ci.

Raccourcis clavier

L'éditeur de schéma prend en charge un flux de travail entièrement au clavier pour une édition efficace :

RaccourciAction
Arrow Up / DownNaviguer entre les propriétés (maintenez Maj pour étendre la sélection)
Arrow Left / RightReplier ou déplier l'objet sélectionné
Home / EndAller à la première ou à la dernière propriété
EnterActiver/désactiver le mode édition sur la propriété sélectionnée
Delete / BackspaceSupprimer la propriété sélectionnée
Ctrl+A / Cmd+ASélectionner toutes les propriétés
EscapeQuitter le mode édition ou effacer la sélection

Réorganisation par glisser-déposer

Le réordonnancement manuel nécessite de désactiver l'option Trié. Par défaut, l'éditeur liste les propriétés par ordre alphabétique et le glisser-déposer y est désactivé — un ordre défini à la main qu'un simple réglage d'affichage pourrait écraser en silence n'aurait guère de valeur. Décocher « Trié » bascule sur l'agencement propre au schéma et active le glisser-déposer ; une ligne d'insertion indique précisément où la propriété va se placer, et l'ordre obtenu est enregistré avec le schéma. Vous pouvez faire glisser une propriété au sein d'un groupe d'expertise ou d'un groupe à l'autre pour changer son domaine d'expertise.

Lorsque le regroupement par expertise est activé, déposer une propriété dans un autre groupe met automatiquement à jour son affectation d'expertise. La réorganisation de grands schémas devient intuitive — faites simplement glisser un champ de « Analyste financier » vers « Expert réglementaire » et son expertise est mise à jour en conséquence.

Panneau d'édition IA

Sous l'arborescence des propriétés, le panneau d'édition IA vous permet de modifier le schéma en langage naturel. Saisissez une instruction comme « ajouter une référence parent_company » et l'IA applique la modification tout en préservant votre structure existante.

Suggestions IA

Après chaque génération ou modification, l'IA propose 5 suggestions d'amélioration affichées sous forme de puces cliquables. Cliquez sur une suggestion pour remplir automatiquement le champ d'édition et l'appliquer. Les suggestions couvrent la complétude des données, la qualité, les relations, l'internationalisation et les améliorations propres au domaine.

Apprenez-en plus sur l'édition de schémas par IA dans le guide Génération de schémas par IA.

Badges d'ambiguïté

Lisez le nom d'une propriété dans le contexte de son objet parent : combien de choses distinctes pourrait-il demander ? Exactement une : c'est clair. Deux ou plus, et la propriété porte un badge ambigu — ambre lorsque les lectures se recoupent en grande partie et ne diffèrent que dans des cas limites, rouge lorsqu'elles produiraient des données sensiblement différentes. Survolez le badge pour lire les interprétations concurrentes que le nom admet, ainsi que la description réécrite qui n'en retient qu'une seule. Un nom auquel le parent n'a rien à répondre est lui aussi signalé : l'infobulle liste alors les lectures envisagées puis écartées, et la correction est un renommage ou une suppression — aucune description ne peut donner à une entité une propriété qu'elle ne possède pas.

Bouton Revérifier

L'icône de bouclier dans la barre d'outils analyse les propriétés qui n'ont pas encore d'annotation, et passe à une réanalyse complète une fois que tout est annoté. Chaque exécution est un petit appel d'IA facturé.

Ici, la correction passe par une description

Sur un schéma enregistré, le badge suggère une description réécrite, jamais un renommage : le schéma étant en production, fixer le sens dans la description laisse le contrat de données intact. Une description qui ne fait que reformuler le nom n'apporte rien, et la propriété est évaluée comme si elle n'en avait aucune.

Annotations obsolètes

Renommer une propriété ou modifier sa description supprime son annotation — le verdict portait sur les deux. L'éditeur met ces propriétés en évidence et propose une revérification.

Bascule par schéma

Désactivez la vérification d'un schéma depuis le menu de débordement — les badges et avertissements disparaissent, et la réactiver sur un schéma jamais analysé lance la vérification automatiquement.

Le fonctionnement complet — les deux verdicts, les interprétations qui les sous-tendent, et pourquoi la correction passe par un renommage avant l'existence du schéma mais par une description une fois celui-ci actif — est détaillé dans le guide Vérification d'ambiguïté.

Gestion des schémas

Le sélecteur de schémas vous permet de créer, charger, épingler, dupliquer et supprimer des schémas. Les schémas sont enregistrés par organisation et accessibles à tous les membres de l'équipe.

Enregistrement automatique

Les modifications sont enregistrées automatiquement après une pause de 2 secondes, avec déduplication par hachage du contenu pour éviter les écritures inutiles.

Épingler des schémas

Épinglez les schémas fréquemment utilisés pour les garder en haut de la liste du sélecteur.

Dupliquer

Créez une copie de n'importe quel schéma pour expérimenter des modifications sans affecter l'original.

Suppression logique

Les schémas supprimés peuvent être restaurés. La suppression définitive est une action distincte.

Prochaines étapes