Analyser les fichiers

Analysez les fichiers joints à un agent : extrayez, synthétisez ou répondez aux requêtes sur le contenu.

Ce qu’il fait

Analyser les fichiers est un outil intégré que vous associez à un agent autonome. Il transmet un ou plusieurs fichiers à un grand modèle de langage (LLM) pour extraire, synthétiser ou répondre aux requêtes concernant leur contenu.

Les fichiers peuvent être des documents, des images ou d'autres pièces jointes. L'agent décide quand appeler l'outil tout en raisonnant, en transmettant les fichiers et une tâche, et l'outil renvoie le résultat que l'agent doit utiliser.

Quand l’utiliser

Connectez Analyser les fichiers lorsque l'agent doit lire des types de fichiers mixtes, ou deux pièces jointes ou plus à la fois, et répondre à une question ou extraire du contenu de celles-ci.

Choisissez Analyser les fichiers plutôt que les alternatives dans ces cas :

• Vous avez un ou plusieurs fichiers de types variés (documents, images, numérisations) et souhaitez que l'agent extraie ou raisonne sur leur contenu.
• La tâche est décrite en langage naturel (« résumer ce document », « ce qu'il y a dans cette image », « extraire les points clés ») plutôt qu'un schéma fixe de champs.

Pour d'autres formes de travail :

• Pour synthétiser dans un long document (jusqu'à 1 000 pages) avec des citations, utilisez l'outil Résumer.
• Pour extraire des champs structurés et typés d'un document à l'aide d'un modèle entraîné, utilisez le nœud Extraire.

Ajout de l'outil à un agent

Analyser les fichiers s'attache à un agent autonome en tant qu'outil.Il ne s'exécute pas tout seul.

1. Ajoutez un agent autonome à la zone de dessin.
2. À partir de la palette de nœuds, ouvrez la catégorie Outils de l'agent et sélectionnez Analyser les fichiers. Flow ajoute le nœud d'outil à la zone de dessin.
3. Connectez l'outil au gestionnaire d'outils de l'agent.
4. Sélectionnez le nœud d'outil pour ouvrir son panneau Propriétés.
5. Configurez l'outil comme décrit ci-dessous.

Résultat : l'outil Analyser les fichiers est connecté à l'agent. L'agent peut désormais l'appeler tout en raisonnant.

Référence de la configuration

Configurez l'outil dans la section Paramètres d'analyse des fichiers du panneau Propriétés.

Champ	Requis	Default	Description
Description de l’outil	Non (No)	Analyze one or more files with an LLM to extract, synthesize, or answer queries about their content.	Description en langage naturel de ce que fait l'outil, utilisée par l'agent pour décider quand l'appeler. Affinez-la pour définir les conditions dans lesquelles l'agent utilise l'outil.
attachments (tableau)	Non (No)	Array of files, documents, images, or other attachments to process	Description des fichiers que l'agent transmet à l'outil. Modifiez-la pour indiquer à l'agent quel type de pièces jointes envoyer.
items (fichier)	Non (No)	Vide	Description facultative par élément pour un seul fichier dans le tableau de pièces jointes. Laissez-la vide si la description au niveau du tableau est suffisante.
analysisTask (chaîne)	Oui (Yes)	Aucun (None)	Tâche, question ou instruction pour le traitement des fichiers. Décrivez-la en termes simples, par exemple summarize this document, extract key pointsou what is in this image.
Paramètres de simulation	Non (No)	Réduite	Exemples d'appels utilisés pour tester l'outil sans invoquer le modèle en direct. Sélectionnez Ajouter un exemple d'appel pour définir un exemple.

Entrées et sorties

Entrées

L'agent fournit les fichiers et la tâche lorsqu'il appelle l'outil. La configuration ci-dessus définit ce que l'agent peut transmettre et comment l'outil se comporte.

Sortie

L'outil renvoie son résultat à l'agent qui l'a appelé. Lorsque vous devez lire la sortie de l'outil directement dans le flux, accédez-y à $vars.<nodeName>.output, où <nodeName> est le nom du nœud Analyser les fichiers sur la zone de dessin.

$vars.analyzeFiles1.output

Dans la plupart des flux, vous ne lisez pas la sortie de l'outil directement. L'agent consomme le résultat dans le cadre de son raisonnement et renvoie son propre résultat sur $vars.<agentNode>.output. Reportez-vous à la section Agent pour connaître la forme de sortie de l'agent.

Exemple

Un agent traite un e-mail entrant avec des pièces jointes mixtes (une image de reçu numérisée et un relevé PDF) et répond à une question à leur sujet.

1. Ajoutez un agent autonome à la zone de dessin.
2. À partir de la palette, ouvrez les outils de l'agent et sélectionnez Analyser les fichiers.
3. Connectez l'outil au gestionnaire d'outils de l'agent.
4. Dans l'outil Analyser les fichiers, modifiez les pièces jointes (tableau) pour décrire ce que l'agent doit envoyer, par exemple The receipt image and statement PDF attached to the incoming email.
5. Définissez analysisTask (string) sur le travail que vous souhaitez effectuer :

Read each attached file. Identify the merchant, the date, and the total amount on
the receipt, and confirm whether the statement lists a matching charge.

6. Dans l'invite utilisateur de l'agent, demandez-lui d'utiliser l'outil, par exemple : Use the Analyze Files tool to check the attachments and tell me whether the receipt matches a charge on the statement.

Lorsque l'agent s'exécute, il appelle Analyser les fichiers avec les pièces jointes, reçoit l'analyse et renvoie sa réponse sur $vars.agent1.output.content.

Pages liées

• Agent (Agent)
• Résumer
• Extraire