Outils intégrés

Les agents UiPath sont fournis avec des outils intégrés, des composants prédéfinis et prêts à l'emploi qui ne nécessitent aucun développement personnalisé ni configuration externe.

Analyser les pièces jointes

L'outil Analyser les pièces jointes permet aux agents de traiter et de raisonner le contenu des fichiers à l'aide de LLM.

Les types de fichiers suivants sont actuellement pris en charge : GIF, JPE, JPEG, PDF, PNG, WEBP.

Pour ajouter cet outil à votre agent, procédez comme suit :

1. Définissez les entrées de fichier. Dans le panneau Data Manager , ajoutez des arguments à votre schéma d'agent pour les entrées de fichiers. Celles-ci doivent être de type File.
   Figure 1. Création d'arguments d'entrée de fichier
   

   

   
   
2. Ajoutez l’outil Analyser les pièces jointes :
   1. Sélectionnez Ajouter un outil dans le panneau Outils.
   2. Dans la catégorie Outils intégrés , choisissez Analyser les pièces jointes.
   3. Vous pouvez éventuellement mettre à jour le nom et la description de l'outil pour aider l'agent à mieux déterminer quand l'utiliser.

3. Comprendre les entrées de l'outil L'outil est préconfiguré avec deux entrées principales :

   • attachments (tableau) : liste d'un ou plusieurs fichiers à analyser.
   • analysisTask (string) : Une invite ou une instruction décrivant la tâche. Si votre cas d'utilisation ne comprend qu'un seul fichier, vous pouvez mettre à jour la description de l'entrée pour indiquer qu'il s'agit d'une seule pièce jointe.
4. Exécutez l’agent avec des fichiers d’entrée.
   1. Ouvrez la fenêtre Configuration du débogage :
      • Accédez à l'onglet Arguments du projet .
      • Fournissez une valeur pour analysisTask, par exemple, « Comparer les deux images ».
      • Téléchargez vos fichiers d'entrée dans les champs liés à votre argument attachments .
   2. Cliquez sur Enregistrer et exécutez la session de débogage.
5. Après avoir exécuté l'agent, inspectez le traçage de l'exécution via le panneau inférieur.
   Figure 2. L'analyse de la piste d'exécution
   

   

   
   

Traçages de pièce jointe

Lors de l'utilisation de l'outil Analyser les pièces jointes , toutes les entrées et sorties de fichiers sont capturées dans le panneau Piste d'exécution , sous 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 pendant l’exécution de l’agent.

Pour chaque fichier, le traçage indique :

• ID: un identifiant unique pour la pièce jointe.
• Nom: le nom du fichier d'origine (par exemple, 1.jpg).
• Type MIME: type de fichier détecté (par exemple, image/jpeg).
• URL de téléchargement: un lien direct pour télécharger le fichier à des fins d'inspection ou de réutilisation. Les liens de téléchargement affichés dans le traçage ont actuellement une durée de mise en production de 30 minutes.

Figure 3. Traçages des pièces jointes

Meilleures pratiques et FAQ

L'outil Analyser les pièces jointes permet aux agents de traiter des documents et des images à l'aide de LLM. Bien qu'ils soient performants, il convient de tenir compte de certaines limitations et comportements importants lors de la conception d'agents centrés sur les fichiers.

Les fichiers volumineux peuvent dépasser les limites de jetons

Les agents traitent les fichiers en intégrant leur contenu dans des requêtes LLM, qui sont limitées par la limite de jetons du modèle. Les PDF volumineux ou les documents image numérisés peuvent échouer en silence ou renvoyer des erreurs vagues comme « Une erreur s'est produite », surtout lorsqu'ils dépassent le budget de jetons du modèle.

Pour atténuer :

• Utilisez des modèles avec une capacité de jeton plus élevée.

• Utilisez l’ancrage dans le contexte au lieu d’une intégration complète du fichier, en particulier pour les fichiers volumineux ou multi-pages.

• Pré-indexer les documents et les synchroniser avant ou pendant l'exécution de l'agent via des outils personnalisés.

Les LLM redimensionnent les images

Lorsque des fichiers 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 proportions ou perdre des données pixels précises.

Évitez les invites qui reposent sur des coordonnées exactes, des cadres englobants ou des comparaisons alignées sur des pixels (par ex. : différences d’images nécessitant un positionnement x/y spécifique). Pour de plus amples informations, consultez le Guide de vision d'image d'OpenAI pour un 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 des types de fichiers varie selon le fournisseur LLM. Par exemple, la prise en charge des fichiers PDF peut échouer sur certains modèles Anthropic en fonction du nom de fichier ou de l'encodage.

Conseils pour de meilleurs résultats

• Si vous travaillez avec de longs fichiers PDF, envisagez de les diviser en blocs ou en pages avant de les transmettre plus petits à l'agent.
• Les noms de fichiers doivent être propres : les modèles Anthropic, en particulier, rejettent les noms de fichiers avec des caractères spéciaux ou des espaces répétés.
• Réduire le nombre d’images : certains modèles comme GPT-4o prennent en charge un maximum de 10 à 50 images par requête.