Analyser les fichiers

Analyser les fichiers

L’outil Analyser les fichiers permet aux Agents de traiter et de raisonner sur le contenu des fichiers à l’aide de LLM.

Pour ajouter l’outil Analyser les fichiers à votre agent, procédez comme suit :

1. Define file inputs. In the Data Manager panel, add an argument for each file input in your agent schema.

   Figure 1. Créer des arguments d'entrée de fichier

   

   L’argument d’entrée doit être explicitement référencé dans l’invite de l’utilisateur à l’aide de la syntaxe {{exampleInput}}.Les arguments d’entrée non référencés sont ignorés et peuvent affecter la note de l’agent.

   • For a single file, set the argument type to File and reference it in the user prompt. For example: "Analyze the following report and summarize the key findings: {{reportFile}}".
   • To pass multiple files, set the argument type to Array and the item type to File, then reference the argument by name in the user prompt. You can also add optional string arguments for runtime instructions. For example:

   Analyze the following report files and summarize the key findings.
   
   ## Inputs
   - Report files: {{reportFiles}}
   - Additional instructions (optional): {{analysisInstructions}}
   

   In this example, reportFiles is an Array of File argument and analysisInstructions is an optional String argument. Both must be defined in the Data Manager panel.

   

   

2. Ajoutez l’outil Analyser les fichiers à la définition de votre agent :

   1. Sélectionnez Ajouter un outil dans le panneau Outils.
   2. Dans la catégorie Outils intégrés, choisissez Analyser les fichiers.
   3. Update the tool name and description to help the agent reason better about when to use it. The name and description guide the agent's planning phase — they determine when the agent decides to call the tool, not what the tool does with the files at runtime.

   

3. Set the tool’s inputs. The tool comes preconfigured with two main inputs:

   • attachments (array): A prompt-defined input that tells the agent which files to pass to the tool. In this field, describe how the agent should use the file inputs referenced in the user prompt (for example, {{reportFiles}}). The agent automatically maps those referenced files to this input at runtime. Example: "Use the files provided in the user prompt (for example, {{reportFiles}}) as inputs for analysis."
   • analysisTask (string): A runtime instruction telling the LLM what to do with the files once the tool is invoked — for example, "Analyze these reports. Extract the report title, an executive summary, key findings ordered by importance, actionable recommendations, and the overall sentiment." This is distinct from the tool name and description, which control when the agent calls the tool. If your use case involves only one file, you can describe attachments accordingly (for example, "Use the file provided in {{reportFile}}…").

4. Exécutez l'agent avec des fichiers d'entrée.

   1. Ouvrez la fenêtre Configuration Debug  :
      1. Accédez à l'onglet Arguments du projet.
      2. Chargez vos fichiers d’entrée liés à votre argument reportFiles.
   2. Sélectionnez Enregistrer et exécutez la session de Debug.

   

5. Après avoir exécuté l'agent, inspectez la trace d'exécution dans le panneau inférieur.

The Analyze Files tool is now added to your agent and configured to process file inputs. The execution trace in the Execution Trail panel shows how each attachment was handled during the run.

Traces des pièces jointes de fichiers

Lors de l’utilisation de l’outil Analyser les fichiers, toutes les entrées et sorties de fichiers sont capturées dans le panneau Piste d’exécution dans l’onglet Historique.Le traçage fournit une visibilité détaillée sur la façon dont les pièces jointes ont été gérées lors de l'exécution de l'agent.

Pour chaque fichier, la trace affiche :

• ID : Un identifiant unique de la pièce jointe.

• Nom : nom du fichier d’origine (par exemple, 1.jpg).

• Type MIME : type de fichier détecté (par exemple, image/jpeg).

  Figure 2. L’analyse du fichier dans la piste d’exécution

  

Sélectionnez l’appel de l’outil à partir de la Trace d’exécution et naviguez vers l’onglet Fichiers pour télécharger le fichier.

Figure 3. Comment télécharger un fichier à partir des Traces

Meilleures pratiques et FAQ

Remarque :

Reportez-vous à Utilisation des fichiers pour de plus amples détails sur l'utilisation de fichiers depuis des Processes Maestro, des workflows RPA ou des exécutions d'agent autonomes.

L’outil Analyser les fichiers permet aux Agents de traiter des documents et des images à l’aide de LLM.Bien que puissant, il présente certaines limitations et comportements importants à connaître lors de la conception d'agents amenés à traiter des fichiers.

Les gros fichiers peuvent dépasser les limites de jetons

Les agents traitent les fichiers en intégrant leur contenu dans les requêtes envoyées au LLM, lesquelles sont limitées par la capacité maximale en jetons du modèle. Les fichiers PDF volumineux ou les documents numérisés peuvent échouer sans message clair ou renvoyer des erreurs vagues telles que « Une erreur s'est produite », en particulier lorsqu'ils dépassent la limite de jetons du modèle.

Pour atténuer :

• Utilisez des modèles avec une capacité de jeton supérieure.
• Utilisez l'ancrage dans le contexte plutôt que l'intégration complète du fichier, en particulier pour les fichiers volumineux ou comportant plusieurs pages.
• Pré-indexez les documents et synchronisez-les avant ou pendant l'exécution de l'agent à l'aide d'outils personnalisés.

Les LLM redimensionnent les images.

Lorsque des fichiers d’image (par exemple, .jpg, .png) sont envoyés dans le cadre de l’invite LLM, la plupart des modèles les redimensionnent automatiquement. Cela peut déformer les rapports d'aspect ou perdre des données au pixel près.

Évitez les invites qui reposent sur des coordonnées exactes, des cases de limitation ou des comparaisons alignées par pixels (par exemple, les différences d’image nécessitant un positionnement x/y spécifique). Pour de plus amples informations, consultez le Guide de vision d'OpenAI pour le comportement de redimensionnement spécifique à un modèle.

Types de fichiers pris en charge

Les extensions de fichiers suivantes sont prises en charge : GIF, JPE, JPEG, PDF, PNG, WEBP.

La prise en charge du type de fichier varie selon le fournisseur LLM. Par exemple, la prise en charge des fichiers PDF peut échouer sur certains modèles Anthropic selon le nom du fichier ou l'encodage.

Handling large PDFs

Large PDFs can exceed the LLM's token budget when processed in full. Split the PDF into smaller chunks or individual pages before passing them to the agent.

File limits

Each file must not exceed 30 MB. There is no enforced limit on the number of files per request.

Conseils pour de meilleurs résultats

• Les noms de fichiers doivent être propres : Les modèles Anthropic, en particulier, rejettent les noms de fichiers contenant des caractères spéciaux ou des espaces blancs répétés.
• Limitez le nombre d'images : Certains modèles comme GPT-4o prennent en charge un maximum de 10 à 50 images par requête.