Charger des fichiers dans une conversation
Financement et utilisation de l’IA
IA incluse utilise des crédits REDA. Votre propre IA utilise le compte fournisseur de votre organisation, facturé directement par ce fournisseur. La licence définit un mode pour toute l’organisation. Dans les deux cas, REDA AI gouverne les outils et actions configurés dans Salesforce. Configurer la licence et les comptes IA.
Avec un compte client, le modèle choisi détermine les niveaux de raisonnement approfondi et les capacités disponibles. Vérifiez les niveaux et avertissements du sélecteur AI Account ; tous les fournisseurs ne prennent pas en charge les mêmes combinaisons. Les outils administratifs et le traitement documentaire utilisent la connexion par défaut de l’organisation. Configurer le choix par défaut et tester le parcours.
Cette page traite du chargement de fichiers à l’initiative de l’utilisateur, lorsqu’il joint un fichier dans une conversation. Pour le traitement plus général des fichiers reçus par e-mail, Flow, API ou messagerie, notamment le circuit de traitement, la transmission des fichiers volumineux et les trois modes de raccordement, consultez Traitement des documents.
Qu’est-ce que le chargement de fichiers ?
Cette fonctionnalité permet de joindre des documents, images, feuilles de calcul et fichiers de données aux conversations. L’agent peut alors :
- Répondre à des questions sur leur contenu
- Résumer des documents et extraire les informations importantes
- Importer des données CSV dans des enregistrements Salesforce
- Analyser des images et captures d’écran
- Associer les fichiers chargés à des enregistrements Salesforce
Types de fichiers pris en charge
| Type de fichier | Extensions | Capacités de l’agent |
|---|---|---|
.pdf |
Lire et résumer des documents, extraire des données et répondre à des questions sur leur contenu | |
| CSV | .csv |
Lire des tableaux, répondre à des questions et importer les lignes sous forme d’enregistrements Salesforce |
| Images | .png, .jpg, .jpeg |
Analyser des images, lire le texte de captures d’écran et décrire leur contenu visuel |
| Texte | .txt |
Lire et analyser du texte brut |
| JSON | .json |
Interpréter et analyser des données structurées |
La liste des extensions autorisées se configure dans les paramètres de la plateforme. Consultez Configuration ci-dessous.
Activer le chargement de fichiers
-
Ouvrez la définition de l’agent
Ouvrez l’enregistrement Définition de l'agent.
-
Vérifiez Autoriser le téléchargement de fichiers
La case Autoriser le téléchargement de fichiers est activée par défaut sur les nouveaux agents. Vérifiez qu’elle est cochée pour permettre de joindre des fichiers.
-
Renseignez Types de fichiers pris en charge, si nécessaire
Pour limiter les outils de traitement de fichiers de cet agent, renseignez Types de fichiers pris en charge avec leurs noms développeurs séparés par des virgules. Laissez vide pour autoriser tous ces outils, sous réserve de leurs autres critères de disponibilité. Ce champ n’accepte pas une liste d’extensions ; celles-ci sont configurées dans Extensions de fichiers autorisées au niveau de la plateforme.
-
Activez l’exécution automatique des actions sur fichiers, si nécessaire
Cochez Actions de fichiers à exécution automati pour permettre à l’agent d’agir automatiquement sur les fichiers, par exemple en important un CSV, sans demander de confirmation préalable.
Comment les utilisateurs joignent des fichiers
Dans la conversation du canal interne, cliquez sur l’icône de pièce jointe près de la zone de saisie pour sélectionner un ou plusieurs fichiers, jusqu’à 5 par message. Chaque fichier apparaît sous forme de pastille portant son nom et peut être retiré individuellement avant l’envoi. Les fichiers sont chargés dans Salesforce sous forme d’enregistrements ContentVersion, puis leur contenu est traité par l’agent.
Les navigateurs compatibles permettent aussi de glisser-déposer les fichiers dans la conversation.
Widget du portail de communauté. Les utilisateurs connectés à un portail Experience Cloud procèdent de la même manière : un bouton trombone dans la barre de message permet de joindre jusqu’à 5 fichiers par message. Chaque pièce jointe apparaît avec son nom sur le message envoyé. Les fichiers du portail sont automatiquement associés au Contact du client connecté, afin que votre équipe puisse les retrouver depuis sa fiche. Le bouton trombone apparaît uniquement si Autoriser le téléchargement de fichiers est activé pour l’agent.
- L’utilisateur charge
tenants.csvet saisit : « Importez ces locataires comme contacts. » - L’agent lit le CSV, repère les en-têtes de colonnes et les associe aux champs de Contact.
- L’agent crée un contact par ligne, avec confirmation lorsque le canal la prévoit et que l’exécution automatique n’est pas activée.
- L’agent annonce le résultat, notamment le nombre d’enregistrements créés avec succès.
Associer un fichier à un enregistrement
Lorsque l’outil link_file_to_record est accessible à l’agent, celui-ci peut associer les fichiers chargés à des enregistrements Salesforce. Par exemple, un utilisateur peut joindre une facture PDF et demander son association à un compte ou une opportunité précis.
Dans le portail de communauté, un fichier chargé est automatiquement associé au contact du client. L’assistant peut également l’associer à un autre enregistrement lié, sur demande, par exemple une requête qu’il crée pour ce client. Limitez l’agent du portail aux propres données du client — contact, compte ou requêtes — pour qu’il ne puisse agir que sur celles-ci.
Configuration
Le chargement de fichiers se configure dans Paramètres de la plateforme, dans le panneau d’administration REDA AI :
| Paramètre | Valeur par défaut | Plage | Description |
|---|---|---|---|
| Taille maximale du fichier (Mo) | 5 | 1 à 25 | Taille maximale autorisée pour un fichier chargé. Les fichiers plus volumineux sont refusés. |
| Extensions de fichiers autorisées | pdf,csv,png,jpg,jpeg,txt,json |
— | Liste des extensions autorisées, séparées par des virgules. Les autres extensions sont refusées. |
| Nombre maximal de caractères CSV | 50 000 | 10 000 à 200 000 | Nombre maximal de caractères du contenu CSV. Un dépassement provoque une erreur. |
| Multiplicateur de crédit pour le traitement des fichiers | Configurable | — | Augmente la limite de jetons de sortie pour les demandes de traitement de fichiers. Une valeur plus élevée permet une analyse plus détaillée, avec un coût supérieur en crédits. |
Paramètres de la définition de l’agent
Chaque définition d’agent possède les paramètres suivants :
| Champ | Valeur par défaut | Description |
|---|---|---|
| Autoriser le téléchargement de fichiers | Activé | Active ou désactive le chargement de fichiers pour cet agent |
| Types de fichiers pris en charge | Vide : aucune restriction par cette liste d’outils | Noms développeurs des outils de traitement de fichiers autorisés, séparés par des virgules ; ce champ ne remplace pas la liste globale des extensions |
| Actions de fichiers à exécution automati | Désactivé | Autorise l’agent à agir immédiatement sur les fichiers sans demander de confirmation |
Effet sur les crédits
Les fichiers augmentent le nombre de jetons d’entrée, car leur contenu est transmis à l’IA pour traitement. Plus ils sont volumineux, plus ils consomment de jetons et donc de crédits.
- Texte et CSV : le nombre de jetons est proportionnel au nombre de caractères.
- PDF et images : leur traitement multimodal consomme davantage de jetons par unité de contenu.
- Multiplicateur : Multiplicateur de crédit pour le traitement des fichiers augmente le budget de jetons de sortie des réponses liées aux fichiers pour permettre une analyse plus détaillée.
Pour un CSV volumineux, envisagez de le diviser en lots plus petits avant de le charger. Nombre maximal de caractères CSV évite qu’un fichier excessivement long consomme trop de crédits dans une seule requête.
Bonnes pratiques
Définissez des tailles adaptées : la limite de 5 Mo par défaut convient à la plupart des documents. Augmentez-la uniquement si des fichiers plus volumineux sont régulièrement nécessaires.
Limitez les extensions nécessaires : configurez Extensions de fichiers autorisées dans les paramètres de la plateforme, en tenant compte de tous les agents concernés. Le champ d’agent Types de fichiers pris en charge concerne les outils de traitement, pas les extensions.
Utilisez l’exécution automatique avec prudence : Actions de fichiers à exécution automati évite la confirmation pour les actions liées aux fichiers, comme les imports CSV. Activez-le uniquement pour des agents internes de confiance dont les utilisateurs comprennent les conséquences.
Rendez link_file_to_record accessible : pour permettre les associations de fichiers aux enregistrements, vérifiez que l’agent dispose de link_file_to_record.
Questions fréquentes
Oui. L’assistant dans Salesforce et le widget de communauté acceptent jusqu’à 5 fichiers par message. Chaque fichier apparaît séparément et peut être retiré avant l’envoi ; l’agent les reçoit et les traite ensemble. Au-delà de 5, envoyez les fichiers supplémentaires dans un autre message de la même conversation.
Oui. Lorsque Autoriser le téléchargement de fichiers est activé, le widget de communauté affiche un trombone. Les fichiers du client sont automatiquement associés à son Contact. Sur demande, l’assistant peut aussi les associer à un enregistrement lié, comme une requête qu’il crée.
Oui. L’action invocable REDA AI accepte plusieurs fichiers dans un même appel. Un flux automatisé peut donc transmettre plusieurs documents à la fois à l’assistant.
Ils sont stockés comme enregistrements Salesforce ContentVersion, selon le stockage standard des fichiers Salesforce. Ils sont décomptés des limites de stockage de fichiers de l’organisation.
Oui. Si l’utilisateur charge un CSV et demande son import, l’agent lit les données, associe les colonnes aux champs Salesforce et crée les enregistrements. Sur le canal interne, il demande une confirmation avant la création, sauf si Actions de fichiers à exécution automati est activé. Les autres canaux suivent leur propre comportement de confirmation.
Le chargement est refusé. Un message indique à l’utilisateur la taille maximale autorisée. Le fichier n’est pas traité.
Cette disponibilité dépend du canal et de la configuration de l’agent. Le paramètre Autoriser le téléchargement de fichiers dans la définition de l’agent contrôle l’autorisation pour chaque agent.
Les extensions autorisées sont configurables dans les paramètres de la plateforme. Cependant, l’agent ne traite nativement que les formats pris en charge : PDF, CSV, PNG, JPG, TXT et JSON. Ajouter une extension non prise en charge autorise le chargement, sans garantir que l’agent puisse lire son contenu.
Prochaines étapes
Consultez Configurer les outils pour gérer les capacités accessibles aux agents, ou Comprendre les crédits pour connaître le coût du traitement des fichiers.