FAQ & dépannage

Cette page rassemble les questions les plus fréquentes sur Abra, classées par thème. Elle s’adresse aux utilisateurs comme aux administrateurs d’organisation. Chaque réponse va à l’essentiel ; quand un sujet a son guide dédié, un lien vous y renvoie pour le détail. Servez-vous de la recherche (en haut) ou parcourez les catégories ci-dessous.

Prise en main & connexion

Comment me connecter à Abra ?

Ouvrez l’URL de votre instance (du type https://abra.votre-entreprise.com, fournie par votre organisation). L’écran de connexion vous propose uniquement les méthodes activées chez vous : e-mail + mot de passe, SSO entreprise (Microsoft Entra / SAML), ou Continuer avec Google / Microsoft. Si vous avez reçu une invitation par e-mail, suivez son lien pour définir votre mot de passe. Voir la Prise en main.

Je ne sais pas quelle méthode de connexion utiliser.

C’est l’administrateur de votre organisation qui décide des méthodes disponibles. Si vous hésitez entre mot de passe et SSO, ou si aucun bouton ne vous semble correspondre à votre compte, rapprochez-vous de lui : lui seul active ou désactive chaque option.

Comment changer d’organisation ?

Si votre compte appartient à plusieurs organisations, utilisez le sélecteur d’organisation (en haut de la barre latérale ou dans le menu de votre profil) pour basculer de l’une à l’autre. Chaque organisation est totalement cloisonnée : ses agents, connecteurs et données lui sont propres et ne se mélangent jamais.

Je ne vois aucun agent, est-ce normal ?

Oui, cela arrive dans une organisation neuve. Ouvrez la Marketplace (section Catalogue) et activez un agent prêt à l’emploi : il apparaîtra aussitôt dans Agents IA. Si la Marketplace elle-même semble vide, votre administrateur n’a pas encore publié de catalogue — signalez-le lui.

Un bouton est grisé ou une section a disparu — pourquoi ?

L’interface s’adapte à vos droits. Les fonctions d’administration (gouvernance, gestion des membres, configuration des connecteurs…) sont réservées à certains rôles, et la barre latérale masque ce que vous ne pouvez pas utiliser. Ce n’est pas un bug : demandez l’accès à l’administrateur de votre organisation. Certains boutons de connecteur, par exemple, exigent des droits d’administration.

Je ne retrouve pas une page (Gestion, Gouvernance LLM, Studio…).

Ces entrées n’apparaissent que pour les rôles manager ou administrateur. Si vous êtes membre standard, c’est parfaitement normal de ne pas les voir.

Agents

Comment créer un agent ?

Ouvrez Agents IA puis Créer un agent. Vous lui donnez une identité (nom, description), écrivez ses instructions (le prompt système : son rôle, son ton, ses garde-fous), choisissez un modèle, et lui branchez au besoin des outils et une base de connaissances. Testez dans le chat, ajustez, enregistrez. Le pas-à-pas complet est dans Créer un agent.

Qui a le droit de créer un agent ?

Les rôles Développeur, Manager et Administrateur. Un membre standard ne voit pas le constructeur. Si l’entrée Créer un agent n’apparaît pas, votre rôle actuel ne le permet pas — demandez les droits à votre administrateur.

C’est quoi le « prompt système » et pourquoi est-il si important ?

C’est le mode d’emploi permanent de l’agent, épinglé en tête de chaque conversation. Il transforme un modèle générique en votre assistant spécialisé. Structurez-le en quatre blocs : rôle, mission et comportement, ton, garde-fous. C’est l’étape qui fait l’essentiel de la qualité — écrivez une première version, testez, ajustez. Détails et exemple dans Créer un agent.

Le modèle que je veux n’apparaît pas dans la liste.

La liste des modèles est cadrée par votre administrateur : ce ne sont pas tous les modèles qui existent, mais ceux qu’il a autorisés pour maîtriser coûts, conformité et confidentialité. Un modèle absent n’a simplement pas été ouvert. Rapprochez-vous de votre administrateur pour qu’il l’ajoute à la liste autorisée.

Mon agent invente des réponses ou répond mal — que faire ?

Deux leviers. D’abord le prompt système : demandez-lui explicitement de répondre « je ne sais pas » et de rediriger quand l’information n’est pas disponible, plutôt que de combler le vide. Ensuite les connaissances : si la réponse devrait exister, vérifiez qu’elle figure dans un document au statut Prêt et que l’outil de recherche documentaire (RAG) est bien activé. Une réponse sans source citée sur un sujet censé être documenté doit vous alerter.

Un agent peut-il vraiment accéder à mes e-mails ou à mon agenda ?

Uniquement si l’outil correspondant a été connecté et si l’agent a été autorisé à s’en servir. Rien n’est actionné à votre insu : tant qu’aucun connecteur n’est branché, l’agent se contente de répondre à partir de ce qu’il sait. Avec un connecteur OAuth, l’agent agit toujours avec votre compte et vos droits.

Combien coûte un agent, et comment maîtriser la dépense ?

Le coût dépend surtout du modèle choisi et du volume d’usage. Règle simple : un modèle rapide et économique pour les tâches simples (FAQ, tri, reformulation), un modèle plus puissant réservé aux cas complexes. Côté maîtrise, un administrateur ou manager peut poser un budget mensuel par membre, et l’opérateur de l’instance peut imposer un plafond global à l’organisation. Voir Créer un agent et le Guide admin.

Connaissances / RAG

Quels formats de documents puis-je déposer ?

Les formats courants en entreprise : PDF (à vrai texte, pas un scan d’image), Word (.docx), texte (.txt), Markdown (.md), CSV, HTML et JSON. Les images et les PDF scannés sans texte lisible ne sont pas exploitables, faute de texte à lire. Détails dans Donner des connaissances (RAG).

Y a-t-il une taille limite par fichier ?

Oui : 25 Mo par fichier. Au-delà, le dépôt est refusé. Un document volumineux gagne de toute façon à être découpé en plusieurs fichiers thématiques — c’est plus léger et cela améliore la précision des réponses. Vous pouvez déposer autant de fichiers que nécessaire.

Comment savoir si l’agent utilise vraiment mes documents ?

Attendez que chaque document soit au statut Prêt, puis posez une question dont vous connaissez la réponse exacte dans un fichier. La réponse doit être juste et l’agent doit afficher la source citée (le bon document) en dessous. Si la source correspond, la chaîne fonctionne de bout en bout. Posez aussi une question hors de vos documents : un bon agent répond « je ne sais pas » plutôt qu’inventer.

Comment mettre à jour un document ?

Il n’y a pas de « remplacer » en un clic : supprimez l’ancienne version depuis le menu « … » de sa ligne, puis déposez la nouvelle. L’agent cesse aussitôt de citer l’ancien contenu. C’est l’occasion de vérifier que vous ne laissez pas deux versions concurrentes se contredire.

Qui voit les documents que je dépose ?

Cela dépend de la portée. Vos documents personnels ne sont visibles que de vous et ne servent qu’à votre agent par défaut dans vos conversations privées — y compris vis-à-vis de l’administrateur. Les documents attachés à un agent sont accessibles à tous ceux qui peuvent discuter avec cet agent. Ne déposez dans une base partagée que ce que son public a le droit de consulter.

Mes documents passent en « Erreur » et ne deviennent jamais « Prêt ».

La cause la plus fréquente : votre organisation n’a pas encore choisi de modèle d’indexation (le moteur qui « range » vos documents pour la recherche), un réglage unique réservé à l’administrateur. Le message au survol du badge le précise en général. Autres causes possibles : un fichier corrompu ou un scan d’image sans texte lisible. Signalez-le à votre administrateur si le message évoque une configuration.

Connecteurs

Quelle est la différence entre OAuth et clé API ?

C’est le service lui-même qui impose l’une ou l’autre méthode. En OAuth, chaque membre relie son propre compte d’un clic (Gmail, Outlook, Drive, Slack, CRM…) et agit sous sa propre identité. En clé API, l’administrateur saisit une seule clé partagée valable pour toute l’organisation (Stripe, SendGrid, une base de données, un fournisseur d’IA…). Voir Connecter des outils.

Un utilisateur peut-il voir les clés ou secrets configurés ?

Non. Tout secret (clé API, client secret, mot de passe) est chiffré dès son enregistrement et n’est jamais réaffiché — pas même à l’administrateur qui rouvre le connecteur (les champs sensibles restent vides, « Laisser vide pour conserver la valeur existante »). Un membre ordinaire ne les voit jamais.

Où trouver l’URL de redirection à déclarer chez le fournisseur ?

Abra vous la fournit dans le dialogue de configuration OAuth (encadré des redirect URIs, avec un bouton pour la copier), et le petit bouton « i » sur la carte du connecteur vous la redonne à tout moment. Collez-la à l’identique dans la liste « Authorized redirect URIs » de l’application, sinon la connexion échoue avec l’erreur redirect_uri_mismatch.

Dois-je configurer une application séparée pour chaque service Google ou Microsoft ?

Non. Une seule application couvre toute la famille : configurez un seul connecteur Google (ou Microsoft) et les autres en héritent automatiquement (badge bleu Hérité). Une app Google ouvre d’un coup Gmail, Drive, Agenda, Sheets… ; une app Microsoft ouvre Outlook, Teams, SharePoint, OneDrive, Excel…

Que se passe-t-il si je me déconnecte d’un service OAuth ?

Votre connexion personnelle est retirée immédiatement. Les agents et workflows qui reposaient sur votre compte pour ce service cessent d’y avoir accès. Rien n’est supprimé côté fournisseur : vous pourrez vous reconnecter plus tard d’un simple clic. Pour une coupure définitive, révoquez aussi l’application dans la console du fournisseur (Google, Microsoft, Slack…).

Le bouton « Se connecter » n’apparaît pas ou indique « Fournisseur non configuré ».

C’est que votre organisation n’a pas encore déclaré l’application OAuth pour ce service. Cette mise en place est réservée à l’administrateur (il renseigne l’identifiant client et le secret). Rapprochez-vous de lui.

Peut-on avoir plusieurs comptes pour un même service ?

Oui, côté administrateur : un connecteur accepte plusieurs instances (par exemple deux boîtes Slack « Production » et « Marketing »). Chacune porte un libellé que l’on retrouve ensuite dans le sélecteur de credential des workflows.

Workflows & automatisations

Quelle est la différence entre un workflow et une automatisation ?

C’est le déclencheur. Un workflow se lance quand vous cliquez Lancer (à la demande, avec ou sans formulaire). Une automatisation se déclenche toute seule, selon un planning (chaque matin, chaque lundi…) ou un événement (un e-mail reçu, une ligne ajoutée à un tableur…), une fois que vous l’avez allumée avec son interrupteur. En coulisses, c’est la même mécanique. Voir Workflows & automatisations.

Pourquoi un workflow me demande-t-il de connecter un outil à l’activation ?

Parce qu’il a besoin d’accéder à un service (votre Google, un CRM, une base…). À l’activation, Abra relie automatiquement chaque besoin à l’un de vos comptes déjà connectés ; s’il en manque un, il vous invite à le connecter d’abord, sans quitter la fenêtre. Une fois l’accès en place, réessayez.

Une exécution a échoué (statut « Erreur ») — que faire ?

Ouvrez l’onglet Historique et le passage concerné : les données d’entrée et le message d’erreur aident à comprendre. La cause la plus fréquente est un connecteur manquant ou déconnecté — reliez à nouveau l’outil, puis relancez. Si l’erreur persiste, signalez-la à l’équipe qui a préparé le modèle.

Où retrouver l’historique de mes exécutions ?

Dans l’onglet Historique d’un workflow : la liste des passages à gauche, le détail à droite (date, durée, statut, données d’entrée, et le résultat complet). L’historique est conservé dans la durée, y compris pour les exécutions automatiques que vous n’avez pas suivies en direct.

Un collègue voit-il mes workflows et mes exécutions ?

Non. Quand vous activez un modèle, Abra vous crée votre copie personnelle : vos lancements, votre historique et vos connecteurs vous sont propres et restent isolés de ceux des autres membres.

Publier / API

Quels sont les moyens de mettre un agent à disposition hors d’Abra ?

Trois canaux, du plus public au plus contrôlé : le widget embarquable (une bulle de chat à coller sur un site), le lien de partage SSO (une page hébergée où l’utilisateur se connecte avant de discuter), et l’API (Agents-as-API, pour appeler l’agent depuis vos applications). Tous partagent le même moteur que le chat interne. Voir Publier un agent.

Comment brancher un agent sur mon site sans écrire de code ?

Utilisez le widget : vous collez un seul <script> dans le HTML de la page. Sur un site public, la variante avec clé permet un chat anonyme ; sur un intranet, la variante avec login SSO rattache chaque conversation à l’utilisateur réel. Un Aperçu en direct vous laisse tester le rendu avant la mise en ligne.

C’est quoi une clé API, et où la crée-t-on ?

Une clé (préfixe abra_live_…) autorise l’appel de vos agents depuis l’extérieur. On la crée dans la page Agents en API (réservée aux admins) en choisissant : les agents qu’elle peut appeler, les domaines autorisés (CORS), un plafond mensuel et un débit optionnels. Le secret ne s’affiche qu’une seule fois à la création — copiez-le immédiatement, Abra n’en garde qu’une empreinte et ne peut pas le réafficher.

Mon appel depuis le navigateur est bloqué (CORS).

Par défaut, une clé est serveur-à-serveur : aucun en-tête CORS n’est renvoyé, donc un navigateur ne peut pas lire la réponse. Ajoutez l’origine exacte de votre page (ex. https://app.mon-site.com) dans les Domaines autorisés de la clé. Abra reflète alors cette origine — et uniquement celle-ci ; jamais *. Voir la Référence API.

Comment révoquer une clé qui a pu fuiter ?

Dans Agents en API → clés API, choisissez Révoquer (désactivation immédiate : les appels suivants reçoivent une erreur 401) ou Rotation (nouveau secret, l’ancien cesse aussitôt de fonctionner). Cela n’affecte aucune autre clé — d’où l’intérêt d’une clé distincte par usage.

Combien coûte l’API, et comment plafonner la dépense ?

Chaque clé porte un plafond mensuel. Une fois atteint, les appels sont refusés (erreur 402) jusqu’au début du mois suivant, ou jusqu’à ce qu’un administrateur relève le plafond. Ajoutez un rate-limit par minute pour lisser les pics. Vous suivez le coût cumulé dans le Dashboard de la page Agents en API.

Dans le widget à clé, oui : le secret figure dans le code source de la page. C’est pourquoi il faut une clé dédiée, limitée à un seul agent, plafonnée et restreinte par domaine. Si vous ne voulez exposer aucune clé, utilisez le widget avec login SSO ou le lien de partage.

Rôles & administration

Quels sont les rôles dans Abra ?

Cinq rôles, du plus restreint au plus large : Membre (utilise les agents et workflows qui lui sont attribués), Manager (gère ses équipes et invite dans leur périmètre), Développeur (construit workflows et agents, puis les soumet à validation), Admin d’organisation (contrôle toute l’organisation), et, au sommet, Admin de plateforme (l’opérateur de l’instance). Le rôle s’applique par organisation, et quand plusieurs se cumulent, le plus fort l’emporte. Détails dans le Guide admin et les Concepts.

Quelle différence entre admin d’organisation et admin de plateforme ?

L’admin d’organisation gère une seule organisation (membres, équipes, agents, connecteurs, SMTP/SSO/marque) et ne voit rien des autres. L’admin de plateforme est l’opérateur (hébergeur / ESN) : au-dessus des organisations, il les crée, gère la licence, le catalogue global, les tarifs et clés des modèles, les plafonds imposés et la file de promotion. Sur une petite installation, une même personne peut cumuler les deux.

Comment inviter un membre ?

Depuis la page de votre organisation, cliquez Inviter un membre, saisissez son e-mail et choisissez son rôle. La personne reçoit une invitation : elle crée son compte (ou se connecte) et rejoint l’organisation. L’invitation ne donne le rôle choisi que dans votre organisation. Les managers peuvent inviter, mais seulement dans le périmètre de leurs équipes.

Comment restreindre les modèles d’IA utilisables dans mon organisation ?

Dans la section Organisation des réglages de l’agent (réservée aux admins), cochez uniquement les modèles autorisés. Tout modèle non coché devient inutilisable pour tous — y compris les agents déjà réglés dessus. Attention : votre liste ne peut jamais dépasser ce que la plateforme autorise (le résultat est l’intersection des deux), et retirer un modèle en cours d’usage peut interrompre un agent en production.

Qui paie l’usage de l’IA : nous ou l’hébergeur ?

Cela dépend de la politique fixée par l’opérateur pour votre organisation. En mode clé plateforme, l’opérateur fournit et paie la clé (souvent avec un quota mensuel). En mode BYOK (« clé du client »), votre organisation saisit sa propre clé dans les Connecteurs et paie directement son fournisseur. Une carte en lecture seule vous indique le mode actif.

Comment configurer le SMTP et le SSO de mon organisation ?

Le SMTP (expéditeur de vos e-mails) se règle dans les paramètres de l’organisation : laissez vide pour hériter de la plateforme, ou renseignez votre propre serveur pour envoyer depuis votre domaine. Le SSO (Microsoft Entra ID et/ou Google Workspace) se met en place avec l’opérateur, car l’application d’identité est partagée par l’instance ; ensuite, Abra rattache vos membres à votre organisation grâce au domaine de leur e-mail. Détails dans le Guide admin.

Le catalogue

Que se passe-t-il quand j’active un template ?

Vous en obtenez votre propre copie, rattachée à vous. Le modèle d’origine reste intact dans le catalogue pour les autres. Vos échanges, votre historique et vos réglages ne sont pas partagés. Pour un agent, la copie apparaît dans Mes agents ; pour un workflow, elle tourne sur vos comptes connectés. Voir Le catalogue.

Faut-il reconfigurer les connecteurs après activation ?

Oui, et c’est voulu : un modèle ne transporte jamais les comptes ou les clés de son auteur. À l’activation, Abra branche les vôtres. Si un outil requis n’est pas encore connecté, l’activation s’arrête avec un message pour le brancher, puis vous réessayez. Les outils partagés au niveau de l’organisation sont, eux, configurés une seule fois par votre administrateur.

Qui peut publier un modèle dans le catalogue ?

Uniquement les développeurs et administrateurs, via l’étape de promotion : l’auteur soumet sa création, un administrateur la relit et l’approuve (ou la rejette avec un motif). Les membres et managers ne publient pas — ils activent ce qui existe déjà.

Pourquoi ne vois-je pas un modèle dont un collègue me parle ?

Le plus souvent, une question de portée : le modèle est peut-être réservé à une équipe ou à des utilisateurs précis dont vous ne faites pas partie. Il se peut aussi qu’il soit encore en cours de validation. Rapprochez-vous d’un administrateur pour ajuster la visibilité.

Sécurité & données

Où sont stockées mes données ?

Dans le périmètre de votre instance Abra. En auto-hébergé, tout reste sur votre infrastructure : vos données, vos clés et vos modèles ne transitent pas par les serveurs de l’éditeur. Même l’indexation des documents (RAG) se fait au sein de votre instance — il n’y a pas de base externe qui « aspire » vos fichiers.

Mes secrets et mots de passe sont-ils chiffrés ?

Oui. Toute clé, tout client secret, tout mot de passe est chiffré dès son enregistrement et n’est jamais réaffiché, même à un administrateur. Les clés API d’agents ne sont stockées que sous forme d’empreinte : le secret n’apparaît qu’une fois, à la création.

Une organisation peut-elle voir les données d’une autre ?

Non. L’organisation est la frontière d’étanchéité d’Abra : membres, agents, connecteurs, conversations et documents appartiennent toujours à une seule organisation, et cette séparation est revérifiée à chaque requête. Rien ne franchit la frontière entre deux organisations, même sur une instance mutualisée.

Mes conversations et documents privés sont-ils vraiment privés ?

Oui. Vos documents personnels ne servent qu’à votre agent par défaut, dans vos conversations privées, et restent invisibles pour les autres membres y compris l’administrateur. De façon générale, pouvoir lire une base ne donne jamais le droit d’y écrire.

Abra est-il compatible avec le RGPD et les exigences de souveraineté ?

Abra est conçu pour ces contraintes : isolation stricte par organisation, secrets chiffrés, traçabilité des accès et des appels, et surtout la possibilité d’un déploiement auto-hébergé où vos données ne quittent jamais votre infrastructure. C’est précisément ce mode que retiennent les organisations aux exigences de conformité les plus strictes.

Auto-hébergement

Peut-on héberger Abra sur nos propres serveurs ?

Oui. Abra se livre comme une stack Docker que vous exploitez entièrement chez vous (cloud ou on-premise) : vos données, vos clés et vos modèles restent sur votre infrastructure. Le déploiement se fait en ~20 min avec un script guidé, et les mises à jour par simple remplacement d’image.

Où trouver le détail de l’installation et de l’exploitation ?

Tout est dans la page dédiée Auto-hébergement : prérequis serveur, DNS/TLS, installation pas à pas, sauvegardes, licence et mises à jour. Pour l’administration au quotidien (membres, rôles, gouvernance des modèles), voir le Guide admin.

Vous n’avez pas trouvé votre réponse ? Reprenez le sujet dans son guide dédié (chaque guide se termine par ses propres questions fréquentes), ou contactez l’administrateur de votre organisation — et, pour une instance auto-hébergée, votre interlocuteur Abra.