FAQ sur les Agents

Écrit par Stanislas

Dernière mise à jour Il y a 19 jours

Obtenez des réponses aux questions courantes sur la création, la configuration, le test et le dépannage des agents IA dans Swiftask. Cette FAQ aborde les questions les plus fréquemment posées concernant le comportement des agents, l'utilisation de la base de connaissances, les réponses incohérentes et les bonnes pratiques.

Aperçu

Cette FAQ couvre les problèmes et questions courants concernant les agents, notamment comment améliorer leurs performances, pourquoi ils produisent des résultats incohérents, comment s'assurer qu'ils utilisent correctement les sources de connaissances et comment résoudre les problèmes courants. Que vous construisiez votre premier agent ou que vous affiniez un agent existant, vous trouverez ici des réponses pratiques.

Questions fréquemment posées

Pourquoi mon agent produit-il des réponses incohérentes ?

Problème : Vous posez plusieurs fois la même question à votre agent et obtenez des réponses différentes à chaque fois.

Causes :

Votre prompt système est ambigu ou manque d'instructions claires.
Vous n'avez pas défini de règles spécifiques concernant le format et le style.
L'agent utilise plusieurs modèles d'IA avec des comportements différents.
Vos documents de base de connaissances contiennent des informations contradictoires.

Solution :

Allez dans Objectifs & Instructions dans la configuration de votre agent.
Rendez votre définition de rôle plus spécifique. Au lieu de "Vous êtes un assistant utile", dites "Vous êtes un spécialiste de la documentation RH axé sur la création de descriptions de poste et de rapports de sélection."
Ajoutez une section Règles détaillée qui définit des formats de sortie exacts et des lignes directrices comportementales.
Testez plusieurs scénarios pour vérifier la cohérence.
Si l'incohérence persiste, simplifiez votre prompt et ajoutez des contraintes plus explicites.

Exemple : Au lieu de "Soyez professionnel", écrivez "Utilisez toujours un langage formel. Évitez les contractions. Structurez tous les documents avec des sections claires : Titre, Aperçu, Détails."

Mon agent n'utilise pas les sources de la base de connaissances que j'ai connectées – pourquoi ?

Problème : Vous avez ajouté des documents à la base de connaissances de votre agent, mais l'agent ne les référence pas ou fournit des réponses génériques.

Causes :

Les documents ne sont pas encore indexés ou entièrement traités.
Les noms des documents ne sont pas clairs ou non descriptifs.
Les documents sont trop volumineux ou mal organisés.
Les instructions de l'agent ne mentionnent pas explicitement l'utilisation de la base de connaissances.
Vos questions ne correspondent pas au contenu de vos documents.

Solution :

Vérifiez que les documents sont indexés : Dans la section Base de connaissances, vérifiez que tous les documents affichent le statut "Indexé et prêt".
Utilisez des noms clairs et descriptifs : Renommez les documents de "Document 1" à "Normes d'Embauche RH 2025" ou "Manuel Produit v3.2".
Organisez en documents ciblés : Au lieu d'un seul document massif, créez plusieurs documents plus petits et ciblés. Séparez "Directives de Recrutement", "Processus d'Entretien" et "Grilles Salariales".
Ajoutez des instructions explicites : Dans votre prompt système, ajoutez : "Lorsque vous répondez aux questions, recherchez toujours dans la base de connaissances connectée et citez les documents pertinents."
Testez avec des questions spécifiques : Posez des questions qui se rapportent directement au contenu de vos documents.
Supprimez les sources inutilisées : Supprimez les documents non pertinents. Trop de sources peuvent ralentir la recherche et réduire la précision.

Conseil : Après avoir ajouté des sources, testez toujours votre agent en posant des questions qui devraient référencer le nouveau contenu. Vérifiez que l'agent cite les informations correctes.

Comment rendre mon agent plus précis et fiable ?

Problème : Votre agent invente parfois des informations, fournit des réponses inexactes ou ne suit pas ses instructions.

Solution :

Étape 1 : Affinez vos instructions

Soyez aussi spécifique que possible sur ce que fait l'agent et comment il doit se comporter.
Décomposez les tâches en étapes numérotées pour créer un flux de travail logique.
Ajoutez des règles claires sur le ton, le format et la précision.

Exemple : Au lieu de "Générer des documents", écrivez : "1. Analysez la demande pour déterminer le type de document. 2. Rédigez un projet de contenu avec des sections claires. 3. Utilisez l'outil export_to_pdf pour générer le document final."

Étape 2 : Testez de manière exhaustive

N'attendez pas que votre agent soit entièrement configuré. Testez après chaque changement majeur.
Utilisez des cas de test réalistes, pas seulement des requêtes simples.
Testez les cas limites — posez des questions hors du champ de votre agent pour vérifier qu'il les gère avec élégance.
Posez la même question plusieurs fois pour vérifier la cohérence.

Étape 3 : Ajoutez des sources de connaissances pertinentes

Commencez par 2-3 documents principaux contenant les informations les plus critiques.
Testez les réponses de l'agent, puis ajoutez d'autres sources au besoin.
Gardez les documents ciblés et organisés.
Mettez à jour les sources régulièrement si votre documentation change.

Étape 4 : Configurez correctement les compétences

Assurez-vous que chaque compétence a tous les paramètres requis configurés.
Ajoutez des instructions explicites sur quand et comment utiliser chaque compétence.

Exemple : "Après avoir rédigé le document, utilisez l'outil export_to_pdf pour créer un fichier PDF pour l'utilisateur."

Étape 5 : Itérez et affinez

Après les tests, identifiez les domaines à améliorer.
Retournez à la configuration et effectuez des ajustements.
Testez à nouveau avec les mêmes questions pour vérifier les améliorations.
Répétez ce cycle jusqu'à ce que votre agent fonctionne de manière fiable.

Pourquoi mon agent utilise-t-il mal les outils (compétences) ?

Problème : Votre agent n'utilise pas les compétences/outils comme prévu, ou les utilise au mauvais moment.

Causes :

Les tâches ne mentionnent pas explicitement quand et comment utiliser les outils.
Les paramètres des outils ne sont pas correctement configurés.
L'agent ne comprend pas la séquence des opérations.

Solution :

Modifiez votre prompt système et faites en sorte que les tâches mentionnent explicitement l'utilisation des outils.
Ajoutez la séquence exacte : "Après [étape 1], utilisez [nom de l'outil] pour [action]."
Dans la section Compétences, vérifiez que tous les paramètres requis sont configurés.
Testez chaque compétence individuellement pour vous assurer qu'elle fonctionne correctement.
Ajoutez des exemples dans vos instructions : "Exemple : Après avoir créé la description de poste, utilisez l'outil export_to_pdf pour générer un PDF téléchargeable."

Exemple de prompt :Tâches : 1. Analysez la demande pour déterminer le type de document. 2. Rédigez un projet de contenu avec des sections claires. 3. Utilisez l'outil export_to_pdf pour générer le document final. 4. Fournissez le lien de téléchargement à l'utilisateur.

Pourquoi mon agent utilise-t-il parfois le LLM de secours au lieu de mon modèle principal ?

Problème : Votre agent bascule de manière inattendue vers un modèle d'IA de secours.

Causes :

Votre modèle principal est indisponible ou surchargé.
Votre espace de travail a des crédits insuffisants.
Votre plan limite l'accès à certains modèles.

Solution :

Vérifiez le solde de crédits de votre espace de travail dans le tableau de bord d'administration.
Envisagez de mettre à niveau votre plan si vous atteignez fréquemment les limites de crédits.
Surveillez l'utilisation de votre agent pour comprendre les modèles de consommation.
Si des modèles spécifiques sont indisponibles, contactez le support Swiftask.

Comment tester efficacement mon agent ?

Problème : Vous ne savez pas comment tester correctement votre agent ou quoi rechercher.

Solution : Utilisez le panneau de test :

Dans la configuration de l'agent, trouvez le panneau de test sur le côté droit.
Cliquez sur le bouton Discuter sur la carte de votre agent.
Une fenêtre de chat s'ouvre — commencez à tester immédiatement.

Évaluez ces domaines clés :

Suit-il les instructions ? Vérifiez que l'agent se comporte conformément à votre prompt système. S'il dévie, affinez vos instructions pour qu'elles soient plus spécifiques.
Utilise-t-il correctement la base de connaissances ? Posez des questions qui nécessitent des informations provenant de vos documents connectés. Vérifiez qu'il référence les bonnes sources.
Les compétences fonctionnent-elles ? Testez chaque compétence que vous avez ajoutée. Par exemple, vérifiez que l'export PDF fonctionne et que les documents sont correctement formatés.
Les réponses sont-elles cohérentes ? Posez la même question plusieurs fois ou reformulez-la. L'agent doit fournir des réponses cohérentes.
Le ton et le format sont-ils appropriés ? Vérifiez que la langue, le professionnalisme et le format de sortie correspondent à vos exigences.

Bonnes pratiques :

Testez tôt et souvent — n'attendez pas que votre agent soit entièrement configuré.
Utilisez des cas de test réalistes qui correspondent aux questions réelles des utilisateurs.
Testez les cas limites — posez des questions hors du champ d'application de votre agent.
Documentez ce qui fonctionne pour comprendre les points forts de votre agent.
Conservez des notes de test pour suivre les améliorations au fil du temps.

Puis-je utiliser la même base de connaissances avec plusieurs agents ?

Oui. Vous pouvez connecter les mêmes documents à plusieurs agents. C'est utile pour :

Créer des agents spécifiques à un département qui accèdent tous aux politiques de l'entreprise.
Construire des agents spécialisés qui partagent une base de connaissances commune.
Assurer la cohérence entre les agents de votre équipe.

Conseil : Utilisez des noms de documents descriptifs pour pouvoir facilement identifier quelles sources sont utilisées par quels agents.

Comment réparer la base de connaissances de mon agent si les documents ne sont pas trouvés ?

Problème : Votre agent ne trouve pas d'informations même si elles sont dans votre base de connaissances.

Solution :

Vérifiez le statut des documents : Assurez-vous que les documents sont entièrement indexés (affiche "Indexé et prêt").
Utilisez une structure claire : Organisez le contenu avec des titres, des puces et des listes numérotées. Le contenu structuré est plus facile à analyser pour les agents.
Gardez les documents ciblés : Au lieu d'un seul document massif, utilisez plusieurs documents plus petits et ciblés.
Vérifiez les noms des documents : Utilisez des noms descriptifs comme "FAQ Produit 2025" au lieu de "Document 1".
Mettez à jour régulièrement : Si la documentation change, mettez à jour ou remplacez immédiatement les sources de la base de connaissances.
Supprimez les sources non pertinentes : Supprimez les sources qui ne sont plus pertinentes. Trop de sources peuvent réduire la précision de la recherche.
Testez après les changements : Testez toujours votre agent après avoir ajouté ou mis à jour des sources.

Quelle est la différence entre créer un agent à partir de zéro et à partir d'un modèle ?

À partir d'un modèle :

Configuration plus rapide — objectifs, instructions, et parfois compétences pré-configurés.
Bon point de départ pour les cas d'utilisation courants (support client, analyse de documents, etc.).
Vous devez toujours personnaliser le prompt système et ajouter votre base de connaissances.
Idéal pour les nouveaux utilisateurs dans la création d'agents.

À partir de zéro :

Contrôle total sur tous les aspects de votre agent.
Plus de flexibilité pour les flux de travail hautement personnalisés.
Nécessite plus de configuration mais vous donne exactement ce dont vous avez besoin.
Meilleur lorsque les modèles ne correspondent pas à votre cas d'utilisation spécifique.

Recommandation : Si vous débutez avec les agents, commencez par un modèle et personnalisez-le. Si vous avez besoin de quelque chose de très spécifique, construisez à partir de zéro.

Comment partager mon agent avec mon équipe ?

Solution :

Ouvrez votre agent.
Cliquez sur le menu d'actions de l'agent (trois points).
Sélectionnez Partager l'agent.
Choisissez les options de partage :
- Partager avec des membres spécifiques de l'équipe.
- Partager avec des groupes.
- Le rendre public (pour les utilisateurs externes).
Les membres de l'équipe verront votre agent dans leur section "Partagé avec moi".

Conseil : Testez toujours votre agent de manière approfondie avant de le partager. Vérifiez que les messages de bienvenue, les questions de démarrage et les réponses de l'agent fonctionnent comme prévu.

Que sont les questions de démarrage et pourquoi devrais-je les utiliser ?

Ce que c'est : Des questions pré-écrites présentées aux utilisateurs lors de leur première interaction avec votre agent.

Pourquoi les utiliser :

Montrent aux utilisateurs ce que votre agent peut faire.
Réduisent la friction — les utilisateurs n'ont pas à réfléchir à des questions.
Guident les conversations vers les points forts de votre agent.
Améliorent l'expérience utilisateur.

Comment les définir :

Dans la configuration de l'agent, allez dans Paramètres d'apparence.
Ajoutez 3-4 questions courantes qui représentent les principaux cas d'utilisation de votre agent.
Rendez-les spécifiques et orientées vers l'action.

Exemple : "Générez une description de poste pour un Responsable Marketing" au lieu de "Que pouvez-vous faire ?".

Comment surveiller l'utilisation et les coûts de mon agent ?

Solution :

Allez dans Administration de l'espace de travail → Tableau de bord.
Vérifiez les mesures de consommation de l'agent.
Surveillez l'utilisation des crédits par agent.
Examinez les modèles d'utilisation pour optimiser les coûts.

Bonnes pratiques :

Vérifiez l'utilisation régulièrement (hebdomadairement recommandé).
Désactivez les compétences d'agent inutiles — chaque compétence active peut consommer des crédits supplémentaires.
Utilisez la base de connaissances au lieu de pièces jointes répétées.
Commencez de nouvelles conversations lorsqu'elles deviennent trop longues (réduit la consommation de crédits par message).

Pourquoi devrais-je tester mon agent après avoir ajouté des sources de connaissances ?

Importance :

Vérifie que les documents ont été indexés correctement.
Confirme que l'agent peut trouver et référencer votre contenu.
Garantit que les réponses sont précises et correctement citées.
Identifie les lacunes dans votre base de connaissances.

Comment tester :

Posez des questions qui devraient référencer le nouveau contenu.
Vérifiez que l'agent cite les bonnes sources.
Vérifiez que les réponses sont précises.
Recherchez les informations manquantes.

Que dois-je faire si mon agent me donne des erreurs ?

Problèmes courants :

"Sources non trouvées"

Vérifiez que les documents sont indexés et accessibles.
Vérifiez que les noms des documents sont clairs et descriptifs.
Assurez-vous d'avoir connecté les sources à l'agent.

"Compétence non fonctionnelle"

Vérifiez que les paramètres de la compétence sont correctement configurés.
Vérifiez que vos instructions mentionnent explicitement quand utiliser la compétence.
Testez la compétence individuellement.

"Agent ne répond pas"

Vérifiez le solde de crédits de votre espace de travail.
Vérifiez que la configuration de l'agent est complète.
Essayez de tester dans le panneau de test.

"Réponses incohérentes"

Affinez votre prompt système pour qu'il soit plus spécifique.
Ajoutez des règles plus claires sur le format et la sortie.
Testez plusieurs scénarios.

Conseils & Bonnes pratiques

Commencez simplement : Construisez un agent de base avec des instructions claires et quelques documents. Testez de manière approfondie. Ajoutez ensuite de la complexité.

Soyez spécifique : Plus votre définition de rôle et vos instructions sont spécifiques, meilleures sont les performances de votre agent. Évitez les descriptions génériques.

Structurez le contenu : Organisez les documents de la base de connaissances avec des titres, des puces et des listes numérotées. Le contenu structuré est plus facile à analyser pour les agents.

Testez tôt et souvent : N'attendez pas que votre agent soit entièrement configuré. Testez après chaque changement majeur.

Utilisez des cas de test réalistes : Testez avec les questions réelles que poseront vos utilisateurs, pas seulement des requêtes simples.

Documentez ce qui fonctionne : Conservez des notes sur les cas de test réussis et les prompts efficaces. Cela vous aide à comprendre ce que votre agent fait bien.

Mettez à jour régulièrement : Gardez votre base de connaissances à jour. Des informations obsolètes entraînent des réponses incorrectes de l'agent.

Surveillez l'utilisation : Vérifiez régulièrement les mesures d'utilisation de votre agent pour comprendre comment les utilisateurs externes interagissent avec lui. Ajustez en fonction des modèles d'utilisation réels.

Ressources supplémentaires

Introduction aux Agents – Découvrez ce que sont les agents et comment ils fonctionnent.
Créer un agent IA étape par étape – Construisez votre premier agent personnalisé.
Définir les objectifs & instructions – Définissez le rôle et le comportement de votre agent.
Sources (base de connaissances) – Connectez des documents à votre agent.
Compétences (outils IA) – Ajoutez des capacités comme l'export de fichiers et l'e-mail.
Tester & interagir – Testez et affinez votre agent.
Partager un agent – Donnez accès à votre agent aux membres de l'équipe.

Prêt à améliorer vos agents ? Commencez par examiner les instructions de votre agent et testez-les avec des questions réalistes. Affinez en fonction des résultats, et votre agent s'améliorera à chaque itération.