Analyser les fichiers

Analyser les fichiers joints à un agent: extraire, synthétiser ou répondre à des 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 modèle LLM pour extraire, synthétiser ou répondre à des requêtes concernant leur contenu.

Il peut s'agir de documents, d'images ou d'autres pièces jointes. L'agent décide quand appeler l'outil pendant le raisonnement, en transmettant les fichiers et une tâche, et l'outil renvoie le résultat que l'agent doit utiliser.

Quand l’utiliser

Connectez-vous à 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 à partir de ceux-ci.

Recherchez pour Analyser les fichiers les alternatives dans ces cas:

• Vous disposez d’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 de champs fixe.

Pour les autres formes de travail:

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

Ajouter l'outil à un agent

L’activité Analyser les fichiers se joint à un Agent autonome en tant qu’outil. Il ne s'exécute pas de manière autonome.

1. Ajoutez un agent autonome au canevas.
2. Dans la palette de nœuds, ouvrez la catégorie Outils d'agent et sélectionnez Analyser les fichiers. Flow ajoute le nœud d’outil à la zone de dessin.
3. Connectez l’outil au handle d’outil 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 pendant son raisonnement.

Référence de la configuration

Configurez l’outil dans la section Paramètres des fichiers d’analyse 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 l'action de l'outil, utilisée par l'agent pour décider quand l'appeler. Affinez-le pour restreindre le moment où l’agent utilise l’outil.
Pièces jointes (tableau)	Non (No)	Array of files, documents, images, or other attachments to process	Description des fichiers que l’agent transmet à l’outil. Modifiez-le pour indiquer à l’agent le type de pièces jointes à envoyer.
élément (fichier)	Non (No)	Vide	Description facultative par élément pour un fichier unique dans le tableau des pièces jointes. Laissez ce champ vide si la description au niveau du tableau est suffisante.
TâcheAnalyse (chaîne)	Oui (Yes)	Aucun (None)	Tâche, question ou instruction de traiter les fichiers. Décrivez-le en langage simple, par exemple summarize this document, extract key points ou 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 dynamique. Sélectionnez Add exemple Call (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 le comportement de l’outil.

Sortie

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

$vars.analyzeFiles1.output

Dans la plupart des flux, vous ne lisez pas directement la sortie de l’outil. L'agent utilise le résultat dans le cadre de son raisonnement et renvoie son propre résultat sur $vars.<agentNode>.output. Reportez-vous à Agent pour connaître la forme de la 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 une instruction PDF) et répond à une question à leur sujet.

1. Ajoutez un agent autonome au canevas.
2. Dans la palette, ouvrez les outils Agent et sélectionnez Analyser les fichiers.
3. Connectez l’outil au handle d’outil de l’agent.
4. Dans l’outil Analyser les fichiers, modifiez les pièces jointes 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 (chaîne) 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 la requête utilisateur de l'agent, indiquez-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