Ce guide explique comment activer et utiliser la prise en charge native des pièces jointes PDF et documents lors des interactions avec les bots IA dans Discourse. Les utilisateurs peuvent téléverser des PDF et autres documents directement dans les conversations avec les agents IA.
Niveau d’utilisateur requis : Administrateur
Résumé
Discourse AI prend désormais en charge la gestion native des pièces jointes, permettant aux utilisateurs de téléverser des PDF et d’autres types de documents directement lors des conversations avec les bots IA. L’IA peut lire et comprendre le contenu de ces pièces jointes, ce qui permet des cas d’usage tels que l’analyse de documents, la synthèse et les réponses aux questions basées sur les fichiers téléversés.
Cette fonctionnalité requiert :
- Des types de pièces jointes autorisés configurés sur le LLM
- Un agent avec la vision activée (cela contrôle si les téléversements sont inclus dans les messages)
- Que l’extension de fichier soit autorisée dans les paramètres de téléversement de votre site
Fournisseurs pris en charge
La prise en charge native des pièces jointes fonctionne avec les modèles des fournisseurs suivants :
- Anthropic (modèles Claude)
- AWS Bedrock (modèles Claude via Bedrock)
- Google (modèles Gemini)
- OpenAI (modèles GPT)
- Azure (modèles compatibles OpenAI)
- OpenRouter (modèles compatibles OpenAI)
Chaque fournisseur gère les pièces jointes différemment au niveau de l’API, mais Discourse AI gère cela automatiquement. Gardez à l’esprit que différents fournisseurs proposent des niveaux de support différents pour divers types de pièces jointes.
Types de pièces jointes pris en charge
Les types de documents suivants peuvent être configurés pour le traitement par l’IA :
| Type | Extensions |
|---|---|
pdf |
|
| Texte brut | txt |
| Microsoft Word | doc, docx |
| Format enrichi (RTF) | rtf |
| HTML | html, htm |
| Markdown | md, markdown |
Les images sont gérées séparément via le paramètre « Vision activée » et ne nécessitent pas de configuration des types de pièces jointes.
Configuration
Étape 1 : Autoriser les extensions de fichiers pour le téléversement
Avant que les utilisateurs puissent téléverser des pièces jointes, assurez-vous que les extensions de fichiers sont autorisées dans les paramètres de votre site.
- Accédez à Admin → Fichiers
- Trouvez le paramètre
authorized extensions(extensions autorisées) - Ajoutez les extensions que vous souhaitez autoriser (ex. :
pdf|txt|docx)
Étape 2 : Configurer le modèle LLM
- Accédez à Admin → Plugins → Discourse AI → LLMs
- Sélectionnez le modèle LLM que vous souhaitez configurer (ou créez-en un nouveau)
- Dans le champ Allowed attachments (Pièces jointes autorisées), sélectionnez ou saisissez les extensions de fichiers que vous souhaitez que le modèle accepte (ex. :
pdf,txt,docx)
Si vous laissez le champ « Pièces jointes autorisées » vide, les pièces jointes de documents seront désactivées pour ce modèle. Les images sont contrôlées séparément via le commutateur « Vision activée ».
Étape 3 : Configurer l’agent
- Accédez à Admin → Plugins → Discourse AI → Agents
- Sélectionnez ou créez un agent
- Assurez-vous que Vision activée est activé — cela contrôle si les téléversements (images et documents) sont inclus dans les messages envoyés au LLM
- Définissez le Modèle par défaut sur un LLM configuré pour accepter les pièces jointes
Comment cela fonctionne
Lorsqu’un utilisateur téléverse un document dans une conversation avec un bot IA :
- Le document est téléversé dans Discourse en utilisant la gestion standard des téléversements
- Discourse AI encode le contenu du document (base64)
- Le contenu encodé est envoyé au LLM avec le message de l’utilisateur
- Le LLM traite à la fois le message texte et le contenu du document
- L’IA répond en se basant sur le contexte combiné
Détails techniques
- Les documents sont encodés en base64 et envoyés en ligne dans la requête
- Chaque fournisseur reçoit les pièces jointes dans son format natif :
- Anthropic : Utilise le type
documentavec une source base64 - Gemini : Utilise le format
inlineData - OpenAI (API Chat Completions) : Utilise le type
fileavecfile_datacontenant le contenu base64 - OpenAI (API Responses) : Utilise le type
input_fileavecfile_datacontenant le contenu base64
- Anthropic : Utilise le type
- Les limites de taille de fichier sont régies par le paramètre de votre site
max attachment size kb(taille maximale des pièces jointes en Ko)
Cas d’usage
La prise en charge native des pièces jointes permet plusieurs flux de travail :
- Analyse de documents : Téléversez des contrats, des rapports ou des articles de recherche pour que l’IA les synthétise ou réponde à des questions à leur sujet
- Revue de contenu : Demandez à l’IA de vérifier et fournir des retours sur des documents en cours de rédaction
- Extraction de données : Extrayez des informations spécifiques à partir de documents téléversés
- Assistance à la traduction : Téléversez des documents dans une langue et discutez de leur contenu ou demandez des traductions
- Support technique : Les utilisateurs peuvent téléverser des fichiers journaux (logs) ou des fichiers de configuration pour obtenir une aide au débogage
Limites
- Taille de fichier : Les pièces jointes sont limitées par les paramètres de taille de téléversement de votre site et par le fournisseur de LLM
- Support du fournisseur : La prise en charge des pièces jointes nécessite un dialecte de fournisseur capable de gérer les documents (Anthropic, AWS Bedrock, Google, OpenAI, Azure et OpenRouter)
- Exigence de vision de l’agent : L’agent doit avoir « Vision activée » activé pour que les téléversements soient inclus dans les messages
- Correspondance des extensions : L’extension du fichier doit être à la fois autorisée pour le téléversement sur votre site et permise dans la configuration des types de pièces jointes du LLM
- Résultats variables : Étant donné que les fournisseurs de LLM et les LLM traitent les fichiers, le coût/la précision et les résultats varieront. Anthropic a tendance à utiliser plus de tokens pour l’analyse qu’OpenAI ou Google.
- Activez la mise en cache : Pour OpenAI, assurez-vous d’utiliser l’API Responses qui offre un support plus cohérent de la mise en cache (lorsque la réflexion est activée) ; pour les modèles Anthropic, vous devrez peut-être activer explicitement la mise en cache dans la configuration du LLM. Cela peut être particulièrement important lors de conversations multi-tours.
Dépannage
Les pièces jointes ne sont pas traitées
- Vérifiez que l’extension de fichier figure dans le paramètre
authorized extensions(extensions autorisées) de votre site - Confirmez que le type de fichier est répertorié dans le paramètre « Pièces jointes autorisées » du LLM
- Assurez-vous que l’agent a « Vision activée » activé et utilise un LLM correctement configuré
Le téléversement échoue
- Vérifiez votre paramètre
max attachment size kb(taille maximale des pièces jointes en Ko) - Vérifiez que l’extension de fichier est autorisée
- Les très grands fichiers PDF peuvent ne pas être pris en charge ; chaque fournisseur de LLM a des tailles maximales de téléversement différentes.
L’IA ne comprend pas le document
- Assurez-vous que vous utilisez un modèle qui prend en charge la compréhension des documents
- Essayez un modèle plus performant (ex. : Claude Sonnet 4.5, GPT-5.1, Gemini Pro 3)
FAQ
Les utilisateurs peuvent-ils téléverser plusieurs documents dans un seul message ?
Oui, les utilisateurs peuvent inclure plusieurs pièces jointes dans un seul message, et l’IA y aura accès toutes.
Cela fonctionne-t-il aussi dans le chat que dans les messages privés ?
Oui, la prise en charge des pièces jointes fonctionne à la fois dans les messages privés avec les bots IA et dans les messages directs du chat, à condition que l’agent soit configuré pour ces méthodes d’interaction.
Cela est-il différent des téléversements RAG sur les agents ?
Oui. Les téléversements RAG sont des documents ajoutés par les administrateurs à la base de connaissances d’un agent, qui sont indexés et recherchés. La prise en charge native des pièces jointes permet aux utilisateurs finaux de téléverser des documents pendant les conversations pour une analyse immédiate sans indexation.
Que deviennent les documents téléversés ?
Les documents sont traités conformément à la gestion standard des téléversements et aux politiques de rétention de votre site. Ils sont stockés en tant que téléversements Discourse réguliers.