Gestion des nœuds d'extraction

Ajoutez, configurez et supprimez des nœuds d'extraction dans UiPath Maestro Flow.

Le nœud Extraire extrait les champs structurés d'un document, tel qu'une facture, un reçu, un formulaire ou un contrat, à l'aide d'un modèle d'extraction IXP, et renvoie le résultat pour que les nœuds en aval puissent agir.

Prérequis

Avant d'ajouter un nœud d'extraction , assurez-vous que les services IXP et Document Understanding sont activés sur votre locataire. Le nœud d'extraction dépend des deux services, même lorsque vous utilisez uniquement des modèles IXP.

Ajouter un nœud d'extraction à un flux

Pour ajouter un nœud d'extraction à un flux, procédez comme suit:

1. Ouvrez votre flux dans Maestro Flow.
2. Sélectionnez Ajouter un nœud, puis Document, puis Extraire.
3. Sélectionnez l'une des options suivantes dans la palette des nœuds:
   • Extraire le document : créez un nouveau nœud et, implicitement, un nouveau modèle.
   • Dans cette solution : sélectionnez un nœud existant dans la liste déroulante.
   • Publié : sélectionnez dans la liste déroulante un modèle IXP déployé, tel qu'un modèle déployé à partir de IXP Documents complexes et non structurés ou à partir du nœud d'extraction d'un autre flux. Chaque modèle apparaît sous la forme d'un nœud individuel.

Résultat: le nœud est ajouté au canevas Flux, lié au modèle que vous avez sélectionné. À ce stade, vous pouvez connecter le nœud Extraire au nœud précédent dans votre flux.

Configuration du nœud d'extraction

Lorsque vous survolez un nœud d'extraction sur le canevas Flux, une barre d'outils s'affiche. Vous pouvez sélectionner l'une des options suivantes pour configurer le nœud:

• Modifier - Ouvre les propriétés du nœud où vous configurez les entrées, la gestion des erreurs et les paramètres avancés du nœud. Pour plus de détails, consultez la section Configuration du nœud dans Propriétés.
• Ouvrir la vue complète : ouvre l’onglet Définition , où vous configurez le modèle d’extraction et la taxonomie du nœud. Pour plus de détails, consultez la section Configuration du nœud dans Définition.

Configuration du nœud dans Propriétés

Pour configurer le nœud dans Properties (Propriétés), procédez comme suit:

1. Dans le canevas Flux, pointez sur le nœud Extraire .
2. Dans la barre d'outils qui apparaît, sélectionnez Modifier.

Résultat: les propriétés du nœud s'ouvrent dans une fenêtre. La section Propriétés au milieu contient les paramètres qui configurent le nœud Extraire . Le panneau Entrée à gauche et le panneau Sortie à droite sont disponibles pour chaque nœud dans Flux. Pour de plus amples informations, consultez les panneaux Input (Entrée) et Output (Sortie).

Propriétés

La section Propriétés contient les onglets suivants:

• Paramètres
• Gestion des erreurs
• Avancé

Paramètres

Remarque :

En cas d'erreurs de validation, un nombre s'affiche sous l'onglet Paramètres .

Pour configurer les champs dans l'onglet Paramètres , procédez comme suit:

• Entrée du fichier:

  • Fichier : le fichier à partir duquel extraire les données. Liez-le à un fichier produit plus tôt dans le flux, tel que la sortie d'un déclencheur ou d'un nœud précédent. Utilisez Insérer pour ouvrir le sélecteur de variables, où vous pouvez rechercher des variables. Le sélecteur répertorie les sorties des nœuds précédents sous $vars et les métadonnées de flux, telles que FolderKey, InstanceId et ProcessKey, sous $metadata.

  • Plage de pages : vous pouvez ajouter les pages au traitement, par exemple 1-5. Laissez ce champ vide pour traiter l'ensemble du document. Utilisez l'icône de type de valeur T dans le champ pour choisir entre:

    • Valeur fixe : saisissez directement une valeur.
    • Expression : saisissez une expression JavaScript avec IntelliSense.

    Vous pouvez également utiliser la fonction Insérer afin d'ajouter une variable.

• Définition - Résumé du modèle d’extraction du nœud:
  • Le modèle d'extraction et sa version, ainsi que les métriques d'évaluation. Un nœud qui n'a pas d'exécution d'évaluation affiche Pas encore évalué.
  • Documents annotés : le nombre de documents annotés sur le nombre total de documents.
  • Charger : charger des documents à annoter.
  • Annoter : ouvre la vue d’annotation. Cette option n’est pas disponible tant que vous n’ajoutez pas de champs à la taxonomie.
  • Exécuter l’évaluation : exécutez une évaluation du modèle d’extraction.
  • Modifier - ouvre l’onglet Définition du panneau Extraire le document . Pour plus de détails, consultez la section Configuration du nœud dans Définition.
  • Configuration du modèle : un résumé en lecture seule de la configuration du modèle: modèle d'extraction, stratégie d'extraction, prise en charge linguistique, analyse de la mise en page et attribution.
  • Taxonomie : nombre de champs dans la taxonomie. Si la taxonomie ne contient aucun champ, sélectionnez Ajouter des champs pour ouvrir l'onglet Définition avec un nouveau groupe de champs.

Gestion des erreurs

L'onglet Gestion des erreurs contient l'option Activer la gestion des erreurs . Lorsque vous l'activez, le nœud obtient une gestion de la sortie d'Error qui détecte et gère les échecs, et la sortie du nœud inclut un Object error avec le code, message, detail, category et status clés.

Avancé

L'onglet Avancé contient les paramètres suivants:

• ID : l'ID du nœud, par exemple extractDocument2. Pour le modifier, sélectionnez l'icône de modification.
• Couleur de l'icône : la couleur de l'icône du nœud sur le canevas.
• Mettre à jour la variable : attribue des valeurs aux variables lorsque le nœud s'exécute. Sélectionnez Ajouter une mise à jour des variables, puis configurez les paramètres suivants:
  • Variable - Variable à mettre à jour. Sélectionnez une variable existante ou sélectionnez Create new variable (Créer une nouvelle variable).
  • Expression - Valeur à attribuer. Utilisez Insérer pour ajouter une variable. Pour référencer une variable dans une expression, utilisez $vars.{name}.

Panneaux Input (Entrée) et Output (Sortie)

Les panneaux Input (Entrée) et Output (Sortie) sont disponibles pour chaque nœud dans Flow (Flux). Elles affichent les données du flux et vous n'y configurez pas le nœud d'extraction .

Entrée

Le panneau Input (Entrée) répertorie les nœuds précédents dans le flux. Vous pouvez afficher l'entrée dans les formats suivants:

• Schéma - Clés de sortie de chaque nœud précédent et leurs types. Pour un nouveau nœud, les clés n'ont pas de valeur.
• JSON : l'entrée au format JSON. Pour un nouveau nœud, cette vue est vide.

Sortie

Le panneau Output (Sortie) affiche la sortie de l'exécution précédente du nœud, avec les clés version, type, result, taxonomy et metadata . Si le nœud n’a pas encore été exécuté, les clés n’ont pas encore de valeurs. Vous pouvez afficher la sortie au format Schéma, JSON ou Résultat d'extraction .

La liste déroulante sélectionne la réponse renvoyée par le nœud:

• En direct : la réponse réelle du nœud.
• Simulation statique : une valeur que vous définissez et renvoyée à chaque fois.
• Généré : une réponse qu'un LLM génère de manière dynamique.

Configuration du nœud dans Définition

Pour configurer le nœud dans l'onglet Définition , procédez comme suit:

1. Dans le canevas Flux, pointez sur le nœud Extraire .
2. Dans la barre d'outils qui apparaît, sélectionnez Ouvrir la vue complète.

Résultat: le panneau Extraire le document ouvre l'onglet Définition .

L'onglet Definition (Définition) contient les sections suivantes:

• Résumé de l’évaluation : le modèle d’extraction, sa version et les métriques d’évaluation. Un nœud qui n'a pas d'exécution d'évaluation affiche Pas encore évalué. Pour plus de détails, consultez le Score de santé du nœud. La section contient également les options suivantes:

  • Documents annotés : le nombre de documents annotés sur le nombre total de documents.
  • Charger : charger des documents à annoter.
  • Annoter le document : ouvre la vue Annotation. Cette option n’est pas disponible tant que vous n’ajoutez pas de champs à la taxonomie.

• Configuration du modèle : le modèle d’extraction et ses paramètres avancés. Pour des détails, vérifiez la configuration du modèle.

• Taxonomie - Les champs que le nœud extrait de chaque document:

  • Instructions générales d'extraction : ajoutez un contexte pertinent pour l'ensemble de la taxonomie.
  • Onglet Taxonomie - Ajoutez et gérez des groupes de champs et des champs. Pour un nouveau nœud, sélectionnez Groupe de champs pour ajouter le premier groupe de champs.
  • Onglet Types de champs : ajoutez et gérez les types de champs préconfigurés et personnalisés.
  • Aperçu des documents : permet d'ouvrir un aperçu du document à côté de la taxonomie.
  • Importer/Exporter : importez ou exportez le (terme) de taxonomie. Pour de plus amples informations, consultez Importer et exporter des taxonomies.

  Pour plus de détails, consultez la section Gestion de la taxonomie.

Lorsque vous modifiez la taxonomie, assurez-vous de sélectionner Enregistrer.

Supprimer un nœud d'extraction

Pour supprimer un nœud d'extraction d'un flux, procédez comme suit:

1. Dans le canevas Flux, pointez sur le nœud Extraire .
2. Dans la barre d'outils qui apparaît, sélectionnez l'icône d'ellipse.
3. Sélectionnez Supprimer. Vous pouvez également sélectionner le nœud Extraire dans le canevas Flux et appuyer sur Retour arrière.

Résultat: le nœud Extraction est supprimé du canevas Flux.

Documentation Maestro Flows connexes

• Extraire : la référence du nœud, y compris la façon de lire le résultat de l'extraction, les champs manquants, les scores de confiance et les champs de la table.
• Traitement des documents : nœuds de traitement de documents disponibles sur le canevas Flow.