Résoudre les problèmes de traitement des documents
Où apparaissent les erreurs
En cas de problème de traitement, le message peut apparaître à trois endroits :
- Dans la réponse de l’agent, lorsque l’utilisateur peut intervenir : fichier trop volumineux, type non autorisé ou fichier introuvable.
- Dans la transcription de la conversation : dans la réponse de l’agent et dans le résultat structuré de l’outil éventuellement appelé.
- Dans un journal d’incidents, lorsque la plateforme a enregistré un échec nécessitant une investigation. Voir Journaux d’incidents d’IA.
Si l’incident n’est pas suffisamment explicite, lancez Déboguer avec l’IA depuis son enregistrement pour obtenir une explication et des pistes de correction à vérifier.
Messages visibles par l’utilisateur
« Fichier introuvable ou accès refusé. »
La plateforme n’a pas pu ouvrir le fichier indiqué. Celui-ci peut avoir été supprimé ou ne pas être accessible dans le contexte d’exécution.
À vérifier :
- L’utilisateur peut-il ouvrir directement le fichier dans Salesforce ? Cet essai permet de vérifier son accès ; les étapes de lecture standard du fichier contrôlent les autorisations de l’utilisateur d’exécution.
- Le fichier a-t-il été joint à la bonne conversation ? Il arrive qu’une référence pointe vers un fichier d’une autre conversation.
- Pour une exécution déclenchée par courriel, le message entrant a-t-il effectivement créé un fichier Salesforce ? Consultez le dépannage du canal e-mail ci-dessous.
« Impossible d'accéder au fichier. Veuillez vérifier les autorisations. »
Une requête d’accès au fichier a échoué. Les autorisations sur les objets ou les champs et le partage font partie des causes possibles ; ce message seul ne prouve pas qu’il s’agit uniquement de sécurité au niveau des champs.
À vérifier : les droits effectifs de lecture du fichier pour l’utilisateur d’exécution, y compris ses ensembles d’autorisations et son profil. Consultez le journal d’incidents correspondant, s’il existe, pour identifier l’erreur technique.
« Échec du chargement du fichier : … »
Le fichier n’a pas pu être enregistré dans Salesforce. Le texte après les deux-points décrit l’erreur sous-jacente.
À vérifier :
- Le texte après les deux-points indique la cause à examiner : par exemple une validation à l’enregistrement, une limite de stockage de l’organisation ou un type de fichier refusé.
- La consommation du stockage de fichiers de l’organisation si le message indique un espace insuffisant.
« Le nom et le contenu du fichier sont obligatoires. »
Une tentative de création de fichier ne fournit pas à la fois son nom et son contenu. Ce message concerne généralement une intégration personnalisée qui appelle incorrectement l’étape d’importation. Vérifiez le code ou le Flow appelant.
« Impossible de récupérer l'URL de distribution du fichier. »
La plateforme n’a pas pu récupérer le lien de distribution utilisé pour permettre au fournisseur du modèle de lire un fichier volumineux. Ce message concerne la récupération du lien et ne démontre pas, à lui seul, que sa création a échoué.
À vérifier :
- Les autorisations nécessaires à la création et à la lecture des distributions de fichiers Salesforce, dans le contexte d’exécution concerné.
- L’activation des distributions de contenu dans l’organisation et l’existence du lien attendu. Ce lien permet un accès externe au contenu : appliquez les règles de partage de votre organisation et vérifiez sa révocation. Un traitement qui exige ce lien ne peut pas aboutir sans lui ; utilisez un fichier plus petit si le parcours synchrone le permet.
Messages d’un outil de mappage de fichiers
Ces messages apparaissent dans la réponse de l’agent et dans le résultat de l’outil sur le message de conversation. Pour les imports en arrière-plan, consultez également l’action programmée créée pour l’import.
« Paramètres obligatoires manquants : file_content_version_id, target_object et field_mapping sont requis. »
L’appel ne fournit pas les éléments attendus. Le fichier est fourni à l’exécution ; l’objet cible, l’opération, le mappage et la clé de correspondance des mises à jour sont configurés dans l’outil. Vérifiez ces éléments dans le générateur d’outils, notamment « Colonne CSV → Champ Salesforce » et « Clé du match ». Voir Outils de mappage de fichiers.
« Le fichier CSV ne contient aucune ligne de données. »
Le CSV ne contient aucune ligne exploitable : il peut être vide ou ne contenir que les en-têtes. Vérifiez que l’utilisateur a joint le bon fichier et non un modèle vierge.
« Échec de l'importation du fichier : … »
Une exception a interrompu l’import. Le texte après les deux-points décrit l’erreur. Ne supposez pas que toutes les modifications précédentes ont été annulées : vérifiez les résultats avant de relancer. Parmi les causes à examiner :
- Les règles de validation de l’objet cible et les valeurs du fichier.
- Les droits d’écriture sur les champs du mappage.
- Pour les mises à jour, une clé absente, vide ou mal configurée. Vérifiez aussi son unicité : le traitement en ligne peut sélectionner une première correspondance, tandis qu’un import par lots avec clé externe peut créer les lignes sans correspondance. Ne supposez pas que les deux parcours rejettent toujours les doublons ou n’effectuent que des mises à jour.
« Importation des enregistrements X de Y dans Objet. »
Résumé de l’import en ligne : X lignes ont réussi. Si X est inférieur à Y, les autres ont échoué. Le résultat de l’outil contient un échantillon des erreurs par ligne, qui peut être limité. Identifiez les lignes effectivement enregistrées, corrigez les échecs et relancez uniquement les lignes nécessaires pour éviter les doublons.
« Enregistrements X importés. Erreurs Y. »
Ce résumé concerne un import par lots en arrière-plan. Y peut être nul ; sinon, certaines lignes ont échoué. Consultez le résultat de l’action programmée et les erreurs disponibles. Voir Actions programmées.
« Importation du fichier X lignes vers Objet en cours. Traitement en arrière-plan. Action planifiée : <id> »
Ce n’est pas une erreur : l’import a été lancé en arrière-plan. Le message ne prouve pas qu’il est terminé ni qu’il réussira. Ouvrez l’action programmée indiquée pour suivre son résultat avant de lancer une nouvelle importation.
Symptômes sans message d’erreur précis
L’agent ignore le fichier ou indique ne pas pouvoir l’utiliser
- Le champ Autoriser le téléchargement de fichiers peut être désactivé sur l’agent. Ouvrez sa définition et activez cette option si les pièces jointes sont prévues dans votre usage.
- L’extension peut être absente du paramètre de plateforme Extensions de fichiers autorisées.
- Le fichier peut dépasser la Taille maximale du fichier (Mo).
- Pour un CSV, le contenu peut dépasser le Nombre maximal de caractères CSV.
- L’agent peut ne disposer d’aucun outil adapté à l’action demandée sur les données du fichier. La lecture ou le résumé du contenu et la création d’enregistrements Salesforce sont des capacités distinctes. Voir Traitement des documents.
Les fichiers arrivent dans Salesforce mais pas jusqu’à l’agent
Le canal de courriel entrant peut écarter des pièces jointes lors du filtrage :
- Les pièces jointes très petites peuvent être considérées comme des logos ou des signatures.
- Les extensions absentes de la liste autorisée peuvent être refusées.
Ne supposez pas que chaque fichier filtré produit un incident. Vérifiez également le courriel, les fichiers enregistrés et la configuration du canal. Voir Résoudre les problèmes du canal e-mail.
Une demande contenant un fichier volumineux semble bloquée
Certains fichiers nécessitent un traitement de l’agent en arrière-plan. La réponse est ajoutée à la conversation lorsque ce traitement aboutit. Si l’attente paraît excessive, consultez la demande asynchrone liée à la conversation et son état. Ce parcours est distinct de l’import CSV par lots suivi par une action programmée. Voir Traitement asynchrone des agents.
Procédure d’investigation
-
Lire le message exact.
Comparez le message aux cas ci-dessus pour identifier l’étape qui a échoué.
-
Ouvrir la conversation.
Examinez le message utilisateur, la pièce jointe, l’appel d’outil éventuel et son résultat brut dans la conversation. Le résultat de l’outil fournit souvent davantage de détails que la réponse de l’agent.
-
Rechercher le journal d’incidents.
Recherchez un incident correspondant à l’heure et au contexte de l’échec. Lorsqu’il existe, il peut contenir les détails techniques absents du message utilisateur.
-
Lancer Déboguer avec l’IA.
Posez des questions de suivi pour préciser les hypothèses, puis vérifiez les corrections proposées avant de les appliquer.
-
Vérifier l’aperçu d’exécution.
Si vous avez modifié la configuration de l’agent, ouvrez l’aperçu d’exécution de l’agent pour vérifier les éléments désormais chargés.
Questions fréquentes
Commencez par rechercher un message de refus lié à la taille ou à l’extension. Si l’enregistrement semble avoir réussi, vérifiez la conversation choisie, le lien du fichier et son partage : vous pouvez ne pas disposer des mêmes droits de lecture que l’utilisateur. Pour un courriel, vérifiez également le filtrage des pièces jointes.
Consultez les erreurs par ligne du résultat de l’outil ou de l’action programmée. Les validations, les autorisations, les conversions de valeurs et la clé de correspondance peuvent empêcher toutes les lignes d’aboutir. Corrigez la cause identifiée, puis testez de nouveau sur un échantillon contrôlé.
Les parcours standard de lecture et d’import contrôlent les autorisations de l’utilisateur d’exécution. Comparez les droits sur les objets et les champs, ainsi que le partage des enregistrements. Vérifiez aussi l’identité réellement utilisée par le canal ; un exécuteur Apex personnalisé doit appliquer ses propres contrôles de sécurité.
Consultez la demande asynchrone liée à la conversation. Les états API Queued et Processing indiquent une attente ou un traitement en cours. Completed indique la fin du traitement : vérifiez la réponse. Failed signale un échec : lisez l’erreur et le compteur de tentatives, sans supposer que tous les échecs résultent d’un épuisement des nouvelles tentatives. Pour un import CSV par lots, suivez plutôt l’action programmée.
Vérifiez le champ « Autoriser le téléchargement de fichiers », les restrictions de format et de taille, les instructions de l’agent et les outils nécessaires à l’action demandée. L’absence d’outil d’écriture n’empêche pas à elle seule toute lecture de fichier. Voir Joindre des fichiers.
Consultez le résultat brut de l’outil et l’éventuel journal d’incidents correspondant. Un incident peut contenir la cause sous-jacente et une trace de pile, mais tous les messages ni tous les incidents ne disposent d’une trace complète.
Étapes suivantes
Consultez Journaux d’incidents d’IA pour comprendre les enregistrements techniques, ou Résoudre les problèmes du canal e-mail pour les échecs propres aux courriels entrants et sortants.