Séparer les documents avec le Split Agent dans n8n

Bonjour et bienvenue dans la PaperOffice AI Academy. Cet épisode traite du Split Agent dans n8n : un lot de documents est scanné en entrée, et des documents individuels en ressortent.

Résultat en premier : Numérisation par lots en entrée, documents en sortie

Commençons par examiner le résultat. Notre lot scanné depuis le service de courrier comporte sept pages, avec une feuille séparatrice entre les deux. Le Split Agent identifie où s’arrête un document et où commence le suivant. Cinq documents sont retournés, chacun avec son type, un nom descriptif et ses pages. Voici à quoi cela ressemble dans n8n. Pour un test, je lance le workflow dans l’éditeur et j’envoie le lot de numérisation au webhook. Le workflow s’exécute désormais nœud par nœud. Le job de division est envoyé à PaperOffice, et la boucle continue de vérifier jusqu’à ce que le traitement soit terminé. Au bout de moins de quarante secondes, tout est terminé. Le nœud Pieces contient le résultat : cinq entrées, une par document. Voici les cinq documents : le bon de commande, le bon de livraison, la facture, un bulletin de service technique et un rapport d’inspection. Le bulletin de service technique comporte deux pages, qui restent groupées. Le Split Agent a détecté la feuille séparatrice à la page trois et l’a supprimée. Chaque document reçoit un nom descriptif basé sur votre règle. Chaque pièce est un PDF distinct. Voici le bulletin de service technique : les deux pages dans un seul fichier, nommé selon notre règle. Le résultat inclut le lien de téléchargement, mais celui-ci n’est valable que pour une courte durée. Voici un deuxième lot, plus difficile : six pages en trois langues. Un bon de commande en anglais, un bon de livraison en espagnol et une facture en espagnol, un avoir, une facture de fret avec une tache de café et une photo penchée d’une facture au téléphone. Le Split Agent sépare les six documents et les nomme de manière cohérente en anglais. Et voici comment nous le construisons, en quatre étapes : saisie, tâche de fractionnement, attente et pièces.

Étape 1 sur 4 : Entrée

La première étape est l’entrée : un webhook avec une authentification par en-tête qui accepte le fichier via POST. Si le fichier est manquant, le workflow répond immédiatement par une erreur claire. Et que se passe-t-il en l’absence d’un fichier ? J’envoie une requête sans pièce jointe. Le workflow emprunte le chemin court via le nœud « Fichier manquant » et répond immédiatement avec un statut 400 et un message clair. Aucun job de fractionnement n’est créé, ce qui signifie également qu’il n’y a aucun coût.

Étape 2 sur 4 : La tâche Split

La deuxième étape envoie le lot au Split Agent, avec un seul appel HTTP à l’API PaperOffice. Elle inclut le modèle de division des documents, le modèle Ultra et une règle de nommage des parties : type de document, date, expéditeur. Dans le champ du modèle, vous choisissez la portée. Basic détecte les limites et nomme les parties. Premium lit également le type de document, la date et l’expéditeur. Ultra fournit en outre le raisonnement pour chaque découpe et offre une piste d’audit. La facturation se fait par page. Deux éléments déterminent le prix : la portée et la voie de traitement. Nous avons choisi instantané, ce qui signifie un démarrage immédiat. Sans garantie de démarrage, sans SLA, cela coûte moins cher. Vous trouverez les tarifs actuels sur notre site web sous Tarifs.

Étape 3 sur 4 : En attente

Le travail s’exécute en arrière-plan. Toutes les six secondes, la boucle vérifie son état. Lorsqu’il est terminé, l’exécution se poursuit. En cas d’échec, l’exécution se termine avec un message.

Étape 4 sur 4 : Pièces

À l’étape quatre, la réponse devient une liste, avec une entrée par document. Si une feuille de séparation revient en tant qu’entité indépendante, ce nœud la filtre. Enfin, le webhook répond avec exactement cette liste. Et que se passe-t-il ensuite avec la liste ? Dans la vidéo principale sur la boîte de réception, c’est exactement là que la boucle prend le relais : chaque document est envoyé vers l’IDP Agent individuellement, est lu et classé dans un Workspace. Ainsi, la séparation devient le point de départ d’un workflow complet.

Construisez-le vous-même : Identifiants et appels depuis l’extérieur

Pour le réaliser vous-même, vous avez besoin de deux identifiants, tous deux en tant qu’authentification par en-tête dans n8n. Vous choisissez vous-même la clé pour le webhook, avec un nom d’en-tête personnalisé. Pour PaperOffice, vous utilisez une clé API issue de votre compte, sous la section API et développeurs. Elle est placée dans l’en-tête Authorization. De l’extérieur, vous appelez le workflow avec un POST vers l’URL du webhook : le fichier dans le champ file, la clé dans l’en-tête. Cela peut être un script, un autre programme ou un second workflow. Ce qui revient est la liste des documents, prête pour l’étape suivante. Trois conseils pratiques. Premièrement : vous n’avez pas besoin de feuilles séparatrices ; le Split Agent détecte les limites à partir du contenu. Deuxièmement : vous définissez la règle de nommage dans le champ d’instruction de nommage, par exemple date, expéditeur, type de document. Et troisièmement : téléchargez les pièces rapidement ou classez-les immédiatement, car les liens expirent après un court délai. C’était le Split Agent dans n8n : un webhook, un appel, une boucle et une liste. Dans PaperOffice, vous pouvez également le démarrer directement depuis la liste des documents. La vidéo principale de la boîte de réception montre comment les documents individuels continuent à partir de là. À bientôt dans la PaperOffice AI Academy.