# Ask This Guy, full content > Full text of the Ask This Guy documentation and blog, in French and English. European AI platform for enterprise knowledge management, RAG, agentic automation, natural-language data querying, and embedded chat, packaged as outcome-based solutions and delivery services in French and English. Curated index: https://www.askthisguy.com/llms.txt Last updated: 2026-09-11 --- # Guides de configuration URL: https://www.askthisguy.com/fr/doc/admin-console/knowledge-management/connectors/conf-guides/ Language: fr Section: Documentation Guides de configuration pas à pas pour connecter vos sources de données à ATG. Sélectionnez un guide dans la barre latérale pour commencer. --- # Organisation URL: https://www.askthisguy.com/fr/doc/admin-console/organization-settings/ Language: fr Section: Documentation ### Bienvenue dans les paramètres Organisation d'Ask This Guy ! Gérez les informations principales et les politiques IA de votre organisation. Ces paramètres vous permettent d'aligner **Ask This Guy** sur l'identité et les règles de votre entreprise. ![Paramètres d'organisation](https://www.askthisguy.com/doc/org-settings-fr.webp) ## Fonctionnalités disponibles Configurez ces paramètres essentiels pour personnaliser votre expérience ATG : ** Nom de l'organisation** Le nom affiché publiquement sur la plateforme ATG. ** Description** Un résumé court des activités de votre organisation, inclus automatiquement dans chaque message pour donner du contexte à l'IA. ** Politique IA** Choisissez une politique de résidence des données centrée sur l'Europe ou mondiale. Voir [Politique IA](https://www.askthisguy.com/doc/admin-console/organization-settings/choosing-the-right-ai-policy) pour les détails. ** Prompts prédéfinis** Créez des modèles de prompts réutilisables utilisables en deux clics par votre équipe. Voir [Prompts prédéfinis](https://www.askthisguy.com/doc/admin-console/organization-settings/predefined-prompts) pour les détails. ** Revue de presse** Configurez des revues de presse personnalisées selon les centres d'intérêt de votre organisation. Voir [Revue de presse](https://www.askthisguy.com/doc/admin-console/organization-settings/press-review) pour les détails. ** Contexte organisation** Informations de fond (personnes clés, départements, vocabulaire, règles internes) qui aident l'IA à comprendre les demandes et à fournir des réponses pertinentes. ## Guide pas à pas **1⃣ Accéder aux paramètres Organisation** Depuis la [console d'administration](https://admin.askthisguy.com), cliquez sur **Organisation** → **Paramètres**. **2⃣ Modifier les informations** - Cliquez sur l'**icône crayon ** à côté d'un champ (Nom ou Description) pour modifier **3⃣ Choisir la politique IA** - Choisissez **🇪🇺 Fournisseurs européens** ou ** Monde entier** (flexibilité globale) **4⃣ Définir le contexte organisation** - Cliquez sur l'**icône crayon ** à côté de « Contexte organisation » - Saisissez les informations pertinentes dans la zone de texte — plus de détails aident l'IA - Utilisez **« Créer avec l'IA »** pour générer automatiquement le contexte à partir des connaissances déjà traitées, puis enregistrez ## Points à retenir **Description** Restez concis — elle est incluse dans chaque message utilisateur. **Politique IA** - **Fournisseurs européens :** utilise uniquement des fournisseurs UE et des modèles open-weight (conformité stricte) - **Monde entier :** pas de restriction de fournisseur, mais possiblement soumis à des réglementations hors UE (ex. Patriot Act) ## Pour aller plus loin [Politique IA](https://www.askthisguy.com/doc/admin-console/organization-settings/choosing-the-right-ai-policy) [Prompts prédéfinis](https://www.askthisguy.com/doc/admin-console/organization-settings/predefined-prompts) [Revue de presse](https://www.askthisguy.com/doc/admin-console/organization-settings/press-review) --- # Introduction URL: https://www.askthisguy.com/fr/doc/customizing-atg-to-you/introduction/ Language: fr Section: Documentation ## Différentes approches de la personnalisation Un assistant IA pour votre organisation peut être conçu de plusieurs façons : entièrement générique (taille unique), entièrement sur mesure (tout développé pour vous), ou entre les deux. Chaque approche implique des compromis sur le coût, le délai de mise en valeur et le contrôle. ## L’approche 90-10 ATG repose sur une philosophie **90-10** : - **Environ 90 % est générique** – Ce que fournit la plateforme SaaS ATG : chat, recherche dans les connaissances, connecteurs, agents, sécurité, hébergement et évolution produit continue. Ce socle partagé permet un déploiement rapide et une maintenance prévisible. - **Environ 10 % est spécifique** – Ce qui est adapté à *vos* processus, données et outils. C’est là que se jouent la différenciation et la valeur métier : vos documents, vos formats, vos API et vos bases de données. ![L’approche 90-10 : 90 % plateforme générique, 10 % valeur propre à l’organisation](https://www.askthisguy.com/doc/90-10-fr.webp) Ce 10 % correspond aux options de personnalisation d’ATG : **traitement sur mesure** (vos formats de fichiers et règles), **outils sur mesure** (vos API d’entreprise) et **requête base de données** (accès en langage naturel à vos données). Le reste reste sur la plateforme partagée et robuste, pour allier flexibilité et fiabilité. --- # Connaissances URL: https://www.askthisguy.com/fr/doc/admin-console/knowledge-management/ Language: fr Section: Documentation L'espace **Connaissances** organise les informations que les agents ATG peuvent rechercher. Les administrateurs connectent ou déposent des sources, les regroupent en catégories, puis choisissent les catégories utilisables par chaque agent. **Par où commencer :** [Connecteurs](https://www.askthisguy.com/doc/admin-console/knowledge-management/connectors) explique comment connecter des sources de données à ATG. ## Concepts clés ### Catégories Une **catégorie de connaissances** regroupe les sources destinées à un même public, domaine métier ou cas d'usage. Vous pouvez par exemple créer des catégories pour la documentation commune, la Finance, les RH ou un produit précis. Les catégories sont affectées aux **agents, jamais aux utilisateurs**. Dans l'onglet Connaissances de chaque agent, les administrateurs sélectionnent les catégories que l'agent peut rechercher. ### Sources Chaque catégorie contient une ou plusieurs sources : - les **connecteurs** importent automatiquement le contenu de systèmes comme Confluence, Google Drive, Notion, SharePoint, OneDrive ou Slack ; - le **dépôt de fichiers** ajoute directement des PDF, documents Word, présentations et autres formats compatibles ; - les **crawls web** collectent le contenu de sites configurés. Chaque source dispose de sa propre **fréquence de rafraîchissement**, que les administrateurs règlent sur Manuel, Quotidien, Hebdomadaire ou Mensuel selon la vitesse d'évolution de son contenu. Consultez [Connecteurs](https://www.askthisguy.com/doc/admin-console/knowledge-management/connectors) et [Dépôt de fichiers](https://www.askthisguy.com/doc/admin-console/knowledge-management/file-upload) pour les instructions de configuration, et [Fréquence de rafraîchissement](https://www.askthisguy.com/doc/admin-console/knowledge-management/connectors#frquence-de-rafrachissement) pour régler le rythme des mises à jour. ### Documents Les sources contiennent les documents et contenus qui constituent les connaissances de votre organisation. ATG traite et indexe ce contenu afin que les agents dotés de l'outil **Recherche dans la base de connaissances** puissent retrouver les informations pertinentes et citer leurs sources. ## Fonctionnement de l'accès aux connaissances L'accès aux connaissances se contrôle par les agents : 1. Un administrateur regroupe les sources dans des catégories de connaissances. 2. Il affecte les catégories utiles à un agent. 3. Il ouvre l'agent Webapp à tous ou le réserve à certains utilisateurs. 4. Un utilisateur autorisé à utiliser l'agent peut lui demander de rechercher dans les catégories configurées pour cet agent. Il n'existe aucun droit séparé par catégorie dans la fiche de l'utilisateur. Pour protéger des connaissances confidentielles, créez un agent dédié, affectez-lui uniquement les catégories nécessaires, puis limitez son accès aux utilisateurs autorisés. Consultez [Agents](https://www.askthisguy.com/doc/admin-console/how-to-configure-the-agents) et [Utilisateurs](https://www.askthisguy.com/doc/admin-console/users-management) pour le parcours complet. ## Outils et connaissances sont deux réglages distincts Affecter une catégorie définit **les connaissances disponibles** pour un agent. Activer l'outil **Recherche dans la base de connaissances** détermine **si l'agent peut les rechercher**. Les deux réglages sont nécessaires pour qu'un agent interroge les connaissances de l'organisation. Les utilisateurs ne peuvent pas activer la recherche dans les connaissances depuis l'interface de chat. ## Pièces jointes personnelles dans le chat Les utilisateurs peuvent joindre des fichiers directement dans l'interface de chat. Ces pièces jointes personnelles sont différentes des connaissances de l'organisation : - elles ne sont pas ajoutées à une catégorie de connaissances ; - elles ne sont pas partagées avec les autres utilisateurs ; - elles fournissent un contexte temporaire à la conversation en cours. ## Bonnes pratiques - Regroupez les sources par objectif métier cohérent, pas par utilisateur individuel. - Limitez les connaissances de chaque agent à son rôle. - Utilisez des agents dédiés et restreints pour les services ou projets confidentiels. - Revoyez les accès aux agents lorsque les responsabilités évoluent. - Testez la recherche dans le Playground après un changement de catégories ou d'outils. ## Guides associés - [Connecteurs](https://www.askthisguy.com/doc/admin-console/knowledge-management/connectors) - [Dépôt de fichiers](https://www.askthisguy.com/doc/admin-console/knowledge-management/file-upload) - [Données et RAG](https://www.askthisguy.com/doc/admin-console/knowledge-management/how-is-my-companys-data-processed-what-is-rag) - [Documents et images](https://www.askthisguy.com/doc/admin-console/knowledge-management/how-documents-images-are-processed-by-atg) --- # Intégrer le widget ATG dans votre webapp URL: https://www.askthisguy.com/fr/doc/atg-embedded/how-to-integrate-atg-embedded-in-your-webapp/ Language: fr Section: Documentation ## Vue d'ensemble Le widget ATG s'exécute dans une iframe isolée hébergée sur [`app.askthisguy.com`](http://app.askthisguy.com), ce qui garantit la confidentialité des données, une sécurité robuste et des mises à jour sans effort. ### Modes d'intégration
Mode Cas d'usage typique Authentification pour délimiter la session Backend requis
Mode 1 - Public FAQ site web, génération de leads, aide SaaS simple sans contexte par utilisateur Aucune Non
Mode 2 - Connecté SaaS authentifié, support contextuel, automatisations JWT signé côté serveur avec TTL court Oui
## Concepts clés ### Pour les deux modes ### **Widget (`widget.js`)** Script léger fourni par ATG que vous intégrez sur votre site. Il injecte une iframe pointant vers [`https://app.askthisguy.com`](https://app.askthisguy.com), crée le lanceur de chat via le Shadow DOM et communique avec l'iframe via `postMessage`. ### **Isolation de l'iframe** Toute l'interface et les données du chat se trouvent dans une iframe cross-origin ([`app.askthisguy.com`](http://app.askthisguy.com)) sous la politique Same-Origin du navigateur : - Votre page ne peut pas lire les jetons ATG - ATG ne peut pas accéder à vos cookies ni à vos scripts ### **Shadow DOM** Évite les conflits CSS/JS avec votre site. ### **Access token** Pour maintenir les sessions de chat avec les utilisateurs, ATG s'assure que l'iframe détient en mémoire un jeton porteur à courte durée de vie, lié au DPoP, et l'envoie en `Authorization: DPoP \` avec l'en-tête approprié. Ce mécanisme permet de maintenir une session sur des navigateurs comme Safari où les cookies tiers et les cookies partitionnés sont bloqués. ### Pour le mode 2 uniquement ### **Paramètres signés** Le seul travail backend requis consiste à développer un endpoint simple qui crée un JSON Web Token (JWT) signé avec votre clé privée. Exemple de JWT avec le minimum requis : ```json // Header { "alg": "ES256", "kid": "prod-key-2024-01" } // Payload (minimal requis) { "iat": 1739298000, "exp": 1739298900, "jti": "550e8400-e29b-41d4-a716-446655440000" } ``` Vous pourrez téléverser une clé publique dans la console d'administration ATG pour qu'ATG puisse décoder le JWT et ouvrir une session de chat avec l'utilisateur. Vous conservez la clé privée sur vos serveurs. Vous pouvez transmettre d'autres paramètres à ATG pour définir les droits et le contexte de l'utilisateur pour cette session. Consultez l'[annexe](#annexe) pour la description de tous les paramètres supportés. ### Architecture ### Mode 1 - Flux public ```mermaid sequenceDiagram participant User as Visiteur participant Site as Site web participant Widget as Widget (JS) participant Iframe as Iframe ATG participant ATG as ATG (app.askthisguy.com) User->>Site: Ouvre la page avec le widget de chat Site->>Widget: Charge widget.js Widget->>ATG: init_session ATG->>ATG: Vérifications allow-origin ATG->>Widget: Chat prêt ```

Le schéma montre l'ouverture d'une session en mode public : la page charge widget.js, le widget demande une session à ATG, et ATG vérifie l'origine du site appelant avant de déclarer le chat prêt. Aucune authentification côté client n'intervient.

### Mode 2 - Connecté ```mermaid sequenceDiagram participant User as Utilisateur participant Site as App client participant Widget as Widget (JS) participant Backend as Backend client participant Iframe as Iframe ATG participant ATG as ATG User->>Site: Ouvre l'app avec le chat intégré Site->>Widget: Charge widget.js Widget->>Backend: getSignedParams() Backend-->>Widget: JWT (TTL ≤ 15 min) Widget->>ATG: POST /session/init { jwt } + preuve DPoP ATG-->>Iframe: Access token lié DPoP (en mémoire) Iframe-->>User: Chat prêt ```

Le schéma montre l'ouverture d'une session en mode connecté : votre backend signe un JWT de courte durée (15 minutes au plus), le widget le présente à ATG avec une preuve DPoP, et ATG renvoie à l'iframe un access token lié à cette preuve, conservé en mémoire. Votre clé privée ne quitte jamais vos serveurs.

Une fois la session établie, le widget envoie les messages utilisateur à ATG sur un canal sécurisé (SSE/HTTPS), et ATG renvoie en temps réel les tokens de l'assistant à l'iframe, qui affiche l'interface de chat. ```mermaid sequenceDiagram participant User as Utilisateur participant Widget as Widget (lanceur) participant Iframe as Iframe (app chat) participant ATG as ATG ([app.askthisguy.com](http://app.askthisguy.com)) Note over Widget,ATG: La session est déjà établie User->>Widget: Clique sur le lanceur / saisit un message Widget->>Iframe: Ouvre le panneau (postMessage) / transmet la saisie Iframe->>ATG: Envoie le message (SSE/HTTPS POST) ATG-->>Iframe: Stream tokens/chunks (SSE) Iframe->>User: Affiche la réponse en streaming Iframe-->>ATG: Accusés / keepalive User->>Iframe: Message de suivi Iframe->>ATG: Envoie le message suivant (même session) ATG-->>Iframe: Stream réponse suivante Note over Widget,ATG: Renouvellement de session géré de façon transparente près de l'expiration (détails en FAQ) ```

Le schéma décrit la conversation une fois la session établie : le lanceur transmet la saisie à l'iframe, qui envoie le message à ATG et reçoit la réponse en streaming, token par token, via SSE. Les messages suivants réutilisent la même session, dont le renouvellement est géré de façon transparente à l'approche de l'expiration.

## Étapes d'intégration (les deux modes) > **Sur WordPress ?** Évitez l'intégration manuelle du script et utilisez notre plugin officiel. Il prend en charge les étapes 3 et 4 et couvre les deux modes (ouvert et signé). Consultez [Installer sur WordPress avec le plugin ATG](https://www.askthisguy.com/doc/atg-embedded/install-on-wordpress-with-the-atg-plugin). ### Étape 1 : Configurer votre agent dans la console d'administration ATG ### Créer un agent Widget et configurer ses connaissances Créez d'abord un agent dans la console d'administration et choisissez le type **Widget**. Le type ne peut plus être modifié après la création. Configurez les instructions, les catégories de connaissances et les outils de l'agent avant de l'intégrer. Voir [Configurer les agents](https://www.askthisguy.com/doc/admin-console/how-to-configure-the-agents) pour plus de détails. Cette étape est généralement prise en charge par l'équipe fonctionnelle ou les utilisateurs métier. Ils peuvent tester le comportement de l'agent dans le Playground intégré à la console d'administration. ### **Origines autorisées (Allow-Listed Origins)** Dans la console d'administration, indiquez à ATG les origines exactes autorisées à intégrer le widget (ex. [`https://yourapp.com`](https://yourapp.com), [`https://staging.yourapp.com`](https://staging.yourapp.com)). Cela sera appliqué automatiquement via des contrôles à l'exécution et les en-têtes CSP (Content Security Policy) sur l'iframe, pour que le chat ne soit intégrable que sur les domaines approuvés. ATG définira sa CSP (Content-Security-Policy) avec une directive `frame-ancestors` basée sur vos origines autorisées : ``` Content-Security-Policy: frame-ancestors [https://yourapp.com](https://yourapp.com) [https://staging.yourapp.com](https://staging.yourapp.com); ``` ### Étape 2 : Vérifier que votre site ne bloque pas ATG Si votre site utilise une Content-Security-Policy (CSP) stricte qui bloque par défaut les iframes ou scripts externes, vous devez autoriser explicitement le widget et l'iframe ATG. Pour vérifier si votre site utilise une CSP, vous pouvez utiliser une commande `curl` par exemple : ```bash curl -I [https://yourwebsite.com](https://yourwebsite.com) | grep -i content-security-policy ``` Si la commande ne retourne rien ou seulement une règle `frame-ancestors` (cas le plus fréquent), vous n'avez pas besoin d'étendre l'en-tête CSP, passez à l'étape suivante. Si elle retourne des CSP strictes du type `Content-Security-Policy: default-src 'self'; script-src 'self'; frame-src 'none';`, ajoutez ou étendez votre en-tête CSP ainsi : ``` Content-Security-Policy: script-src 'self' [https://app.askthisguy.com](https://app.askthisguy.com); frame-src [https://app.askthisguy.com](https://app.askthisguy.com); ``` > Cet en-tête est défini sur votre propre serveur ou CDN (par votre équipe tech/ops). > > Il indique au navigateur que votre page est autorisée à charger le script et l'iframe ATG. > ### Étape 3 : Ajouter le script du widget Vous trouverez dans la console d'administration ATG un code JS simple à ajouter vers la fin du `\` de chaque page. Il ressemblera à : ```html ``` Consultez l'[annexe pour la description détaillée](#annexe) de tous les paramètres supportés par le widget. ## Étapes supplémentaires pour le mode 2 ### 1. Implémenter `/embed/presign` Pour activer le mode 2, vous devez implémenter un endpoint simple `/embed/presign`. Vous pouvez changer ce nom si vous préférez. Cet endpoint doit : - Être un endpoint POST - Vérifier que l'utilisateur est authentifié dans votre app - Si oui, retourner un JWT de paramètres signés à courte durée de vie avec un TTL < 15 min - Être signé avec ES256 **et** inclure un en-tête **`kid`** Nous recommandons aussi de n'accepter que les requêtes same-origin sur `/embed/presign`. **Corps de la réponse :** ```json // Payload (avec contexte optionnel) { "iat": 1739298000, "exp": 1739298900, "jti": "550e8400-e29b-41d4-a716-446655440000", "external_user_ref": "user_12345", "entitlements": { "plan": "premium", "features": ["export", "analytics"] }, "context_metadata": { "department": "sales", "region": "EU" } } ``` Consultez l'[annexe](#annexe) pour la description de tous les paramètres supportés. ### 2. Configurer la clé publique pour qu'ATG décode le JWT Dans la console d'administration ATG, allez dans les paramètres de sécurité de votre agent et saisissez la clé publique que ATG utilisera pour décoder le JWT signé avec votre clé privée dans `/embed/presign`. ### 3. Fournir le JWT au widget Le code JS à ajouter sur votre site sera légèrement différent pour le mode 2. Depuis la console d'administration, vous pouvez télécharger le dernier code JS à insérer dans votre page ou via votre tag manager. Le code ressemblera à : ```html ``` Le widget appellera `window.ATG.getSignedParams()` pour obtenir le JWT. Adaptez et intégrez ce code selon vos standards de sécurité : - Assurez-vous de fournir `window.ATG.getSignedParams()` - Définissez-le une seule fois ; protégez contre la ré-injection dans les SPA - Privilégiez un nonce CSP Si vous utilisez un tag manager avec deux tags (un pour le callback et un pour widget.js), assurez-vous d'utiliser le séquencement des tags pour que le callback se charge en premier. ### 4. Ce qu'ATG fait avec les paramètres signés 1. **Vérifie la signature** avec la clé publique de l'agent (identifiée par kid) 2. **Valide les claims** : - Horodatages (iat, exp): durée de vie max 15 minutes - Unicité de jti: évite les attaques par rejeu (stocké 15 min) 3. **Émet un access token lié DPoP**: cryptographiquement lié à la paire de clés éphémère de l'iframe 4. **Fournit le contexte de session**: les claims optionnels (external_user_ref, entitlements, context_metadata) sont disponibles pour l'agent pour la personnalisation ## API JavaScript : piloter le widget depuis votre page Une fois `widget.js` chargé, il expose une petite API sur `window.ATG` qui vous permet de piloter le chat depuis votre propre interface, au lieu de vous reposer uniquement sur le lanceur intégré. C'est ce qui rend possible des parcours plus orientés utilisateur : ouvrir le chat automatiquement sur une page donnée, brancher votre propre bouton « Demander à l'IA », ou démarrer une nouvelle conversation depuis un menu.
Méthode Ce qu'elle fait
window.ATG.open() Ouvre le panneau de chat.
window.ATG.close() Ferme le panneau de chat.
window.ATG.toggle() Ouvre ou ferme le panneau de chat selon son état.
window.ATG.expand() Agrandit le chat en vue complète (mode bulle uniquement).
window.ATG.minimize() Réduit le chat à sa vue compacte (mode bulle uniquement).
window.ATG.isExpanded() Renvoie true si le chat est actuellement agrandi.
window.ATG.resetConversation() Démarre une nouvelle conversation en effaçant l'historique des messages. (Ouvrez le chat au moins une fois au préalable pour que l'iframe soit initialisée.)
window.ATG.updatePageRoute(url) Met à jour la route de la page courante pour que l'agent dispose du contexte à jour. Surtout utilisé dans les SPA (voir ci-dessous).
> L'API devient disponible une fois que `widget.js` s'est exécuté. Protégez vos appels avec window.ATG?.open?.() pour éviter une erreur si le script n'est pas encore chargé, et branchez-les après DOMContentLoaded ou le hook de montage de votre framework. ### Quelques cas d'usage **Ouvrir le chat depuis votre propre bouton.** Combinez `data-launcher="hidden"` (pas de lanceur intégré) avec votre propre déclencheur : ```html ``` **Transformer une barre de recherche en point d'entrée du chat.** Quand l'utilisateur lance une recherche, ouvrez l'assistant au lieu (ou en plus) d'afficher des résultats : ```javascript searchForm.addEventListener('submit', (e) => { e.preventDefault(); window.ATG?.open?.(); }); ``` **Ouvrir le chat automatiquement sur une page précise** (ex. une page de tarifs ou d'onboarding), après un court délai pour ne pas gêner le rendu initial : ```javascript window.addEventListener('load', () => { if (location.pathname === '/tarifs') { setTimeout(() => window.ATG?.open?.(), 1500); } }); ``` **Démarrer une nouvelle conversation** depuis une entrée de menu « Nouveau chat » : ```javascript newChatButton.addEventListener('click', () => { window.ATG?.resetConversation?.(); window.ATG?.open?.(); }); ``` ## URL des pages dans vos agents (optionnel) > **Note :** Ceci n'est nécessaire que si vous avez une **Single Page Application (SPA)** avec routage côté client et souhaitez que l'agent fournisse une aide contextuelle spécifique à chaque page. ### Pourquoi les SPA ont besoin de ceci Dans les sites web traditionnels, chaque navigation charge une nouvelle page et réinitialise le widget avec l'URL actuelle. Dans les SPA, l'URL change sans rechargement de page, donc le widget ne détecte pas automatiquement la navigation. Si vous souhaitez que votre agent fournisse une **aide contextuelle spécifique à la page** en fonction de la route actuelle, vous devez notifier le widget des changements de route. ### Solution Appelez `window.ATG.updatePageRoute()` à chaque navigation de votre routeur SPA : ```javascript window.ATG.updatePageRoute(window.location.href); ``` ### Exemples d'implémentation **React Router (v6+)** ```jsx function App() { const location = useLocation(); useEffect(() => { if (window.ATG?.updatePageRoute) { window.ATG.updatePageRoute(window.location.href); } }, [location]); return {/* Vos routes */}; } ``` **Vue Router (v4+)** ```javascript // router/index.js const router = createRouter({ history: createWebHistory(), routes: [/* Vos routes */], }); router.afterEach(() => { if (window.ATG?.updatePageRoute) { window.ATG.updatePageRoute(window.location.href); } }); export default router; ``` ## Annexe ### Paramètres du widget
Attribut Description
data-agent-id Requis. ID de l'agent fourni par ATG.
data-signed-params Optionnel. Booléen (true ou false). Active l'authentification par paramètres signés. Nécessite l'implémentation du callback window.ATG.getSignedParams. Par défaut : false.
data-launcher Optionnel. Position du lanceur de chat (bottom-right, bottom-left, floating, hidden). Par défaut : bottom-right. Utilisez hidden pour charger le widget sans bouton de lanceur et l'ouvrir vous-même via l'API JS.
data-mode-style Optionnel. Mode d'affichage du panneau de chat (bubble, drawer). Par défaut : bubble. bubble : panneau compact ancré au lanceur, agrandissable en fenêtre centrée. drawer : panneau pleine hauteur ancré à droite qui glisse à l'écran (le lanceur est masqué pendant l'ouverture ; agrandir/réduire sont désactivés). Sur mobile, l'affichage reste plein écran quel que soit le mode.
data-language Optionnel. Langue de l'interface : en, fr. Par défaut : en.
data-page-route Optionnel. Route canonique de la page courante (ex. /plans). Utile si vous configurez des instructions d'agent qui en tiennent compte pour le contenu contextuel.
data-theme-json Optionnel. Objet JSON définissant des tokens visuels (couleur de marque, polices, rayon des coins). Permet de styliser rapidement l'assistant. Exemple : {'{"color.brand":"#6D28D9","radius.lg":"12px"}'}
data-aria-label Optionnel. Label d'accessibilité pour le bouton du lanceur de chat (ex. « Ouvrir l'assistant de chat »).
data-debug Optionnel. Booléen (true ou false). Active des logs détaillés dans la console pour le diagnostic. Par défaut : false.
Description de `data-theme-json` :
Nom du token Description Exemple de valeur
color.brand Couleur de marque principale #6D28D9
color.bg Couleur de fond du chat #0B0B0F
color.text Couleur du texte principal #F3F4F6
color.muted Couleur du texte secondaire #9CA3AF
color.assistant-bg Couleur de fond des bulles de message de l'assistant #F8F8F8
radius.sm, radius.lg Rayon des coins pour boutons, cartes 8px, 16px
font.family Stack de polices Inter, system-ui, sans-serif
shadow.elevation Ombre des cartes / lanceur 0 8px 24px rgba(0,0,0,0.25)
### Paramètres de l'endpoint Le JWT signé par `/embed/presign` pour démarrer une session doit comporter deux parties : header et claims (payload). **Header**
Claim Type Description Exemple / Notes
kid string Key ID : identifie quelle clé publique utiliser pour la vérification de signature. Doit correspondre à une clé enregistrée pour votre agent dans la console ATG. "prod-key-2024-01"
alg string Algorithme : doit être "ES256" (ECDSA avec courbe P-256 et SHA-256). "ES256"
**Claims du payload (requis)**
Claim Type Description Exemple / Notes
iat number (secondes Unix) Heure d'émission du jeton. Utilisé pour détecter dérive d'horloge ou rejeu. 1739298000
exp number (secondes Unix) Expiration : date d'expiration absolue de ce jeton de paramètres signés. Doit être courte (≤ 15 min). ATG refuse les jetons expirés ou à trop longue durée de vie. 1739298900
jti string (UUID/aléatoire) JWT ID : nonce unique pour ce jeton. Doit être aléatoire à chaque émission. 550e8400-e29b-41d4-a716-446655440000
**Claims du payload (optionnels)**
Claim Type Description Exemple / Notes
external_user_ref string Référence ou ID utilisateur externe de votre système. Peut servir à identifier l'utilisateur dans les instructions de l'agent ou les logs. "user_12345"
entitlements object (JSON) Droits ou permissions de l'utilisateur. Utilisable par l'agent pour la logique de contrôle d'accès. {'{"plan": "premium", "features": ["export"]}'}
context_metadata object (JSON) Métadonnées de contexte supplémentaires sur la session ou l'utilisateur. {'{"department": "sales", "region": "EU"}'}
## FAQ ### Comment est géré le renouvellement de session ? ATG renouvelle automatiquement le jeton de session **60 secondes avant expiration** pour éviter les coupures de chat : 1. **Configuration du timer** : À l'initialisation de la session, un timer de rotation est planifié selon la valeur expires_in (en général 10 minutes). 2. **Demande de pré-rotation** (si paramètres signés activés) : - 60 secondes avant l'expiration du jeton, l'iframe envoie un postMessage au widget : {'{ type: "ATG_REQUEST_SIGNED_PARAMS_FOR_ROTATION" }'} - Le widget appelle automatiquement votre callback window.ATG.getSignedParams() pour obtenir un nouveau JWT signé. - Votre callback doit appeler l'endpoint presign de votre backend et retourner le nouveau JWT. - Le widget renvoie le JWT à l'iframe et l'iframe renouvelle la session avec le serveur ATG. ### Utilisez-vous des cookies tiers ? Non, nous n'utilisons pas de cookies tiers (ils seraient bloqués). Pour notre access token, nous utilisons JWT + preuve DPoP. ### Comment ATG gère-t-il la rotation des clés et l'en-tête `kid` ? Chaque JWT de paramètres signés inclut un `kid` (Key ID) dans son header. ATG utilise cette valeur pour retrouver immédiatement la bonne clé publique que vous avez téléversée dans la console. Lors d'une rotation de clés : 1. Générez une nouvelle paire de clés de signature et donnez-lui un nouveau `kid` (ex. `key-2025-02`). 2. Ajoutez la nouvelle clé publique dans la console ATG en gardant l'ancienne jusqu'à expiration des jetons signés avec elle (≤ 15 min). 3. Signez les nouveaux jetons avec le nouveau `kid`, puis retirez l'ancienne clé. ATG vérifie chaque jeton avec la clé publique qui correspond à son `kid`, donc la rotation se fait sans interruption ni reconfiguration manuelle. --- # Traitement sur mesure URL: https://www.askthisguy.com/fr/doc/customizing-atg-to-you/tailored-processing/ Language: fr Section: Documentation ## Adapter ATG aux fichiers propres à votre organisation **ATG peut être personnalisé** pour traiter intelligemment **les types de fichiers spécifiques de votre organisation** et transformer des documents complexes en informations exploitables. ### Quels contenus peuvent être traités ? Que vous travailliez avec des **feuilles Excel**, des **catalogues produits**, des **rapports commerciaux**, des **jeux de données scientifiques** ou tout autre document spécialisé, ATG peut apprendre à les traiter exactement comme vous en avez besoin : - **Bases de contacts** – Extraire et structurer les informations sur les parties prenantes - **Fiches produit** – Analyser stocks et spécifications - **Rapports commerciaux** – Analyser performances et tendances commerciales - **Données scientifiques** – Traiter résultats de recherche et mesures - **Formats métiers** propres à votre secteur ### Fonctionnement Un traitement sur mesure repose sur **deux éléments clés** : 1. **Critères de déclenchement** – Définir ce qui active le traitement personnalisé (par ex. mots-clés dans les noms de fichiers, types de fichiers ou motifs dans le contenu) 2. **Règles de traitement** – Préciser comment ATG doit extraire, transformer et structurer les données **Une fois configuré, le traitement s’applique automatiquement**, quelle que soit l’origine du fichier. Déposé directement, synchronisé via **Notion**, récupéré depuis **Google Drive**, **Confluence**, **SharePoint** ou tout autre connecteur, vos règles personnalisées s’appliquent de la même façon sur toutes les sources. Voir [Connecteurs](https://www.askthisguy.com/doc/admin-console/knowledge-management/connectors) pour plus d’informations sur les connecteurs. Votre équipe obtient ainsi **la bonne information** issue des bons fichiers, à chaque fois. ### Pourquoi le contexte compte : pas de traitement CSV/Excel générique Vous vous demandez peut-être : **« Pourquoi ne pas traiter automatiquement tous les fichiers Excel et CSV ? »** La réponse est simple : **le contexte est essentiel**. Un tableur sans contexte n’est que des données brutes. Cette colonne « Montant » est-elle en euros ou en dollars ? « Statut » signifie-t-il statut de commande, de projet ou d’employé ? Quelles lignes sont des en-têtes, des totaux, les données utiles ? **Un traitement automatisé générique produit souvent du bruit**. Notre approche est plus réfléchie : - **Comprendre d’abord votre activité** – Nous apprenons comment votre organisation structure ses données - **Concevoir des règles ciblées** – Un traitement sur mesure qui sait ce que signifie chaque colonne et comment gérer les cas limites - **Livrer des informations de qualité** – Votre équipe obtient des éléments exploitables, pas seulement des cellules parsées **Données médiocres en entrée, résultats médiocres en sortie.** En investissant un peu de temps au départ pour comprendre votre contexte, nous faisons en sorte qu’ATG alimente une base de connaissances de qualité, réellement utilisable par vos équipes. ### Prochaines étapes Le traitement personnalisé des fichiers est proposé sous la forme d’un **développement sur mesure** adapté aux besoins de votre organisation. **Contactez votre interlocuteur ATG** pour parler de votre cas d’usage et explorer comment optimiser ATG pour vos flux de travail. --- # Outils et MCP URL: https://www.askthisguy.com/fr/doc/admin-console/tools-management/ Language: fr Section: Documentation La section **Outils et MCP** recense les outils intégrés à ATG et permet de connecter des systèmes externes via le **Model Context Protocol (MCP)**, avec le **catalogue MCP** pour ajouter rapidement des services tiers. Dans la console, ouvrez **Outils et MCP**, puis l’onglet **Serveurs MCP** pour gérer vos connexions ou parcourir le catalogue. Les outils s’activent agent par agent : l’onglet **Outils** de chaque agent détermine les outils intégrés, personnalisés et MCP utilisables dans ses conversations. Consultez [Agents](https://www.askthisguy.com/doc/admin-console/how-to-configure-the-agents). ## Dans cette section - **[Outils](https://www.askthisguy.com/doc/admin-console/tools-management/chat-tools)** - Les outils intégrés dont dispose chaque organisation : recherche documentaire, web, génération de fichiers, e-mail, revue de presse. - **[Serveurs MCP](https://www.askthisguy.com/doc/admin-console/tools-management/mcp-servers)** - Ajouter et configurer des points d’accès MCP (URL, authentification, transport, filtrage des outils). - **[Catalogue MCP](https://www.askthisguy.com/doc/admin-console/tools-management/mcp-catalog)** - Découvrir des services MCP tiers pré-intégrés et les ajouter à votre organisation, qu’ils soient en accès libre ou qu’ils exigent une clé API. --- # Plugin d'ATG pour WordPress URL: https://www.askthisguy.com/fr/doc/atg-embedded/install-on-wordpress-with-the-atg-plugin/ Language: fr Section: Documentation ## Introduction Le plugin d'ATG vous permet d'activer un agent de chat sur votre site WordPress et de le configurer en quelques clics : choisir la forme du widget, l'endroit où il s'affiche, sa charte graphique, cibler les pages concernées, et plus encore. En option, vous pouvez aussi sécuriser les sessions de chat pour ne les rendre accessibles qu'aux utilisateurs authentifiés sur votre site. ## Prérequis - **Un site WordPress** en version 6.0 ou ultérieure, PHP 7.4 ou ultérieur. Pour le mode signé, l'extension PHP `openssl` doit être activée (elle l'est sur la quasi-totalité des hébergeurs de production). - **L'UUID d'un agent Widget.** Créez un agent ATG et choisissez le type **Widget**. Le type ne peut plus être modifié après la création. Consultez [Configurer les agents](https://www.askthisguy.com/doc/admin-console/how-to-configure-the-agents). L'UUID est disponible dans l'onglet Code d'intégration de l'agent. - **La liste des domaines de votre site WordPress :** dans la console d'administration ATG, ajoutez les domaines de votre site (par exemple `https://votresite.com`, `https://staging.votresite.com`) à la liste des origines autorisées de l'agent. Le Chat ne fonctionnera que sur ces domaines. ## Étape 1 : Télécharger et installer le plugin Téléchargez le ZIP du plugin : [atg-chat-widget.zip](https://www.askthisguy.com/downloads/atg-chat-widget.zip) Puis installez-le comme n'importe quel plugin WordPress : 1. Dans l'administration de WordPress, allez dans **Extensions → Ajouter → Téléverser une extension**. 2. Sélectionnez le fichier `atg-chat-widget.zip` que vous venez de télécharger puis cliquez sur **Installer maintenant**. 3. Cliquez sur **Activer l'extension**. Un nouveau menu **Réglages → Ask This Guy Chat** apparaît. ## Étape 2 : Renseigner l'UUID de l'agent 1. Allez dans **Réglages → Ask This Guy Chat**. 2. Collez l'UUID de votre agent dans le champ **Agent UUID**. 3. Cliquez sur **Enregistrer les modifications**. Ouvrez la partie publique de votre site ; le lanceur de chat doit apparaître en bas à droite. ![Page de réglages du plugin Ask This Guy Chat dans l'administration WordPress](https://www.askthisguy.com/doc/wordpress-plugin-settings.webp) ## Étape 3 : Configurer les options d'affichage Sur la même page de réglages, vous pouvez affiner où et comment le widget s'affiche :
Réglage Ce qu'il contrôle
Position du lanceur En bas à droite (défaut), en bas à gauche, flottant, ou masqué. Masqué charge le widget sans bouton de lanceur, vous pouvez alors déclencher l'ouverture via l'API JS window.ATG.
Mode d'affichage Bulle (défaut) : panneau compact, agrandissable en fenêtre centrée. Tiroir : panneau pleine hauteur ancré à droite.
Langue Détection automatique depuis la locale du site WordPress, ou forcer anglais / français.
Afficher sur Tout le site, restreint à certains types de contenus, ou partout sauf une liste de chemins d'URL.
Libellé d'accessibilité Remplace l'aria-label du bouton du lanceur.
Personnalisation du thème Couleur de marque, police, ombre. Le JSON complet du thème par défaut est affiché à titre de référence à copier-coller-modifier.
## Étape 4 (optionnelle) : Activer le mode signé pour n'authoriser les sessions de chat qu'aux utilisateurs authentifiés Ce mode garantit que toute la session de chat est signée par un système de clé privée et publique. Le widget signe un JWT à courte durée de vie, de sorte que le chat soit associé à un utilisateur connecté. Les visiteurs anonymes ne voient aucun widget lorsque le mode signé est activé et se verront refuser toute session. > **Avertissement RGPD.** Le mode signé transmet l'identifiant utilisateur WordPress, ses rôles, son login, son nom affiché et son adresse email à Ask This Guy. Vous devez le mentionner dans la politique de confidentialité de votre site avant de l'activer. Le `readme.txt` du plugin propose une clause type à copier. Pour l'activer : 1. Sur la page de réglages, allez à la section **Mode signé (avancé)**. 2. Cochez **Un token JWT sera signé avec votre clé privée pour permettre aux utilisateurs authentifiés d'accéder au chat**. 3. Cliquez sur **Enregistrer les modifications**. Le plugin génère une paire de clés privée et publique. 4. Copiez la **clé publique** affichée sous le toggle, ainsi que le `kid` indiqué à côté. 5. Dans la console d'administration ATG, dans les **Paramètres signés** de votre agent, enregistrez cette clé publique avec ce `kid`. La clé privée ne quitte jamais votre installation WordPress. Elle est stockée dans la table standard `wp_options` de votre propre base. ### Renouveler la clé de signature Le renouvellement se fait en deux temps, pour que la clé active continue de signer pendant que vous enregistrez la nouvelle dans la console ATG. Aucune conversation n'est interrompue. Dans **Réglages → Ask This Guy Chat → Renouveler la clé de signature** : 1. Cliquez sur **Préparer une nouvelle clé**. Une nouvelle paire est générée et un nouveau `kid` est affiché, mais la clé active continue de signer les conversations. 2. Copiez la **nouvelle clé publique** et enregistrez-la dans votre console ATG, à côté de la clé active (ne supprimez pas encore l'ancienne). 3. Cliquez sur **Validez la nouvelle clé**. Le plugin signe désormais les nouveaux JWT avec le nouveau `kid`. Vous pouvez alors retirer l'ancienne clé de votre console ATG. Si besoin, **Supprimer la nouvelle clé** annule la préparation : la clé active continue de signer comme avant. --- # Outils sur mesure URL: https://www.askthisguy.com/fr/doc/customizing-atg-to-you/tailored-tools/ Language: fr Section: Documentation ## Interroger vos outils d’entreprise Au-delà des documents et des bases de connaissances, ATG peut **appeler vos systèmes d’entreprise** pour que l’assistant réponde en s’appuyant sur des données à jour issues de votre CRM, de vos outils internes ou d’autres API. ### Principe Nous pouvons développer des **outils personnalisés** que l’**agent orchestrateur (IA)** d’ATG invoque lorsque c’est pertinent. Ces outils dialoguent avec **vos API** : par exemple votre CRM, votre outil de ticketing, vos outils RH ou tout autre service utilisé dans l’organisation. L’agent décide quand utiliser chaque outil, envoie les bons paramètres et s’appuie sur les résultats pour répondre à l’utilisateur en langage naturel. ### Cas d’usage typiques - **CRM** – « Quel est le statut de l’opportunité X ? » ou « Liste des affaires ouvertes pour la région Y. » - **Applications internes** – Consulter stocks, commandes ou avancement de projets depuis vos propres systèmes. - **RH / annuaire** – Qui fait quoi, qui contacter pour un sujet donné. - **Reporting** – Extraire chiffres ou synthèses depuis vos outils métier plutôt que depuis des documents figés. L’assistant devient ainsi un **point d’entrée unique** pour vos connaissances et vos données opérationnelles. ### Propriété Comme pour les autres développements spécifiques à votre instance, le **code source propre au client** (implémentation des outils pour vos API) **vous appartient**. ATG le livre et le maintient pour vous, mais vous en êtes propriétaire. **Contactez votre interlocuteur ATG** pour identifier quels systèmes pourraient être exposés en outils et comment procéder. --- # Outils URL: https://www.askthisguy.com/fr/doc/admin-console/tools-management/chat-tools/ Language: fr Section: Documentation Les **outils** sont les capacités intégrées à ATG qu’un agent peut mobiliser pendant un échange : chercher dans vos connaissances, consulter le web, produire un fichier bureautique, vous envoyer un e-mail, et d’autres encore. Chaque organisation part du même catalogue, sans développement. ## Comment un outil devient utilisable 1. **Au niveau de l’organisation.** Ouvrez **Outils et MCP** dans la console d’administration pour voir le catalogue. La plupart des outils sont actifs pour les nouvelles organisations ; quelques-uns doivent être activés explicitement. 2. **Au niveau de l’agent.** L’onglet **Outils** de chaque agent détermine lesquels il peut utiliser. Consultez [Agents](https://www.askthisguy.com/doc/admin-console/how-to-configure-the-agents). 3. **Dans la conversation.** L’agent choisit lui-même l’outil pertinent, selon la demande et ses instructions. L’utilisateur ne peut pas activer un outil depuis le chat : si l’agent ne l’a pas, la capacité n’existe tout simplement pas. Dans les tableaux ci-dessous, la colonne **Widget** indique si l’outil fonctionne pour les [agents widget](https://www.askthisguy.com/doc/atg-embedded/how-to-integrate-atg-embedded-in-your-webapp) intégrés à un site public. Les outils marqués **Non** ne fonctionnent que dans la webapp authentifiée, car ils écrivent dans les fichiers ou la messagerie d’un utilisateur identifié. ## Connaissances et documents Ces outils se complètent : l’un cherche dans le contenu, un autre localise un fichier précis, un troisième le lit intégralement, et le dernier répond aux questions d’inventaire sur la base elle-même.
OutilCe qu’il faitWidgetActif par défaut
Recherche dans les connaissancesCherche le sens de vos [documents](https://www.askthisguy.com/doc/admin-console/knowledge-management) indexés et renvoie les passages pertinents.OuiOui
Recherche de documents pertinentsIdentifie les documents correspondant à une description, quand l’utilisateur cherche un fichier plutôt qu’une réponse.OuiOui
Lecture d’un documentLit un document en entier, une fois qu’il a été identifié, y compris les fichiers déposés par l’utilisateur.OuiOui
Interrogation du catalogue documentaireRépond sur la base elle-même : combien de documents, quels dossiers, quelle source, quel statut.Oui**Non**
Contexte de l’organisationRécupère la description libre de votre organisation saisie dans [Organisation](https://www.askthisguy.com/doc/admin-console/organization-settings).OuiOui
**L’interrogation du catalogue documentaire s’active manuellement.** Activez-la si vos utilisateurs posent des questions de dénombrement ou d’inventaire (« combien de contrats sont indexés ? », « liste les sous-dossiers de ce Drive »). La recherche seule ne peut pas y répondre de façon fiable, car elle porte sur le contenu et non sur le catalogue. Tous ces outils respectent les catégories de connaissances accordées à l’agent. Un utilisateur ne voit jamais un document que son agent n’a pas le droit de lire. ## Contenus web
OutilCe qu’il faitWidgetActif par défaut
Recherche webCherche sur le web public les informations récentes que vos documents et le modèle ne couvrent pas.OuiOui
Lecture d’une page webLit les pages derrière les URL fournies par l’utilisateur, ou derrière un lien présent dans vos connaissances.OuiOui
N’attribuez ces deux outils qu’aux agents pour lesquels la consultation de sources externes est acceptable. ## Fichiers et visuels Ces outils produisent un fichier téléchargeable, enregistré dans les fichiers personnels de l’utilisateur. Ils sont donc réservés à la webapp.
OutilCe qu’il faitWidgetActif par défaut
Génération de document WordTransforme une réponse rédigée en fichier `.docx`, avec ses titres et ses listes.NonOui
Génération de présentation PowerPointConstruit un diaporama `.pptx`, une diapositive par titre principal.NonOui
Génération de tableurExporte des données structurées en fichier CSV ou Excel.NonOui
Génération d’imageCrée ou modifie une illustration à partir d’une description textuelle.NonOui
La génération d’image sert aux illustrations, pas aux graphiques. Les figures issues de vos données s’affichent directement dans la conversation, sans appel d’outil. ## Communication
OutilCe qu’il faitWidgetActif par défaut
M’envoyer par e-mailEnvoie à l’utilisateur courant un e-mail reprenant un contenu produit dans la conversation.NonOui
Le destinataire est toujours l’adresse du profil de l’utilisateur connecté. L’agent ne choisit jamais le destinataire et ne peut rien envoyer à un tiers. Les administrateurs peuvent ajuster les couleurs de l’e-mail depuis **Outils et MCP**. ## Veille et données spécialisées
OutilCe qu’il faitWidgetActif par défaut
Revue de presseProduit une synthèse d’actualité suivant le brief défini dans [Revue de presse](https://www.askthisguy.com/doc/admin-console/organization-settings/press-review).OuiOui
Base de données des bâtiments (BDNB)Interroge la Base de Données Nationale des Bâtiments pour obtenir les données publiques d’un bâtiment ou d’une parcelle.Oui**Non**
La BDNB répond à un besoin métier précis, surtout dans l’immobilier et la rénovation énergétique. Ne l’activez que pour les agents concernés. ## Salesforce Salesforce peut être connecté à ATG via une intégration adaptée à votre instance. Son modèle de données étant souvent personnalisé, une légère phase d’intégration et de configuration sera nécessaire pour identifier les objets, champs, relations et règles métier utiles. L’outil exploite alors les données Salesforce avec le bon contexte. ## Aller plus loin Les outils intégrés couvrent les besoins les plus courants. Deux options les prolongent : - Les **[serveurs MCP](https://www.askthisguy.com/doc/admin-console/tools-management/mcp-servers)** et le **[catalogue MCP](https://www.askthisguy.com/doc/admin-console/tools-management/mcp-catalog)** connectent des services tiers via un protocole standard. - Les **[outils sur mesure](https://www.askthisguy.com/doc/customizing-atg-to-you/tailored-tools)** interrogent vos propres systèmes (CRM, ticketing, API internes) quand aucun outil standard ne convient. --- # Serveurs MCP URL: https://www.askthisguy.com/fr/doc/admin-console/tools-management/mcp-servers/ Language: fr Section: Documentation L’écran **Serveurs MCP** sert à connecter les agents IA à des outils et des sources de données externes via un **protocole standard** (Model Context Protocol), plutôt que de développer une intégration spécifique pour chaque produit. Dans la console, ouvrez **Outils et MCP**, puis l’onglet **Serveurs MCP**. Vous y gérez les serveurs ajoutés manuellement ou via le [catalogue MCP](https://www.askthisguy.com/doc/admin-console/tools-management/mcp-catalog). La liste des serveurs MCP configurés s’affiche dans cette vue. ![Liste des serveurs MCP sous Outils et MCP](https://www.askthisguy.com/doc/mcp-01-fr.webp) ## Rôle et comportement Le MCP fait le pont entre l’IA et vos systèmes. Au lieu d’un développement sur mesure par application, le protocole permet au modèle de découvrir ce qu’un serveur MCP distant expose et de l’appeler au besoin. - **Gestion centralisée** - Les systèmes tiers (SaaS, bases internes, API métier) sont configurés et supervisés depuis une même interface d’administration. - **Utilisation à la demande** - Le modèle interprète la demande de l’utilisateur et n’invoque un serveur MCP que lorsqu’il lui faut des informations ou des actions qu’il ne peut pas couvrir avec les outils intégrés ou la connaissance interne seuls. ## Ajouter et configurer un serveur Cliquez sur **+ Serveur MCP** pour créer un serveur. Une boîte de dialogue permet de renseigner les paramètres ci-dessous. ![Boîte de dialogue d’ajout d’un serveur MCP](https://www.askthisguy.com/doc/mcp-02-fr.webp) La connexion d’un serveur MCP est pensée pour être réalisable sans expertise développeur poussée : - **Nom du serveur** - Libellé clair pour identifier la source de données ou l’intégration. - **URL du serveur** - **URL de base** MCP. Vous pouvez la saisir **avec ou sans slash final**, selon la documentation du fournisseur ; l’important est que l’URL combinée corresponde au point de terminaison attendu. - **Méthode d’authentification** - Mode d’envoi des identifiants. - **Aucune** - Connexion sans identifiants lorsque le point d’accès MCP l’autorise. - **Jeton Bearer** - Secret envoyé en en-tête **Bearer** (pas dans le chemin d’URL). - **Clé API dans le chemin d’URL** - Secret envoyé comme **dernier segment de chemin** après l’URL de base (par ex. `…/votre-url-de-base/`). Pas d’en-tête Bearer. À utiliser lorsque le fournisseur impose une clé dans le chemin (bases juridiques, registres, etc.). Les identifiants sont **stockés de manière sécurisée**. Lors de la **modification** d’un serveur existant, **laissez le champ secret vide** pour conserver la valeur enregistrée ; saisissez une nouvelle valeur uniquement pour une rotation ou un remplacement. - **Type de transport** - Mode de communication avec le serveur. - **HTTP Streaming** - Choix par défaut recommandé pour la plupart des déploiements MCP. - **SSE** (Server-Sent Events) - À utiliser si le serveur distant repose sur le SSE plutôt que sur le HTTP Streaming ; alignez-vous sur la documentation du fournisseur. En pratique : privilégiez **HTTP Streaming** sauf obligation explicite de **SSE**. ## Découverte et sélection des outils Une fois les paramètres de connexion renseignés, utilisez **Tester la connexion** pour que le produit joigne le serveur MCP et **liste les outils** exposés. Configurez ensuite **les outils disponibles** : - Choisissez un **mode de filtre** : **tous** les outils découverts, **inclure uniquement** une sélection, ou **exclure** certains outils. - Utilisez les **cases à cocher** pour définir ce qui est inclus ou exclu selon le mode choisi. Vous pouvez marquer le serveur comme **inactif** (ou le **désactiver**) pour cesser de l’exposer dans le chat sans supprimer la configuration ; réactivez-le quand vous êtes prêt. Ces réglages évoluent à tout moment selon vos intégrations. ## Analyse combinée entre sources Le MCP prend tout son sens combiné au reste du contexte : - **Sources multiples** - L’IA peut combiner un serveur MCP (données spécialisées ou temps réel), la base de connaissances interne et le web, selon la requête. - **Réponses synthétisées** - Les résultats MCP sont intégrés à une réponse cohérente plutôt qu’un simple flux brut de sorties d’outils. En résumé, **Serveurs MCP** permet à l’assistant d’orchestrer l’accès aux données là où elles se trouvent, tout en vous laissant le contrôle sur les outils externes exposés. --- # Catalogue MCP URL: https://www.askthisguy.com/fr/doc/admin-console/tools-management/mcp-catalog/ Language: fr Section: Documentation Le **catalogue MCP** permet d’ajouter des services MCP tiers à votre organisation sans tout reconstituer à la main. Dans **Outils et MCP**, ouvrez l’onglet **Serveurs MCP**, puis **Parcourir le catalogue** (à distinguer de **Mes serveurs**, qui liste ce que vous avez déjà configuré). ![Catalogue MCP : vue Parcourir le catalogue avec les cartes d’intégration](https://www.askthisguy.com/doc/mcp-catalog-01-fr.webp) Chaque carte résume un service (description, étiquettes comme France ou Juridique, lien vers la documentation du fournisseur). Utilisez **+ Ajouter** pour commencer l’ajout à l’organisation. Lorsqu’un service est déjà connecté, la carte peut afficher **Configuré** à la place. ## Accès libre et clés API Les entrées du catalogue se répartissent en deux grands cas : - **Accès ouvert / public** - Certains points d’accès ne demandent pas d’inscription chez le tiers ni de secret à coller ; le produit peut les marquer comme prêts une fois ajoutés (par exemple des données publiques ouvertes comme **datagouv**). - **Compte et clé chez le fournisseur** - D’autres attendent que vous créiez un compte sur le site du fournisseur, génériez un jeton API et le saisissiez dans la console. Le jeton est stocké de manière sécurisée et transmis selon le service (souvent en **Bearer**). Consultez systématiquement la documentation du fournisseur (lien sur la carte) pour tarifs, quotas et conditions. ## Ajouter à l’organisation Lorsqu’un service exige des identifiants, une boîte du type **Ajouter à l’organisation** recueille le libellé du serveur, l’**URL du serveur** (souvent préremplie depuis le catalogue), l’**authentification** (par ex. **Jeton Bearer**) et le champ **Jeton API**. Utilisez **Tester et ajouter** pour valider la connexion avant enregistrement. ![Ajouter à l’organisation : exemple avec jeton Bearer et Tester et ajouter](https://www.askthisguy.com/doc/mcp-catalog-02-fr.webp) Après un ajout réussi, le serveur apparaît dans **Mes serveurs** et suit le même cycle de vie que tout autre serveur MCP (sélection des outils, actif/inactif, modifications). Voir [Serveurs MCP](https://www.askthisguy.com/doc/admin-console/tools-management/mcp-servers) pour les options de connexion et le filtrage des outils. ## Intégrations mises en avant ### Normi - DVF et immobilier français **Normi** expose des données de transactions immobilières françaises (DVF) nettoyées, des recoupements avec les diagnostics de performance énergétique (DPE) et des analyses de marché via plus de 25 outils MCP : comparables, tendances, comparaisons de quartiers, etc. Créez un compte sur le site de Normi, obtenez le jeton API et activez-le dans ATG via le catalogue MCP. --- # Agents URL: https://www.askthisguy.com/fr/doc/admin-console/how-to-configure-the-agents/ Language: fr Section: Documentation Chaque conversation ATG utilise obligatoirement un **agent**. Celui-ci définit les instructions, les connaissances et les outils disponibles pendant la conversation. ATG propose deux types d'agents : - **Webapp** : utilisé par les membres authentifiés de votre organisation dans la webapp ATG. - **Widget** : intégré dans un site web, un produit SaaS ou une application. Les deux types se configurent depuis le même espace et partagent les réglages principaux. Chaque type dispose aussi d'onglets dédiés. **Le type d'agent est définitif.** Choisissez Webapp ou Widget lors de la création. Pour changer de mode de déploiement, créez un nouvel agent. ## Créer un agent Dans la console d'administration, ouvrez **Agents**, puis créez un agent en définissant : - **Nom de l'agent** : un nom clair qui aide les administrateurs et les utilisateurs à reconnaître son rôle. - **Description** : une courte explication de son objectif. - **Instructions spécifiques** : le rôle, les objectifs, le ton, les règles de réponse et les limites de l'agent. - **Type d'agent** : Webapp ou Widget. ![Création d'un agent ATG et choix entre Webapp et Widget](https://www.askthisguy.com/doc/agents-create-type-fr.webp) Le type choisi détermine les réglages dédiés disponibles après la création. ## Comparer les agents Webapp et Widget
RéglageWebappWidget
ConfigurationOuiOui
ConnaissancesOuiOui
OutilsOuiOui
PlaygroundOuiOui
Accès des utilisateurs internesOuiNon
Visibilité des sourcesNonOui
Sécurité JWT et origines autoriséesNonOui
Code d'intégration et UUIDNonOui
## Configurer les réglages communs Sélectionnez un agent pour ouvrir ses paramètres. Les onglets **Configuration**, **Connaissances** et **Outils**, ainsi que le Playground, sont disponibles pour les deux types d'agents. ### Configuration L'onglet Configuration permet de modifier : - le nom et la description de l'agent ; - ses instructions spécifiques ; - sa politique IA ; - son statut actif ou inactif. Les instructions sont le principal réglage comportemental. Indiquez ce que l'agent doit faire ou éviter, comment il doit guider les utilisateurs et quel ton il doit adopter. ![Onglet Configuration d'un agent Webapp avec le Playground](https://www.askthisguy.com/doc/agents-webapp-configuration-fr.webp) ### Connaissances Sélectionnez les catégories de connaissances que l'agent peut rechercher. Les catégories regroupent les sources nécessaires à un rôle ou à un cas d'usage. Les catégories de connaissances sont affectées aux **agents, jamais aux utilisateurs**. Un utilisateur qui peut accéder à un agent peut utiliser les catégories de connaissances configurées pour cet agent. Consultez [Connaissances](https://www.askthisguy.com/doc/admin-console/knowledge-management) pour comprendre l'ensemble du modèle d'accès. Limitez chaque agent aux catégories dont il a réellement besoin. Un périmètre de connaissances ciblé produit généralement des réponses plus pertinentes et simplifie la gestion des accès. ### Outils Sélectionnez tous les outils que l'agent est autorisé à utiliser : recherche dans la base de connaissances, recherche web, récupération de documents, génération d'images ou outils personnalisés. La configuration de l'agent **détermine entièrement les outils disponibles dans une conversation**. Les utilisateurs ne peuvent pas activer d'outils supplémentaires depuis la webapp. Si un outil n'est pas activé pour l'agent sélectionné, celui-ci ne peut pas l'utiliser. ![Outils activés pour un agent Webapp dans la console d'administration](https://www.askthisguy.com/doc/agents-webapp-tools-fr.webp) Consultez [Outils](https://www.askthisguy.com/doc/admin-console/tools-management/chat-tools) pour le rôle de chaque outil intégré, et [Outils et MCP](https://www.askthisguy.com/doc/admin-console/tools-management) pour les serveurs MCP et les outils personnalisés. ### Playground Le Playground s'affiche à côté des réglages. Utilisez-le pour tester l'agent après une modification de ses instructions, connaissances ou outils. Réinitialisez la conversation de test pour valider un changement depuis un contexte vierge. ## Configurer un agent Webapp Les agents Webapp disposent d'un onglet **Accès** supplémentaire. ### Contrôler qui peut utiliser l'agent Choisissez l'un des modes suivants : - **Ouvert à tous** : tous les utilisateurs de l'organisation peuvent voir et utiliser l'agent. - **Restreint** : seuls les utilisateurs sélectionnés peuvent voir et utiliser l'agent. ![Onglet Accès d'un agent Webapp avec les modes ouvert et restreint](https://www.askthisguy.com/doc/agents-webapp-access-fr.webp) Seuls les agents Webapp actifs et accessibles à un utilisateur apparaissent dans son sélecteur d'agents. Les droits peuvent être gérés depuis l'agent ou depuis la fiche de l'utilisateur. Consultez [Utilisateurs](https://www.askthisguy.com/doc/admin-console/users-management). L'espace contient initialement un agent interne par défaut. Il peut être reconfiguré, restreint ou supprimé. Pour démarrer une conversation dans la webapp, un utilisateur doit avoir accès à au moins un agent Webapp actif. ## Configurer un agent Widget Les agents Widget disposent des onglets **Sources**, **Sécurité** et **Code d'intégration**. ### Visibilité des sources L'onglet Sources contrôle la présentation des références aux utilisateurs du widget : - afficher ou masquer par défaut les sources documentaires et web ; - remplacer ce comportement pour une source précise ; - configurer la conversion d'URL pour les sources web compatibles. ![Réglages de visibilité des sources d'un agent Widget](https://www.askthisguy.com/doc/agents-sources-tab.webp) ### Messages d'accueil personnalisés Les messages d'accueil du widget peuvent utiliser les valeurs du JWT signé de la session. Toute valeur de `context_metadata` est disponible sous forme de `{{placeholder}}`. Deux formes sont prises en charge : - `{{first_name}}` : remplacé par `first_name`, ou par une valeur vide si la clé est absente. - `{{first_name|cher visiteur}}` : remplacé par `first_name`, ou par le texte de repli `cher visiteur` si la clé est absente ou vide. Par exemple : > `Bonjour {{first_name|cher visiteur}}, comment puis-je vous aider aujourd'hui ?` La casse et les underscores ne sont pas pris en compte pour les noms de clés. `firstName`, `first_name` et `FirstName` correspondent tous à `{{first_name}}`. ### Sécurité L'onglet Sécurité permet de : - demander un JWT signé pour chaque session de chat ; - configurer les origines autorisées à intégrer le widget ; - gérer les clés publiques utilisées pour vérifier les JWT. ![Onglet Sécurité moderne avec les domaines autorisés et les clés JWT d'un agent Widget](https://www.askthisguy.com/doc/agents-widget-security-fr.webp) ### Code d'intégration L'onglet Code d'intégration fournit : - l'UUID unique de l'agent ; - des exemples d'intégration JavaScript avec ou sans authentification JWT ; - les informations nécessaires au chargement et à la configuration du widget. Consultez [Intégrer le widget ATG dans votre webapp](https://www.askthisguy.com/doc/atg-embedded/how-to-integrate-atg-embedded-in-your-webapp) pour le processus complet. ## Gérer le cycle de vie d'un agent - **Désactivez** un agent pour le retirer de l'usage sans supprimer sa configuration. - **Supprimez** un agent qui n'est plus nécessaire. - **Créez un nouvel agent** pour changer de type de déploiement, car le type Webapp ou Widget ne peut pas être modifié. - **Testez les changements** dans le Playground avant de rendre l'agent accessible aux utilisateurs. --- # Requête base de données URL: https://www.askthisguy.com/fr/doc/customizing-atg-to-you/database-query/ Language: fr Section: Documentation ## Valeur métier Beaucoup de questions posées par vos équipes portent sur des **données structurées** : chiffres d’affaires, stocks, avancement de projets, ou toute autre information stockée en base. Rédiger du SQL ou attendre un rapport est long — et pour de nombreux utilisateurs, **le SQL est tout simplement hors de portée** (trop technique). Formuler sa demande en **langage courant** est plus rapide et **accessible à tous** ceux qui ont besoin de la réponse. **Requête base de données** permet de poser des questions naturellement et d’obtenir des réponses à partir de vos données, sans écrire la moindre requête. Un autre frein courant est de **croiser des informations éparpillées** : plusieurs bases ou schémas SQL, **tables structurées** à côté de **connaissances non structurées** (documents, wikis, chat), ou données opérationnelles face au contexte narratif. L’**agent orchestrateur** peut utiliser l’outil Requête base de données **avec d’autres outils et sources de connaissances** (par ex. [Outils sur mesure](https://www.askthisguy.com/doc/customizing-atg-to-you/tailored-tools), documents de l’organisation) pour qu’une même conversation franchisse ces frontières au lieu d’obliger les utilisateurs à jongler entre systèmes. ATG peut générer et exécuter du **SQL** sur **votre propre base** ou une **base hébergée et gérée pour vous** (par exemple un schéma PostgreSQL dédié). L’assistant l’expose comme un **outil** à l’agent orchestrateur : lorsqu’une question concerne ces données, l’agent appelle l’outil, qui transforme la question en SQL, l’exécute et renvoie un résultat interprété. ## Mise en œuvre type Une configuration courante comprend : - Une **base client dédiée** (par ex. un **schéma PostgreSQL dédié** – un ensemble de tables isolé dans la même base). Cela sépare vos données et facilite la gestion. - Un **outil Requête base de données dédié** exposé à l’**agent orchestrateur (IA)**. L’agent le voit parmi les autres outils disponibles et décide quand l’utiliser. L’outil repose sur **trois textes de configuration** : 1. **Description de l’outil** – Présentée à l’agent orchestrateur pour qu’il sache **quand et comment** appeler l’outil (par ex. quels types de questions il peut traiter). 2. **Instructions de génération SQL** – Description du schéma (tables, colonnes, contexte métier) utilisée par une **IA dédiée à la génération SQL** pour produire le SQL à partir de la question en langage naturel. 3. **Interprétation des résultats** – Court texte renvoyé à l’orchestrateur avec le résultat de la requête, pour interpréter correctement les données (signification des colonnes, unités, contexte métier). L’outil n’autorise que l’accès en **lecture seule** : seules les requêtes **SELECT** sont permises. Aucune modification des données. **Périmètre du schéma** – L’intégralité du schéma n’a pas besoin d’être exposée à l’IA. Privilégiez des **tables ou vues bien documentées**, claires et utiles pour les questions métier. L’IA de génération SQL travaille ainsi sur un périmètre maîtrisé et lisible. ## Flux de bout en bout ```mermaid sequenceDiagram participant U as Utilisateur participant A as Gestionnaire de workflow (ATG) participant O as IA principale (IA) participant T as Outil Requête base de données (ATG) participant S as Génération SQL (IA) participant B as Base de données (cliente ou gérée par ATG) U->>A: Message A->>O: Tour de dialogue (contexte + message + définitions des outils) O->>A: Appel d'outil (question en langage naturel) A->>T: Appel d'outil T->>S: Demander la requête SQL (question + instructions) S->>T: Requête SQL T->>B: Exécuter la requête SQL B->>T: Résultat T->>A: Résultat + explication A->>O: Tour de dialogue (contexte + message + résultat d'outil) O->>A: Réponse pour l'utilisateur A->>U: Réponse ```

Le schéma suit une question de bout en bout : l’IA principale décide d’appeler l’outil Requête base de données en formulant une question en langage naturel, une IA dédiée traduit cette question en SQL, et l’outil exécute la requête en lecture seule avant de renvoyer le résultat accompagné de son explication. Plusieurs tours de dialogue sont possibles, et l’outil Requête base de données n’est que l’un des outils disponibles.

**[Réserver une démo](https://www.askthisguy.com/demo)** pour échanger sur la connexion de votre base ou la mise en place d’une base gérée pour cette capacité. --- # Configurer le mode vocal URL: https://www.askthisguy.com/fr/doc/admin-console/voice-mode/ Language: fr Section: Documentation Le mode vocal se configure séparément pour chaque agent. Une fois activé, il transforme l'agent en assistant vocal IA : les utilisateurs dictent leurs messages et écoutent ses réponses dans la webapp ATG authentifiée. **Périmètre :** le fonctionnement présenté ici a été vérifié dans la webapp principale authentifiée. Ne présumez pas que le mode vocal est disponible dans le widget intégré ou les conversations partagées. ## Activer le mode vocal 1. Dans la console d'administration, ouvrez **Agents**. 2. Sélectionnez l'agent à configurer. 3. Ouvrez l'onglet **Configuration**. 4. Activez **Activer le mode vocal**. 5. Vérifiez le fournisseur de reconnaissance vocale, le fournisseur de synthèse vocale et la voix. Réglages du mode vocal dans l'onglet Configuration d'un agent ATG Dès que l'agent est actif et accessible à un utilisateur, un bouton de microphone **Parler** apparaît dans le champ de saisie de la webapp. ## Choisir les services vocaux Les fournisseurs et les voix disponibles dépendent des services configurés dans votre environnement. - **Fournisseur de reconnaissance vocale :** transcrit l'enregistrement de l'utilisateur en texte modifiable. - **Fournisseur de synthèse vocale :** transforme la réponse terminée de l'agent en audio. - **Voix :** détermine la voix utilisée pour lire les réponses. L'option **Par défaut** utilise le service par défaut disponible sur la plateforme. Si vous sélectionnez une voix précise, vérifiez que sa langue correspond au public de l'agent. ## Effets de l'activation pour les utilisateurs Pour les utilisateurs de l'agent configuré : - un bouton de microphone devient disponible dans les nouvelles conversations comme dans les conversations existantes ; - chaque enregistrement est transcrit puis préparé pour un envoi automatique ; - la réponse à un message dicté est lue automatiquement ; - toute réponse terminée peut aussi être écoutée à la demande. Le mode vocal complète la conversation écrite. Il ne désactive ni le clavier, ni les pièces jointes, ni les modes de réponse, ni les autres fonctions du chat. Il ne crée pas non plus d'appel vocal continu en temps réel. ## Mode vocal, chatbot vocal ou voicebot ? Le mode vocal ATG répond à un besoin précis. Avant de le déployer, vérifiez qu'il correspond bien à l'usage attendu. - **Mode vocal ATG :** dictée des messages et lecture des réponses, agent par agent, dans la webapp authentifiée. C'est un agent vocal IA interne, adossé à vos connaissances et à vos outils. - **Chatbot vocal sur site public :** le widget [ATG Embedded](https://www.askthisguy.com/doc/atg-embedded) n'est pas couvert par cette page. Ne présumez pas que le vocal y est disponible. Pour le cadrage d'un agent conversationnel de site web, voir la page [Chatbot de site web](https://www.askthisguy.com/solutions/website-chatbot/). - **Voicebot ou callbot téléphonique :** hors périmètre. Le mode vocal n'établit pas d'appel téléphonique et ne tient pas de conversation audio continue en temps réel. ## Valider la configuration Testez la fonctionnalité avec un compte utilisateur autorisé à accéder à l'agent : 1. Vérifiez que le bouton **Parler** apparaît pour cet agent. 2. Autorisez le microphone et enregistrez une courte question. 3. Contrôlez la transcription et le compte à rebours de deux secondes avant l'envoi automatique. 4. Annulez l'envoi et vérifiez que le texte reste modifiable. 5. Envoyez un message vocal et vérifiez que la réponse terminée est lue à voix haute. 6. Arrêtez la lecture, puis utilisez **Lire à voix haute** sur une réponse précédente. Testez également les navigateurs pris en charge par votre organisation. Les autorisations du microphone et les règles de lecture automatique du navigateur peuvent influer sur l'enregistrement et la restitution audio. ## Contraintes actuelles - Chaque enregistrement est limité à 60 secondes. - La transcription et la synthèse vocale nécessitent une connexion réseau. - Les utilisateurs ne peuvent pas choisir le fournisseur ou la voix depuis le chat, et aucune préférence vocale n'est enregistrée par utilisateur. - Parler n'interrompt pas automatiquement un contenu audio en cours de lecture. - La disponibilité des fournisseurs peut varier selon les environnements. Ne faites aucune supposition sur la durée de conservation des extraits audio. Avant le déploiement, vérifiez les exigences de confidentialité de votre organisation et les politiques des fournisseurs vocaux configurés. Partagez la page [Utiliser le mode vocal](https://www.askthisguy.com/doc/webapp/using-voice-mode) avec vos utilisateurs pour les instructions et le dépannage. --- # Tags et alertes URL: https://www.askthisguy.com/fr/doc/admin-console/tags-alerts/ Language: fr Section: Documentation Les **Tags et alertes** permettent de définir des règles qui **étiquettent** automatiquement les conversations et, si vous le souhaitez, **envoient des notifications par e-mail** lorsqu’une conversation correspond à une condition que vous décriviez en langage clair—sans vous limiter à une liste figée de mots-clés. ## Liste et filtres La vue principale présente vos tags dans un tableau. Utilisez le menu déroulant **Agent** en haut de page pour gérer les règles **pour un assistant précis** (chaque tag est rattaché à un agent). ![Vue d’ensemble Tags et alertes : liste, filtre par agent et bouton Nouveau tag](https://www.askthisguy.com/doc/tags-alerts-01-fr.webp) ### Colonnes du tableau - **Tag** — Libellé appliqué aux conversations correspondantes (réutilisé ailleurs dans les analyses). - **Condition** — Brève description du cas où le tag s’applique ; le texte complet se modifie dans le panneau latéral. - **E-mail** — Nombre de destinataires configurés pour les alertes sur ce tag. - **Actif** — Active ou désactive la règle sans la supprimer. - **Actions** — Modifier ou supprimer le tag. ## Créer ou modifier un tag Choisissez **+ New Tag** ou ouvrez une ligne existante. Un **panneau latéral** s’ouvre pour la définition du tag. ![Édition d’un tag : libellé, condition, agent, bascules étiquetage et e-mail](https://www.askthisguy.com/doc/tags-alerts-02-fr.webp) ### Champs obligatoires - **Tag label** — Nom clair du tag (par exemple « Intention d’achat » ou « Client veut annuler »). - **Condition** — Décrivez en **langage naturel** ce qui doit compter comme correspondance (par exemple intérêt pour une offre supérieure, demande de devis ou risque de désabonnement). Le système tient compte du **contexte de la conversation** ; vous pouvez formuler la règle comme votre équipe raisonne sur le cas. - **Agent** — L’assistant auquel cette règle s’applique. ### Analyser les conversations Activez **Tag conversations that match this condition** pour appliquer ce tag lorsque la condition est satisfaite. ### Notifications par e-mail Activez **Send an email when this condition matches a conversation** pour prévenir une ou plusieurs adresses lors d’une correspondance. Saisissez le ou les e-mails dans le champ prévu. Enregistrez vos modifications avec l’action en bas du panneau. ## Utiliser les tags avec Insights Les conversations étiquetées alimentent **Insights** (par exemple les répartitions par tag). Définissez des tags stables ici, puis consultez volumes et tendances dans [Insights](https://www.askthisguy.com/doc/admin-console/insights). --- # Évaluation des agents URL: https://www.askthisguy.com/fr/doc/admin-console/agent-evaluation/ Language: fr Section: Documentation ## Qu'est-ce que l'évaluation des agents ? L'**évaluation des agents** vous aide à tester comment votre agent répond à un grand nombre de questions. **Utilisez-la pour :** - L'assurance qualité avant de lancer votre agent - Identifier les domaines où votre agent doit s'améliorer - Les tests de régression après des modifications de votre base de connaissances - Mesurer les performances de l'agent dans le temps ![Interface d'évaluation des agents](https://www.askthisguy.com/doc/documentation-for-administrators-admin-console-agent-evaluation-interface-fr.webp) ## Pour commencer ### 1. Sélectionner un agent Choisissez l'agent que vous souhaitez évaluer dans le menu déroulant **Agent** en haut de la page. ### 2. Choisir la langue de test Sélectionnez la langue pour vos questions de test : - **EN** - Anglais - **FR** - Français Vos jeux de questions en anglais et en français sont séparés et l'agent répondra dans la même langue que la question. ## Ajouter des questions Vous pouvez : - saisir vos questions manuellement - importer un fichier de questions - demander à la plateforme de générer des questions pour vous ### Importer des questions **Formats supportés :** fichiers CSV ou TXT 1. Cliquez sur **Upload Questions** 2. Sélectionnez un fichier `.csv` ou `.txt` depuis votre ordinateur 3. Les questions doivent être une par ligne/rangée 4. Pour les fichiers CSV, utilisez uniquement la première colonne (supprimez les colonnes supplémentaires) 5. Si votre question existe déjà dans votre jeu, elle ne sera simplement pas ajoutée pour éviter les doublons **Notes importantes :** - Maximum 50 questions par exécution de test - Si vous importez depuis un tableur (Excel, Numbers), exportez d'abord en CSV - Les fichiers sont automatiquement enregistrés dans votre jeu de questions ### Option B : Générer des questions Laissez le système générer automatiquement des questions à partir de la base de connaissances de votre agent : 1. Cliquez sur **Generate Questions** 2. Choisissez le nombre de questions (5-50) 3. Sélectionnez les types de contenu à inclure (documents, fichiers, sources web) 4. Examinez les questions générées 5. Sélectionnez celles à conserver et cliquez sur **Add Selected** Pour vous donner une image complète des performances de votre agent, la fonctionnalité d'évaluation génère un mélange de questions pertinentes et hors sujet. Cela vous aide à voir comment votre agent gère les requêtes qui sortent de son domaine prévu. **Gain de temps :** Générez des questions automatiquement pour démarrer rapidement, puis affinez votre jeu de tests en fonction des schémas d'utilisation réels. ## Gérer votre jeu de questions Une fois que vous avez chargé des questions, vous pouvez : - **Sélectionner/désélectionner** des questions avec les cases à cocher (seules les questions sélectionnées seront exécutées) - **Modifier** le texte d'une question en cliquant dessus - **Supprimer** les questions dont vous n'avez pas besoin - **Ajouter** de nouvelles questions manuellement avec le bouton "+ Add Question" ### Télécharger les questions Exportez vos questions sous forme de fichier CSV avec le bouton **Download Questions**. Utile pour : - Sauvegarder votre jeu de questions - Partager avec les membres de l'équipe - Modifier en masse dans un tableur ## Lancer des tests ### Démarrer un test 1. Assurez-vous d'avoir des questions sélectionnées (cases cochées) 2. Cliquez sur le bouton **Run Test** 3. Suivez la progression en temps réel à mesure que chaque question reçoit une réponse 4. Les résultats apparaissent un par un au fur et à mesure qu'ils sont terminés **Maximum :** 50 questions par exécution Vous ne pouvez lancer qu'une seule évaluation à la fois pour un agent spécifique dans votre organisation. ### Pendant l'exécution du test Vous verrez : - **Barre de progression** indiquant l'état d'avancement - **Résultats en direct** apparaissant au fur et à mesure que chaque question est terminée - **Temps d'exécution** pour chaque réponse - **Indicateurs de succès/échec** ### Arrêter un test en cours Si vous devez arrêter un test avant la fin : 1. Cliquez sur le bouton **Stop** dans la zone de progression 2. Attendez que le système arrête le traitement en toute sécurité 3. Les résultats partiels seront conservés ## Comprendre les résultats ### Pour chaque paire question-réponse Cliquez sur n'importe quelle question pour l'agrandir et voir : **Détails de la réponse :** - Réponse complète de l'agent (avec formatage markdown) - Temps d'exécution (temps nécessaire pour générer) - Outils utilisés (recherche, récupération de documents, etc.) - Sources citées (documents ou pages web) **Options de feedback :** - **Pouce levé** - Bonne réponse - **Pouce baissé** - Réponse problématique (ajoutez des détails sur les raisons) ### Détails du feedback Lorsque vous marquez une réponse comme négative, vous pouvez ajouter des notes spécifiques : - Ce qui n'allait pas avec la réponse - Ce que vous attendiez à la place - Les schémas que vous remarquez Ce feedback vous aide à identifier : - Les lacunes de connaissances de votre agent - Les questions qui nécessitent de meilleures données d'entraînement - Les schémas d'échec courants ### Exporter les résultats Téléchargez les résultats des tests au format CSV avec le bouton **Download Results**. L'export comprend : - Texte de la question - Réponse de l'agent - Statut de succès/échec - Temps d'exécution - Messages d'erreur (le cas échéant) - Notes de feedback ## Onglet Historique ### Voir les exécutions de tests passées Basculez vers l'onglet **History** pour voir toutes les évaluations précédentes : **Vue liste des exécutions :** - Date et heure de chaque exécution - Statut (Terminé, Arrêté, En cours, Erreur) - Total de questions testées - Comptages de succès/échec **Vue détails de l'exécution :** 1. Cliquez sur n'importe quelle exécution pour voir les résultats détaillés 2. Agrandissez les paires question-réponse individuelles 3. Ajoutez du feedback aux réponses passées 4. Exportez les résultats d'une exécution spécifique au format CSV ### Pagination - **Liste des exécutions :** 10 exécutions par page - **Détails de l'exécution :** 50 résultats par page Utilisez les contrôles de pagination en bas pour naviguer dans les jeux de résultats plus larges. ## Bonnes pratiques ### Créer des jeux de questions efficaces - Couvrez différents sujets de votre base de connaissances - Incluez des cas limites et des questions délicates - Mélangez questions simples et complexes - Testez les requêtes courantes des utilisateurs ### Planning de tests réguliers Envisagez de lancer des évaluations : - Avant les versions majeures ou les mises à jour - Après l'ajout de nouveau contenu à la base de connaissances - Lorsque les utilisateurs signalent des problèmes sur des sujets spécifiques - Mensuellement pour le suivi de la qualité **Itérer :** Commencez avec un petit jeu (10-15 questions), affinez en fonction des résultats, puis étendez. Lancez les mêmes questions périodiquement pour suivre les améliorations dans le temps ! ## Dépannage ### "Maximum de 50 questions atteint" Vous avez sélectionné trop de questions. Décochez certaines questions ou divisez en plusieurs exécutions de tests. ### "Test déjà en cours" Un autre test est en cours. Attendez qu'il se termine ou arrêtez-le d'abord. ### Erreurs d'import de fichier **"Type de fichier invalide"** - Utilisez uniquement des fichiers `.csv` ou `.txt` - Si vous utilisez un tableur, exportez en CSV **"Plusieurs colonnes détectées"** - Supprimez toutes les colonnes sauf la première (questions) - Ou enregistrez en texte brut (.txt) avec une question par ligne **"Aucune question trouvée"** - Vérifiez que votre fichier n'est pas vide - Assurez-vous que chaque ligne contient du texte ### Impossible de voir les résultats Si un test est en cours mais que vous ne voyez pas les résultats : 1. Vérifiez l'onglet **History** 2. Cherchez l'exécution en cours 3. Cliquez sur **Reconnect** pour reprendre la visualisation des résultats en direct ## Limites et contraintes - **Questions max par exécution :** 50 - **Questions max stockées :** 100 par agent - **Taille de fichier :** fichiers CSV/TXT de taille raisonnable uniquement - **Exécutions simultanées :** un test par agent à la fois **Rappel :** L'évaluation des agents est un processus continu, pas une tâche ponctuelle. Des tests réguliers vous aident à maintenir des interactions IA de haute qualité à mesure que votre base de connaissances grandit et que les besoins des utilisateurs évoluent ! --- # Insights URL: https://www.askthisguy.com/fr/doc/admin-console/insights/ Language: fr Section: Documentation **Insights** est l'espace d'analyse de la console d'administration. Il permet de comprendre comment les assistants sont utilisés, quel ressenti les utilisateurs ont de l'expérience et où porter l'attention — avec les mêmes filtres pour les indicateurs et les graphiques. ## Filtres En haut de la page, vous pouvez restreindre ce que le tableau de bord affiche : - **Agents** — Sélectionnez un ou plusieurs agents. Seules les conversations prises en charge par les agents choisis sont incluses. - **Préréglages de durée** — Plages rapides : **7 jours**, **30 jours** ou **90 jours**. - **Plage personnalisée** — Définissez une date de **début** et de **fin** pour analyser la période souhaitée. - **Période de comparaison** — Le tableau de bord compare la plage sélectionnée à la **période précédente de même durée** (par exemple, pour une fenêtre de 7 jours, les indicateurs sont comparés aux 7 jours qui la précèdent immédiatement). Les dates de comparaison sont indiquées à côté des filtres pour que « précédente » soit toujours explicite. ## Indicateurs récapitulatifs La ligne du haut résume les indicateurs clés pour la période choisie, chacun avec une **variation par rapport à la période précédente** (pourcentage ou points de pourcentage, selon l'indicateur) : - **Conversations** — Nombre total de conversations sur la plage. - **Messages par conversation** — Nombre moyen de messages par conversation (indicateur simple de la profondeur d'échange). - **Sentiments** — Part des conversations classées en sentiment **positif** et **négatif** (détection automatique par l'IA). - **Réactions** — Part des conversations où les utilisateurs ont laissé un **pouce vers le haut** ou un **pouce vers le bas** sur la réponse de l'assistant, avec la variation par rapport à la période précédente. Ces cartes offrent un premier diagnostic avant d'explorer les tendances et les répartitions. ## Graphiques et répartitions Sous le récapitulatif, le tableau de bord visualise la même période sous plusieurs formes (la disposition exacte peut évoluer avec le produit) : - **Tendance dans le temps** — En général un graphique en courbes pour le **volume quotidien de conversations**, et/ou des courbes qui ventilent le volume par **sentiment** (par exemple positif vs. négatif) afin de repérer les pics ou les changements sur certains jours. - **Par tag** — Graphiques horizontaux montrant comment les conversations **se rattachent aux tags** (par exemple volume par tag, ou répartition **positive / neutre / négative** par tag). Les tags reflètent la manière dont les conversations sont catégorisées dans votre espace (par exemple des thèmes comme l'onboarding ou la facturation). - **Par agent** — Répartitions similaires **par agent**, pour comparer charge et sentiment entre assistants (par exemple customer success vs. spécialiste produit). Les infobulles sur les graphiques permettent de lire les effectifs ou pourcentages exacts. ## Comment utiliser Insights - **Suivi opérationnel** — Observer le volume de conversations et les réactions après une mise en ligne, une campagne ou une modification des consignes d'un agent. - **Qualité et sentiment** — Suivre le sentiment et les pouces haut/bas dans le temps pour voir si les utilisateurs sont satisfaits et où apparaît la friction. - **Priorisation** — S'appuyer sur les répartitions par tag et par agent pour identifier les zones qui concentrent le volume ou un signal négatif, et les croiser avec la configuration ou les mises à jour des connaissances ailleurs dans la console d'administration. Insights est en **lecture seule** : il ne modifie ni les agents ni le contenu ; il sert à décider **où** agir ensuite. --- # Confluence URL: https://www.askthisguy.com/fr/doc/admin-console/knowledge-management/connectors/conf-guides/confluence-conf-guide/ Language: fr Section: Documentation **Vous cherchez les capacités du connecteur ?** Cette page donne les instructions de configuration pas à pas. Pour une vue d'ensemble du connecteur Confluence et de ses fonctionnalités, consultez la page [Connecteur Confluence](https://www.askthisguy.com/doc/admin-console/knowledge-management/connectors/confluence-connector). *Temps approximatif : 5-7 minutes, hors prérequis* ## Avant de commencer Pour connecter votre ou vos espace(s) Confluence à ATG, suivez les étapes ci-dessous : [1. Créer un jeton API sur le compte Atlassian](https://www.askthisguy.com/doc/admin-console/knowledge-management/connectors/conf-guides/confluence-conf-guide) : un compte administrateur Atlassian est requis. [2. Configurer le connecteur Confluence dans ATG](https://www.askthisguy.com/doc/admin-console/knowledge-management/connectors/conf-guides/confluence-conf-guide) : un compte administrateur ATG est requis. ## 1. Créer un jeton API sur le compte Atlassian ### Accédez à la page dédiée de votre [compte Atlassian](https://id.atlassian.com/manage-profile/security/api-tokens) ![](https://www.askthisguy.com/doc/confluence-conf-1.webp) ### Cliquez sur *Créer un jeton API* ![](https://www.askthisguy.com/doc/confluence-conf-2.webp) ### Saisissez un nom pour votre clé ![](https://www.askthisguy.com/doc/confluence-conf-3.webp) ### Saisissez une date d'expiration ![](https://www.askthisguy.com/doc/confluence-conf-4.webp) La date d'expiration ne peut pas dépasser un an. Lorsque la clé expire, il faudra en générer une nouvelle et mettre à jour la configuration du connecteur. Nous recommandons de mettre une alerte pour ne pas oublier. ### Cliquez sur *Créer* ![](https://www.askthisguy.com/doc/confluence-conf-5.webp) ### Copiez votre clé ![](https://www.askthisguy.com/doc/confluence-conf-6.webp) Enregistrez ce jeton API dans un outil sécurisé (gestionnaire de mots de passe, etc.). Si vous ne l'enregistrez pas à cette étape, il ne pourra pas être récupéré plus tard. Il faudra en générer un nouveau. ### Cliquez sur *Terminé* ![](https://www.askthisguy.com/doc/confluence-conf-7.webp) ![](https://www.askthisguy.com/doc/confluence-conf-8.webp) Votre nouveau jeton apparaît dans le tableau ## 2. Configurer le connecteur Confluence dans ATG ### Revenez à votre console d'administration ATG ![](https://www.askthisguy.com/doc/confluence-conf-9.webp) Saisissez le nom de domaine (ex. ***votreentreprise***.atlassian.net) Saisissez votre adresse e-mail (celle avec laquelle le jeton API a été créé sur Atlassian) Saisissez le jeton API généré précédemment Cliquez sur « Valider » ### Ajouter une ou plusieurs sources depuis Confluence ### Cliquez sur « Ajouter une source » ![](https://www.askthisguy.com/doc/confluence-conf-10.webp) ### Sélectionnez les espaces à inclure dans l'import ![](https://www.askthisguy.com/doc/confluence-conf-11.webp) ### Cliquez sur Suivant ![](https://www.askthisguy.com/doc/confluence-conf-12.webp) ### Configurez les filtres de documents ![](https://www.askthisguy.com/doc/confluence-conf-13.webp) Cliquez sur **« Suivant »** ### Choisissez le nom de votre source et enregistrez la configuration ![](https://www.askthisguy.com/doc/confluence-conf-14.webp) ### Vérifier les documents Une fois tous les documents traités (cela peut prendre quelques minutes selon le volume), ils apparaîtront dans la source ![](https://www.askthisguy.com/doc/confluence-conf-15.webp) ## Modification et mise à jour de la clé API Lorsque votre jeton expire, vous devrez créer un nouveau jeton et mettre à jour la configuration du connecteur. --- # Connecteur Confluence URL: https://www.askthisguy.com/fr/doc/admin-console/knowledge-management/connectors/confluence-connector/ Language: fr Section: Documentation **Vous voulez configurer ce connecteur ?** Cette page présente le connecteur Confluence et ses capacités. Pour les instructions pas à pas, consultez le [Guide de configuration Confluence](https://www.askthisguy.com/doc/admin-console/knowledge-management/connectors/conf-guides/confluence-conf-guide). ## Connecter votre base Confluence à ATG Le **connecteur Confluence** synchronise la documentation de votre organisation depuis **Confluence Cloud** vers ATG, pour que les connaissances de votre équipe soient accessibles via la recherche et le chat IA. ### Ce qui est synchronisé Le connecteur peut importer du contenu depuis : - **Espaces de collaboration** — Espaces d'équipe où votre organisation crée et partage la documentation - **Espaces personnels** — Espaces individuels pour notes et contenu personnels Vous gardez un **contrôle total** sur ce qui est importé grâce aux options de filtrage. ### Traitement complet du contenu Lors de la synchronisation des pages Confluence, ATG traite **à la fois le texte et les images** de vos articles pour une capture complète des connaissances. Votre assistant IA peut ainsi comprendre et référencer le contenu visuel en plus du texte. En savoir plus : [Documents et images](https://www.askthisguy.com/doc/admin-console/knowledge-management/how-documents-images-are-processed-by-atg) ### Options de filtrage flexibles Une fois connecté, vous pouvez préciser ce qu'ATG importe : - **Sélectionner des espaces** — Choisir quels espaces de collaboration ou personnels synchroniser - **Filtres de date** — Importer uniquement les documents mis à jour avant une date donnée, après une date donnée, ou entre deux dates - **Inclure/Exclure dossiers et fichiers** — Inclure ou exclure des dossiers ou fichiers précis - **Filtrage par labels** — Utiliser les [labels Confluence](https://support.atlassian.com/confluence-cloud/docs/use-labels-to-organize-your-content/) pour inclure ou exclure du contenu selon la taxonomie de votre organisation Ainsi, ATG ne traite que le contenu pertinent pour votre équipe. ### Mises à jour automatiques Après la première synchronisation, le connecteur se rafraîchit selon la **fréquence configurée pour la source**. Les nouvelles sources sont réglées sur **Quotidien** ; un administrateur peut choisir Manuel, Hebdomadaire ou Mensuel, ou lancer une actualisation à la demande, pour que votre assistant IA dispose de la documentation à jour. Voir [Fréquence de rafraîchissement](https://www.askthisguy.com/doc/admin-console/knowledge-management/connectors#frquence-de-rafrachissement). ### Prêt à démarrer ? Consultez le [Guide de configuration Confluence](https://www.askthisguy.com/doc/admin-console/knowledge-management/connectors/conf-guides/confluence-conf-guide) pour les instructions détaillées. --- # Utilisateurs URL: https://www.askthisguy.com/fr/doc/admin-console/users-management/ Language: fr Section: Documentation L'espace **Utilisateurs** permet aux administrateurs d'inviter des membres, de gérer les privilèges administrateur et de choisir les agents Webapp que chaque personne peut utiliser. ## Inviter et intégrer des utilisateurs Les nouveaux utilisateurs rejoignent une organisation ATG sur invitation d'un administrateur. Ils reçoivent un e-mail de validation et suivent les étapes d'onboarding pour activer leur compte. Après l'activation, donnez à l'utilisateur accès aux agents Webapp nécessaires à son rôle. Un utilisateur doit disposer d'au moins un agent Webapp actif et accessible pour démarrer une conversation. ## Comprendre le modèle d'accès ATG distingue deux types de droits : - **Accès administrateur** : autorise la gestion des utilisateurs, des agents et des paramètres de l'organisation. - **Accès aux agents** : détermine les agents Webapp que l'utilisateur peut voir et sélectionner dans une nouvelle conversation. Les catégories de connaissances ne sont **jamais affectées aux utilisateurs**. Elles sont configurées sur les agents. Lorsqu'un utilisateur peut accéder à un agent, il peut utiliser les connaissances et les outils configurés pour cet agent. ## Gérer les accès depuis la fiche d'un utilisateur Ouvrez un utilisateur depuis la liste, puis utilisez la section **Accès aux agents** pour sélectionner les agents disponibles pour cette personne. Vous pouvez tout sélectionner ou choisir les agents individuellement. Affectation des agents Webapp à un utilisateur depuis l'espace Utilisateurs Enregistrez les modifications lorsque la sélection est terminée. Seuls les agents Webapp actifs affectés à l'utilisateur apparaissent dans son sélecteur d'agents. ## Gérer les accès depuis un agent Vous pouvez gérer la même relation depuis l'onglet **Accès** de l'agent : - **Ouvert à tous** rend l'agent accessible à tous les utilisateurs de l'organisation. - **Restreint** réserve l'agent aux utilisateurs sélectionnés. Les modifications effectuées depuis la fiche d'un utilisateur ou depuis un agent mettent à jour les mêmes règles d'accès. Consultez [Agents](https://www.askthisguy.com/doc/admin-console/how-to-configure-the-agents). ## Privilèges administrateur Activez **Accès administrateur** uniquement pour les personnes chargées de gérer l'organisation. Les utilisateurs standard peuvent utiliser les agents Webapp qui leur sont affectés, mais ne peuvent pas modifier les paramètres administratifs. Les privilèges administrateur et l'accès aux agents sont indépendants. Un administrateur peut donc disposer d'un ensemble limité d'agents Webapp pour ses conversations courantes. ## Bonnes pratiques - **Appliquez le principe du moindre privilège** : donnez à chaque utilisateur uniquement les agents nécessaires à son travail. - **Utilisez des agents spécialisés** : placez les connaissances confidentielles ou propres à un métier derrière des agents dédiés. - **Revoyez régulièrement les accès** : retirez les agents qui ne correspondent plus aux responsabilités d'un utilisateur. - **Traitez rapidement l'onboarding et l'offboarding** : mettez à jour les accès lors d'une arrivée, d'un changement de rôle ou d'un départ. - **Limitez les droits administrateur** : réservez-les aux personnes qui gèrent l'espace. ## Exemple Pour une organisation composée d'équipes RH, Finance et Ingénierie : - créez un agent Finance avec les connaissances et outils financiers, puis limitez-le à l'équipe Finance ; - créez un agent RH avec les connaissances RH, puis limitez-le aux utilisateurs RH autorisés ; - gardez un agent interne général ouvert à tous pour les usages communs à l'entreprise. Ce modèle protège les connaissances spécialisées en contrôlant l'accès aux agents capables de les utiliser. --- # Google Drive URL: https://www.askthisguy.com/fr/doc/admin-console/knowledge-management/connectors/conf-guides/google-drive-conf-guide/ Language: fr Section: Documentation **Vous cherchez les capacités du connecteur ?** Cette page décrit la configuration pas à pas. Pour une vue d’ensemble du connecteur Google Drive et de ses fonctionnalités, consultez la page [Connecteur Google Drive](https://www.askthisguy.com/doc/admin-console/knowledge-management/connectors/google-drive-connector). *Temps approximatif : 5 à 10 minutes, hors prérequis* ## Avant de commencer Les actions ci-dessous ne peuvent être effectuées que par les administrateurs de votre espace GCP. Assurez-vous d’avoir accès à un compte administrateur GCP de votre organisation. Pour connecter ATG à Google Drive, vous devrez : - [1. Activer l’API Google Drive](https://www.askthisguy.com/doc/admin-console/knowledge-management/connectors/conf-guides/google-drive-conf-guide#1-enable-the-google-drive-api) : cela permettra à votre compte de service GCP d’utiliser Google Drive. - [2. Configurer le compte de service dans la console cloud GCP](https://www.askthisguy.com/doc/admin-console/knowledge-management/connectors/conf-guides/google-drive-conf-guide#2-setup-the-service-account-in-your-gcp-cloud-console) : cela créera un compte de service lié à votre Google Drive. - [3. Créer les clés du compte de service](https://www.askthisguy.com/doc/admin-console/knowledge-management/connectors/conf-guides/google-drive-conf-guide#3-create-keys-for-the-service-account) : cela vous permettra de créer une clé pour votre compte de service et de générer un fichier JSON à importer dans ATG. - [4. Partager le contenu avec ATG](https://www.askthisguy.com/doc/admin-console/knowledge-management/connectors/conf-guides/google-drive-conf-guide#4-share-content-to-atg) : cela vous permettra de choisir quels Drive et contenus autoriser pour ATG. - [5. Connecter Google Drive dans ATG](https://www.askthisguy.com/doc/admin-console/knowledge-management/connectors/conf-guides/google-drive-conf-guide#5-connect-google-drive-in-atg) : cela vous permettra de configurer le connecteur et de choisir quels dossiers seront accessibles aux utilisateurs ATG. ## **1. Activer l’API Google Drive** ### Accéder à la console Google Cloud Rendez-vous sur [https://console.cloud.google.com/](https://console.cloud.google.com/) ### Ouvrir la section « API et services activés » Ouvrez le menu de navigation : ![Menu de navigation de la console Google Cloud](https://www.askthisguy.com/doc/documentation-for-administrators-knowledge-management-how-to-configure-my-connectors-google-drive-conf-guide-image.webp) Sélectionnez « API et services », puis « API et services activés » : ![Section API et services activés de la console Google Cloud](https://www.askthisguy.com/doc/documentation-for-administrators-knowledge-management-how-to-configure-my-connectors-google-drive-conf-guide-image-1.webp) ### Sélectionner un projet Cliquez sur le bouton « Sélectionner un projet » : ![Bouton Sélectionner un projet de la console Google Cloud](https://www.askthisguy.com/doc/documentation-for-administrators-knowledge-management-how-to-configure-my-connectors-google-drive-conf-guide-image-2.webp) Si aucun projet n’a été créé auparavant, cliquez sur « Créer un projet » : ![Bouton Créer un projet de la console Google Cloud](https://www.askthisguy.com/doc/documentation-for-administrators-knowledge-management-how-to-configure-my-connectors-google-drive-conf-guide-image-3.webp) ### Créer votre projet (si ce n’est pas déjà fait) Saisissez un nom de projet, sélectionnez votre organisation et l’emplacement du projet. Puis cliquez sur « Créer » : ![Menu « Créer un projet » de la console Google Cloud](https://www.askthisguy.com/doc/documentation-for-administrators-knowledge-management-how-to-configure-my-connectors-google-drive-conf-guide-image-4.webp) ### Ouvrir « API et services » Cliquez sur « API et services activés » dans le menu de gauche : ![Menu « API et services activés » de la console Google Cloud](https://www.askthisguy.com/doc/documentation-for-administrators-knowledge-management-how-to-configure-my-connectors-google-drive-conf-guide-image-4.1.webp) ### Activer des API et services Cliquez sur le bouton « + Activer des API et services » : ![Bouton « Activer des API et services » de la console Google Cloud](https://www.askthisguy.com/doc/documentation-for-administrators-knowledge-management-how-to-configure-my-connectors-google-drive-conf-guide-image-4.2.webp) ### Rechercher l’API Google Drive Saisissez « google drive » dans la barre de recherche et appuyez sur Entrée, puis sélectionnez « Google Drive API » dans les résultats : ![Résultat de recherche « API Google Drive » dans la console Google Cloud](https://www.askthisguy.com/doc/documentation-for-administrators-knowledge-management-how-to-configure-my-connectors-google-drive-conf-guide-image-4.3.webp) Sélectionnez l’API Google Drive : ![Sélection « API Google Drive » dans la console Google Cloud](https://www.askthisguy.com/doc/documentation-for-administrators-knowledge-management-how-to-configure-my-connectors-google-drive-conf-guide-image-4.4.webp) ### Activer l’API Google Drive Cliquez sur le bouton « Activer » pour activer l’API Google Drive : ![Bouton Activer l’API Google Drive dans la console Google Cloud](https://www.askthisguy.com/doc/documentation-for-administrators-knowledge-management-how-to-configure-my-connectors-google-drive-conf-guide-image-101.webp) ## **2. Configurer le compte de service dans la console cloud GCP** ### Accéder à la console Google Cloud Revenez à la section « API et services » dans le menu de navigation et cliquez sur « Identifiants » : ![Menu Identifiants « API et services » de la console Google Cloud](https://www.askthisguy.com/doc/documentation-for-administrators-knowledge-management-how-to-configure-my-connectors-google-drive-conf-guide-image-6.webp) ### Créer des identifiants Cliquez sur le bouton « + Créer des identifiants » : ![Bouton « + Créer des identifiants » de la console Google Cloud](https://www.askthisguy.com/doc/documentation-for-administrators-knowledge-management-how-to-configure-my-connectors-google-drive-conf-guide-image-7.webp) Sélectionnez « Compte de service » : ![Sélection « Compte de service » dans la console Google Cloud](https://www.askthisguy.com/doc/documentation-for-administrators-knowledge-management-how-to-configure-my-connectors-google-drive-conf-guide-image-100.webp) Créez le compte de service. Saisissez un nom de compte de service et (optionnellement) une description : ![Menu « Créer un compte de service » de la console Google Cloud](https://www.askthisguy.com/doc/documentation-for-administrators-knowledge-management-how-to-configure-my-connectors-google-drive-conf-guide-image-102.webp) Cliquez sur « Créer » puis « Continuer » : ![Menu « Créer un compte de service » de la console Google Cloud](https://www.askthisguy.com/doc/documentation-for-administrators-knowledge-management-how-to-configure-my-connectors-google-drive-conf-guide-image-103.webp) Choisissez le rôle à attribuer au compte de service en cliquant sur « Sélectionner un rôle ». ![Menu « Sélectionner un rôle » de la console Google Cloud](https://www.askthisguy.com/doc/documentation-for-administrators-knowledge-management-how-to-configure-my-connectors-google-drive-conf-guide-image-104.webp) Vous pouvez choisir le rôle « Lecteur » pour accorder un accès en lecture seule au compte de service. ![Menu « Sélectionner un rôle » de la console Google Cloud](https://www.askthisguy.com/doc/documentation-for-administrators-knowledge-management-how-to-configure-my-connectors-google-drive-conf-guide-image-105.webp) Terminez la création du compte de service en cliquant sur « Terminé ». ![Bouton « Terminer la création du compte de service » de la console Google Cloud](https://www.askthisguy.com/doc/documentation-for-administrators-knowledge-management-how-to-configure-my-connectors-google-drive-conf-guide-image-106.webp) ## 3. Créer les clés du compte de service ### Sélectionner votre compte de service Allez dans la section « Identifiants » du menu « API et services », puis cliquez sur le compte de service créé précédemment. ![Menu « Sélectionner votre compte de service » de la console Google Cloud](https://www.askthisguy.com/doc/documentation-for-administrators-knowledge-management-how-to-configure-my-connectors-google-drive-conf-guide-image-107.webp) ### Accéder aux clés Cliquez sur le menu « Clés » : ![Menu « Clés » de la console Google Cloud](https://www.askthisguy.com/doc/documentation-for-administrators-knowledge-management-how-to-configure-my-connectors-google-drive-conf-guide-image-9.webp) ### Créer une nouvelle clé La section Clés est vide tant qu’aucune clé n’a été créée. Cliquez sur « Ajouter une clé » puis « Créer une clé ». ![Bouton « Créer une clé » de la console Google Cloud](https://www.askthisguy.com/doc/documentation-for-administrators-knowledge-management-how-to-configure-my-connectors-google-drive-conf-guide-image-108.webp) ### Choisir JSON et créer Sélectionnez le type de clé JSON puis cliquez sur « Créer ». ![Menu « Choisir JSON et créer » de la console Google Cloud](https://www.askthisguy.com/doc/documentation-for-administrators-knowledge-management-how-to-configure-my-connectors-google-drive-conf-guide-image-109.webp) **Enregistrez ensuite la clé JSON :** ![Bouton « Enregistrer la clé JSON » de la console Google Cloud](https://www.askthisguy.com/doc/documentation-for-administrators-knowledge-management-how-to-configure-my-connectors-google-drive-conf-guide-image-110.webp) Un message indiquera que la clé a été enregistrée. Cliquez sur « Fermer ». Cette clé permet d’accéder à votre Google Drive. **Elle est confidentielle.** Ne la partagez avec personne et ne l’incluez pas dans des dépôts de code publics. Conservez-la en suivant les [bonnes pratiques Google](https://docs.cloud.google.com/iam/docs/best-practices-for-managing-service-account-keys). ### En cas de message d’erreur lors de la création de la clé Si vous voyez le message d’erreur suivant : ![Message d’erreur de la console Google Cloud](https://www.askthisguy.com/doc/documentation-for-administrators-knowledge-management-how-to-configure-my-connectors-google-drive-conf-guide-image-10.webp) Vous devrez mettre à jour les stratégies de l’organisation. Pour cela, votre compte doit disposer des droits d’administrateur. Allez dans Stratégies de l’organisation, recherchez `iam.disableServiceAccountKeyCreation` et désactivez-la au niveau du projet (ou au niveau de l’organisation si le projet hérite des règles de l’organisation). ![Stratégies de l’organisation dans la console Google Cloud](https://www.askthisguy.com/doc/documentation-for-administrators-knowledge-management-how-to-configure-my-connectors-google-drive-conf-guide-image-11.webp) ## 4. Partager le contenu avec ATG Par défaut, ATG n’a aucun accès à votre Google Drive. Vous devez d’abord partager le contenu que vous souhaitez importer dans ATG. Vous pouvez partager avec ATG tout contenu Google Drive souhaité : Drive, dossiers, fichiers, etc., comme vous le faites habituellement. En règle générale, par mesure de sécurité, ne partagez pas plus que le nécessaire avec un système externe. Rassurez-vous : partager du contenu avec ATG ne donne pas à ATG l’accès aux utilisateurs de votre organisation. Vous pouvez configurer les accès directement dans ATG (voir plus loin dans le document). Commencez par récupérer l’adresse e-mail associée à votre compte de service : elle figure dans les détails du compte de service ou dans le fichier JSON enregistré précédemment. Elle ressemble à ceci : [`atg@master-puppets-493931-f4.iam.gserviceaccount.com`](mailto:atg@master-puppets-493931-f4.iam.gserviceaccount.com) par exemple. Vous pouvez ensuite partager tout contenu avec cette adresse (un accès Lecteur suffit) : ![Partager le contenu avec le compte de service dans Google Drive — étape 2](https://www.askthisguy.com/doc/google-drive-2.webp) ## 5. Connecter Google Drive dans ATG ### Accéder au menu Connecteurs dans la console d’administration ATG Rendez-vous dans [le menu Connecteurs](https://app.askthisguy.com/admin/knowledge?tab=connectors) : ![Menu Connecteurs dans la console d’administration](https://www.askthisguy.com/doc/connectors-menu-1-fr.webp) Cliquez sur « Ajouter un connecteur », puis sélectionnez « Google Drive » : ![Ajouter un connecteur, sélectionner Google Drive](https://www.askthisguy.com/doc/connectors-menu-google-1-fr.webp) Téléversez le fichier JSON des identifiants généré précédemment : ![Téléversement du fichier d’identifiants](https://www.askthisguy.com/doc/connectors-menu-google-2-fr.webp) Le connecteur Google Drive est maintenant ajouté à ATG : ![Vue du statut des connecteurs dans la console d’administration](https://www.askthisguy.com/doc/connectors-menu-google-3-fr.webp) Le connecteur Google Drive a bien été ajouté à ATG ! Pour ajouter une source, allez dans [le menu Sources](https://app.askthisguy.com/admin/knowledge?tab=sources) et ajoutez une source (le connecteur Google Drive apparaît dans la liste) : ![Menu d’ajout de source dans la console d’administration](https://www.askthisguy.com/doc/connectors-menu-google-4-fr.webp) --- # Connecteurs URL: https://www.askthisguy.com/fr/doc/admin-console/knowledge-management/connectors/ Language: fr Section: Documentation Les **connecteurs ATG** automatisent l'import et la mise à jour des connaissances de votre organisation. Au lieu de téléverser les fichiers un par un, les connecteurs s'intègrent directement à vos outils existants — **Google Drive**, **Confluence**, **Slack**, etc. — pour synchroniser les documents automatiquement. Chaque connecteur peut être configuré avec des **paramètres précis** (dossiers, plages de dates, types de contenu). Une fois en place, les connecteurs peuvent se **rafraîchir automatiquement** ou à la demande, pour que votre assistant IA ait toujours accès aux dernières informations. **Connecteurs personnalisés :** Vous devez vous connecter à un outil qui n'est pas dans la liste ? C'est là qu'ATG apporte une vraie valeur. **Nous pouvons développer des connecteurs sur mesure** — système propriétaire, plateforme de niche ou besoin d'intégration spécifique. Contactez-nous pour en discuter. ## Connecteurs disponibles Découvrez chaque connecteur et ses capacités : **Stockage cloud** [Connecteur Google Drive](https://www.askthisguy.com/doc/admin-console/knowledge-management/connectors/google-drive-connector) [Connecteur SharePoint et OneDrive](https://www.askthisguy.com/doc/admin-console/knowledge-management/connectors/sharepoint-onedrive-connector) [Connecteur FTP](https://www.askthisguy.com/doc/admin-console/knowledge-management/connectors/ftp-connector) **Documentation et communication** [Connecteur Confluence](https://www.askthisguy.com/doc/admin-console/knowledge-management/connectors/confluence-connector) [Connecteur Notion](https://www.askthisguy.com/doc/admin-console/knowledge-management/connectors/notion-connector) [Connecteur Slack](https://www.askthisguy.com/doc/admin-console/knowledge-management/connectors/slack-connector) **Fichiers** [Téléversement de fichiers](https://www.askthisguy.com/doc/admin-console/knowledge-management/file-upload) **Sites web** [Sites web](https://www.askthisguy.com/doc/admin-console/knowledge-management/connectors/web-sites-connector) **Connecteurs personnalisés :** Besoin d'intégrer un outil non listé ? Nous pouvons développer des connecteurs adaptés à votre organisation — système propriétaire, base interne ou toute autre plateforme. Contactez-nous pour en discuter. ## Fréquence de rafraîchissement La **fréquence de rafraîchissement** définit à quel rythme ATG met à jour le contenu importé depuis une source. Elle se règle source par source, et seuls les administrateurs de l'organisation peuvent la modifier. À chaque rafraîchissement, ATG détecte les fichiers ajoutés, modifiés et supprimés depuis le passage précédent, et ne retraite que ce qui est nécessaire. 1. Dans la console d'administration, ouvrez **Connaissances**, puis l'onglet **Sources**. 2. Repérez la source à configurer et sélectionnez **Modifier**. 3. Dans le champ **Fréquence de rafraîchissement**, choisissez **Manuel**, **Quotidien**, **Hebdomadaire** ou **Mensuel**. 4. Sélectionnez **Enregistrer les modifications**. Champ Fréquence de rafraîchissement dans la fenêtre Modifier la source de la console d'administration ATG La fréquence retenue apparaît sur la ligne de la source, à côté de sa dernière date de traitement. En mode **Manuel**, aucun rafraîchissement automatique n'est lancé : utilisez **Actualiser** sur la source au moment voulu. À la création, les sources Google Drive, Confluence, Notion, Slack, SharePoint et FTP/SFTP sont réglées sur **Quotidien**, et les sources de type site web sur **Hebdomadaire**. ### Ce qu'il faut savoir - Enregistrer une nouvelle fréquence ne relance pas l'importation. Le nouveau rythme s'applique aux prochains passages de la planification. - Un rafraîchissement automatique peut être décalé si la source a été traitée trop récemment ou si un autre traitement est déjà en cours. - Il n'est pas possible de choisir une heure précise, un jour précis ou une fréquence personnalisée. - Une source en cours de mise à jour apparaît **en actualisation** dans la liste. En cas d'échec, consultez le message associé à la source, puis relancez une actualisation manuelle une fois la situation corrigée. ## Guides de configuration Instructions pas à pas pour configurer chaque connecteur dans votre organisation : [Google Drive](https://www.askthisguy.com/doc/admin-console/knowledge-management/connectors/conf-guides/google-drive-conf-guide) [SharePoint et OneDrive](https://www.askthisguy.com/doc/admin-console/knowledge-management/connectors/conf-guides/sharepoint-onedrive-conf-guide) [Confluence](https://www.askthisguy.com/doc/admin-console/knowledge-management/connectors/conf-guides/confluence-conf-guide) [Slack](https://www.askthisguy.com/doc/admin-console/knowledge-management/connectors/conf-guides/slack-conf-guide) [Notion](https://www.askthisguy.com/doc/admin-console/knowledge-management/connectors/conf-guides/notion-conf-guide) --- # Console d'administration URL: https://www.askthisguy.com/fr/doc/admin-console/ Language: fr Section: Documentation La **console d'administration** est votre centre de contrôle pour gérer votre environnement ATG ! Configurez les agents IA, organisez les connaissances, gérez les outils et contrôlez l'accès des utilisateurs — le tout en un seul endroit. **Personnalisez l'expérience ATG de votre organisation en toute simplicité.** Configurez les membres de l'équipe, définissez les permissions, connectez les sources de données et organisez les connaissances IA avec des outils conçus pour l'efficacité. ![Vue d'ensemble de la console d'administration](https://www.askthisguy.com/doc/documentation-for-administrators-admin-console-fr.webp) Explorez les sous-pages ci-dessous pour des guides pas à pas sur les politiques IA, le traitement des données, la gestion des utilisateurs, etc. Tout ce qu'il faut pour maîtriser vos super-pouvoirs d'administrateur ! **Organisation** - [Organisation](https://www.askthisguy.com/doc/admin-console/organization-settings) **Menus de la console** - [Connaissances](https://www.askthisguy.com/doc/admin-console/knowledge-management) - [Outils et MCP](https://www.askthisguy.com/doc/admin-console/tools-management) - [Agents](https://www.askthisguy.com/doc/admin-console/how-to-configure-the-agents) - [Tags et alertes](https://www.askthisguy.com/doc/admin-console/tags-alerts) - [Évaluation des agents](https://www.askthisguy.com/doc/admin-console/agent-evaluation) - [Insights](https://www.askthisguy.com/doc/admin-console/insights) - [Utilisateurs](https://www.askthisguy.com/doc/admin-console/users-management) **Infrastructure et sécurité** - [Infrastructure et sécurité](https://www.askthisguy.com/doc/infrastructure-and-security) ## Prêt à vous lancer ? Accédez à la console d'administration sur [https://app.askthisguy.com/admin/](https://app.askthisguy.com/admin) et explorez les fonctionnalités ci-dessous ! --- # Connecteur Google Drive URL: https://www.askthisguy.com/fr/doc/admin-console/knowledge-management/connectors/google-drive-connector/ Language: fr Section: Documentation **Vous souhaitez configurer ce connecteur ?** Cette page présente une vue d'ensemble du connecteur Google Drive et de ses fonctionnalités. Pour les instructions de configuration pas à pas, consultez le [guide de configuration Google Drive](https://www.askthisguy.com/doc/admin-console/knowledge-management/connectors/conf-guides/google-drive-conf-guide). ## Connecter votre Google Workspace à ATG Le **Connecteur Google Drive** synchronise les documents de votre organisation depuis **Google Workspace** (Entreprise) vers ATG, rendant le savoir de votre équipe immédiatement accessible via la recherche et le chat pilotés par l'IA. **Note :** Ce connecteur fonctionne exclusivement avec les comptes **Google Workspace** (anciennement G Suite). Les comptes Google Drive grand public ne sont pas pris en charge. ### Que peut-on synchroniser ? Le connecteur peut importer des documents depuis : - **Les espaces partagés Drive** - Les espaces d'équipe accessibles à votre organisation - **Les dossiers partagés** - Les dossiers individuels partagés depuis les Google Drive des collaborateurs Vous gardez un **contrôle total** sur ce qui est importé grâce à des options de filtrage avancées. ### Options de filtrage flexibles Une fois connecté, vous pouvez préciser exactement quel contenu ATG importe : - **Sélectionner des Drive spécifiques** - Choisir quels espaces partagés ou dossiers synchroniser - **Filtres par date** - Importer uniquement les documents mis à jour avant une date, après une date, ou entre deux dates - **Règles d'inclusion/exclusion** - Indiquer des dossiers ou fichiers précis à inclure ou exclure Ainsi, ATG ne traite que le contenu pertinent pour votre équipe, pour une base de connaissances ciblée et efficace. ### Mises à jour automatiques Après la première synchronisation, le connecteur se rafraîchit selon la **fréquence configurée pour la source**. Les nouvelles sources sont réglées sur **Quotidien** ; un administrateur peut choisir Manuel, Hebdomadaire ou Mensuel, ou lancer une actualisation à la demande, pour que votre assistant IA dispose des dernières versions de vos documents. Voir [Fréquence de rafraîchissement](https://www.askthisguy.com/doc/admin-console/knowledge-management/connectors#frquence-de-rafrachissement). ### Types de fichiers pris en charge Le connecteur Google Drive gère un **large éventail** de formats : **Fichiers natifs Google Workspace :** - Google Docs - Google Slides - Google Drawings **Formats de documents courants :** - PDF (.pdf) - Documents Word (.docx) - Présentations PowerPoint (.pptx) - Fichiers HTML (.html) - Markdown (.md) - Texte brut (.txt) - Format RTF (.rtf) **Images :** - PNG (.png) - JPEG (.jpg) **Types de fichiers personnalisés (Excel par exemple) :** - [Traitement de documents sur mesure](https://www.askthisguy.com/doc/customizing-atg-to-you/tailored-processing) - ATG peut être configuré pour prendre en charge les formats spécifiques de votre organisation avec des règles de traitement dédiées. ### Prêt à commencer ? Consultez le [guide de configuration Google Drive](https://www.askthisguy.com/doc/admin-console/knowledge-management/connectors/conf-guides/google-drive-conf-guide) pour les instructions de configuration détaillées. --- # Dépôt de fichiers URL: https://www.askthisguy.com/fr/doc/admin-console/knowledge-management/file-upload/ Language: fr Section: Documentation ## Déposer vos documents directement dans ATG Le **dépôt de fichiers** est la façon la plus simple d'ajouter les documents de votre organisation dans ATG : **glissez, déposez, c'est fait**. Déposez des fichiers depuis la console d'administration et affectez-les à des catégories de connaissances. ### Idéal pour partager rapidement des connaissances C'est adapté lorsque vous souhaitez : - **Rendre des documents disponibles** aux agents qui utilisent la catégorie choisie - **Ajouter des fichiers ponctuels** sans mettre en place une intégration complète - **Tester du contenu** avant de connecter de gros dépôts - **Déposer des fichiers** qui ne sont pas dans vos systèmes de stockage cloud Après traitement, les fichiers deviennent disponibles pour les agents qui disposent à la fois de la catégorie choisie et de l'outil Recherche dans la base de connaissances. Aucun accès direct à une catégorie n'est attribué aux utilisateurs. ### Formats supportés Le dépôt de fichiers prend en charge un **large éventail** de formats : **Formats standards :** - PDF Documents PDF (.pdf) - Texte brut Texte brut (.txt) - Markdown Markdown (.md) - HTML Fichiers HTML (.html) **Documents Office :** - Word Documents Word (.docx) - PowerPoint Présentations PowerPoint (.pptx) Tous les fichiers déposés sont traités avec **extraction du texte et des images** pour une capture complète du contenu. En savoir plus sur le traitement des images et du contenu visuel : [Documents et images](https://www.askthisguy.com/doc/admin-console/knowledge-management/how-documents-images-are-processed-by-atg) **Types de fichiers personnalisés :** - [Traitement sur mesure](https://www.askthisguy.com/doc/customizing-atg-to-you/tailored-processing) : ATG peut être adapté pour traiter les formats spécifiques de votre organisation avec des règles de traitement dédiées. ### Comment déposer des fichiers C'est très simple : 1. **Ouvrez la console d'administration** et allez dans la section **Connaissances** 2. **Sélectionnez une catégorie de connaissances** où ajouter les fichiers 3. **Glissez-déposez vos fichiers** dans l'interface, ou cliquez pour parcourir et les sélectionner 4. **C'est tout !** Les fichiers sont traités automatiquement et prêts à l'emploi Aucune configuration complexe ni authentification n'est nécessaire. ### Traitement automatique Une fois déposés, vos fichiers sont automatiquement : - **Extraits** : le texte et les images sont traités pour une compréhension complète du contenu - **Indexés** : le contenu devient recherchable dans la base de connaissances ATG - **Catégorisés** : le contenu est organisé dans la catégorie choisie Après traitement, les agents qui disposent de la catégorie choisie et de l'outil Recherche dans la base de connaissances peuvent retrouver les documents déposés. ### Bonnes pratiques - **Organiser par catégorie** : déposez les documents liés dans la même catégorie pour un meilleur contexte - **Tenir les fichiers à jour** : déposez les nouvelles versions lorsque les documents changent - **Utiliser des noms de fichiers explicites** : des noms clairs aident les utilisateurs et les agents à comprendre le contenu --- # Notion URL: https://www.askthisguy.com/fr/doc/admin-console/knowledge-management/connectors/conf-guides/notion-conf-guide/ Language: fr Section: Documentation **Vous cherchez les capacités du connecteur ?** Cette page donne les instructions de configuration pas à pas. Pour une vue d'ensemble du connecteur Notion et de ses fonctionnalités, consultez la page [Connecteur Notion](https://www.askthisguy.com/doc/admin-console/knowledge-management/connectors/notion-connector). *Temps approximatif : 3 à 5 minutes* ## Avant de commencer Pour connecter ATG à Notion, vous aurez besoin de : - Un **espace de travail Notion** où vous avez le droit de créer des intégrations et de gérer les connexions de pages - Un compte **administrateur ATG** pour configurer le connecteur dans la [Console d'administration](https://app.askthisguy.com/admin/knowledge?tab=connectors) La configuration se déroule en quatre étapes : - [1. Créer une connexion Notion](#1-crer-une-connexion-notion) - [2. Configurer les permissions et copier le jeton d'accès](#2-configurer-les-permissions-et-copier-le-jeton-daccs) - [3. Donner accès à votre contenu Notion](#3-donner-accs-votre-contenu-notion) - [4. Connecter Notion dans ATG](#4-connecter-notion-dans-atg) ## 1. Créer une connexion Notion ### Ouvrir le portail développeur Notion Rendez-vous sur le [portail développeur Notion](https://www.notion.so/developers/connections) et ouvrez la page **Connexions**. ![Portail développeur Notion, page Connexions](https://www.askthisguy.com/doc/notion-01-fr.webp) Cliquez sur **+ Nouvelle connexion** pour créer une nouvelle intégration. ### Créer la connexion Dans la fenêtre **Nouvelle connexion** : - Saisissez un **Nom de la connexion** (par exemple `Ask This Guy` ou `ATG`) - Sélectionnez **Jeton d'accès** comme méthode d'authentification. Il s'agit du jeton limité à l'espace de travail qu'ATG utilise pour lire votre contenu. - Choisissez l'**espace de travail** dans lequel la connexion sera installée ![Notion, fenêtre Nouvelle connexion](https://www.askthisguy.com/doc/notion-02-fr.webp) Cliquez sur **Créer une connexion**. ## 2. Configurer les permissions et copier le jeton d'accès Après la création, vous êtes redirigé vers la page de configuration de la connexion. ![Notion, Configuration de la connexion](https://www.askthisguy.com/doc/notion-03-fr.webp) Sous **Capacités**, activez les permissions dont ATG a besoin :
CapacitéRequis
**Lire le contenu**Oui. Permet à ATG d'importer les pages et les bases de données.
**Afficher les informations des utilisateur.rices**Oui. Permet à ATG d'attribuer le contenu aux bons utilisateurs.
Mettre à jour le contenuNon
Insérer du contenuNon
Lire / Insérer des commentairesNon
Avant d'enregistrer, copiez le **Jeton d'accès** dans la section **Jeton d'intégration** à l'aide du bouton de copie. Vous collerez ce jeton dans ATG plus tard. Conservez-le en lieu sûr, par exemple dans un gestionnaire de mots de passe. Le jeton d'accès permet de lire toute page Notion que vous connectez explicitement à cette intégration. **Il est confidentiel.** Ne le partagez pas et ne le commitez pas dans des dépôts de code publics. Cliquez sur **Enregistrer la connexion** pour appliquer vos modifications. ## 3. Donner accès à votre contenu Notion Les intégrations Notion n'accèdent qu'aux pages que vous autorisez explicitement. Pour chaque page (ou page racine dont vous souhaitez synchroniser l'arborescence), vous devez ajouter la connexion. ### Ouvrir les paramètres de la page Accédez à la page Notion que vous souhaitez rendre accessible à ATG. Cliquez sur le menu **⋯** en haut à droite, faites défiler jusqu'à **Connexions**, puis cliquez sur **+ Ajouter une connexion**. ![Notion, menu de page, section Connexions](https://www.askthisguy.com/doc/notion-04-fr.webp) ### Sélectionner votre connexion Dans le panneau **Ajouter une connexion**, recherchez la connexion que vous avez créée (par exemple `ATG`), puis sélectionnez-la dans les résultats. ![Notion, recherche Ajouter une connexion](https://www.askthisguy.com/doc/notion-05-fr.webp) ### Confirmer l'accès Vérifiez les permissions dans la fenêtre de confirmation. ATG n'a besoin que d'un accès en **lecture**. Vous devez voir **Peut lire le contenu** activé et les permissions d'écriture et de commentaire désactivées. Cliquez sur **Ajouter à la page** pour autoriser l'accès à cette page et à toutes ses pages enfants. ![Notion, Confirmer la connexion sur la page](https://www.askthisguy.com/doc/notion-06-fr.webp) Répétez cette étape pour chaque page racine ou base de données que vous souhaitez synchroniser avec ATG. Les pages enfants héritent de l'accès de leur parent : vous n'avez généralement besoin de connecter que les pages racines de chaque espace ou section à importer. ## 4. Connecter Notion dans ATG ### Ouvrir le menu Connecteurs Rendez-vous sur l'[onglet Connecteurs](https://app.askthisguy.com/admin/knowledge?tab=connectors) de la Console d'administration ATG. Cliquez sur **Ajouter un connecteur** et sélectionnez **Notion**. ### Coller votre jeton d'accès Collez le **Jeton d'accès** que vous avez copié depuis le portail développeur Notion, puis cliquez sur **Valider**. ### Ajouter une source Une fois le connecteur validé, rendez-vous sur l'[onglet Sources](https://app.askthisguy.com/admin/knowledge?tab=sources) et cliquez sur **Ajouter une source**. Sélectionnez le connecteur **Notion**, puis configurez les espaces et pages à importer. Vous pouvez inclure ou exclure du contenu spécifique pour garder une base de connaissances ciblée. Cliquez sur **Enregistrer** pour lancer la synchronisation initiale. Votre connexion Notion est prête. *Ask This Guy* peut désormais accéder aux pages que vous avez autorisées et les utiliser comme sources de données. Le connecteur se rafraîchit ensuite selon la fréquence configurée pour la source, quotidienne par défaut, pour prendre en compte les dernières modifications. --- # Connecteur Notion URL: https://www.askthisguy.com/fr/doc/admin-console/knowledge-management/connectors/notion-connector/ Language: fr Section: Documentation **Vous voulez configurer ce connecteur ?** Cette page présente le connecteur Notion et ses capacités. Pour les instructions pas à pas, consultez la page [Notion](https://www.askthisguy.com/doc/admin-console/knowledge-management/connectors/conf-guides/notion-conf-guide). ## Connecter votre workspace Notion à ATG Le **connecteur Notion** synchronise les pages et bases de votre organisation depuis **Notion** vers ATG, pour que les connaissances de votre équipe soient accessibles via la recherche et le chat IA. ### Ce qui est synchronisé Le connecteur peut importer du contenu depuis : - **Espaces d'équipe** — Workspaces partagés où votre organisation collabore - **Espaces privés** — Workspaces individuels pour notes et contenu personnels Vous gardez un **contrôle total** sur ce qui est importé grâce à des options de filtrage simples et puissantes. ### Traitement complet du contenu Lors de la synchronisation des pages Notion, ATG traite **à la fois le texte et les images** pour une capture complète. Votre assistant IA peut ainsi comprendre et référencer le contenu visuel en plus du texte. En savoir plus : [Documents et images](https://www.askthisguy.com/doc/admin-console/knowledge-management/how-documents-images-are-processed-by-atg) ### Options de filtrage simples Une fois connecté, vous pouvez préciser ce qu'ATG importe : - **Sélectionner des espaces** — Choisir quels espaces Notion synchroniser - **Inclure/Exclure dossiers et fichiers** — Inclure ou exclure des pages ou bases précises Ainsi, ATG ne traite que le contenu pertinent pour votre équipe. ### Mises à jour automatiques Après la première synchronisation, le connecteur se rafraîchit selon la **fréquence configurée pour la source**. Les nouvelles sources sont réglées sur **Quotidien** ; un administrateur peut choisir Manuel, Hebdomadaire ou Mensuel, ou lancer une actualisation à la demande, pour que votre assistant IA dispose du contenu Notion le plus récent. Voir [Fréquence de rafraîchissement](https://www.askthisguy.com/doc/admin-console/knowledge-management/connectors#frquence-de-rafrachissement). ### Prêt à démarrer ? Consultez la page [Notion](https://www.askthisguy.com/doc/admin-console/knowledge-management/connectors/conf-guides/notion-conf-guide) pour les instructions détaillées. --- # Données et RAG URL: https://www.askthisguy.com/fr/doc/admin-console/knowledge-management/how-is-my-companys-data-processed-what-is-rag/ Language: fr Section: Documentation Chez *Ask This Guy*, nous savons à quel point il est important pour vous de savoir ce qu'il advient de vos données lorsque vous utilisez notre plateforme. Cette page explique de façon claire et simple comment vos données sont traitées, organisées et utilisées pour fournir des réponses précises et fiables — toujours avec la confidentialité et la sécurité en tête. Nous utilisons la technologie **Retrieval-Augmented Generation (RAG)** pour que vos questions soient répondues à la fois à partir des dernières informations et des connaissances de votre organisation, sans compromettre l'intégrité des données. Pour rendre ces notions faciles à saisir, imaginez notre système comme un bibliothécaire très compétent dans une bibliothèque moderne et bien organisée. ![Le meilleur bibliothécaire](https://www.askthisguy.com/doc/documentation-for-administrators-knowledge-management-how-is-my-companys-data-processed-what-is-rag-image.webp) ## Qu'est-ce que le RAG ? Imaginez votre assistant IA comme un bibliothécaire très savant. Traditionnellement, ce bibliothécaire ne connaît que ce qu'il a en tête (les données d'entraînement du LLM). Avec le RAG, le bibliothécaire peut aussi chercher dans les derniers livres, documents et pages web de la bibliothèque et en ligne pour vous donner la meilleure réponse. **Techniquement :** Le RAG permet au LLM de « consulter » des informations pertinentes dans des sources externes — documents, bases de données, web — au moment où vous posez une question. L'IA combine ses propres connaissances avec ce qu'elle trouve pour vous donner une réponse plus fiable et à jour. ## Pourquoi utiliser le RAG ? - **Réponses à jour :** le RAG récupère les dernières informations, au-delà de la date de coupure des connaissances du LLM - **Expertise métier :** il connecte l'IA à vos connaissances internes pour des réponses adaptées - **Vérification des faits :** le RAG peut citer ses sources pour faciliter la vérification et la confiance dans les résultats ## Comment fonctionne le RAG ? Restons sur la métaphore du bibliothécaire : Le LLM est comme un bibliothécaire qui a beaucoup lu et étudié (ses données d'entraînement). Avec le RAG, il peut aussi parcourir les rayonnages et même interroger des bases en ligne pour trouver les informations les plus récentes et pertinentes pour votre question. **Le processus RAG :** 1. **Indexation (Cataloguer la bibliothèque)** - Tous les documents et données sont convertis en « embeddings » — des empreintes mathématiques qui capturent leur sens. Ils sont stockés dans une base vectorielle, comme un catalogue ultra-efficace, pour retrouver rapidement l'information pertinente. 2. **Récupération (Chercher dans les rayonnages)** - Quand vous posez une question, le bibliothécaire interroge le catalogue pour trouver les livres, articles ou documents les plus pertinents grâce à : - **Recherche par mots-clés :** recherche des mots exacts dans les titres ou le texte - **Recherche sémantique :** compréhension du sens de votre question pour trouver des contenus liés, même avec des formulations différentes 3. **Chunking (Diviser les livres en chapitres ou sections)** - Les grands documents sont découpés en sections pertinentes (« chunks »), pour ne récupérer que les chapitres ou pages utiles à votre question 4. **Augmentation (Rassembler et préparer les matériaux)** - Le bibliothécaire rassemble les sections pertinentes, les combine avec votre question et prépare une liste ou un résumé pour vous répondre précisément 5. **Génération (Rédiger la réponse)** - Le bibliothécaire s'appuie sur son expertise et sur les matériaux fraîchement récupérés pour fournir une réponse complète et sourcée — en vous indiquant souvent le livre ou la page exacte utilisée ## Système RAG multi-agents *This Guy* démocratise le prétraitement des connaissances internes en le rendant accessible à tous les utilisateurs. Traditionnellement, de tels pipelines sont déployés par de grandes entreprises sur des projets lourds nécessitant une expertise IA. Avec *This Guy*, le processus est simplifié et s'exécute en quelques minutes, sans compétences IA préalables. ![RAG - sélection visuelle.svg](https://www.askthisguy.com/doc/documentation-for-administrators-knowledge-management-how-is-my-companys-data-processed-what-is-rag-RAG_-_visual_selection.svg) ## Concepts clés ### **Chunking** Découper de longs textes en parties plus petites et pertinentes. Le système ne récupère ainsi que les sections les plus pertinentes pour votre question, ce qui améliore précision et efficacité. ### **Embeddings** Les embeddings sont comme des « empreintes » uniques pour des morceaux de texte. Ce sont des représentations mathématiques du sens d'une phrase ou d'un paragraphe, qui permettent au système de comparer et de trouver du contenu similaire — même avec des mots différents. ### **Tokenizers** Les tokenizers sont comme les lunettes du bibliothécaire : ils découpent le texte en unités compréhensibles. Le tokenizer découpe votre texte en unités appelées « tokens » — mots entiers, parties de mots ou caractères. Par exemple, pour « Quelle est notre politique de télétravail ? », le tokenizer peut produire : « Quelle », « est », « notre », « politique », « de », « télétravail », « ? ». Chaque token reçoit un numéro unique (comme une cote de catalogue) pour que l'IA traite votre question mathématiquement. En pratique : un token correspond environ à ~4 caractères pour un texte en anglais courant, soit environ ¾ de mot (100 tokens ≈ 75 mots). *Exemple de tokenisation : voir [OpenAI tokenizer](https://platform.openai.com/tokenizer).* ### **Recherche sémantique vs recherche par mots-clés** - **Recherche par mots-clés :** comme chercher un livre par son titre exact - **Recherche sémantique :** comme demander au bibliothécaire « des livres sur créer une entreprise » et qu'il trouve des ouvrages pertinents même avec d'autres mots (ex. « entrepreneuriat ») ### **Base vectorielle** Une base vectorielle est comme un catalogue de bibliothèque ultra-organisé. Elle stocke tous les embeddings et permet au système de retrouver rapidement l'information la plus pertinente pour votre question. ### Base de recherche par mots-clés La base de recherche par mots-clés est comme le catalogue de fiches du bibliothécaire pour trouver des livres par mots-clés. Quand vous cherchez « politique télétravail », elle parcourt les documents pour trouver ceux qui contiennent ces mots. *This Guy* va toutefois au-delà du simple décompte : il tient compte de la fréquence du terme dans chaque document (sans survaloriser les documents qui répètent 500 fois le même mot), de la rareté du terme dans l’ensemble des documents (un terme rare comme « sabbatical » compte plus qu’un terme courant comme « le »), et de la longueur des documents — les documents courts contenant vos mots-clés sont mieux notés que les très longs où les mots-clés sont moins pertinents. **Exemple :** pour « note de frais », *This Guy* peut mieux noter une courte politique de 2 pages qu’un manuel RH de 50 pages qui ne mentionne les frais qu’une fois. ### **Prompt engineering** Il s’agit de concevoir comment l’information récupérée et votre question sont combinées avant d’être envoyées au LLM. Les [Bonnes pratiques LLM](https://www.askthisguy.com/doc/webapp/llm-best-practices) aident le LLM à comprendre le contexte et à produire de meilleures réponses. ### **Mise à jour des données externes** Pour garder les réponses à jour, *This Guy* met régulièrement à jour ses sources externes et recalcule les embeddings, afin que l’IA ait toujours accès aux dernières informations. ### **Attribution des sources (citations)** *This Guy* peut fournir des références ou citations pour les informations utilisées, ce qui permet aux utilisateurs de vérifier les faits et de faire confiance aux réponses. ## Exemple concret Supposons que vous demandiez à *This Guy* : *« Quelle est notre politique de télétravail pour les nouvelles recrues ? »* Le système va : 1. Découper votre manuel RH en chapitres ou sections 2. Utiliser la recherche sémantique pour trouver la section sur le télétravail 3. Envoyer cette section et votre question au LLM 4. Le LLM (votre bibliothécaire expert) génère une réponse en citant la page ou la section utilisée ## Résumé
**Concept****Signification****Exemple**
RAGLLM + recherche en temps réel pour des réponses ancréesBibliothécaire avec accès à toutes les ressources
EmbeddingsEmpreintes mathématiques du sens du texteCote unique pour chaque livre
Base vectorielleStocke et organise les embeddings pour une récupération rapideCatalogue pour une recherche rapide
Recherche sémantiqueTrouve le sens, pas seulement les motsBibliothécaire qui « comprend » ce que vous voulez
Recherche par mots-clésTrouve les correspondances exactes de motsRecherche par titre de livre
ChunkingDécoupe les longs textes en parties pertinentesDiviser un livre en chapitres
Prompt engineeringConcevoir comment l’info est présentée au LLMPoser une question claire au bibliothécaire
Mise à jour des données externesRafraîchir sources et embeddings régulièrementMettre la bibliothèque à jour avec de nouveaux livres
Attribution des sourcesFournir des références pour les réponsesNotes de bas de page dans un rapport
La technologie RAG rend *This Guy* plus fiable et digne de confiance en lui permettant de « consulter » les informations les plus récentes et pertinentes — comme un bon bibliothécaire qui vérifie toujours les rayonnages et cite ses sources avant de vous répondre. --- # SharePoint et OneDrive URL: https://www.askthisguy.com/fr/doc/admin-console/knowledge-management/connectors/conf-guides/sharepoint-onedrive-conf-guide/ Language: fr Section: Documentation **Vous cherchez les capacités du connecteur ?** Cette page donne les instructions de configuration pas à pas. Pour une vue d'ensemble du connecteur SharePoint et de ses fonctionnalités, consultez la [page Connecteur SharePoint](https://www.askthisguy.com/doc/admin-console/knowledge-management/connectors/sharepoint-onedrive-connector). *Temps approximatif : 5 minutes pour l'option A, 10-15 minutes pour l'option B* ## Avant de commencer Les actions ci-dessous ne peuvent être effectuées que par les administrateurs Microsoft Entra (anciennement Azure AD). Assurez-vous d'avoir accès à un compte administrateur de votre organisation. Pour connecter ATG à SharePoint, vous devrez suivre les étapes ci-dessous : 1. [Créer une application d'entreprise dans Microsoft Entra](#1-crer-une-application-dentreprise-dans-microsoft-entra) 2. [Configurer les autorisations API de l'application](#2-configurer-les-autorisations-de-lapi-microsoft-graph) 3. (Option B uniquement) [Configurer les autorisations par site avec PowerShell](#3-configurer-les-autorisations-par-site-avec-powershell-option-b-uniquement) 4. [Créer un secret client](#4-crer-un-secret-client) 5. [Récupérer les identifiants pour connecter SharePoint dans ATG](#5-recuperer-les-identifiants-pour-atg) 6. [Configurer vos sites SharePoint dans ATG](#6-connecter-sharepoint-dans-atg) ## 1. Créer une application d'entreprise dans Microsoft Entra ### Accéder au menu Inscriptions d'applications Rendez-vous sur le [Centre d’administration Microsoft Entra](https://entra.microsoft.com/), puis ouvrez « Inscriptions d’applications » dans le menu de gauche. ![Centre d'administration Microsoft Entra](https://www.askthisguy.com/doc/sharepoint-1-fr.webp) ### Créer une nouvelle inscription d'application Cliquez sur « + Nouvelle inscription » dans le menu en haut. Saisissez « Ask This Guy » (ou un autre nom si vous préférez) comme nom, conservez les paramètres par défaut ci-dessous, puis cliquez sur « S'inscrire » : ![Création d'inscription d'application](https://www.askthisguy.com/doc/sharepoint-2-fr.webp) ### Vue d'ensemble de l'application Après l'inscription, la page de gestion de l'application s'affiche. Vous devrez noter deux valeurs importantes de cette page pour plus tard : - ID d'application (client) - ID d'annuaire (locataire) ![Vue d'ensemble de l'inscription d'application](https://www.askthisguy.com/doc/sharepoint-3-fr.webp) ## 2. Configurer les autorisations de l'API Microsoft Graph Vous avez deux options pour configurer les autorisations : **[Option A : Autorisations globales pour tous les sites SharePoint/OneDrive](#option-a-autorisations-globales-pour-tous-les-sites-sharepointonedrive)**. Cette configuration est la plus simple : vous accorderez à ATG des droits de lecture sur tous les sites SharePoint et activerez la découverte des espaces. Vous pourrez tout configurer facilement dans la console d’administration ATG. **[Option B : Autorisations restreintes pour des sites SharePoint spécifiques](#option-b-autorisations-restreintes-pour-des-sites-sharepoint-specifiques)** Cette configuration renforce la sécurité : vous choisirez les sites auxquels ATG pourra accéder. Vous devrez configurer manuellement la liste des sites autorisés dans la console d’administration. ### Option A : Autorisations globales pour tous les sites SharePoint/OneDrive Allez dans « Autorisations d’API » et cliquez sur « + Ajouter une autorisation » : ![Ajouter une autorisation](https://www.askthisguy.com/doc/sharepoint-4-fr.webp) Cliquez sur « Microsoft Graph » : ![Microsoft Graph](https://www.askthisguy.com/doc/sharepoint-6-fr.webp) Puis cliquez sur « Autorisations d’application » : ![Autorisations d'application](https://www.askthisguy.com/doc/sharepoint-7-fr.webp) Ensuite, ajoutez les autorisations suivantes : - Sites.Read.All - User.Read.All - Files.Read.All et cliquez sur « Ajouter des autorisations » : ![Ajouter des autorisations](https://www.askthisguy.com/doc/sharepoint-8-fr.webp) Vous devriez maintenant voir les autorisations sur votre application, comme ceci : ![Autorisations d'application](https://www.askthisguy.com/doc/sharepoint-9-en.webp) Dernière étape : accorder le consentement administrateur pour l'application. Cliquez sur « Accorder le consentement de l’administrateur pour [votre organisation] » ![Accorder le consentement administrateur](https://www.askthisguy.com/doc/sharepoint-11-en.webp) Confirmez lorsque demandé : ![Accorder le consentement administrateur](https://www.askthisguy.com/doc/sharepoint-12-en.webp) Vous devriez maintenant voir des coches vertes, comme ceci : ![Accorder le consentement administrateur](https://www.askthisguy.com/doc/sharepoint-13-fr.webp) C'est tout ! **Vous pouvez maintenant passer à l’[étape 4 : Créer un secret client](#4-crer-un-secret-client).** ### Option B : Autorisations restreintes pour des sites SharePoint spécifiques Allez dans « Autorisations d’API » et cliquez sur « + Ajouter une autorisation » : ![Ajouter une autorisation](https://www.askthisguy.com/doc/sharepoint-4-fr.webp) Cliquez sur « Microsoft Graph » : ![Microsoft Graph](https://www.askthisguy.com/doc/sharepoint-6-fr.webp) Puis cliquez sur « Autorisations d’application » : ![Autorisations d'application](https://www.askthisguy.com/doc/sharepoint-7-fr.webp) Ensuite, ajoutez l'autorisation suivante : - Sites.Selected et cliquez sur « Ajouter des autorisations » : ![Ajouter des autorisations](https://www.askthisguy.com/doc/sharepoint-10-fr.webp) ## 3. Configurer les autorisations par site avec PowerShell (option B uniquement) Avec **Sites.Selected**, vous devez accorder explicitement l'accès à chaque site SharePoint via PowerShell. Cela permet de contrôler finement quels sites ATG peut utiliser. ### 3.1. Lancer PowerShell Sur votre machine, PowerShell doit être installé. Sinon, [suivez ce guide pour installer PowerShell](https://learn.microsoft.com/fr-fr/powershell/scripting/install/install-powershell). Puis lancez-le avec : ```bash pwsh ``` ### 3.2 Installer le module PnP PowerShell Dans PowerShell, vous avez besoin du [module PnP PowerShell](https://pnp.github.io/powershell/) de Microsoft. Si le module n'est pas déjà installé, exécutez simplement la commande suivante : ```powershell Install-Module PnP.PowerShell -Scope CurrentUser -Force ``` ### 3.3 Créer une application d'aide pour l'authentification PowerShell Pour vous connecter à SharePoint avec l'authentification moderne, vous devez créer une inscription d'application Entra ID supplémentaire dédiée à l'accès PowerShell. Retournez dans le centre d'administration Microsoft Entra, dans le [menu Inscriptions d'applications](https://entra.microsoft.com/#view/Microsoft_AAD_RegisteredApps/ApplicationsListBlade/quickStartType~/null/sourceType/Microsoft_AAD_IAM), et créez une **nouvelle inscription d'application** : 1. Cliquez sur « + Nouvelle inscription » et saisissez les informations suivantes : - Nom : « PowerShell Helper App » - Types de compte pris en charge : « Comptes dans cet annuaire uniquement » - URI de redirection : sélectionnez « Client public/natif (mobile et bureau) » et indiquez `http://localhost` comme URI ![Nouvelle inscription d'application](https://www.askthisguy.com/doc/sharepoint-14-en.webp) 2. Cliquez sur « S'inscrire » Votre application doit apparaître dans la liste des inscriptions d'applications : ![Nouvelle inscription d'application](https://www.askthisguy.com/doc/sharepoint-15-en.webp) Notez que votre application d'aide a un ID d'application (client), vous en aurez besoin plus tard. ### 3.4 Configurer les autorisations API de l'application d'aide Dans votre nouvelle application d'aide, allez dans « Autorisations d’API ». Pour l'instant, votre application ne doit avoir qu'une seule autorisation : « User.Read » : ![Autorisations d'API](https://www.askthisguy.com/doc/sharepoint-16-fr.webp) Nous devons ajouter de nouvelles autorisations. Cliquez sur « + Ajouter une autorisation » et sélectionnez « Microsoft Graph » : ![Microsoft Graph](https://www.askthisguy.com/doc/sharepoint-17-fr.webp) Cliquez sur « Autorisations déléguées » : ![Autorisations déléguées](https://www.askthisguy.com/doc/sharepoint-18-fr.webp) Ajoutez l'autorisation déléguée suivante : - Sites.FullControl.All et cliquez sur « Ajouter des autorisations » : ![Ajouter des autorisations](https://www.askthisguy.com/doc/sharepoint-19-fr.webp) Votre application doit maintenant avoir les autorisations suivantes : - User.Read - Sites.FullControl.All ![Autorisations d'application](https://www.askthisguy.com/doc/sharepoint-20-fr.webp) Cliquez sur « Accorder le consentement de l'administrateur pour [votre organisation] » : ![Accorder le consentement administrateur](https://www.askthisguy.com/doc/sharepoint-21-en.webp) Confirmez : ![Accorder le consentement administrateur](https://www.askthisguy.com/doc/sharepoint-22-en.webp) Vous devriez maintenant voir des coches vertes, comme ceci : ![Accorder le consentement administrateur](https://www.askthisguy.com/doc/sharepoint-23-fr.webp) ### 3.5 Activer les flux client publics Allez dans « Authentification (Aperçu) » dans le menu de gauche. Ouvrez le menu « Paramètres ». Réglez « Autoriser les flux client publics » sur **Activé**. Cliquez sur « Enregistrer ». ![Flux client publics](https://www.askthisguy.com/doc/sharepoint-24-fr.webp) ### 3.6 Se connecter à SharePoint avec PowerShell Vous pouvez maintenant vous connecter à SharePoint en tant qu'administrateur avec l'application d'aide que vous venez de créer. Exécutez la commande suivante en remplaçant : - `` par le nom de votre locataire (ex. si vos sites SharePoint sont sur [https://contoso.sharepoint.com](https://contoso.sharepoint.com), utilisez « contoso ») - `` par l'ID d'application (client) de la page de vue d'ensemble de l'application d'aide ```powershell Connect-PnPOnline ` -Url https://-admin.sharepoint.com ` -ClientId ` -Interactive ``` Une fenêtre de navigateur s'ouvrira pour vous authentifier avec vos identifiants administrateur. Vous êtes maintenant connecté à SharePoint en tant qu'administrateur avec l'authentification moderne. ### 3.7 Lister les sites SharePoint disponibles (optionnel) Pour afficher tous les sites SharePoint de votre locataire : ```powershell Get-PnPTenantSite | Where-Object { $_.Url -like "*/sites/*" } | Select Url, Title ``` ### 3.8 Accorder les autorisations de site à l'application ATG Pour chaque site SharePoint auquel ATG doit accéder, exécutez la commande suivante : Remplacez : - `` par le nom de votre locataire - `` par le nom du site (ex. « TeamSite ») - `` par l’**ID d'application (client)** de votre **application ATG** (la première application créée, pas l'application d'aide) - `` par un nom lisible (ex. « Ask This Guy Connector ») ```powershell Grant-PnPAzureADAppSitePermission ` -Site https://.sharepoint.com/sites/ ` -AppId ` -DisplayName "" ` -Permissions Read ``` **Exemple :** ```powershell Grant-PnPAzureADAppSitePermission ` -Site https://contoso.sharepoint.com/sites/Engineering ` -AppId b742cb55-dc46-4a46-adc4-72a5a28c4b64 ` -DisplayName "Ask This Guy Connector" ` -Permissions Read ``` Répétez cette commande pour chaque site à autoriser. ### 3.9 Vérifier les autorisations (optionnel) Pour afficher les autorisations accordées sur un site donné : ```powershell Get-PnPAzureADAppSitePermission -Site ``` Les autorisations par site sont configurées. L'application ATG peut désormais accéder uniquement aux sites SharePoint que vous avez explicitement autorisés. ## 4. Créer un secret client Allez dans « Certificats et secrets » dans le menu de gauche de l'inscription d'application : ![Certificats et secrets](https://www.askthisguy.com/doc/sharepoint-25-fr.webp) Cliquez sur « + Nouveau secret client », saisissez une description (optionnel) et choisissez une durée d'expiration, puis cliquez sur « Ajouter » : ![Nouveau secret client](https://www.askthisguy.com/doc/sharepoint-26-fr.webp) **Important :** - Copiez immédiatement la **Valeur** du secret ! Vous ne pourrez plus la consulter après avoir quitté cette page. - Si vous définissez une **date d'expiration** du secret, notez-la : vous devrez renouveler le secret avant expiration et le reconfigurer dans ATG. ## 5. Récupérer les identifiants pour ATG Vous aurez besoin des trois valeurs suivantes pour configurer le connecteur SharePoint dans ATG : 1. **ID du locataire** : sur la page de vue d'ensemble de l'application 2. **ID client** : sur la page de vue d'ensemble, sous « ID d'application (client) » 3. **Valeur du secret client** : la valeur copiée à l'étape de création du secret client Conservez ces identifiants en sécurité. Ils donnent accès à votre contenu SharePoint. ## 6. Connecter SharePoint dans ATG ### Accéder au menu Connecteurs dans la console d'administration ATG Allez dans [le menu Connecteurs](https://app.askthisguy.com/admin/knowledge?tab=connectors) : ![Menu Connecteurs dans la console d'administration](https://www.askthisguy.com/doc/connectors-menu-1-en.webp) Cliquez sur « Ajouter un connecteur », sélectionnez « Sharepoint » : ![Ajouter un connecteur, sélectionner SharePoint](https://www.askthisguy.com/doc/connectors-menu-sharepoint-1-fr.webp) Saisissez les identifiants récupérés : - ID du locataire - ID d'application (client) - Secret client puis cliquez sur « Enregistrer » : ![Saisir les identifiants](https://www.askthisguy.com/doc/connectors-menu-sharepoint-2-fr.webp) Bravo ! Le connecteur SharePoint est maintenant ajouté à ATG. Vous pouvez ajouter des sources à votre connecteur. Le connecteur SharePoint a bien été ajouté à ATG ! Pour ajouter une source, allez dans [le menu Sources](https://app.askthisguy.com/admin/knowledge?tab=sources) et ajoutez une source (le connecteur SharePoint est désormais disponible dans la liste). --- # Documents et images URL: https://www.askthisguy.com/fr/doc/admin-console/knowledge-management/how-documents-images-are-processed-by-atg/ Language: fr Section: Documentation L'assistant IA *This Guy* met en œuvre un **pipeline de traitement documentaire multimodal** qui transforme des documents complexes en bases de connaissances indexées intelligemment. Le système atteint **plus de 95 % de précision** en extraction de texte et supporte **plus de 50 langues** avec détection automatique. Un des points forts de *This Guy* est de gérer intelligemment les images dans les documents et de pouvoir les réutiliser dans ses réponses. Voici comment fonctionne le pipeline : ![*Pipeline de traitement et d'intégration des images dans ATG*](https://www.askthisguy.com/doc/documentation-for-administrators-knowledge-management-how-documents-images-are-processed-by-atg-image.webp) *Pipeline de traitement et d'intégration des images dans ATG* ## Recommandations pour la mise en forme de vos documents Pour optimiser le travail et la précision de *This Guy*, il est essentiel de rendre vos (futurs) documents aussi explicites que possible. Voici des conseils pour que vos équipes structurent leurs documents afin qu'ils soient plus facilement interprétables par des outils IA comme Mistral ou autres : **Clarté et précision :** Assurez-vous que le contenu est clair et précis. Évitez les ambiguïtés et soyez aussi détaillés que possible. **Structure cohérente :** Gardez une structure cohérente entre informations textuelles et visuelles. Utilisez des titres et sous-titres pour organiser le contenu et faciliter la compréhension. **Séparation des éléments :** Distinguez clairement les types d'information (par ex. séparer les paragraphes des images ou graphiques). **Mots-clés :** Intégrez des mots-clés pertinents pour identifier le contenu et le contexte. **Formatage uniforme :** Utilisez un formatage uniforme pour les éléments similaires (ex. toutes les images formatées de la même façon). **Annotations et légendes :** Ajoutez des annotations et légendes aux images et graphiques pour donner du contexte et clarifier le contenu. En suivant ces conseils, vous aiderez *This Guy* à mieux comprendre et traiter vos documents, et donc à améliorer la précision et l'efficacité de son travail. ## Vue d'ensemble de l'architecture du pipeline ![Intégration du pipeline de traitement des images ATG](https://www.askthisguy.com/doc/documentation-for-administrators-knowledge-management-how-documents-images-are-processed-by-atg-cf20a0ee-ffbf-457e-bfc8-d1f389c74988.webp) Intégration du pipeline de traitement des images ATG Le système d'intégration documentaire ATG fonctionne via un **pipeline en cinq étapes**, du téléversement initial jusqu'à l'indexation dans la base de connaissances. Cette architecture respecte des standards entreprise pour la scalabilité et la fiabilité. ### Étape 1 : Ingestion des documents Le système accepte plusieurs formats (PDF, Word, PowerPoint, etc.). Les documents sont validés et mis en file pour le traitement, avec détection automatique du format et extraction des métadonnées. ### Étape 2 : Extraction et séparation du contenu Le pipeline sépare le contenu textuel des images intégrées en préservant la structure du document et en préparant les assets pour des flux de traitement dédiés. ### Étape 3 : Couche de traitement IA Cette étape met en œuvre une **analyse multimodale parallèle** avec des technologies de vision par ordinateur et de traitement du langage naturel. Texte et images sont traités simultanément pour une efficacité maximale. **Flux texte :** - OCR avancé pour les documents scannés et le texte intégré - Détection de langue et normalisation du texte - Analyse sémantique et extraction d'entités **Flux images :** - Analyse du contenu visuel et génération de descriptions - Reconnaissance de graphiques, schémas et tableaux - Compréhension contextuelle des images avec logique métier ### Étape 4 : Intégration et enrichissement du contenu Le système combine le texte traité et les descriptions d'images en **format markdown structuré**, pour une représentation unifiée qui préserve l'information visuelle et textuelle. **Génération du markdown :** - Les images sont stockées de façon sécurisée dans le stockage cloud ATG - Les descriptions générées par l'IA servent de texte alternatif pour l'accessibilité - Préservation de la structure hiérarchique (titres, formatage) - Renvois entre images et contenu textuel associé ### Étape 5 : Indexation et recherche dans la base de connaissances La dernière étape met en œuvre **vectorisation et embeddings** pour permettre la recherche sémantique. **Fonctionnalités d'indexation :** - **Stratégie de chunking :** les documents sont segmentés en chunks logiques pour une récupération optimale - **Embeddings vectoriels :** le texte et les descriptions d'images sont convertis en vecteurs de haute dimension - **Recherche hybride :** combinaison de recherche par mots-clés et sémantique - **Mises à jour en temps réel :** ré-indexation automatique lorsque les documents sont modifiés ## Stack technique Le système ATG s'appuie sur des technologies IA de pointe tout en conservant flexibilité et souveraineté des données (selon la politique IA choisie par les administrateurs) : ### Traitement OCR - **OCR :** reconnaissance de texte à **plus de 95 % de précision** sur les documents standards - **Multilingue :** détection automatique de plus de 50 langues - **Reconnaissance de l'écriture manuscrite :** capacités avancées pour les manuscrits ### IA vision multimodale - Compréhension multimodale niveau entreprise pour une analyse documentaire complète - **Descriptions contextuelles :** analyse détaillée des images avec intégration du contexte métier - **Reconnaissance de schémas techniques :** traitement dédié aux graphiques, courbes et illustrations techniques ### Solutions IA européennes - Hébergement conforme UE pour la souveraineté des données - Inclusion, le cas échéant, de modèles open-weight dans les flux de traitement - Traitement multimodal efficace avec résidence des données en Europe ### Enrichissement linguistique - Enrichissement et analyse sémantique avancés du texte - Amélioration automatique de la structure et de la lisibilité des documents --- # Connecteur SharePoint et OneDrive URL: https://www.askthisguy.com/fr/doc/admin-console/knowledge-management/connectors/sharepoint-onedrive-connector/ Language: fr Section: Documentation **Vous souhaitez configurer ce connecteur ?** Cette page présente une vue d'ensemble du connecteur SharePoint et OneDrive et de ses fonctionnalités. Pour les instructions de configuration pas à pas, consultez le [guide de configuration SharePoint et OneDrive](https://www.askthisguy.com/doc/admin-console/knowledge-management/connectors/conf-guides/sharepoint-onedrive-conf-guide). ## Connecter votre Microsoft 365 à ATG Le **connecteur SharePoint et OneDrive** synchronise les documents de votre organisation depuis **Microsoft 365** vers ATG, rendant le savoir de votre équipe immédiatement accessible via la recherche et le chat pilotés par l'IA. **Note :** Ce connecteur fonctionne exclusivement avec **SharePoint** (sites d'organisation) et **OneDrive Entreprise**. Les comptes OneDrive personnels ne sont pas pris en charge. ### Que peut-on synchroniser ? Le connecteur peut importer des documents depuis : - **Sites SharePoint** - Sites d'équipe et bibliothèques de documents accessibles à votre organisation - **OneDrive Entreprise** - Dossiers OneDrive individuels des collaborateurs de votre organisation Vous gardez un **contrôle total** sur ce qui est importé grâce à des options de filtrage avancées. ### Options de filtrage flexibles Une fois connecté, vous pouvez préciser exactement quel contenu ATG importe : - **Sélectionner des sites ou dossiers précis** - Choisir quels sites SharePoint ou dossiers OneDrive synchroniser - **Filtres par date** - Importer uniquement les documents mis à jour avant une date, après une date, ou entre deux dates - **Règles d'inclusion/exclusion** - Indiquer des dossiers ou fichiers précis à inclure ou exclure ### Filtrage intelligent par étiquettes C'est là que SharePoint et OneDrive se distinguent avec une **fonctionnalité exclusive puissante** : le **filtrage par étiquettes**, compatible avec le [**magasin de termes**](https://learn.microsoft.com/fr-fr/sharepoint/managed-metadata) Microsoft. Les étiquettes vous permettent de **contrôler finement** quels documents sont synchronisés selon leurs métadonnées, ce qui facilite grandement la sélection des seuls documents de référence pertinents. **Fonctionnement :** - **Étiquettes d'inclusion** - Ne synchroniser que les documents marqués par certains termes (par ex. « Approuvé », « Version finale », « Public ») - **Étiquettes d'exclusion** - Ignorer les documents marqués par certains termes (par ex. « Brouillon », « Archivé », « Interne uniquement ») **Exemple d'usage :** Imaginons que votre équipe juridique étiquette tous les contrats finalisés avec **« Contrat signé »** dans SharePoint. Vous pouvez configurer ATG pour **n'importer que les documents portant cette étiquette**, afin que votre assistant IA ne s'appuie que sur des accords validés et signés — pas sur des brouillons ou des modèles. Votre base de connaissances reste ainsi propre, exacte et fiable. Ainsi, ATG ne traite que le contenu pertinent pour votre équipe, pour une base de connaissances ciblée et efficace. ### Mises à jour automatiques Après la première synchronisation, le connecteur se rafraîchit selon la **fréquence configurée pour la source**. Les nouvelles sources sont réglées sur **Quotidien** ; un administrateur peut choisir Manuel, Hebdomadaire ou Mensuel, ou lancer une actualisation à la demande, pour que votre assistant IA dispose des dernières versions de vos documents. Voir [Fréquence de rafraîchissement](https://www.askthisguy.com/doc/admin-console/knowledge-management/connectors#frquence-de-rafrachissement). ### Types de fichiers pris en charge Le connecteur SharePoint et OneDrive gère un **large éventail** de formats : **Formats de documents courants :** - Markdown (.md) - PDF (.pdf) - Texte brut (.txt) - Format RTF (.rtf) - Fichiers HTML (.html) **Fichiers Microsoft Office :** - Documents Word (.docx) - Présentations PowerPoint (.pptx) **Images :** - PNG (.png) - JPEG (.jpg) **Types de fichiers personnalisés :** - [Traitement sur mesure](https://www.askthisguy.com/doc/customizing-atg-to-you/tailored-processing) - ATG peut être configuré pour prendre en charge les formats spécifiques de votre organisation avec des règles de traitement dédiées. ### Prêt à commencer ? Consultez le [guide de configuration SharePoint et OneDrive](https://www.askthisguy.com/doc/admin-console/knowledge-management/connectors/conf-guides/sharepoint-onedrive-conf-guide) pour les instructions de configuration détaillées, ou contactez votre interlocuteur Ask This Guy si vous avez besoin d'aide. --- # Slack URL: https://www.askthisguy.com/fr/doc/admin-console/knowledge-management/connectors/conf-guides/slack-conf-guide/ Language: fr Section: Documentation **Vous cherchez les capacités du connecteur ?** Cette page donne les instructions de configuration pas à pas. Pour une vue d'ensemble du connecteur Slack et de ses fonctionnalités, consultez la page [Connecteur Slack](https://www.askthisguy.com/doc/admin-console/knowledge-management/connectors/slack-connector). Pour connecter ATG à Slack, vous devrez obtenir un jeton depuis Slack. Pour commencer, créez une application Slack. L'app sert de conteneur pour vos identifiants ; sans elle vous ne pouvez pas obtenir de jeton. Vous pouvez suivre le guide de démarrage rapide Slack pour créer une app : [Quickstart](https://api.slack.com/quickstart) Instructions pas à pas pour créer, installer et configurer la connexion ATG à Slack : [1. Créer une app](https://www.askthisguy.com/doc/admin-console/knowledge-management/connectors/conf-guides/slack-conf-guide) [2. Définir les scopes de votre app](https://www.askthisguy.com/doc/admin-console/knowledge-management/connectors/conf-guides/slack-conf-guide) [3. Installer et autoriser l'app](https://www.askthisguy.com/doc/admin-console/knowledge-management/connectors/conf-guides/slack-conf-guide) [4. Importer le jeton dans ATG](https://www.askthisguy.com/doc/admin-console/knowledge-management/connectors/conf-guides/slack-conf-guide) ## 1. Créer une app ### Accédez à vos applications Slack [Slack API: Applications | Slack](https://api.slack.com/apps) ### Démarrer la création d'une nouvelle app ![](https://3wnk7clnt5z9buow.public.blob.vercel-storage.com/99fb1a0f-6283-46c3-a73c-353aa14c3996/19ce2399-95ad-4f5c-85e4-b10bc40061a2-thumb.png) Cliquez sur le bouton « Create New App ». ### Option 1 (recommandée) : choisir « From a manifest » ![](https://3wnk7clnt5z9buow.public.blob.vercel-storage.com/7618db6f-9e6a-4db5-8cb9-157e230de247/13b92304-1439-416a-b010-f71ebcd49ff2-thumb.png) Sélectionnez l'option pour créer l'app à partir d'un fichier manifest. ### Sélectionner le workspace ![](https://3wnk7clnt5z9buow.public.blob.vercel-storage.com/7618db6f-9e6a-4db5-8cb9-157e230de247/64a04729-0c58-458e-a4df-e8077238af72-thumb.png) Choisissez le workspace dans lequel vous voulez développer votre app et cliquez sur « Next ». ### Confirmer la sélection du workspace ![](https://3wnk7clnt5z9buow.public.blob.vercel-storage.com/7618db6f-9e6a-4db5-8cb9-157e230de247/3c42a47b-dac3-4a48-b4e7-ad78fb60c027-thumb.png) Cliquez sur le bouton « Next ». ### Copier-coller le manifest JSON ci-dessous ```json { "display_information": { "name": "Ask This Guy" }, "oauth_config": { "scopes": { "user": [ "channels:history", "channels:read", "files:read", "users:read" ] } }, "settings": { "org_deploy_enabled": false, "socket_mode_enabled": false, "token_rotation_enabled": false } } ``` ![](https://3wnk7clnt5z9buow.public.blob.vercel-storage.com/7618db6f-9e6a-4db5-8cb9-157e230de247/fb1e4c01-10cb-4103-a9e4-ed79a21fff90-thumb.png) Cliquez sur le bouton « Next ». ### Option 2 : choisir « From scratch » ![](https://3wnk7clnt5z9buow.public.blob.vercel-storage.com/99fb1a0f-6283-46c3-a73c-353aa14c3996/6183d7cf-1f70-46ce-b242-aeee50db3e4f-thumb.png) Sélectionnez « From scratch ». ### Nommer votre app ![](https://3wnk7clnt5z9buow.public.blob.vercel-storage.com/99fb1a0f-6283-46c3-a73c-353aa14c3996/0aa24e46-157e-4f3d-acdd-6b2dcc1e18c4-thumb.png) Saisissez un nom d'app et choisissez un workspace. ### Sélectionner votre workspace ![](https://3wnk7clnt5z9buow.public.blob.vercel-storage.com/99fb1a0f-6283-46c3-a73c-353aa14c3996/c8b30019-3490-4938-917b-0b7e0b0ff4af-thumb.png) Choisissez un nom d'app, sélectionnez le workspace dans lequel développer l'app puis cliquez sur « Create App ». ## 2. Définir les scopes de votre app Les scopes donnent à votre app l'autorisation d'effectuer des actions, par exemple lire les messages dans votre workspace. Si vous avez créé l'app from scratch, vous devez configurer ou modifier les [**scopes**](https://api.slack.com/scopes) de l'app. Si vous avez créé l'app à partir d'un manifest, les scopes recommandés sont déjà en place. Vous pouvez les modifier plus tard si besoin en suivant les étapes ci-dessous : ### Accédez à vos apps Slack et sélectionnez votre app [Slack API: Applications | Slack](https://api.slack.com/apps) ### Aller à OAuth & Permissions ![image.png](https://www.askthisguy.com/doc/documentation-for-administrators-knowledge-management-how-to-configure-my-connectors-slack-conf-guide-image.webp) Cliquez sur « OAuth & Permissions » dans la section Features. ### Ajouter un scope OAuth ![image.png](https://www.askthisguy.com/doc/documentation-for-administrators-knowledge-management-how-to-configure-my-connectors-slack-conf-guide-image-1.webp) Descendez jusqu'à la section Scopes et au bouton « Add an OAuth Scope » sous « User Token Scopes ». ### Ajouter les scopes OAuth Descendez jusqu'à la section Scopes et au bouton « Add an OAuth Scope » sous « User Token Scopes ». Nous recommandons de limiter les scopes à la **configuration minimale** pour qu'ATG fonctionne :
[**channels:history**](https://api.slack.com/scopes/channels:history)Voir les messages et le contenu des canaux publics de l'utilisateur
[**channels:read**](https://api.slack.com/scopes/channels:read)Voir les informations de base sur les canaux publics du workspace
[**files:read**](https://api.slack.com/scopes/files:read)Voir les fichiers partagés dans les canaux et conversations auxquels l'utilisateur a accès
[**users:read**](https://api.slack.com/scopes/users:read)Voir les personnes du workspace
## 3. Installer et autoriser l'app ### Aller à la section Install App ![](https://3wnk7clnt5z9buow.public.blob.vercel-storage.com/07e20523-1de6-4060-85ff-534e9d98e8ca/1ee99e74-f129-4f0e-9932-13f4516ed9eb-thumb.png) Sur la page des paramètres de l'API Slack, cliquez sur « Install App » dans le menu de gauche. ### Démarrer l'installation ![image.png](https://www.askthisguy.com/doc/documentation-for-administrators-knowledge-management-how-to-configure-my-connectors-slack-conf-guide-image-2.webp) Cliquez sur le bouton Install pour lancer l'installation de l'app dans le workspace choisi. ### Autoriser l'app ![](https://3wnk7clnt5z9buow.public.blob.vercel-storage.com/07e20523-1de6-4060-85ff-534e9d98e8ca/5313c9e1-4189-4e98-bf73-ee6bdb081376-thumb.png) Vérifiez les permissions demandées par l'app puis cliquez sur « Allow » pour autoriser l'app dans votre workspace Slack. ### Voir/copier le jeton OAuth ![](https://3wnk7clnt5z9buow.public.blob.vercel-storage.com/07e20523-1de6-4060-85ff-534e9d98e8ca/8e37297d-d4f0-4302-bf5a-22f3f6499b79-thumb.png) Après une installation réussie, la page « Installed App Settings » affiche votre Bot User OAuth Token. C'est ce jeton que vous utiliserez pour appeler l'API Slack au nom de votre app. Cliquez sur Copy pour le copier dans le presse-papiers pour une utilisation ultérieure dans ATG. Les jetons d'accès représentent les permissions déléguées à votre app par l'utilisateur qui installe. Ces identifiants permettent à votre app d'accéder à l'API Slack. Ils sont confidentiels. Ne partagez pas ces identifiants et ne les incluez pas dans des dépôts de code publics. Stockez-les de manière sécurisée. ## 4. Importer le jeton dans ATG ### Ouvrir les catégories de connaissances ![](https://3wnk7clnt5z9buow.public.blob.vercel-storage.com/473e6c56-a7a7-467f-863c-f486d9fc0474/7cf6de35-1186-4b71-ad4f-80e569c675c8-thumb.png) Ouvrez la section Catégories de connaissances de la [Console d'administration ATG](https://app.askthisguy.com/admin). ### Ajouter un connecteur ![](https://3wnk7clnt5z9buow.public.blob.vercel-storage.com/473e6c56-a7a7-467f-863c-f486d9fc0474/03b690cd-55eb-4fc0-8631-fbb862e94fb6-thumb.png) Cliquez sur « Add a connector » pour ouvrir le menu de sélection des connecteurs et choisissez le connecteur Slack parmi les options disponibles. ### Coller votre jeton ![](https://3wnk7clnt5z9buow.public.blob.vercel-storage.com/473e6c56-a7a7-467f-863c-f486d9fc0474/5e9396c1-b61a-47e7-b8cb-2cf7e44e881a-thumb.png) Collez le jeton généré précédemment dans la console d'administration Slack. ### Valider le connecteur Slack ![](https://3wnk7clnt5z9buow.public.blob.vercel-storage.com/473e6c56-a7a7-467f-863c-f486d9fc0474/40a7b4d4-a6f6-456a-8cd4-b813398874db-thumb.png) Cliquez sur le bouton « Validate » pour confirmer le jeton. Votre connexion Slack est prête : *Ask This Guy* pourra désormais accéder à votre workspace Slack et l'utiliser parmi ses sources de données. --- # Connecteur FTP URL: https://www.askthisguy.com/fr/doc/admin-console/knowledge-management/connectors/ftp-connector/ Language: fr Section: Documentation ## Connecter les serveurs de fichiers distants à ATG Le **connecteur FTP** synchronise les documents des serveurs **FTP**, **FTPS** ou **SFTP** de votre organisation vers ATG, afin que vos équipes puissent rechercher et dialoguer sur ce contenu comme sur les autres sources de connaissances. ### Protocoles pris en charge - **FTP** — transfert de fichiers classique - **FTPS** — FTP sur TLS - **SFTP** — transfert de fichiers par SSH ### Qu'est-ce qui est synchronisé ? Le connecteur importe les fichiers depuis les **chemins distants** que vous configurez sur le serveur (dossiers et sous-dossiers autorisés). Vous maîtrisez le périmètre grâce aux options de filtrage ci-dessous. ### Options de filtrage Vous pouvez préciser exactement ce qu'ATG importe : - **Règles d'inclusion / d'exclusion** — Cibler des dossiers ou fichiers précis à inclure ou à exclure - **Date de dernière modification des fichiers** — N'importer que les fichiers modifiés avant une date, après une date, ou entre deux dates ### Types de fichiers pris en charge Le connecteur gère une **large gamme** de formats : **Documents** - Markdown (.md) - PDF (.pdf) - Texte brut (.txt) - Rich Text Format (.rtf) - HTML (.html) **Microsoft Office** - Word (.docx) - PowerPoint (.pptx) **Images** - PNG (.png) - JPEG (.jpg) **Autres formats** - [Traitement sur mesure](https://www.askthisguy.com/doc/customizing-atg-to-you/tailored-processing) — ATG peut être personnalisé pour d'autres types de fichiers selon les besoins de votre organisation. ### Mise à jour du contenu Après la synchronisation initiale, le connecteur se rafraîchit selon la **fréquence configurée pour la source**. Les nouvelles sources sont réglées sur **Quotidien** ; un administrateur peut choisir Manuel, Hebdomadaire ou Mensuel, ou lancer une actualisation à la demande, afin que votre base de connaissances reste alignée avec le serveur. Voir [Fréquence de rafraîchissement](https://www.askthisguy.com/doc/admin-console/knowledge-management/connectors#frquence-de-rafrachissement). --- # Connecteur Slack URL: https://www.askthisguy.com/fr/doc/admin-console/knowledge-management/connectors/slack-connector/ Language: fr Section: Documentation **Vous voulez configurer ce connecteur ?** Cette page présente le connecteur Slack et ses capacités. Pour les instructions pas à pas, consultez la page [Slack](https://www.askthisguy.com/doc/admin-console/knowledge-management/connectors/conf-guides/slack-conf-guide). ## Connecter votre workspace Slack à ATG Le **connecteur Slack** synchronise les conversations, fichiers partagés et connaissances collaboratives de votre équipe depuis **Slack** vers ATG, pour que tout l'historique Slack soit recherchable et accessible via le chat IA. ### Ce qui est synchronisé Le connecteur importe du contenu depuis : - **Canaux publics** — Tous les messages et fils des canaux accessibles à l'utilisateur connecté - **Informations utilisateur** — Profils des membres pour le contexte et l'attribution Vous gardez un **contrôle total** sur l'accès via les permissions natives Slack — ATG respecte les paramètres de sécurité existants de votre workspace. ### Traitement complet du contenu Lors de la synchronisation des canaux Slack, ATG traite **messages et fichiers joints** pour une capture complète des conversations. Votre assistant IA comprend ainsi le contexte des échanges, y compris documents partagés, images et discussions collaboratives. En savoir plus : [Documents et images](https://www.askthisguy.com/doc/admin-console/knowledge-management/how-documents-images-are-processed-by-atg) ### Accès intelligent aux canaux Le connecteur synchronise automatiquement tous les **canaux publics** auxquels l'utilisateur connecté a accès, en respectant les contrôles d'accès et les périmètres de sécurité existants. Les membres n'accèdent qu'aux conversations qu'ils sont autorisés à voir. ### Mises à jour automatiques Après la première synchronisation, le connecteur se rafraîchit selon la **fréquence configurée pour la source**. Les nouvelles sources sont réglées sur **Quotidien** ; un administrateur peut choisir Manuel, Hebdomadaire ou Mensuel, ou lancer une actualisation à la demande, pour que votre assistant IA dispose des messages et contenus partagés les plus récents. Voir [Fréquence de rafraîchissement](https://www.askthisguy.com/doc/admin-console/knowledge-management/connectors#frquence-de-rafrachissement). ### Prêt à démarrer ? Consultez la page [Slack](https://www.askthisguy.com/doc/admin-console/knowledge-management/connectors/conf-guides/slack-conf-guide) pour les instructions détaillées. --- # Sites web URL: https://www.askthisguy.com/fr/doc/admin-console/knowledge-management/connectors/web-sites-connector/ Language: fr Section: Documentation ## Importer du contenu web dans ATG Le **connecteur Sites web** permet d'intégrer du **contenu web externe** directement dans la base de connaissances de votre organisation. En définissant une URL de départ, ATG crawl et indexe le site pour que son contenu soit recherchable et accessible via le chat IA. ### Fonctionnement Indiquez une **URL** de départ pour le crawl, et ATG va : - **Télécharger les pages web** du site ou de la section définie - **Suivre chaque page individuellement** — Chaque page devient une ressource recherchable - **Respecter le périmètre** — Contrôler quelles parties du site inclure Idéal pour importer des sites de documentation, des bases de connaissances, des wikis internes ou tout contenu web pertinent pour votre équipe. ### Contrôler ce qui est importé Vous contrôlez le périmètre du crawl : - **Définir l'URL de départ** — Choisir d'où commence le crawler - **Définir les limites** — Importer tout le site ou seulement certaines sections - **Filtrer le contenu** — Préciser quelles pages ou chemins inclure ou exclure ### Fréquence de rafraîchissement Les nouvelles sources de type site web sont réglées sur un rafraîchissement **hebdomadaire**. Un administrateur peut modifier cette fréquence, ou passer la source en **Manuel** pour décider lui-même quand relancer le crawl et garder la maîtrise de la synchronisation du contenu externe. Voir [Fréquence de rafraîchissement](https://www.askthisguy.com/doc/admin-console/knowledge-management/connectors#frquence-de-rafrachissement). ### Ce qui est indexé Le connecteur traite les **pages HTML** et en extrait le texte, les liens et la structure. Chaque page devient une ressource distincte et citable dans votre base ATG. ### Prêt à démarrer ? **Configuration rapide en 4 étapes :** 1. Dans la **console d'administration**, allez dans **Connaissances** et sélectionnez une catégorie 2. Cliquez sur **+ Ajouter** à côté de **Sites web** 3. Saisissez l'URL (ou les URL) à crawler — à la main ou en choisissant parmi les suggestions ![Écran Sélection des sites web dans la console d'administration](https://www.askthisguy.com/doc/documentation-for-administrators-knowledge-management-how-to-configure-my-connectors-web-sites-connector-image.webp) Écran Sélection des sites web dans la console d'administration 4. Nommez votre source et cliquez sur **Créer** L'import du contenu web démarre immédiatement ! --- # Widget ATG URL: https://www.askthisguy.com/fr/doc/atg-embedded/ Language: fr Section: Documentation **Guides essentiels :** - [Agents](https://www.askthisguy.com/doc/admin-console/how-to-configure-the-agents): Configurer vos agents dans la console d'administration - [Intégrer dans votre webapp](https://www.askthisguy.com/doc/atg-embedded/how-to-integrate-atg-embedded-in-your-webapp): Intégrer le widget dans votre site ou application (iframe, modes, JWT) ## Transformez votre plateforme avec les agents IA Le **widget ATG** permet d'intégrer les agents ATG dans des sites web tiers, des produits SaaS ou des outils internes, sans la complexité ni le coût d'un développement complet. Créez un **agent Widget** dans la console d'administration, configurez ses connaissances et ses outils, puis intégrez cet agent précis à votre plateforme. Que vous souhaitiez renforcer le support client, automatiser des processus internes ou proposer des expériences utilisateur intelligentes, le widget ATG rend l'intégration rapide, flexible et économique. ## Cas d'usage : où les agents IA font la différence ### **Sites web publics** Ajoutez un assistant intelligent sur votre site institutionnel ou marketing qui : - **Répond aux questions des visiteurs** instantanément en s'appuyant sur le contenu de votre site et votre base de connaissances - **Guide les prospects** à travers vos produits et services - **Détecte les intentions** (intérêt d'achat, demande de démo, etc.) et déclenche des notifications pour votre équipe commerciale - Fonctionne pour les **utilisateurs non authentifiés** sans friction ### **Applications SaaS et web** Intégrez un copilote IA directement dans votre produit qui : - **Aide les utilisateurs à naviguer** dans des fonctionnalités et parcours complexes - **Fournit un support contextuel** selon l'endroit où se trouve l'utilisateur dans l'application - **Exécute des actions** pour le compte des utilisateurs (création d'enregistrements, mise à jour de paramètres, déclenchement de workflows) - **Personnalise les réponses** avec les données client et le contexte utilisateur - Est entièrement **white-label** pour correspondre à votre marque ### **Outils et plateformes internes** Donnez à vos équipes des agents IA qui : - **Recherchent** dans les bases de connaissances (Notion, Confluence, Google Drive, SharePoint, Slack, etc.) - **Répondent aux questions** des employés sur les processus, politiques et documentation - **Automatisent** les tâches répétitives et la recherche d'information - **S'intègrent aux systèmes internes** pour récupérer des données ou déclencher des actions ## Pourquoi choisir le widget ATG ? ### **Déploiement rapide et économique** Pas besoin de construire une infrastructure IA from scratch. Notre **API prête à l'intégration** ne demande qu'un minimum de développement front et back. Configurez vos agents via une **console d'administration no-code**: ce qui réduit fortement le time-to-market et les coûts. ### **Qualité IA de premier plan** Bénéficiez du **Retrieval Augmented Generation (RAG)** pour des réponses précises et pertinentes ancrées dans votre base de connaissances. Le système limite les « hallucinations » de l'IA et assure des réponses fiables. ### **Gestion des connaissances simplifiée** Gardez les connaissances de votre IA **à jour automatiquement** en connectant vos sources existantes : - **Notion**, **Confluence**, **Google Drive**, **SharePoint**, **Slack** - **Téléversement de fichiers** et **crawling de pages web** - La **synchronisation automatique** garantit que votre IA dispose toujours des dernières informations ### **Personnalisation et contrôle complets** - **Instructions personnalisées** pour définir la personnalité et le comportement de l'agent - **Identité visuelle** pour s'aligner sur votre plateforme - **Catégories de connaissances** pour contrôler finement ce à quoi chaque agent a accès - **Outils personnalisés** pour interagir avec votre plateforme (lecture de données, actions, notifications) - **Mécanisme de validation des outils** pour des opérations d'écriture en toute sécurité ### **Détection d'intention et automatisation** Configurez vos agents pour **reconnaître les intentions** (signaux d'achat, risque de churn, escalade support) et **déclencher automatiquement des actions** (notifications, création de tickets, etc.). ## Fonctionnement 1. **Configurer la base de connaissances** : connectez vos sources via la console d'administration: sans code 2. **Créer un agent Widget** : choisissez le type Widget, définissez ses instructions, sélectionnez ses catégories de connaissances et ses outils, puis configurez sa sécurité 3. **Intégrer l'API** : ajoutez notre API légère à votre plateforme avec un minimum de travail front et back 4. **Lancer et itérer** : vos agents sont en ligne et s'enrichissent continuellement avec votre base à jour ## Extensibilité Besoin de quelque chose de spécifique ? Le widget ATG prend en charge : - Les **connecteurs personnalisés** pour des sources de données uniques - Les **outils personnalisés** adaptés à votre plateforme - Un **modèle d'intégration API** flexible ### Pour aller plus loin [Agents](https://www.askthisguy.com/doc/admin-console/how-to-configure-the-agents) [Intégrer dans votre webapp](https://www.askthisguy.com/doc/atg-embedded/how-to-integrate-atg-embedded-in-your-webapp) --- # Politique IA URL: https://www.askthisguy.com/fr/doc/admin-console/organization-settings/choosing-the-right-ai-policy/ Language: fr Section: Documentation ATG vous donne un contrôle total sur les fournisseurs d'IA qui peuvent accéder à vos données. En coulisses, ATG s'intègre à plusieurs fournisseurs d'IA de premier plan, notamment : ## Fournisseurs européens - [**Scaleway**](http://scaleway.com/) : hébergeur cloud français pour modèles open-weight - [**Nebius**](https://nebius.com/) : fournisseur d'infrastructure IA européenne, spécialisé en IA, héberge des modèles open-weight - [**Mistral**](https://mistral.ai/) : entreprise française d'IA avec ses propres modèles (commerciaux ou open-weight) - [**Black Forest Labs**](https://bfl.ai/) : entreprise européenne de R&D en IA, spécialisée dans la génération d'images ## Fournisseurs mondiaux En plus de tous les fournisseurs européens ci-dessus, la politique mondiale inclut : - [**Google**](https://gemini.google.com/) : fournisseur américain avec les modèles Gemini - [**Cerebras**](https://www.cerebras.ai/) : fournisseur d'infrastructure IA américain, spécialisé dans l'inférence ultra-rapide - [**Groq**](https://groq.com/) : fournisseur d'infrastructure IA américain, spécialisé dans l'inférence ultra-rapide - [**SambaNova**](https://sambanova.ai/) : fournisseur d'infrastructure IA américain, spécialisé dans l'inférence ultra-rapide - [**OpenAI**](https://openai.com/) : fournisseur américain des modèles GPT (ChatGPT) - [**DeepInfra**](https://deepinfra.com/) : fournisseur d'infrastructure IA américain ## Modèles commerciaux vs open-weight Les fournisseurs utilisent différentes approches : - **Modèles commerciaux :** modèles propriétaires développés et maintenus par le fournisseur (ex. : modèles Mistral, Gemini de Google, GPT d'OpenAI) - **Modèles open-weight :** modèles dont les poids sont publics et peuvent être téléchargés, inspectés et hébergés de façon indépendante. Des fournisseurs comme Scaleway hébergent ces modèles sur leur infrastructure, pour allier transparence open-weight et hébergement européen. Les modèles open-weight offrent une plus grande transparence (architecture et paramètres accessibles), permettant des audits de sécurité indépendants et limitant le vendor lock-in. ## Deux niveaux de politique de confidentialité La protection de vos données est une priorité : ATG propose deux niveaux de politique de confidentialité : - **Fournisseurs UE uniquement :** limite le traitement IA aux fournisseurs européens (Scaleway, Nebius, Mistral, Black Forest Labs). Vos données restent sous juridiction UE et protégées par le RGPD. - **Fournisseurs mondiaux :** autorise tous les fournisseurs, y compris américains (OpenAI, Google, DeepInfra), en plus des fournisseurs européens. **Important :** Choisir des fournisseurs mondiaux peut soumettre vos données à des réglementations américaines (Patriot Act, Cloud Act), qui peuvent exiger que des entreprises américaines donnent accès aux données aux autorités US, y compris pour des données stockées hors des États-Unis. Choisir uniquement des fournisseurs UE vous protège de ces réglementations. Pour configurer la politique IA : [Console d'administration](https://admin.askthisguy.com) → Organisation ⇒ Paramètres ⇒ Politique IA ![Politique IA](https://www.askthisguy.com/doc/documentation-for-administrators-organization-settings-choosing-the-right-ai-policy-image.webp) ## Infrastructure européenne au-delà de l'IA Quelle que soit votre politique IA, toute l'infrastructure plateforme ATG et le stockage des données (hors traitement LLM) sont hébergés exclusivement par des fournisseurs européens dans des datacenters européens. Vos données principales restent ainsi sous juridiction UE et protection RGPD en permanence. Nous recommandons de choisir le niveau de confidentialité qui correspond le mieux aux exigences de protection des données et aux obligations de conformité de votre organisation. ## Ressources [AI and data privacy: What your company needs to know](https://usercentrics.com/guides/data-privacy/ai-and-data-privacy/) [Rethinking Privacy in the AI Era: Policy Provocations for a Data-Centric World | Stanford HAI](https://hai.stanford.edu/policy/white-paper-rethinking-privacy-ai-era-policy-provocations-data-centric-world) [The growing data privacy concerns with AI: What you need to know](https://www.dataguard.com/blog/growing-data-privacy-concerns-ai/) --- # Prompts prédéfinis URL: https://www.askthisguy.com/fr/doc/admin-console/organization-settings/predefined-prompts/ Language: fr Section: Documentation ## Standardiser les interactions IA dans votre organisation Les **Prompts prédéfinis** permettent de créer des **modèles de prompts réutilisables** que toute l'équipe peut utiliser en deux clics. Au lieu que chaque employé rédige ses propres prompts from scratch, vous définissez une fois des modèles professionnels et optimisés — et tout le monde bénéficie de sorties IA cohérentes et de qualité. ### Qu'est-ce qu'un prompt prédéfini ? Pensez aux Prompts prédéfinis comme à des **modèles d'interaction IA** pour votre organisation. Ce sont des modèles préconfigurés qui : - **Standardisent les workflows** — Garantissent que tout le monde applique les bonnes pratiques avec l'IA - **Font gagner du temps** — Les utilisateurs insèrent des prompts éprouvés en deux clics au lieu de les rédiger - **Améliorent la qualité** — Des modèles bien conçus produisent des résultats meilleurs et plus cohérents - **Capitalisent l'expertise** — Encodent le savoir-faire de votre organisation en instructions IA réutilisables ### Cas d'usage courants Les organisations utilisent les Prompts prédéfinis pour de nombreuses tâches : **Classification de documents :** - Standardiser les systèmes d'étiquetage entre départements - Appliquer une catégorisation cohérente aux fichiers et contenus - Automatiser l'organisation du contenu avec des taxonomies prédéfinies **Création de contenu :** - Générer de la documentation produit selon votre guide de style - Rédiger des articles de blog avec la voix de votre marque - Créer des contenus marketing alignés sur votre message - Rédiger des communications client avec un ton cohérent **Traitement de données :** - Extraire des informations structurées de documents non structurés - Résumer des rapports dans le format préféré de votre organisation - Traduire du contenu en préservant la terminologie technique **Analyse et recherche :** - Analyser les retours avec des critères d'évaluation standardisés - Passer en revue des documents selon des listes de contrôle qualité - Générer des insights selon vos cadres d'analyse ### Fonctionnement **Pour les administrateurs (dans la console d'administration) :** 1. **Créer un modèle** — Rédigez votre prompt avec des instructions claires et le contexte nécessaire 2. **Optimiser avec l'IA** — Utilisez la fonction de réécriture IA intégrée pour améliorer automatiquement votre prompt 3. **Publier** — Rendez le modèle disponible à votre équipe Vous gardez le contrôle sur les prompts disponibles et pouvez les modifier à tout moment. **Optimisation des prompts par l'IA** Vous ne savez pas si votre prompt est optimal ? ATG inclut une **fonction de réécriture IA** qui affine automatiquement vos prompts pour une efficacité maximale. Rédigez votre prompt initial, puis cliquez sur le bouton d'optimisation — ATG le restructure et l'enrichit selon les bonnes pratiques de prompt engineering. Chaque Prompt prédéfini livre ainsi les **meilleurs résultats possibles**, même sans être expert. ![Exemple de configuration de prompt dans la console d'administration](https://www.askthisguy.com/doc/predefined-prompts-config.webp) Exemple de configuration de prompt dans la console d'administration **Pour les utilisateurs (dans l'application web sur [app.askthisguy.com](http://app.askthisguy.com)) :** 1. **Parcourir les prompts disponibles** — Voir tous les modèles configurés par l'équipe admin 2. **Sélectionner un prompt** — Cliquer pour l'insérer dans la conversation 3. **Ajouter les détails** — Remplir les variables ou le contexte requis 4. **Obtenir les résultats** — ATG traite la requête avec le modèle optimisé **Deux clics** suffisent pour accéder à des prompts IA de niveau professionnel. ![Illustration de la sélection de prompt dans la webapp ATG](https://www.askthisguy.com/doc/documentation-for-administrators-smart-ai-services-for-your-users-predefined-prompts-image.webp) Illustration de la sélection de prompt dans la webapp ATG ### Bénéfices **Pour l'organisation :** - **Cohérence** — Tout le monde utilise des prompts éprouvés et de qualité - **Efficacité** — Moins de temps passé à concevoir et affiner des prompts - **Partage de connaissances** — Les bonnes pratiques se diffusent dans l'équipe - **Contrôle** — Les administrateurs veillent à ce que l'usage de l'IA respecte les standards de l'entreprise **Pour les utilisateurs :** - **Rapidité** — Insérer des prompts de niveau expert instantanément - **Apprentissage** — Voir des exemples d'interactions IA efficaces - **Résultats** — Obtenir de meilleures sorties sans expertise en prompt engineering - **Simplicité** — Se concentrer sur le travail, pas sur la formulation des questions ### Démarrer Les administrateurs peuvent créer et gérer les Prompts prédéfinis depuis la **console d'administration**. Commencez par quelques modèles à fort impact pour vos tâches les plus courantes, puis enrichissez la bibliothèque selon les retours et l'usage. Les utilisateurs trouvent les Prompts prédéfinis directement dans l'application web ATG — l'assistance IA devient un simple point-and-click. --- # Revue de presse URL: https://www.askthisguy.com/fr/doc/admin-console/organization-settings/press-review/ Language: fr Section: Documentation ## Obtenir des briefings actualités pilotés par l'IA sur ce qui compte pour vous La **Revue de presse** fournit des **revues de presse personnalisées** adaptées aux centres d'intérêt de votre organisation. Rédigez un brief décrivant ce que vous voulez suivre, et ATG recherche, filtre et compile automatiquement les actualités pertinentes à la demande. ### Qu'est-ce que la Revue de presse ? La Revue de presse est votre **veille actualités IA**. Au lieu de passer des heures à parcourir les sites d'actualité, définissez une fois vos sujets, puis générez des briefings frais et ciblés quand vous en avez besoin. **Suivez ce que vous voulez :** - **Concurrents** : Lancements de produits, levées de fonds, mouvements stratégiques - **Tendances du secteur** : Réglementations, innovations, évolutions du marché - **Comptes clés** : Actualités clients ou partenaires - **Sujets précis** : Technologies, marchés, régions - **Thèmes généraux** : Évolutions et tendances du secteur Le brief est **totalement flexible** : vous décidez de ce qui compte. ### Fonctionnement **Les administrateurs** configurent la Revue de presse dans la console d'administration : 1. **Rédiger un brief** : Décrire en langage naturel quelles actualités suivre (concurrents, sujets, secteurs, entreprises, mots-clés : tout ce qui vous importe) 2. **Optimiser avec l'IA** : Utiliser la fonction de réécriture IA intégrée pour améliorer votre brief et maximiser la pertinence 3. **Publier** : Rendre le brief disponible à l'équipe **Optimisation du brief par l'IA** Vous ne savez pas comment structurer votre brief ? La **fonction de réécriture IA** d'ATG l'optimise automatiquement. Rédigez votre description initiale, puis cliquez sur le bouton d'optimisation : ATG restructure et enrichit le brief pour que vous obteniez les **actualités les plus pertinentes** à chaque fois. ![Configuration de la revue de presse dans la console d'administration](https://www.askthisguy.com/doc/documentation-for-administrators-smart-ai-services-for-your-users-press-review-image.webp) Configuration de la revue de presse dans la console d'administration **Les utilisateurs** génèrent des revues depuis l'application web sur [app.askthisguy.com](http://app.askthisguy.com) : 1. **Choisir une Revue de presse** : Sélectionner parmi les briefs configurés 2. **Générer** : ATG recherche sur le web, filtre les articles pertinents et produit un briefing structuré 3. **Lire les insights** : Obtenir une revue complète et facile à parcourir avec les dernières actualités pertinentes ![Exemple de revue de presse dans la webapp ATG](https://www.askthisguy.com/doc/press-review-example.webp) Exemple de revue de presse dans la webapp ATG Chaque revue est **générée à la demande**, vous avez toujours une information à jour. ### Bénéfices **Gagner du temps** : Quelques minutes au lieu d'heures de veille **Rester focalisé** : Ne voir que ce qui est pertinent pour votre activité **Repérer les opportunités** : Détecter tôt les mouvements concurrentiels et les tendances marché **Mieux décider** : Fonder la stratégie sur une intelligence marché à jour ### Cas d'usage - **Veille concurrentielle** : Suivre ce que fait la concurrence - **Gestion de comptes** : Suivre l'actualité des clients et prospects pour un contact au bon moment - **Planification stratégique** : Alimenter les réflexions de la direction avec du contexte marché - **Veille sectorielle** : Rester à jour sur les évolutions et réglementations du secteur ### Démarrer Les administrateurs configurent la Revue de presse dans la **console d'administration**. Plus votre brief est précis, plus les revues seront pertinentes. La fonction d'optimisation IA vous aide à affiner tout brief pour de meilleurs résultats. Les utilisateurs génèrent des revues à tout moment depuis l'**application web ATG** : une intelligence fraîche, à la demande. --- # Webapp URL: https://www.askthisguy.com/fr/doc/webapp/ Language: fr Section: Documentation La webapp ATG donne aux membres authentifiés de votre organisation accès aux agents IA configurés pour leur travail. Rendez-vous sur [app.askthisguy.com](https://app.askthisguy.com) et connectez-vous pour démarrer une conversation. ## Démarrer une conversation avec un agent Chaque conversation utilise obligatoirement un agent. Lorsque vous commencez un nouveau chat : 1. Ouvrez **Nouveau chat**. 2. Ouvrez le sélecteur d'agents dans la zone de saisie. 3. Choisissez l'agent adapté à votre tâche. 4. Rédigez votre message et envoyez-le. Le sélecteur affiche uniquement les **agents Webapp actifs que vous êtes autorisé à utiliser**. ATG présélectionne le dernier agent que vous avez utilisé. ![Choix d'un agent avant de démarrer une conversation dans la webapp ATG](https://www.askthisguy.com/doc/webapp-select-agent-fr.webp) L'agent sélectionné reste attaché à la conversation après le premier message. Démarrez un nouveau chat pour utiliser un autre agent. ## Ce que contrôle l'agent sélectionné Votre administrateur configure chaque agent avec : - des **instructions** : son rôle, son comportement, son ton et ses règles de réponse ; - des **connaissances** : les catégories et sources de l'organisation qu'il peut rechercher ; - des **outils** : les capacités qu'il peut utiliser, comme la recherche dans les connaissances, la recherche web, la récupération de documents, la génération d'images ou les outils personnalisés. La configuration de l'agent détermine entièrement les outils disponibles. La webapp ne propose plus de boutons permettant aux utilisateurs d'activer les connaissances de l'organisation ou la recherche web. Décrivez le résultat attendu : l'agent choisit comment répondre en utilisant uniquement les outils qui lui sont autorisés. Si l'agent ne dispose pas d'un outil ou d'une catégorie de connaissances nécessaire, démarrez une nouvelle conversation avec un autre agent disponible ou contactez votre administrateur. ## Ajouter du contexte à votre demande La zone de saisie permet aussi de : - **joindre des fichiers** que l'agent analysera dans la conversation en cours ; - **utiliser des prompts prédéfinis** créés par votre organisation ; - **choisir le mode de réponse** lorsque cette option est disponible. Les pièces jointes personnelles appartiennent à la conversation. Elles sont distinctes des sources de connaissances de l'organisation. Consultez [Utiliser les pièces jointes](https://www.askthisguy.com/doc/webapp/using-attachments) pour connaître les formats pris en charge et les modalités d'utilisation. ## Naviguer dans la webapp La barre latérale donne accès à : - **Nouveau chat** : démarrer une conversation et choisir un agent ; - **Prompts** : ouvrir la bibliothèque de prompts ; - **Revues de presse** : accéder aux fonctionnalités configurées pour votre organisation ; - **Historique des conversations** : rouvrir une conversation avec son agent et son contexte d'origine. Depuis le menu de votre profil, vous pouvez changer de langue, vous déconnecter et ouvrir la console d'administration si vous disposez des droits nécessaires. ## Partager une conversation Le partage de conversation transmet une discussion ATG à vos collègues de la même organisation, pour relecture, alignement ou transmission d'un résultat. Seul le propriétaire de la conversation peut activer ou arrêter son partage. 1. Ouvrez une conversation de votre historique. 2. Sélectionnez **Partager** dans l'en-tête de la conversation. 3. Dans la fenêtre de partage, choisissez **Partager avec l'organisation**. 4. Sélectionnez **Copier le lien**, puis envoyez ce lien aux personnes concernées. Fenêtre Partager avec l'organisation ouverte depuis l'en-tête d'une conversation ATG Une fois le partage actif, le bouton est identifié comme **Partagé**. Rouvrez son menu à tout moment pour copier de nouveau le lien, ou sélectionnez **Arrêter le partage** pour révoquer l'accès. Menu d'une conversation partagée, avec le lien à copier et l'action Arrêter le partage ### Ce que voit le destinataire Une personne connectée à ATG, membre de votre organisation et disposant du lien, ouvre la conversation dans une vue dédiée en lecture seule. Elle lit les messages et voit qui a partagé la conversation, mais elle ne peut ni répondre, ni poursuivre la discussion, ni la modifier. La conversation partagée n'est pas ajoutée à son historique ni à sa barre latérale. ### Règles de partage - Le partage couvre tous les membres authentifiés de votre organisation. Il ne s'agit ni d'un partage nominatif, ni d'un lien public. - Le lien ne fonctionne pas pour une personne non connectée, pour un compte sans organisation ou pour un membre d'une autre organisation. - **Arrêter le partage** révoque l'accès immédiatement, y compris pour les personnes qui avaient déjà reçu le lien. Vous pouvez partager de nouveau plus tard : le même lien redevient utilisable tant que le partage est actif. - Une conversation supprimée, ou dont le partage a été arrêté, s'affiche comme indisponible. - Un lien donne accès à cette seule conversation, jamais à votre historique ni aux autres conversations de l'organisation. Avant de partager, vérifiez que la conversation peut être vue par l'ensemble de votre organisation. Arrêtez le partage dès que ce n'est plus le cas. ## Obtenir de meilleures réponses - Choisissez l'agent dont le rôle correspond le mieux à votre tâche. - Précisez le contexte, le format attendu et les contraintes utiles. - Joignez les fichiers nécessaires à la demande. - Posez vos questions de suivi dans la même conversation lorsque vous souhaitez conserver le contexte. Pour aller plus loin : - [Bonnes pratiques LLM](https://www.askthisguy.com/doc/webapp/llm-best-practices) - [Utiliser les pièces jointes](https://www.askthisguy.com/doc/webapp/using-attachments) --- # Mode vocal : utiliser un agent vocal IA URL: https://www.askthisguy.com/fr/doc/webapp/using-voice-mode/ Language: fr Section: Documentation Le mode vocal permet de parler à un agent Ask This Guy comme à un assistant vocal IA, sans saisir tout son message au clavier. La conversation reste disponible par écrit et vous pouvez toujours utiliser le clavier, joindre des fichiers et choisir un mode de réponse. **Périmètre :** le mode vocal est activé séparément pour chaque agent. Cette page décrit son fonctionnement dans la webapp ATG authentifiée. ## Vérifier que le mode vocal est disponible Sélectionnez un agent. Si le mode vocal est activé pour celui-ci, un bouton de microphone intitulé **Parler** apparaît sous le champ de saisie. Bouton Parler sous le champ de saisie d'un agent compatible avec le mode vocal Si le bouton n'apparaît pas ou reste inactif, plusieurs raisons sont possibles : - le mode vocal n'est pas activé pour l'agent sélectionné ou votre organisation ; - le navigateur ne prend pas en charge l'enregistrement audio nécessaire ; - la conversation est en lecture seule ou la saisie est temporairement désactivée. ## Dicter un message 1. Sélectionnez **Parler**. Le bouton devient un carré rouge et une onde sonore indique que le microphone écoute. 2. Lors du premier enregistrement, autorisez le navigateur à utiliser votre microphone. 3. Parlez naturellement. La langue de l'interface aide le service de transcription à interpréter l'enregistrement dans la langue appropriée. 4. Pour terminer, sélectionnez le carré rouge ou marquez une pause après avoir parlé. L'enregistrement s'arrête automatiquement environ **1,5 seconde après la détection d'un silence** et reste toujours limité à **60 secondes**. 5. Patientez pendant l'affichage de **Transcription…**. Le texte reconnu est ajouté dans le champ de saisie. La transcription se comporte comme du texte ordinaire. Elle s'ajoute au contenu déjà présent dans le champ : vous pouvez donc combiner clavier et dictée, ou enregistrer plusieurs segments successifs. ## Vérifier ou annuler l'envoi automatique Après la transcription, ATG affiche **Envoi dans 2 s**, puis **Envoi dans 1 s**. - Ne faites rien pour envoyer le message automatiquement. - Sélectionnez **Annuler** pour conserver la transcription dans le champ, puis la corriger, la compléter, l'envoyer ou l'abandonner. - Sélectionnez de nouveau le microphone pour annuler le compte à rebours et commencer une autre dictée. Relisez toujours les noms propres, les nombres, les informations sensibles et les références techniques avant l'envoi. ## Écouter la réponse de l'agent Lorsqu'au moins une partie du message envoyé a été dictée, ATG considère l'échange comme un tour vocal et lit automatiquement la réponse terminée de l'agent. Corriger ou compléter la transcription au clavier ne désactive pas ce comportement. Pendant le traitement, de courtes annonces vocales peuvent signaler que l'agent recherche dans la base de connaissances ou sur le web, consulte des documents ou des données, ou prépare un graphique. Si l'opération se prolonge, ATG peut aussi vous demander de patienter encore un instant. Chaque type d'annonce n'est prononcé qu'une fois par réponse. La barre audio affiche **Préparation de l'audio…** pendant la synthèse, puis **Lecture en cours…** pendant la restitution. Sélectionnez **Arrêter** pour interrompre la lecture et vider la file audio. Si la génération de la réponse échoue, la lecture automatique est annulée. La version orale est adaptée pour une écoute naturelle : les marqueurs Markdown, les séparateurs de tableaux, les blocs de code, les images et les marqueurs techniques des sources ne sont pas lus. L'intitulé d'un lien peut être prononcé, tandis que la réponse complète, sa mise en forme et ses sources restent visibles à l'écran. ## Écouter une réponse à la demande Chaque réponse terminée de l'agent propose une action **Lire à voix haute**. Vous pouvez l'utiliser même si la question d'origine a été saisie au clavier, ou pour réécouter une ancienne réponse de la conversation. Sélectionnez **Lire à voix haute** pour préparer et lancer l'audio. Le bouton carré permet de l'interrompre. Le lancement d'une autre réponse remplace la lecture en cours : une seule réponse est diffusée à la fois. ## Autoriser l'accès au microphone Lors de la première utilisation, le navigateur demande l'autorisation d'accéder au microphone. Son indicateur d'enregistrement reste actif uniquement pendant la prise de parole et le flux du microphone s'arrête avec l'enregistrement. L'extrait audio est alors envoyé pour transcription. Si l'accès est bloqué, ATG vous invite à autoriser le microphone dans le navigateur. Ouvrez les autorisations du site, activez l'accès au microphone pour ATG, puis lancez un nouvel enregistrement. ## Limites actuelles - Le mode vocal peut ne pas être activé pour toutes les organisations ou tous les agents. - Une prise de parole est limitée à 60 secondes. - La transcription et la synthèse vocale nécessitent une connexion réseau et ne fonctionnent pas hors ligne. - Le mode vocal repose sur des enregistrements ponctuels et lit la réponse terminée : il ne s'agit pas d'une conversation audio continue en temps réel. - Le fournisseur de transcription, le fournisseur de synthèse et la voix sont configurés pour l'agent. Les utilisateurs ne peuvent pas les modifier depuis le chat. - Aucune préférence vocale n'est mémorisée pour chaque utilisateur. - Parler n'interrompt pas automatiquement la lecture. Sélectionnez **Arrêter** avant d'utiliser le microphone. - Si le navigateur bloque la lecture automatique, utilisez **Lire à voix haute** sur la réponse terminée. ## Résoudre les problèmes courants
SituationQue faire ?
Le microphone n'apparaît pasSélectionnez un autre agent compatible avec le mode vocal ou demandez à votre administrateur de l'activer.
L'accès au microphone est bloquéAutorisez le microphone dans les réglages du site de votre navigateur, puis recommencez l'enregistrement.
ATG ne parvient pas à transcrire l'audioVérifiez votre connexion, réduisez les bruits de fond et réessayez.
La lecture ne démarre pas automatiquementSélectionnez **Lire à voix haute** sous la réponse terminée.
Vous devez corriger la transcriptionSélectionnez **Annuler** pendant le compte à rebours de deux secondes.
## Questions fréquentes sur le mode vocal ### Le mode vocal ATG est-il un voicebot téléphonique ? Non. Le mode vocal fonctionne dans la webapp ATG : vous dictez un message, l'agent y répond et sa réponse est lue à voix haute. Il ne passe pas d'appel téléphonique et n'entretient pas de conversation audio continue en temps réel, contrairement à un **voicebot** ou à un callbot de centre de contacts. ### Quelle différence avec un chatbot vocal de site web ? Le mode vocal s'utilise dans la webapp authentifiée, avec un agent vocal IA connecté à vos connaissances internes et à vos outils. Un **chatbot vocal** de site web s'adresse à des visiteurs anonymes. Le widget [ATG Embedded](https://www.askthisguy.com/doc/atg-embedded) n'est pas couvert par cette page : ne présumez pas que le vocal y est disponible. Voir aussi la page [Chatbot de site web](https://www.askthisguy.com/solutions/website-chatbot/). ### Le mode vocal est-il disponible pour tous les agents ? Non. Un administrateur l'active agent par agent dans la console d'administration. Si le bouton **Parler** n'apparaît pas, sélectionnez un autre agent compatible ou demandez son activation à votre administrateur. ### Puis-je corriger la transcription avant l'envoi ? Oui. Après la transcription, ATG affiche un compte à rebours de deux secondes. Sélectionnez **Annuler** pendant ce délai : le texte dicté reste dans le champ de saisie et se modifie comme un message écrit. Pour connaître les réglages disponibles, consultez [Configurer le mode vocal d'un agent](https://www.askthisguy.com/doc/admin-console/voice-mode). --- # Bonnes pratiques LLM URL: https://www.askthisguy.com/fr/doc/webapp/llm-best-practices/ Language: fr Section: Documentation > Les chatbots basés sur des modèles de langage (LLM) comme ceux qui sous-tendent Ask This Guy sont des outils puissants pour accéder à l'information et la gérer. Pour vous aider à tirer le meilleur parti de votre assistant, voici des conseils pratiques et des principes à garder en tête. > En suivant ce cadre, vous rédigerez des instructions (prompts) efficaces et obtiendrez de meilleurs résultats avec ATG. > ## Cadre pour rédiger de bonnes instructions (prompts) - **Soyez clair et précis :** Indiquez exactement ce que vous voulez que le chatbot fasse ou réponde. - **Donnez du contexte :** incluez des informations de fond pertinentes pour que l'IA comprenne votre intention. - **Utilisez un langage poli et concis :** soyez respectueux et gardez vos instructions courtes mais complètes. - **Donnez des exemples quand c'est possible :** montrez au chatbot le type de réponse ou de format attendu. - **Reformulez ou découpez les demandes complexes :** si votre demande est compliquée, divisez-la en instructions plus petites et plus simples. - **Demandez des précisions si besoin :** si la réponse ne convient pas, enchaînez avec des questions ou demandes plus précises. ### Soyez clair et précis Exprimez vos questions ou demandes le plus clairement possible. Au lieu de « Montre-moi le rapport », préférez « Peux-tu me montrer le rapport des ventes du T1 2024 ? ». Cela aide le chatbot à comprendre exactement ce dont vous avez besoin. ### Donnez du contexte quand il le faut Si votre question porte sur un projet, une équipe ou un sujet précis, mentionnez-le. Par exemple : « Comment déposer une note de frais pour l'équipe marketing ? » Ce contexte supplémentaire permet au chatbot de vous donner une réponse plus précise. ### Engagez le dialogue Si la réponse du chatbot ne correspond pas à ce que vous attendiez, n'hésitez pas à poser des questions de suivi ou à demander des précisions. Vous pouvez dire : « Peux-tu expliquer plus simplement ? » ou « Peux-tu me donner un exemple ? » ### Reformulez ou simplifiez vos questions Si le chatbot ne comprend pas votre question, essayez de la reformuler ou de la découper. Par exemple, au lieu d'une question en plusieurs parties, posez une partie à la fois. ### Utilisez des exemples dans vos prompts Donner des exemples aide ATG à mieux cerner votre intention. Si vous voulez un résumé dans un style précis, vous pouvez dire : « Résume cet article en puces, comme ceci : exemple. » L'IA pourra mieux correspondre à vos attentes. ### Vérifiez toujours les informations importantes ATG est conçu pour être utile, mais il peut parfois se tromper ou donner des informations obsolètes. Pour les décisions critiques ou les tâches importantes, recoupez les réponses avec les sources officielles ou la documentation. Les LLM sont avancés mais pas parfaits ; leurs réponses peuvent être incorrectes ou incomplètes. Utilisez votre jugement et vérifiez les informations importantes. ### Citez vos sources quand vous partagez des réponses Si vous partagez des informations du chatbot avec d'autres, indiquez d'où elles viennent. Cela renforce la confiance et permet à chacun de vérifier si besoin. ### Respectez la confidentialité Ne partagez que les informations auxquelles vous êtes autorisé à accéder. Évitez de saisir des données sensibles ou personnelles sauf si vous êtes sûr que les paramètres de confidentialité et de sécurité du chatbot sont adaptés. ### Ne partagez pas de données sensibles inutilement Soyez conscient des informations que vous communiquez. En cas de doute sur le caractère confidentiel, vérifiez avec votre administrateur ou votre responsable avant de partager. ### Évitez de n'utiliser que des mots-clés Saisir uniquement des mots-clés ou des phrases très courtes peut embrouiller le chatbot. Privilégiez des phrases complètes. ### N'abusez pas du jargon Les LLM comprennent beaucoup de langage technique, mais trop de jargon ou d'acronymes peut mener à des quiproquos. Restez simple et clair, surtout au début. ### Utilisez un langage poli Les chatbots n'ont pas de sentiments, mais un langage poli (« s'il te plaît », « merci ») rend les échanges plus naturels et agréables. --- # Utiliser les pièces jointes URL: https://www.askthisguy.com/fr/doc/webapp/using-attachments/ Language: fr Section: Documentation Les pièces jointes permettent de donner à **Ask This Guy** un **contexte direct** à partir de vos fichiers et des documents de votre organisation, pour des réponses **plus précises** et **traçables**. ### Ce que vous pouvez faire avec les pièces jointes - **Utiliser deux types de sources** - **Documents organisation** : ressources partagées de votre espace. Votre administrateur a défini à quels documents vous avez accès. - **Mes fichiers** : vos téléversements personnels pour l'espace actuel, y compris les fichiers générés par ATG (ex. images). - **Rechercher par le sens (recherche IA)** - Activez **Activer la recherche IA** pour trouver des documents par concepts, pas seulement par nom de fichier. Utile pour trouver les fichiers et documents qui correspondent à votre demande, quelle qu'en soit l'origine. La recherche porte sur tous les documents organisation auxquels vous avez accès. - **Joindre plusieurs fichiers** - Posez des questions multi-documents et comparez les sources. ### Comment joindre un document (pas à pas) #### 1) Ouvrir le menu pièces jointes Dans la zone de saisie du chat, cliquez sur l'icône **trombone**. #### 2) Choisir la source Dans la fenêtre, choisissez un onglet : - **Documents** (Documents organisation) - **Mes fichiers** #### 3) Trouver le bon document - **Parcourir** la liste - **Rechercher par nom de fichier** dans la barre de recherche - **Rechercher par le sens** - Activez **Activer la recherche IA** - Saisissez une requête en langage naturel ![Dialogue Joindre des fichiers avec résultats de recherche IA](https://www.askthisguy.com/doc/attachments-ai-search.webp) #### 4) Joindre et poser votre question - Cochez la case à côté d'un ou plusieurs fichiers. - Cliquez sur **Joindre**. - Quand la pastille du fichier apparaît dans la barre de message, saisissez votre demande et envoyez. **Exemples de questions** - « Résume les points clés de ce document. » - « Que dit ce document sur la tarification de l'offre X ? » - « Compare les exigences du fichier A et du fichier B. » ### Options et conseils - **Tri :** trier par **Dernière mise à jour** ou **Alphabétique**. - **Quand utiliser la recherche IA :** idéal quand vous ne connaissez pas le nom exact du fichier ou quand vous cherchez un concept. - **Soyez explicite :** si vous voulez une citation ou un paragraphe exact, demandez-le (ex. : « inclure l'extrait exact »). ### Limites - **Taille des fichiers :** les téléversements sont limités à **20 Mo** par fichier. - **Longueur minimale de la requête :** la recherche IA nécessite au moins **3 caractères**. --- # Gestion des fournisseurs IA URL: https://www.askthisguy.com/fr/doc/infrastructure-and-security/ai-providers/ Language: fr Section: Documentation ## Choisir la bonne politique IA Les modèles IA utilisés par ATG dépendent du paramètre **Politique IA** de votre organisation. - **UE uniquement :** seuls les fournisseurs européens sont utilisés - **Monde entier :** fournisseurs UE plus des fournisseurs non-UE sélectionnés En savoir plus : [Politique IA](https://www.askthisguy.com/doc/admin-console/organization-settings/choosing-the-right-ai-policy) ## Usage sécurisé des fournisseurs Toutes les interactions avec les LLM passent **exclusivement par des API** avec garanties contractuelles de protection des données : - **Vos données ne sont jamais utilisées pour l'entraînement des modèles** — chaque contrat fournisseur inclut des clauses strictes de non-entraînement - **Aucun risque de fuite via l'entraînement** ou la collecte de données par le fournisseur Les connaissances de votre organisation restent ainsi confidentielles et ne sont jamais exposées via l'entraînement de modèles IA ou la collecte par des tiers. ## Périmètre des fournisseurs **Fournisseurs UE** (souveraineté des données garantie) :
Mistral Nebius Scaleway Black Forest Labs
- **Mistral**: Leader IA français - **Scaleway**: Cloud et services IA français - **Nebius**: Infrastructure IA européenne - **Black Forest Labs**: Innovation IA allemande **Fournisseurs mondiaux** Tous les fournisseurs UE plus : - **Cerebras** - **Groq** - **SambaNova** - **Google Gemini** - **OpenAI** - **DeepInfra** ## Nos propres infrastructures GPU En complément de ces fournisseurs, ATG monte aussi ses **propres infrastructures GPU** chez **Verda**, un acteur finlandais qui opère des data centers en **Finlande** et en **Islande**. - Nous y déployons et exploitons nous-mêmes certains modèles à poids ouverts, sur des GPU dédiés à ATG - Nous maîtrisons la version du modèle, sa configuration et son cycle de mise à jour - L'inférence reste dans un périmètre européen : la Finlande est dans l'Union européenne, l'Islande dans l'Espace économique européen, toutes deux couvertes par le RGPD Ces modèles auto-hébergés sont utilisables avec la politique **UE uniquement**, au même titre que les fournisseurs européens listés ci-dessus. Voir [Notre approche de l'IA souveraine](https://www.askthisguy.com/doc/infrastructure-and-security/sovereign-ai). **Note :** La liste des fournisseurs peut évoluer avec le paysage IA. Tous les coûts LLM sont **inclus dans votre abonnement ATG** — pas de surprise sur la facturation, quel que soit l'usage. --- # Gestion de vos données URL: https://www.askthisguy.com/fr/doc/infrastructure-and-security/data-management/ Language: fr Section: Documentation ## Pourquoi la protection de vos données compte Les données de votre organisation sont critiques : documents confidentiels, informations clients, connaissances internes, contexte métier sensible. ATG est conçu pour éviter que ces données soient exposées à des tiers non autorisés, à des juridictions étrangères ou à un usage « shadow AI » non maîtrisé. ## Risques principaux et réponse d'ATG ```mermaid flowchart TB subgraph risks["Risques"] R1[Fuite via entraînement LLM] R2[Sur-rétention de fichiers] R3[Transferts de données vers les US] end subgraph atg["Comment ATG y répond"] A1[Pas d'entraînement sur vos données] A2[Rétention minimale, pas de stockage tiers] A3[Politique UE uniquement bloque les fournisseurs US] end R1 --> A1 R2 --> A2 R3 --> A3 ```

Le schéma met en regard les trois risques principaux qui pèsent sur vos données et la réponse d'ATG pour chacun : aucun entraînement de modèle sur vos contenus, une rétention minimale sans stockage chez un tiers, et une politique UE uniquement qui bloque les fournisseurs américains.

### 1) Entraînement des IA publiques et fuite shadow AI Nombre de systèmes d'IA publics peuvent utiliser l'usage des consommateurs pour améliorer les modèles. En clair : si un employé colle des informations confidentielles dans un chatbot public, cela peut contribuer à une future version du modèle, sans traçabilité fiable. **Notre engagement :** ATG n'utilise des fournisseurs IA que via des API qui garantissent contractuellement qu'ils **n'entraînent pas les modèles** sur vos données. ### 2) Rétention minimale par conception Nous appliquons une approche de **rétention minimale** : ATG ne conserve que ce qui est nécessaire au fonctionnement du service. - Nous évitons de stocker les fichiers bruts lorsqu'ils ne sont pas nécessaires. - Nous n'utilisons pas les fonctionnalités « hosted data » de tiers (certains fournisseurs IA les proposent ; nous ne les utilisons pas volontairement). ### 3) Politique UE uniquement = pas de transferts vers les US Si votre **politique IA** est réglée sur **UE uniquement**, ATG ne transfère rien vers des fournisseurs américains. En savoir plus : [Politique IA](https://www.askthisguy.com/doc/admin-console/organization-settings/choosing-the-right-ai-policy) ## Transit des données : deux phases distinctes ATG traite les données en deux phases : 1. **Préparation des documents** (transformation des documents en base de connaissances interne) 2. **Réponses aux utilisateurs** (réponse aux questions via récupération interne + appels LLM contrôlés) La **politique IA** a le plus d'impact en phase 2 (fournisseurs LLM utilisés pour la génération). ## Phase 1 — Préparation des documents (ingestion et préparation RAG) ATG exécute un pipeline complet de préparation RAG : extraction du texte et des images, traitement, découpage en chunks, vectorisation et indexation. En savoir plus : [Comment les données de mon entreprise sont-elles traitées ? Qu'est-ce que le RAG ?](https://www.askthisguy.com/doc/admin-console/knowledge-management/how-is-my-companys-data-processed-what-is-rag) ```mermaid flowchart LR Source["Sources client (Drive, etc.)"] --> ATG["Backend ATG"] ATG --> Prep["Extraction + traitement"] Prep --> Vec["Vectorisation (fournisseurs UE)"] Prep --> Img["Compréhension d'images (fournisseurs UE)"] Prep --> OCR["OCR (document complet) via Mistral (si besoin)"] Vec --> Store["PostgreSQL + PGVector + S3 (Supabase auto-hébergé)"] Img --> Store OCR --> Prep ```

Le schéma détaille la phase de préparation : les documents issus de vos sources sont extraits et traités par le backend ATG, puis vectorisés et analysés par des fournisseurs européens, avec un passage par l'OCR Mistral uniquement quand la conversion en texte l'exige. Le résultat est stocké chez nous, dans PostgreSQL avec PGVector et S3 sur un Supabase auto-hébergé.

### Ce qui peut être envoyé à des services externes en phase 1 Certains appels à des services IA externes peuvent avoir lieu pendant la préparation, strictement contrôlés par le backend : - **Compréhension d'images** : fournisseurs européens uniquement - **Vectorisation** : fournisseurs européens uniquement - **OCR document complet** : le seul cas où un document entier peut être envoyé à un tiers est la **conversion en texte** via **Mistral OCR** ### Ce qui est stocké après la préparation Après la préparation, ATG stocke principalement : - le texte extrait, découpé en **chunks** - les vecteurs (embeddings) pour la recherche - les images sélectionnées lorsqu'elles sont conservées ATG **ne conserve pas** les fichiers originaux sauf nécessité : - Les **fichiers téléversés** ne sont conservés **que** si un admin souhaite explicitement que les utilisateurs puissent les télécharger plus tard - Pour les documents issus d'un drive/connecteur externe, ATG ne conserve pas les fichiers bruts (ce n'est pas nécessaire) ## Phase 2 — Réponse aux utilisateurs (chat et recherche) ATG n'envoie jamais les documents de votre organisation aux fournisseurs LLM. La récupération d'information se fait **en interne** (sur les serveurs ATG OVHCloud). Ce qui est envoyé à un fournisseur IA, ce sont : - la requête utilisateur - le petit ensemble de **snippets pertinents** (chunks) sélectionnés par ATG comme contexte ```mermaid sequenceDiagram participant U as Navigateur utilisateur participant B as Backend ATG participant DB as Stockage/DB participant LLM as Fournisseurs LLM U->>B: Envoyer la requête B->>DB: Récupérer les chunks pertinents (PGVector) DB-->>B: Top-k snippets B->>LLM: Requête + snippets sélectionnés (pas de documents complets) LLM-->>B: Réponse générée B-->>U: Réponse + citations (affichage par le frontend) ```

Le schéma suit une question de bout en bout : le backend ATG récupère lui-même les extraits pertinents dans la base vectorielle, puis n'envoie au fournisseur LLM que la requête de l'utilisateur et ces quelques extraits. Les documents complets ne quittent jamais l'infrastructure ATG.

### Où la politique IA intervient La politique IA détermine quels fournisseurs externes peuvent être utilisés en phase 2 : - **UE uniquement :** fournisseurs européens uniquement - **Monde entier :** fournisseurs UE plus des fournisseurs mondiaux sélectionnés Voir : [Gestion des fournisseurs IA](https://www.askthisguy.com/doc/infrastructure-and-security/ai-providers) --- # Notre approche de l'IA souveraine URL: https://www.askthisguy.com/fr/doc/infrastructure-and-security/sovereign-ai/ Language: fr Section: Documentation ## Notre définition de l'IA souveraine Pour ATG, une **IA souveraine** ne se résume pas à utiliser un modèle européen. La souveraineté dépend de la maîtrise de trois éléments complémentaires : 1. **Le droit applicable à l'entreprise** qui fournit le service 2. **L'infrastructure** qui héberge la plateforme et les données 3. **Les modèles d'IA** qui traitent les requêtes et leur contexte Cette distinction est importante. Une plateforme peut être hébergée en Europe tout en faisant appel à un fournisseur d'IA soumis à une juridiction non européenne. À l'inverse, un modèle européen ne suffit pas à rendre souveraine une solution dont l'infrastructure ou l'opérateur échappe au périmètre européen. Cette page décrit **notre mise en œuvre**. Pour la définition générale, les critères d'évaluation et les questions à poser à n'importe quel fournisseur, voir notre page [IA souveraine](https://www.askthisguy.com/ia-souveraine/). Pour approfondir les enjeux de dépendance et de souveraineté numérique, consultez [nos articles consacrés à la souveraineté](https://www.askthisguy.com/blog/tag/souverainete/). ## 1. Une société française, soumise au droit européen Ask This Guy est une société française. Nos engagements contractuels et nos décisions concernant le traitement des données s'inscrivent dans le cadre du droit français et européen, notamment du RGPD. Ce premier niveau de souveraineté apporte un interlocuteur établi en France et un cadre juridique européen. Il ne suffit toutefois pas à lui seul : la localisation de l'infrastructure et le choix des fournisseurs IA sont tout aussi déterminants. ## 2. Une infrastructure européenne, avec une trajectoire on-premise La plateforme ATG est hébergée dans l'Union européenne par des sociétés de droit européen. Notre infrastructure principale repose notamment sur des serveurs dédiés OVHcloud situés à Gravelines, en France, avec une redondance à Francfort, en Allemagne. Les composants essentiels restent dans ce périmètre : - frontend et backend ATG ; - bases PostgreSQL et PGVector ; - stockage des documents et des médias ; - sauvegardes et réplication. Le backend ATG est le point de contrôle des appels vers les services externes. Il accède au stockage, applique les règles d'accès et ne transmet que les informations nécessaires aux fournisseurs IA autorisés par votre politique. ### Nos propres infrastructures GPU en Europe ATG ne se limite pas à consommer des API d'inférence externes. Nous montons également nos **propres infrastructures GPU** chez **Verda**, un acteur finlandais qui opère ses data centers en **Finlande** et en **Islande**. Nous y déployons et exploitons nous-mêmes certains modèles, sur des GPU dédiés à ATG. Cette brique complète le recours à des fournisseurs externes et apporte : - une **IA hébergée en Europe** jusqu'à la couche d'inférence, sans transit du contexte hors de notre périmètre ; - la maîtrise du modèle servi : version, configuration, cycle de mise à jour ; - un opérateur soumis au droit européen, la Finlande étant dans l'Union européenne et l'Islande dans l'Espace économique européen, donc couverte par le RGPD. Selon les cas d'usage, ATG combine ainsi ses propres GPU et des fournisseurs d'inférence tiers sélectionnés, dans les limites de la politique IA choisie par votre organisation. Notre article sur l'[infrastructure IA et les 7 approches d'inférence](https://www.askthisguy.com/blog/enterprise-ai-inference/) détaille les arbitrages de coût et de souveraineté derrière ces choix. ### Aller plus loin avec l'on-premise Pour certaines organisations, la souveraineté exige que la plateforme soit déployée dans leur propre environnement. Nous voulons que l'**on-premise** reste une option possible pour aller plus loin dans la maîtrise de l'infrastructure, du réseau et de la localisation des données. Selon le contexte, le périmètre et les exigences de sécurité, un déploiement dédié peut être étudié avec vos équipes. L'objectif est de rapprocher ATG de votre infrastructure de confiance, sans renoncer aux fonctions de recherche, de gestion des connaissances et d'assistance IA. ## 3. Les modèles IA : souveraineté totale ou meilleure performance Le marché de l'IA évolue rapidement. À ce stade, il existe encore, selon les tâches et les modèles comparés, un écart de performance entre certains fournisseurs américains et européens. Cet écart combine notamment : - la vitesse d'inférence ; - la qualité du raisonnement et de la génération ; - les capacités multimodales et le support natif de pièces jointes. Nous préférons donc être transparents sur ce compromis plutôt que de présenter une souveraineté théorique comme une réponse universelle. ATG vous laisse choisir le niveau adapté à votre organisation. ## Deux politiques IA selon votre niveau d'exigence ### UE uniquement : la souveraineté maximale La politique **UE uniquement** limite les traitements IA aux fournisseurs de droit européen qui exécutent leurs services en Europe, ainsi qu'aux modèles que nous opérons nous-mêmes sur nos GPU chez Verda. C'est le choix à privilégier lorsque la maîtrise de la juridiction et la résidence européenne des traitements sont prioritaires. Cette politique s'inscrit dans une approche d'**IA hébergée en Europe** et d'IA compatible avec les exigences de conformité RGPD. Elle peut toutefois réduire le choix de modèles, leur vitesse ou leurs capacités sur certains cas d'usage. ### Monde entier : une exception limitée à la couche IA La politique **Monde entier** autorise, en plus des fournisseurs européens, certains fournisseurs internationaux sélectionnés. Elle permet de bénéficier des modèles les plus performants ou les plus rapides lorsque cela apporte une valeur concrète à vos utilisateurs. Cette exception concerne la couche IA. L'infrastructure principale ATG, le stockage et les bases de données restent hébergés en Europe. Même avec cette politique, ATG : - n'envoie que les éléments nécessaires au traitement de la requête ; - transmet généralement la question et les extraits pertinents, plutôt que les documents complets ; - utilise les fournisseurs via des API encadrées ; - ne permet pas aux LLM utilisés via ATG d'entraîner leurs modèles sur vos données. Le choix mondial ne supprime donc pas nos exigences de minimisation et de contrôle. Il vous permet d'arbitrer explicitement entre souveraineté maximale et performance opérationnelle. ## Vous gardez la main à tout moment La politique IA peut être modifiée à tout moment depuis le menu **Politique IA** de la console d'administration : [Configurer la politique IA](https://www.askthisguy.com/doc/admin-console/organization-settings/choosing-the-right-ai-policy) Vous pouvez ainsi commencer avec une politique mondiale pour évaluer les performances, puis passer à une politique UE uniquement lorsque vos exigences de conformité ou votre cas d'usage le demandent. L'inverse est également possible si vos priorités évoluent. Pour comprendre précisément les fournisseurs disponibles et leurs garanties, consultez la page [Gestion des fournisseurs IA](https://www.askthisguy.com/doc/infrastructure-and-security/ai-providers). Pour le détail des flux de données, consultez [Gestion de vos données](https://www.askthisguy.com/doc/infrastructure-and-security/data-management). ## Notre trajectoire : vous laisser choisir votre IA Notre objectif à terme est de proposer un mode **Bring Your Own AI**. Il permettra aux organisations qui le souhaitent de connecter leurs propres modèles, fournisseurs ou points d'inférence, et de conserver davantage d'autonomie sur la dernière brique de la chaîne. Cette fonctionnalité est inscrite dans notre roadmap. En attendant, les politiques UE uniquement et Monde entier permettent déjà d'adapter le niveau de souveraineté au risque, aux contraintes réglementaires et aux objectifs de performance de chaque organisation. ## En résumé Notre approche de l'IA souveraine repose sur trois engagements : - **Une entreprise française** soumise au droit français et européen - **Une infrastructure européenne**, incluant nos propres GPU chez Verda en Finlande et en Islande, avec une option on-premise pour les besoins les plus exigeants - **Un choix explicite pour l'IA**, entre fournisseurs européens uniquement et accès à des fournisseurs mondiaux pour gagner en performance La souveraineté n'est pas un slogan ni un réglage unique. C'est un arbitrage documenté, que vous pouvez faire évoluer à mesure que vos contraintes et les performances des modèles changent. ## Questions fréquentes sur l'IA souveraine ### Quels critères vérifier pour évaluer la souveraineté d'une IA d'entreprise ? Vérifiez séparément le cadre juridique applicable à l'opérateur, l'infrastructure qui héberge les données et les fournisseurs IA qui traitent les requêtes. Un modèle européen ne suffit pas si l'opérateur ou l'infrastructure échappe à ce périmètre. ### Pourquoi l'hébergement européen ne suffit-il pas à garantir la souveraineté ? L'hébergement européen est un élément important, mais il ne garantit pas à lui seul la souveraineté. Il faut aussi examiner le droit auquel est soumis l'opérateur et les fournisseurs IA qui traitent les requêtes. Une solution peut stocker ses données en Europe tout en dépendant d'un fournisseur soumis à une juridiction non européenne. ### ATG est-elle une IA française ? Ask This Guy est une société française, soumise au droit français et européen. La notion d'**IA française** n'est toutefois pas la bonne : nous fournissons avant tout une plateforme française permettant d'exploiter l'IA. ### Quelle différence entre les politiques UE uniquement et Monde entier ? La politique **UE uniquement** limite les traitements IA aux fournisseurs de droit européen qui exécutent leurs services en Europe. La politique **Monde entier** autorise aussi certains fournisseurs internationaux, tout en conservant l'infrastructure principale, le stockage et les bases de données ATG en Europe. Vous choisissez ainsi entre souveraineté maximale et accès à davantage de modèles. ### ATG opère-t-elle ses propres infrastructures GPU ? Oui. En plus des fournisseurs d'IA externes, ATG monte ses propres infrastructures GPU chez **Verda**, un acteur finlandais dont les data centers se trouvent en **Finlande** et en **Islande**. Nous y déployons et opérons nous-mêmes certains modèles, ce qui permet de garder l'inférence dans un périmètre européen soumis au RGPD, en complément de la plateforme hébergée chez OVHcloud. ### ATG peut-elle être déployée en on-premise ? L'on-premise est une option envisagée pour les organisations qui doivent garder davantage de contrôle sur leur infrastructure, leur réseau et la localisation de leurs données. Selon le contexte, le périmètre et les exigences de sécurité, un déploiement dédié peut être étudié avec vos équipes. --- # Personnaliser ATG pour vous URL: https://www.askthisguy.com/fr/doc/customizing-atg-to-you/ Language: fr Section: Documentation Cette section décrit comment *Ask This Guy* (ATG) peut être **adapté à votre organisation** au-delà du déploiement standard. Plusieurs approches sont possibles ; ATG suit une philosophie **90-10** : garder l’essentiel du système générique tout en concentrant la personnalisation là où elle apporte le plus de valeur. **Dans cette section** - [Introduction](https://www.askthisguy.com/doc/customizing-atg-to-you/introduction) – Approches et modèle 90-10 - [Traitement sur mesure](https://www.askthisguy.com/doc/customizing-atg-to-you/tailored-processing) – Gestion documentaire adaptée à vos types de fichiers - [Outils sur mesure](https://www.askthisguy.com/doc/customizing-atg-to-you/tailored-tools) – Interroger vos API d’entreprise (CRM, outils internes, etc.) - [Requête base de données](https://www.askthisguy.com/doc/customizing-atg-to-you/database-query) – SQL en langage naturel sur vos données --- # Infrastructure et sécurité URL: https://www.askthisguy.com/fr/doc/infrastructure-and-security/ Language: fr Section: Documentation ## Conçue pour la performance, la sécurité et la souveraineté des données L'infrastructure d'ATG a été **soigneusement conçue** pour offrir performance, sécurité et flexibilité — tout en assurant un **contrôle total** sur vos données. Chaque choix technique reflète notre engagement pour la **souveraineté des données en Europe** et les meilleures pratiques de sécurité. ### Architecture Toute l'infrastructure d'ATG — **frontend**, **backend** et **stockage/bases de données** — tourne sur **des serveurs ATG dédiés chez OVHCloud**, avec redondance sur un second site physique. Cela signifie un **hébergeur européen** et des données non soumises à la législation américaine (Cloud Act, Patriot Act, etc.). Site principal : **Gravelines (France)** ; secondaire : **Francfort (Allemagne)**. Votre appareil communique uniquement avec le frontend et le backend ; le backend seul accède au stockage et aux bases et est le seul à appeler les **services externes** (LLM, recherche web, etc.). Vos données restent sur les serveurs européens d'ATG ; tout appel à un fournisseur d'IA ou autre passe par notre backend sous contrôle strict. **Nos propres GPU, en plus des fournisseurs externes :** ATG ne se contente pas d'appeler des fournisseurs d'IA externes. Nous montons aussi nos **propres infrastructures GPU** chez **Verda**, un acteur finlandais qui opère des data centers en **Finlande** et en **Islande**. Nous y déployons et exploitons nous-mêmes certains modèles, sur des GPU dédiés, sans sortir du périmètre européen (la Finlande est dans l'Union européenne, l'Islande dans l'Espace économique européen, toutes deux couvertes par le RGPD). Détails sur la page [Gestion des fournisseurs IA](https://www.askthisguy.com/doc/infrastructure-and-security/ai-providers). **Technologies utilisées :** - **Python** pour tout le backend, permettant une intégration fluide entre les services et modules de la plateforme - **PostgreSQL** pour les données structurées et métadonnées, **PGVector** pour la recherche sémantique IA, **S3** pour les documents et médias. Concrètement il s'agit de **Supabase**, mais **auto-hébergé** sur les serveurs OVHCloud d'ATG et entièrement géré par ATG
Python PostgreSQL OVHcloud
### Hébergement et redondance des données **Infrastructure européenne chez des hébergeurs européens** - Site principal : **Gravelines (France)** ; site secondaire : **Francfort (Allemagne)** pour la redondance physique - Des **sauvegardes horaires** sont envoyées automatiquement vers le site secondaire - Toutes les données résident sur des **serveurs privés virtuels OVHCloud** avec **stockage SSD** performant - Certains traitements IA tournent sur des **GPU dédiés à ATG** chez **Verda**, en **Finlande** et en **Islande** **Certifications de sécurité :** - OVHCloud est certifié **ISO/IEC 27001, ISO/IEC 27017 et ISO/IEC 27018** - Ces certifications garantissent la conformité aux bonnes pratiques internationales en matière de sécurité et de protection des données **Principes de souveraineté des données :** - Toutes les informations sensibles sont traitées de manière **souveraine** en Europe - Le partage de données avec des entités non européennes est **limité ou supprimé** selon le choix de politique IA de votre organisation - ATG applique une politique de **rétention minimale des données** — nous **ne stockons pas les fichiers** des connecteurs externes après traitement Vos connaissances restent ainsi sous votre contrôle, dans le périmètre européen. Pour aller plus loin : - **[Notre approche de l'IA souveraine](https://www.askthisguy.com/doc/infrastructure-and-security/sovereign-ai)** : les trois niveaux de souveraineté et le choix entre politique UE uniquement et politique mondiale - **[Gestion des fournisseurs IA](https://www.askthisguy.com/doc/infrastructure-and-security/ai-providers)** : comment ATG sélectionne et utilise les fournisseurs de LLM selon votre politique IA - **[Gestion de vos données](https://www.askthisguy.com/doc/infrastructure-and-security/data-management)** : vue didactique du traitement, de la rétention et de la protection de vos données ### Pourquoi c'est important Ces choix techniques permettent à ATG de garantir : - **Performance** — Recherche et chat IA rapides et fiables - **Sécurité** — Protection niveau entreprise avec une infrastructure certifiée ISO - **Souveraineté** — Vos données restent en Europe, sous votre contrôle, et ne sont pas soumises au Patriot Act, au Cloud Act ou à d'autres législations étrangères si vous restez en politique UE - **Confidentialité** — Rétention minimale des données et pas de stockage de fichiers inutile - **Flexibilité** — Choisissez les fournisseurs IA en fonction de vos exigences de conformité Vos connaissances, vos règles, votre infrastructure. --- # Foire aux questions URL: https://www.askthisguy.com/fr/doc/frequently-asked-questions/ Language: fr Section: Documentation ### Où sont hébergés les serveurs d'ATG ? Tous les serveurs This Guy sont **hébergés dans l'Union européenne** chez des hébergeurs européens, garantissant la souveraineté des données et la conformité RGPD par défaut. Points clés en matière de sécurité : - **Résidence des données en UE** avec réplication dans des datacenters européens - Politique de **rétention minimale des données**: uniquement ce qui est nécessaire au service - **Les documents originaux ne sont pas stockés**: uniquement les versions converties et indexées - **Choix flexible du fournisseur IA**: uniquement UE ou monde entier Cette approche EU-first signifie que vos données restent sous juridiction européenne, pour une conformité et un contrôle complets. *En savoir plus : [Infrastructure et sécurité](https://www.askthisguy.com/doc/infrastructure-and-security)* ### Comment ATG gère-t-il les permissions et l'accès aux données ? ATG utilise un **contrôle d'accès par agent** pour les utilisateurs de la webapp : - Les administrateurs ouvrent un agent Webapp à tous ou le réservent à certains utilisateurs. - Les catégories de connaissances sont affectées aux agents, jamais aux utilisateurs. - Les outils sont activés sur chaque agent par les administrateurs. - Les utilisateurs voient uniquement les agents Webapp actifs qu'ils sont autorisés à utiliser. Pour protéger des informations sensibles, créez un agent spécialisé avec les catégories nécessaires et limitez cet agent aux utilisateurs autorisés. *En savoir plus : [Utilisateurs](https://www.askthisguy.com/doc/admin-console/users-management)* ### ATG peut-il effectuer des actions dans nos systèmes internes ? Oui ! Au-delà de la recherche et des réponses, Ask This Guy (ATG) peut être étendu avec des **outils personnalisés** qui s'intègrent à vos systèmes métier. Les outils personnalisés peuvent notamment : - **Mettre à jour votre CRM** avec des informations clients - **Déclencher des workflows** dans vos applications métier - **Interroger des bases internes** pour des données spécifiques - **Créer des tickets** dans votre outil de support - **Envoyer des notifications** aux membres de l'équipe - **Exécuter des actions métier** propres à votre organisation Ces outils sont développés spécifiquement pour vos besoins et peuvent faire d'Ask This Guy un maillon à part entière de votre stack. Pour les opérations d'écriture, le système demande toujours une validation utilisateur avant d'exécuter l'action, pour garder le contrôle et éviter les effets de bord. *En savoir plus : [Outils et MCP](https://www.askthisguy.com/doc/admin-console/tools-management)* ### Informations générales ### Qu'est-ce qu'Ask This Guy exactement ? Ask This Guy (ATG) est un assistant intelligent propulsé par l'IA, conçu pour les entreprises, qui aide les équipes à retrouver rapidement des informations dans les données internes ou sur le web et à utiliser l'IA pour accomplir diverses tâches. Accessible via une interface de chat simple ou des widgets intégrables, il fournit des réponses précises, fiables et contextualisées là où les collaborateurs en ont besoin. Propulsé par des modèles d'IA de premier plan, ATG indique clairement ses sources pour chaque réponse, permettant aux organisations de vérifier l'information et de garder la main sur le contenu produit. ### Quand la société a-t-elle été créée ? Ask This Guy a été créée en **février 2025**. ### Où la société est-elle implantée ? La société est **domiciliée et basée en France**. ### Qui sont les fondateurs d'Ask This Guy ? Ask This Guy a été fondée par **Rémi Chkaibane** et **Jean-Christophe Budin**, ingénieurs expérimentés issus de **l'INSA Lyon**. ### Ask This Guy est-il déjà commercialisé ? Oui. Ask This Guy est **commercialisé depuis 2025**. - **Des clients sont déjà déployés** en production (déploiements depuis 2025). - La société est **rentable dès son premier exercice** et **autofinancée**. ### Comment est fixé le tarif et quel est l'abonnement minimum ? Ask This Guy propose **trois modalités tarifaires** selon votre usage : - **Chatbot de site web** : **90 €/mois** tout compris (jusqu'à 200 messages/mois). - **Assistant support produit** : **190 €/mois** (jusqu'à 500 messages/mois). - **Autres solutions** (RAG, Talk to Data, automatisation, IA sur mesure) : tarif **établi avec vous** après analyse de vos besoins, en fonction du nombre d'utilisateurs et/ou du volume de messages traités. Dans tous les cas : - **Facturation forfaitaire**: pas de surprise « par token » ni facturation opaque. - **Sans engagement** au-delà du premier mois. - **Intégrations et développements spécifiques** : devis forfaitaire ferme (votre besoin → notre proposition), sans mauvaise surprise ; le code et la propriété intellectuelle restent au client. Contactez [bonjour@askthisguy.com](mailto:bonjour@askthisguy.com) pour un devis adapté à votre contexte. ### Quels modèles et fournisseurs d'IA utilise Ask This Guy ? ATG s'appuie sur des modèles d'IA de premier plan de fournisseurs tels que Cerebras, Groq, SambaNova, Gemini, Mistral, Nebius, DeepInfra, OpenAI, Black Forest Labs et Scaleway. Les organisations peuvent choisir des fournisseurs basés en UE (souveraineté des données, serveurs dans l'Union européenne) ou mondiaux, selon leurs exigences de conformité et préférences. ### Quelles langues ATG comprend-il ? ATG prend en charge la quasi-totalité des langues. Posez vos questions dans la langue qui vous convient le mieux, il comprendra et répondra en conséquence. ### Comment ATG choisit-il les outils et sources à utiliser ? Les administrateurs déterminent les outils disponibles pour chaque agent. Selon sa configuration, un agent peut notamment : - **Rechercher dans la base de connaissances** de votre entreprise (documentation et informations internes) - **Rechercher sur le web** (actualités, tendances, informations externes) - **Rechercher des documents** par nom ou contenu dans votre organisation - **Récupérer le contenu d'URL** que vous fournissez ou pertinentes pour votre question - **Accéder aux plateformes connectées** (Confluence, Notion, Slack, etc.) L'agent sélectionne les outils pertinents parmi ceux qui lui sont activés. Les utilisateurs ne peuvent pas activer ou désactiver des outils depuis la webapp. Vous pouvez décrire le résultat souhaité ou demander l'utilisation d'une source précise, mais l'agent ne peut utiliser que les outils et connaissances configurés par un administrateur. ### Utiliser Ask This Guy ### Pour quels types de tâches puis-je utiliser This Guy au quotidien ? Ask This Guy (ATG) est un assistant vraiment polyvalent ! Vous pouvez l'utiliser comme d'autres chatbots IA pour de nombreuses tâches : - **Création de contenu :** lui demander de rédiger des e-mails, résumés, rapports, posts LinkedIn ou de brainstormer des idées marketing. - **Collaboration :** brainstormer avec vous, structurer un projet ou améliorer des textes existants. - **Recherche d'information :** poser vos questions et obtenir des réponses basées sur vos documents internes, internet ou l'intelligence générale de l'IA. - **Requêtes sur les données :** poser des questions en langage naturel pour interroger des bases structurées, sans langage de requête technique. - **Support intégré :** accéder à This Guy directement dans vos sites institutionnels, outils IT et applications web via des widgets intégrés, au bon endroit. L'objectif est de vous fournir des réponses pertinentes et rapides, parfaitement adaptées à votre contexte professionnel ! ### Pouvez-vous me donner des exemples de questions ou de prompts ? Bien sûr ! Voici quelques cas d'usage courants pour commencer : - « Rédige un e-mail de relance pour un prospect inactif depuis 2 semaines. » - « Quelles sont les conclusions clés de notre dernier rapport commercial ? » - « Donne-moi les dernières actualités sur nos concurrents. » - « Résume-moi notre politique RH sur le congé maternité. » - « Explique en 3 phrases simples comment fonctionne notre dernière offre produit. » Exemples dans des widgets intégrés et avec des données structurées : **Exemples avec contexte widget :** - « Je suis sur le portail employé: quelle est la procédure pour demander le télétravail ? » - « Je consulte le catalogue produit: peux-tu expliquer les paliers de prix de notre offre entreprise ? » - « Je suis dans l'outil support client: quelle est notre politique de délai de réponse ? » - « Je suis sur la page support IT: comment réinitialiser mes identifiants VPN ? » **Exemples de requêtes sur données structurées :** - « Quels ont été nos ventes totales au T3 2024 par région ? » - « Montre-moi le top 5 des produits les plus performants du mois dernier. » - « Quelles expériences de notre base recherche ont un taux de succès supérieur à 85 % ? » - « Quel est le score moyen de satisfaction client pour notre équipe support cette année ? » - « Combien d'unités du produit X ont été vendues en France au dernier trimestre ? » - « Compare la croissance de revenus mensuels entre janvier et octobre 2024. » Ces exemples montrent comment Ask This Guy (ATG) peut vous assister directement dans vos outils et vous aider à extraire des insights de jeux de données complexes en langage naturel. ### Comment Ask This Guy garantit-il que les informations fournies sont fiables et traçables ? Ask This Guy (ATG) est conçu pour vous laisser le contrôle. À chaque réponse, il indique clairement ses sources: documents internes ou liens web: ce qui vous permet de vérifier facilement l'information et d'en tracer l'origine, tout en gagnant en efficacité. ### Ask This Guy et les connaissances de votre organisation ### Comment Ask This Guy gère-t-il les connaissances internes de mon organisation ? Ask This Guy (ATG) est conçu pour vous donner un accès rapide aux informations essentielles de votre entreprise sans avoir à fouiller des dizaines de fichiers ou d'outils. Voici les principes : - **Base de connaissances organisée :** les administrateurs de votre espace This Guy sélectionnent, centralisent, organisent et catégorisent les informations accessibles via l'assistant, pour des données pertinentes et fiables. - **Sources variées :** les administrateurs peuvent inclure des données de Confluence (espaces, pages, bases documentaires), de fichiers (PDF, Word, PowerPoint, etc.) téléversés, d'espaces Notion, de conversations et fichiers Slack, de pages web crawlées automatiquement. - **Catégories structurées :** chaque source est liée à une catégorie de connaissances. Les administrateurs affectent les catégories aux agents selon leur rôle et leur cas d'usage. - **Accès par agent :** les utilisateurs reçoivent des droits sur les agents Webapp, pas sur les catégories. Un agent restreint peut protéger des catégories confidentielles. - **Recherche maîtrisée :** un agent peut rechercher dans ses catégories uniquement si l'outil Recherche dans la base de connaissances lui est activé. Les utilisateurs n'activent pas cette recherche depuis le chat. - **Réponses traçables :** lorsque l'agent utilise les connaissances de l'organisation, il cite les documents ou pages employés dans sa réponse. ### Conseils pour bien interagir ### Quelles sont les bonnes pratiques pour rédiger des instructions (prompts) efficaces ? Pour obtenir les réponses les plus précises et utiles de This Guy, la formulation de vos questions (les « prompts » en jargon IA) compte beaucoup. Quelques conseils : - **Soyez clair et précis :** exprimez vos questions ou demandes le plus clairement possible. Par ex. au lieu de « Montre le rapport », préférez « Peux-tu me montrer le rapport des ventes du T4 2025 ? » - **Donnez du contexte :** si la question concerne un projet, une équipe ou un sujet précis, mentionnez-le. Ex. : « Comment déposer une note de frais pour l'équipe marketing ? » - **Dialoguez :** si la première réponse ne convient pas, n'hésitez pas à demander des précisions ou une reformulation. Ex. : « Peux-tu expliquer plus simplement ? » ou « Peux-tu me donner un exemple ? » - Si This Guy ne semble pas comprendre, reformulez ou découpez la question en parties plus petites. - **Utilisez des exemples :** un exemple aide This Guy à mieux cerner votre intention. Ex. : « Résume cet article en puces, comme ceci : [exemple de puces]. » ### Faut-il vérifier les informations fournies par This Guy ? Oui, absolument ! Bien qu'Ask This Guy (ATG) soit un outil puissant et très utile, c'est une IA : comme tous les modèles, elle peut parfois se tromper ou donner des informations obsolètes. Pour les décisions importantes, il est recommandé de recouper les réponses avec les sources officielles ou la documentation. Votre jugement reste essentiel ! ### Que garder en tête sur la confidentialité et la vie privée avec This Guy ? La sécurité de vos données compte. À retenir : - **Respecter la confidentialité :** ne partagez que les informations auxquelles vous êtes autorisé à accéder. - **Éviter les données sensibles inutiles :** soyez conscient des informations que vous communiquez. Sauf si vous êtes certain que les paramètres de confidentialité et sécurité d'Ask This Guy sont adaptés, évitez de saisir des données sensibles ou personnelles. En cas de doute, adressez-vous à votre administrateur ou responsable. ### Que faut-il éviter lors des échanges avec This Guy ? Pour des échanges fluides et efficaces, évitez notamment : - **N'utiliser que des mots-clés :** des phrases trop courtes ou uniquement des mots-clés peuvent embrouiller le chatbot. Privilégiez des phrases complètes. - **Trop de jargon :** This Guy comprend beaucoup de termes techniques, mais trop de jargon ou d'acronymes peut mener à des quiproquos. Restez simple et clair, surtout au début. ### Faut-il être poli avec This Guy ? This Guy n'a pas de sentiments (c'est une IA ! ), mais utiliser « s'il te plaît » et « merci » rend les échanges plus naturels et agréables. C'est une bonne habitude à garder ! ### Agents IA et personnalisation ### Qu'est-ce qu'un agent IA dans This Guy ? Chaque conversation ATG utilise obligatoirement un **agent**. Les agents s'adaptent à des usages précis dans votre organisation. Chaque agent peut avoir : - **Instructions et personnalité uniques :** définir comment l'agent interagit et répond (ex. : bot support client, assistant commercial, aide technique) - **Outils spécifiques :** choisir les capacités (recherche connaissances, recherche web, génération d'images, outils personnalisés, etc.) - **Accès aux connaissances :** contrôler les catégories et sources accessibles à l'agent - **Politique IA :** choisir des fournisseurs basés en UE ou mondiaux selon vos besoins de conformité Vous pouvez donc créer des agents différents pour différentes équipes ou cas d'usage, chacun optimisé pour son rôle ! Choisissez le type **Webapp** lorsque l'agent est destiné aux membres authentifiés de l'organisation, ou **Widget** lorsqu'il doit être intégré dans un site ou une application. Le type est définitif après la création. *En savoir plus : [Agents](https://www.askthisguy.com/doc/admin-console/how-to-configure-the-agents) • [Widget ATG](https://www.askthisguy.com/doc/atg-embedded)* ### Comment les utilisateurs choisissent-ils un agent dans la webapp ATG ? Les utilisateurs choisissent un agent Webapp actif qu'ils sont autorisés à utiliser au démarrage d'un nouveau chat. ATG présélectionne le dernier agent utilisé. Après le premier message, l'agent sélectionné reste attaché à la conversation. Il faut donc démarrer un nouveau chat pour changer d'agent. *En savoir plus : [Webapp](https://www.askthisguy.com/doc/webapp)* ### Quelle est la différence entre les outils intégrés et les outils personnalisés ? Les **outils intégrés** sont fournis par défaut avec This Guy : recherche web, recherche dans la base de connaissances, récupération de documents, fetch d'URL, génération d'images. Les administrateurs peuvent les activer ou les désactiver par agent. Les **outils personnalisés** sont développés spécifiquement pour votre organisation (intégration à des systèmes propriétaires, requêtes métier, déclenchement de workflows). Ils étendent les capacités de This Guy au-delà des fonctionnalités standard. Les deux types sont configurés par agent. Un utilisateur peut bénéficier d'un outil uniquement à travers un agent sur lequel cet outil est activé. *En savoir plus : [Outils et MCP](https://www.askthisguy.com/doc/admin-console/tools-management)* ### Widget ATG et intégration ### Peut-on intégrer Ask This Guy directement dans nos sites ou applications ? Absolument ! Ask This Guy (ATG) propose des **widgets intégrables** pour : - Vos **sites d'entreprise** (assistance aux visiteurs) - Vos **systèmes et outils internes** (support aux employés) - Vos **produits SaaS et applications web** (assistance IA côté client) Le **widget ATG** peut être entièrement personnalisé avec votre identité visuelle, configuré avec un agent Widget dédié et intégré aux données et workflows de votre plateforme. Il permet de proposer une assistance IA exactement où vos utilisateurs en ont besoin, sans quitter votre application. *En savoir plus : [Widget ATG](https://www.askthisguy.com/doc/atg-embedded)* ### En quoi le widget ATG diffère-t-il de l'application web standard ? Le widget ATG est conçu pour **l'intégration dans vos propres plateformes**, tandis que l'application web sur [app.askthisguy.com](http://app.askthisguy.com) est destinée à l'usage interne des employés. **Fonctionnalités du widget ATG :** - Personnalisation visuelle et branding complets - Intégration par API avec un minimum de développement - Réponses contextuelles basées sur les données de votre plateforme - Support de métadonnées client pour des interactions personnalisées - Intégration d'outils personnalisés pour des actions spécifiques à la plateforme - Pas de gestion d'utilisateurs dédiée (réutilisation de votre authentification) Les deux solutions partagent la même base de connaissances et peuvent utiliser les mêmes sources configurées, pour une cohérence sur tous les canaux de déploiement. *En savoir plus : [Widget ATG](https://www.askthisguy.com/doc/atg-embedded)* ### Services avancés ### Qu'est-ce que le service Press Review ? **Press Review** est un service de revue de presse propulsé par l'IA qui aide les équipes à rester informées sur des sujets pertinents sans y passer des heures. Les administrateurs créent des « briefs » avec des sujets, mots-clés et axes précis. Les utilisateurs peuvent ensuite générer à la demande des revues de presse personnalisées qui : - Recherchent sur le web des articles actuels et pertinents - Filtrent le contenu selon le brief configuré - Produisent un rapport structuré et facile à parcourir - Donnent des insights sur la veille concurrentielle, les tendances marché et l'actualité du secteur Idéal pour la veille concurrentielle, la gestion de comptes, la planification stratégique et tout ce qui compte pour votre activité. *En savoir plus : [Press Review](https://www.askthisguy.com/doc/admin-console/organization-settings/press-review)* ### Que sont les Predefined Prompts ? Les **Predefined Prompts** sont des modèles prêts à l'emploi qui permettent d'obtenir des résultats de qualité professionnelle en quelques clics. Les administrateurs créent et optimisent des prompts pour des tâches courantes (e-mails de relance, résumés de rapports, analyse de données). Les utilisateurs peuvent ensuite : - Parcourir les modèles disponibles - Sélectionner un prompt en un clic - Ajouter des détails ou variables - Obtenir des résultats homogènes et de qualité Ainsi, tout le monde utilise des prompts éprouvés sans être expert en prompt engineering. ATG propose même une fonction d'optimisation par IA pour affiner les prompts côté administrateur. *En savoir plus : [Prompts prédéfinis](https://www.askthisguy.com/doc/admin-console/organization-settings/predefined-prompts)* ### Sources de données et connecteurs ### À quels types de sources This Guy peut-il se connecter ? This Guy peut s'intégrer à une grande variété de plateformes et de sources : **Connecteurs standard :** - **Confluence** (espaces, pages, documentation) - **Notion** (workspaces, pages, bases) - **Google Drive** (documents, tableurs, présentations) - **SharePoint/OneDrive** (dépôts Microsoft) - **Slack** (conversations et fichiers partagés) - **Téléversement de fichiers** (PDF, Word, Excel, PowerPoint, images, etc.) - **Pages web** (crawling automatisé de sites définis) - **E-mail** (partage de documents par e-mail) **Connecteurs personnalisés :** ATG peut développer des connecteurs dédiés pour vos systèmes propriétaires ou sources spécifiques, sur demande. Tous les connecteurs se synchronisent automatiquement pour garder votre base de connaissances à jour ! *En savoir plus : [Connecteurs](https://www.askthisguy.com/doc/admin-console/knowledge-management/connectors)* ### Comment This Guy gère-t-il les images et le contenu visuel dans les documents ? This Guy utilise un **traitement multimodal avancé** pour comprendre à la fois le texte et les images dans vos documents. Le système : - **Extrait les images** des PDF, documents Word, présentations et autres fichiers - **Analyse le contenu visuel** via une IA de vision (graphiques, schémas, photos, illustrations techniques) - **Génère des descriptions détaillées** de chaque image avec un contexte métier - **Indexe texte et images** pour une recherche complète - **Peut référencer les images** dans ses réponses pour des réponses contextuelles incluant l'information visuelle Vous pouvez ainsi obtenir des insights à partir du texte et des éléments visuels de vos documents: avec une précision de plus de 95 % et plus de 50 langues supportées. *En savoir plus : [Documents et images](https://www.askthisguy.com/doc/admin-console/knowledge-management/how-documents-images-are-processed-by-atg)* ### Les utilisateurs peuvent-ils joindre des fichiers directement dans les conversations ? Oui ! Les utilisateurs peuvent joindre des fichiers à leurs messages, notamment : - **Documents :** PDF, Word, PowerPoint, fichiers texte - **Médias :** images, vidéos, fichiers audio - **Tableurs :** Excel et autres données structurées This Guy analyse les fichiers joints immédiatement et répond en fonction de leur contenu, sans avoir à les ajouter définitivement à la base de connaissances. ### Technique et sécurité ### Qu'est-ce que le RAG et pourquoi c'est important ? Le **RAG (Retrieval Augmented Generation)** est la technologie qui rend les réponses de This Guy précises et fiables. Fonctionnement : 1. **Vous posez une question** 2. **This Guy recherche** dans votre base de connaissances (recherche sémantique et par mots-clés) 3. **Les documents pertinents sont récupérés** et fournis comme contexte 4. **L'IA génère une réponse** à partir des informations récupérées (et non uniquement de sa mémoire) 5. **Les sources sont clairement citées** pour que vous puissiez vérifier Cette approche **réduit les « hallucinations »** de l'IA et ancre les réponses dans vos vrais documents et données. Le système RAG convertit tous les documents: y compris les images: en markdown et crée des embeddings vectoriels pour une recherche sémantique intelligente. *En savoir plus : [Données et RAG](https://www.askthisguy.com/doc/admin-console/knowledge-management/how-is-my-companys-data-processed-what-is-rag)* ### Peut-on contrôler quels fournisseurs IA traitent nos données ? Oui ! This Guy propose une **sélection de politique IA** flexible : - **Politique UE :** les données ne sont traitées que par des fournisseurs IA basés en UE, avec serveurs dans l'Union européenne - **Politique mondiale :** permet l'usage de fournisseurs globaux comme OpenAI Les administrateurs choisissent la politique qui correspond à vos exigences de conformité. ATG s'intègre à plusieurs fournisseurs dont Mistral, Nebius, Scaleway, Cerebras, Groq, SambaNova, Gemini, DeepInfra, OpenAI et Black Forest Labs, pour allier flexibilité et contrôle. *En savoir plus : [Politique IA](https://www.askthisguy.com/doc/admin-console/organization-settings/choosing-the-right-ai-policy)* ### Dépannage ### Je ne reçois pas les e-mails (invitations, codes de confirmation, etc.) Si vous ne recevez pas les e-mails envoyés par Ask This Guy (invitations, codes de confirmation, notifications), suivez ces étapes selon votre environnement : **Environnement Microsoft 365 :** - Vérifiez d'abord le dossier **Courrier indésirable** - Consultez la **quarantaine Microsoft** : [https://security.microsoft.com/quarantine](https://security.microsoft.com/quarantine) - Si vous y trouvez les e-mails, demandez à votre administrateur IT d'ajouter [team@askthisguy.com](mailto:team@askthisguy.com) à la liste d'autorisation **Environnement Google Workspace :** - Vérifiez d'abord le dossier **Spam** - Contactez votre **administrateur IT** pour consulter la quarantaine : [**admin.google.com**](http://admin.google.com) ⇒ Applications > Google Workspace > Gmail > Quarantaine - Si les e-mails sont en quarantaine, demandez à l'administrateur de configurer des règles pour autoriser les expéditeurs Ask This Guy **Conseil général :** vérifiez que l'adresse e-mail de votre profil This Guy est correcte et active. **Toujours des soucis ?** Contactez le support à [support@askthisguy.com](mailto:support@askthisguy.com) ### This Guy ne trouve pas l'information que je cherche Si This Guy ne trouve pas l'information attendue : - **Vérifiez la formulation :** essayez de reformuler votre question de façon plus claire et précise - **Donnez du contexte :** indiquez le nom du document, du projet ou de la catégorie de connaissances concernée - **Vérifiez l'agent sélectionné :** démarrez un nouveau chat avec un autre agent disponible si le sujet ne correspond pas au rôle de l'agent actuel - **Contactez votre administrateur :** l'agent sélectionné ne dispose peut-être pas de la catégorie ou de l'outil Recherche dans la base de connaissances nécessaire ### This Guy est lent ou ne répond pas En cas de problème de performance : - **Vérifiez votre connexion internet :** une connexion instable peut affecter le service - **Actualisez la page :** un simple rechargement peut résoudre des problèmes temporaires - **Essayez un autre navigateur :** certains navigateurs peuvent mieux convenir - **Vérifiez les extensions :** certaines extensions peuvent perturber This Guy - **Contactez le support :** si le problème persiste, signalez-le à votre administrateur ou à [support@askthisguy.com](mailto:support@askthisguy.com) --- # Conf Guides URL: https://www.askthisguy.com/en/doc/admin-console/knowledge-management/connectors/conf-guides/ Language: en Section: Documentation Step-by-step configuration guides for connecting your data sources to ATG. Select a guide from the sidebar to get started. --- # Organization URL: https://www.askthisguy.com/en/doc/admin-console/organization-settings/ Language: en Section: Documentation ### Welcome to Your Ask This Guy Organization Settings! Manage your organization's core information and AI policies with ease. These settings let you tailor **Ask This Guy** to reflect your company's identity and operational guidelines. ![Organization settings](https://www.askthisguy.com/doc/org-settings-en.webp) ## Available Features Configure these essential settings to customize your ATG experience: ** Organization Name** Your public-facing name within the ATG platform. ** Description** A brief summary of your organization's activities, automatically included in every message to provide context to the AI. ** AI Policy** Choose between European-focused or global data residency policies. See [AI Policy](https://www.askthisguy.com/doc/admin-console/organization-settings/choosing-the-right-ai-policy) for details. ** Predefined Prompts** Create reusable prompt templates that your team can use in two clicks. See [Predefined Prompts](https://www.askthisguy.com/doc/admin-console/organization-settings/predefined-prompts) for details. ** Press Review** Configure custom news digests tailored to your organization's interests. See [Press Review](https://www.askthisguy.com/doc/admin-console/organization-settings/press-review) for details. ** Organization Context** Comprehensive background information (key personnel, departments, vocabulary, internal rules) that helps the AI understand requests and provide relevant responses. ## Step-by-Step Guide **1⃣ Navigate to Organization Settings** From the [Admin console](https://admin.askthisguy.com), click **Organization** → **Settings**. **2⃣ Edit Organization Details** - Click the ** pencil icon** next to any field (Name or Description) to edit **3⃣ Select Your AI Policy** - Choose between **🇪🇺 European Providers** (European providers) or ** Worldwide** (global flexibility) **4⃣ Define Organization Context** - Click the ** pencil icon** next to "Organization context" - Enter relevant information about your organization in the text area - more detail helps the AI understand better - Use **" Create with AI"** for automatically generating context with knowledge that is already processed, then save your changes ## Key Considerations **Description** Keep it concise - it's included in every user message. **AI Policy** - **European Providers:** Uses only EU providers and open-weight models (strict compliance) - **Worldwide:** No provider restrictions, but may be subject to non-EU regulations like the Patriot Act ## Additional Information [AI Policy](https://www.askthisguy.com/doc/admin-console/organization-settings/choosing-the-right-ai-policy) [Predefined Prompts](https://www.askthisguy.com/doc/admin-console/organization-settings/predefined-prompts) [Press Review](https://www.askthisguy.com/doc/admin-console/organization-settings/press-review) --- # Introduction URL: https://www.askthisguy.com/en/doc/customizing-atg-to-you/introduction/ Language: en Section: Documentation ## Different approaches to customization An AI assistant for your organization can be built in many ways: fully generic (one size fits all), fully bespoke (everything built for you), or something in between. Each approach has trade-offs in cost, time-to-value, and control. ## The 90-10 approach ATG is designed around a **90-10** philosophy: - **About 90% is generic** – What the ATG SaaS platform provides: chat, knowledge search, connectors, agents, security, hosting, and ongoing product evolution. This shared foundation is what makes deployment fast and maintenance predictable. - **About 10% is specific** – What is tailored to *your* processes, data, and tools. This is where the real differentiation and business value come from: your documents, your formats, your APIs, and your databases. ![The 90-10 approach: 90% generic platform, 10% organization-specific value](https://www.askthisguy.com/doc/90-10-en.webp) That 10% is where ATG’s customization options apply: **Tailored Processing** (your file formats and rules), **Tailored Tools** (your enterprise APIs), and **Database Query** (natural-language access to your data). The rest stays on the robust, shared platform so you get both flexibility and reliability. --- # Knowledge URL: https://www.askthisguy.com/en/doc/admin-console/knowledge-management/ Language: en Section: Documentation The **Knowledge** area organizes the information that ATG agents can search. Administrators connect or upload sources, group them into categories, then choose which categories each agent can use. **Start here:** [Connectors](https://www.askthisguy.com/doc/admin-console/knowledge-management/connectors) explains how to connect data sources to ATG. ## Key concepts ### Categories A **knowledge category** groups sources that serve the same audience, business area, or use case. For example, you can create categories for company-wide documentation, Finance, HR, or a specific product. Categories are assigned to **agents, not users**. In each agent's Knowledge tab, administrators select the categories that the agent can search. ### Sources Each category contains one or more sources: - **Connectors** automatically import content from systems such as Confluence, Google Drive, Notion, SharePoint, OneDrive, or Slack. - **File uploads** add PDFs, Word documents, presentations, and other supported files directly. - **Web crawls** collect content from configured websites. Each source has its own **refresh frequency**, which administrators set to Manual, Daily, Weekly, or Monthly depending on how fast its content changes. See [Connectors](https://www.askthisguy.com/doc/admin-console/knowledge-management/connectors) and [File Upload](https://www.askthisguy.com/doc/admin-console/knowledge-management/file-upload) for setup instructions, and [Refresh frequency](https://www.askthisguy.com/doc/admin-console/knowledge-management/connectors#refresh-frequency) to set the update rhythm. ### Documents Sources contain the documents and content that make up your organization's knowledge. ATG processes and indexes this content so agents with the **Knowledge Base Search** tool can retrieve relevant information and cite their sources. ## How knowledge access works Knowledge access is controlled through agents: 1. An administrator groups sources into knowledge categories. 2. The administrator assigns the relevant categories to an agent. 3. The administrator makes the Webapp agent open to everyone or restricts it to selected users. 4. A user who can access the agent can ask it to search the categories configured for that agent. There is no separate category permission on the user profile. To protect confidential knowledge, create a dedicated agent, assign only the required categories, then restrict access to the authorized users. See [Agents](https://www.askthisguy.com/doc/admin-console/how-to-configure-the-agents) and [Users](https://www.askthisguy.com/doc/admin-console/users-management) for the complete configuration flow. ## Tools and knowledge are separate settings Assigning a category defines **what knowledge is available** to an agent. Enabling the **Knowledge Base Search** tool defines **whether the agent can search it**. Both settings are required for an agent to retrieve organizational knowledge. Users cannot enable knowledge search from the chat interface. ## Personal chat attachments Users can attach files directly in the chat interface. These personal attachments are different from organizational knowledge: - they are not added to a knowledge category; - they are not shared with other users; - they provide temporary context to the current conversation. ## Best practices - Group sources by coherent business purpose, not by individual user. - Keep each agent's knowledge scope limited to its role. - Use dedicated restricted agents for confidential departments or projects. - Review agent access whenever responsibilities change. - Test knowledge retrieval in the agent Playground after changing categories or tools. ## Related guides - [Connectors](https://www.askthisguy.com/doc/admin-console/knowledge-management/connectors) - [File Upload](https://www.askthisguy.com/doc/admin-console/knowledge-management/file-upload) - [Data and RAG](https://www.askthisguy.com/doc/admin-console/knowledge-management/how-is-my-companys-data-processed-what-is-rag) - [Documents and Images](https://www.askthisguy.com/doc/admin-console/knowledge-management/how-documents-images-are-processed-by-atg) --- # Integrate the ATG widget in your webapp URL: https://www.askthisguy.com/en/doc/atg-embedded/how-to-integrate-atg-embedded-in-your-webapp/ Language: en Section: Documentation ## Overview The ATG widget runs inside an isolated iframe hosted on [`app.askthisguy.com`](http://app.askthisguy.com), ensuring data privacy, robust security, and effortless updates. ### Integration modes
Mode Typical Use Case Authentication to scope the session Requires Backend
Mode 1 - Public Website FAQ, lead gen, simple SaaS help without per-user context None No
Mode 2 - Connected Auth'd SaaS, contextual support, automations Server-signed JWT with short TTL Yes
## Key concepts ### For both modes ### **Widget (`widget.js`)** A lightweight script that ATG provides and that you embed in your site. It injects an iframe pointing to [`https://app.askthisguy.com`](https://app.askthisguy.com), creates the chat launcher via Shadow DOM, and communicates with the iframe using `postMessage`. ### **Iframe isolation** All chat UI and data live inside a cross-origin iframe ([`app.askthisguy.com`](http://app.askthisguy.com)) under the browser's Same-Origin Policy: - Your page cannot read ATG tokens - ATG cannot access your cookies or scripts ### **Shadow DOM** Prevents CSS/JS collisions with your site. ### **Access token** To maintan the chat sessions with users, ATG ensures that the iframe holds a short-lived, DPoP-bound bearer token in memory and sends it as `Authorization: DPoP \` with the right header. This mechanism allows to maintain a session on browser like Safari where 3rd party cookies and partitionned cookies would get blocked. ### For Mode 2 only ### **Signed Parameters** The only backend work that is required consists in developing a simple endpoint, that will create a Json Web Token (JWT) signed with your private key. This is an example JWT with the minimum required parameter : ```json // Header { "alg": "ES256", "kid": "prod-key-2024-01" } // Payload (minimal required) { "iat": 1739298000, "exp": 1739298900, "jti": "550e8400-e29b-41d4-a716-446655440000" } ``` You'll be able to upload a public key in ATG's administration console so that ATG can decode the JWT and open a chat session with the user. You keep the private key on your servers. You can pass on more parameters to ATG that define the user’s entitlements and context for this session. Check the [appendix](#appendix) for the description of all supported parameters. ### Architecture overview ### Mode 1 - Public flow ```mermaid sequenceDiagram participant User as Visitor participant Site as Website participant Widget as Widget (JS) participant Iframe as ATG Iframe participant ATG as ATG (app.askthisguy.com) User->>Site: Opens webpage with chat widget Site->>Widget: Loads widget.js Widget->>ATG: init_session ATG->>ATG: Allow-origin checks ATG->>Widget: Chat ready ```

The diagram shows how a session opens in public mode: the page loads widget.js, the widget requests a session from ATG, and ATG checks the calling origin before declaring the chat ready. No client-side authentication is involved.

### Mode 2 - Connected ```mermaid sequenceDiagram participant User as User participant Site as Client App participant Widget as Widget (JS) participant Backend as Client Backend participant Iframe as ATG Iframe participant ATG as ATG User->>Site: Opens app with embedded chat Site->>Widget: Loads widget.js Widget->>Backend: getSignedParams() Backend-->>Widget: JWT (≤15 min TTL) Widget->>ATG: POST /session/init { jwt } + DPoP Proof ATG-->>Iframe: DPoP-bound access token (in-memory) Iframe-->>User: Chat ready ```

The diagram shows how a session opens in connected mode: your backend signs a short-lived JWT (15 minutes at most), the widget presents it to ATG along with a DPoP proof, and ATG returns a DPoP-bound access token to the iframe, held in memory. Your private key never leaves your servers.

Once the session is established, the widget streams user messages to ATG over a secure channel (SSE/HTTPS), and ATG streams assistant tokens back in real time to the iframe, which renders the chat UI. ```mermaid sequenceDiagram participant User as User participant Widget as Widget (launcher) participant Iframe as Iframe (chat app) participant ATG as ATG ([app.askthisguy.com](http://app.askthisguy.com)) Note over Widget,ATG: Session is already established User->>Widget: Clicks launcher / types a message Widget->>Iframe: Open panel (postMessage) / pass input Iframe->>ATG: Send message (SSE/HTTPS POST) ATG-->>Iframe: Stream tokens/chunks (SSE) Iframe->>User: Render streaming reply Iframe-->>ATG: Acks / keepalive User->>Iframe: Follow-up message Iframe->>ATG: Send next message (same session) ATG-->>Iframe: Stream next reply Note over Widget,ATG: Session refresh handled transparently when near expiry (more details in FAQ) ```

The diagram covers the conversation once the session is established: the launcher passes input to the iframe, which sends the message to ATG and receives the reply streamed token by token over SSE. Follow-up messages reuse the same session, whose refresh is handled transparently as expiry approaches.

## Integration Steps (both modes) > **Using WordPress?** Skip the manual script integration and use our official plugin instead. It handles steps 3 and 4 for you and supports both open and signed modes. See [Install on WordPress with the ATG plugin](https://www.askthisguy.com/doc/atg-embedded/install-on-wordpress-with-the-atg-plugin). ### Step 1: Configure your agent in ATG's admin console ### Create a Widget agent and set up its knowledge First, create an agent in the Admin Console and choose the **Widget** type. The type cannot be changed after creation. Configure the agent's instructions, knowledge categories, and tools before integrating it. See [Configure Agents](https://www.askthisguy.com/doc/admin-console/how-to-configure-the-agents) for more details. This is generally done by the functional team or business users. They can test the agent's behavior in the Playground integrated into the Admin Console. ### **Allow-Listed Origins** In the admin console, provide ATG with the exact origins authorized to embed the widget (e.g., [`https://yourapp.com`](https://yourapp.com), [`https://staging.yourapp.com`](https://staging.yourapp.com)) Then, it will be automatically enforced via both runtime checks and CSP (Content Security Policy) headers on the iframe, ensuring the chat can only be embedded on approved domains. ATG will set its CSP (Content-Service-Policy) with a `frame-ancestors` directive based on your allow-listed origins: ``` Content-Security-Policy: frame-ancestors [https://yourapp.com](https://yourapp.com) [https://staging.yourapp.com](https://staging.yourapp.com); ``` ### Step 2: Check that your website does not block ATG If your website uses a strict Content-Security-Policy (CSP) that blocks iframes or external scripts by default, you need to allow the ATG widget and iframe explicitly. To check if your website uses CSP, you can use a `curl`command for example: ```bash curl -I [https://yourwebsite.com](https://yourwebsite.com) | grep -i content-security-policy ``` If it returns nothing or only `frame-ancestors` rule (most common case), then you do not need to extend the CSP header, jump to next step If it returns strict CSPs, like `Content-Security-Policy: default-src 'self'; script-src 'self'; frame-src 'none';`, then add or extend your CSP header as follows: ``` Content-Security-Policy: script-src 'self' [https://app.askthisguy.com](https://app.askthisguy.com); frame-src [https://app.askthisguy.com](https://app.askthisguy.com); ``` > This header is set on your own server or CDN (by your tech/ops team). > > > It tells browsers your page is allowed to load the ATG script and iframe. > ### Step 3: Add the Widget script You will find a simple JS code in ATG’s admin console you can add near the end of the `\` of each page. It will look like: ```html ``` Check the [Appendix for the detailed description](#appendix) of all the parameters supported by the widget. ## Additional integration steps for Mode 2 ### 1. Implement `/embed/presign` To enable Mode 2, you will need to implement one simple end-point `/embed/presign`. You can change this name if you prefer to. This end-point must: - Be a POST end-point - Verify that the user is authenticated in your app - If so, return a short lived Signed Parameters JWT with a TTL < 15 min - It must be signed using ES256 ****and include a **`kid`** header We also recommend applying same-origin only on `/embed/presign` **Response payload :** ```json // Payload (with optional context) { "iat": 1739298000, "exp": 1739298900, "jti": "550e8400-e29b-41d4-a716-446655440000", "external_user_ref": "user_12345", "entitlements": { "plan": "premium", "features": ["export", "analytics"] }, "context_metadata": { "department": "sales", "region": "EU" } } ``` Check the [appendix](#appendix) for the description of all supported parameters. ### 2. Configure the public key for ATG to decode the JWT In the admin console of ATG, go to your agent's security settings and enter the public key that ATG can use to decode the JWT token that will be signed by your private key in `/embed/presign` ### 3. Provide the JWT to the widget The JS code to append to you website will be slightly different for Mode 2. From the admin console, you can download the latest JS code to insert to your page or via your tag manager. The code will look like: ```html ``` The widget will call `window.ATG.getSignedParams()` to obtain the JWT Feel free to adapt and integrate this code according to your security standards: - Make sure you provide `window.ATG.getSignedParams()` - Define once; guard against re-injection in SPAs - Prefer CSP nonce If you're using a tag manager and you've defined two tags, one for the call-back and one for the widget.js, please make sure you use tag sequencing with the call-back loading first. ### 4. What ATG does with the Signed Parameters 1. **Verifies signature** using the agent's public key (identified by kid) 2. **Validates claims**: - Timestamps (iat, exp) - max 15-minute lifetime - jti uniqueness - prevents replay attacks (stored for 15 min) 3. **Issues DPoP-bound access token** - cryptographically bound to the iframe's ephemeral key pair 4. **Provides session context** - optional claims (external_user_ref, entitlements, context_metadata) are available to the agent for personalization ## JavaScript API: control the widget from your page Once `widget.js` is loaded, it exposes a small API on `window.ATG` that lets you drive the chat from your own UI, instead of relying only on the built-in launcher. This is what enables more user-centric flows: opening the chat automatically on a given page, wiring your own "Ask AI" button, or starting a fresh conversation from a menu.
Method What it does
window.ATG.open() Opens the chat panel.
window.ATG.close() Closes the chat panel.
window.ATG.toggle() Toggles the chat panel open/closed.
window.ATG.expand() Expands the chat to its full view (bubble mode only).
window.ATG.minimize() Minimizes the chat back to its compact view (bubble mode only).
window.ATG.isExpanded() Returns true if the chat is currently expanded.
window.ATG.resetConversation() Starts a new conversation, clearing the current message history. (Open the chat at least once first so the iframe is initialized.)
window.ATG.updatePageRoute(url) Updates the current page route so the agent has up-to-date page context. Mainly used in SPAs (see below).
> The API becomes available once `widget.js` has run. Guard your calls with `window.ATG?.open?.()` so they don't throw if the script hasn't loaded yet, and bind them after `DOMContentLoaded` or your framework's mount hook. ### A few ways to use it **Open the chat from your own button.** Combine `data-launcher="hidden"` (no built-in launcher) with your own trigger: ```html ``` **Turn a search box into a chat entry point.** When a user submits a search, open the assistant instead of (or alongside) showing results: ```javascript searchForm.addEventListener('submit', (e) => { e.preventDefault(); window.ATG?.open?.(); }); ``` **Open the chat automatically on a specific page** (e.g. a pricing or onboarding page), after a short delay so it doesn't fight the initial render: ```javascript window.addEventListener('load', () => { if (location.pathname === '/pricing') { setTimeout(() => window.ATG?.open?.(), 1500); } }); ``` **Start a fresh conversation** from a "New chat" menu item: ```javascript newChatButton.addEventListener('click', () => { window.ATG?.resetConversation?.(); window.ATG?.open?.(); }); ``` ## Optional: Tracking Page Routes in SPAs > **Note:** This is only needed if you have a **Single Page Application (SPA)** with client-side routing and want the agent to provide page-specific contextual help. ### Why SPAs need this In traditional websites, each navigation loads a new page and re-initializes the widget with the current URL. In SPAs, the URL changes without page reloads, so the widget doesn't automatically detect navigation. If you want your agent to provide **contextual, page-specific help** based on the current route, you need to notify the widget of route changes. ### Solution Call `window.ATG.updatePageRoute()` whenever your SPA router navigates: ```javascript window.ATG.updatePageRoute(window.location.href); ``` ### Implementation examples **React Router (v6+)** ```jsx function App() { const location = useLocation(); useEffect(() => { if (window.ATG?.updatePageRoute) { window.ATG.updatePageRoute(window.location.href); } }, [location]); return {/* Your routes */}; } ``` **Vue Router (v4+)** ```javascript // router/index.js const router = createRouter({ history: createWebHistory(), routes: [/* Your routes */], }); router.afterEach(() => { if (window.ATG?.updatePageRoute) { window.ATG.updatePageRoute(window.location.href); } }); export default router; ``` ## Appendix ### Widget parameters
Attribute Description
data-agent-id Required. Agent ID provided by ATG.
data-signed-params Optional. Boolean (true or false). Enables signed parameter authentication for enhanced security. Requires implementing window.ATG.getSignedParams callback. Defaults to false.
data-launcher Optional. Position of the chat launcher (bottom-right, bottom-left, floating, hidden). Defaults to bottom-right. Use hidden to load the widget without a launcher button and open it yourself via the JS API.
data-mode-style Optional. Display mode of the chat panel (bubble, drawer). Defaults to bubble. bubble: compact panel anchored to the launcher, expandable to a centered modal. drawer: full-height panel anchored right that slides in (launcher is hidden while open; expand/minimize disabled). Mobile viewports stay fullscreen regardless of mode.
data-language Optional. Interface language en, fr. Defaults to en.
data-page-route Optional. Canonical route for the current page (e.g. /plans). Useful if you set up agent instructions that take it in account for contextual content.
data-theme-json Optional. JSON object defining custom visual tokens such as brand color, fonts or corner radius. It helps instantly style the assistant. Example: {'{"color.brand":"#6D28D9","radius.lg":"12px"}'}
data-aria-label Optional. Provides an accessibility label for the chat launcher button, allowing screen readers to announce its purpose (e.g. "Open chat support assistant").
data-debug Optional. Boolean (true or false). Enables verbose console logging for troubleshooting. Defaults to false.
`data-theme-json` description:
Token name Description Example value
color.brand Primary brand color #6D28D9
color.bg Chat background color #0B0B0F
color.text Main text color #F3F4F6
color.muted Secondary text color #9CA3AF
color.assistant-bg Background color of assistant message bubbles #F8F8F8
radius.sm, radius.lg Corner radius for buttons, cards 8px, 16px
font.family Font stack Inter, system-ui, sans-serif
shadow.elevation Card/launcher shadow 0 8px 24px rgba(0,0,0,0.25)
### End-point parameters The JWT signed by `/embed/presign` to start a session must have two parts: header and claims (payload). Header
Claim Type Description Example / Notes
kid string Key ID: Identifies which public key to use for signature verification. Must match a key registered with your agent in ATG's admin console. "prod-key-2024-01"
alg string Algorithm: Must be "ES256" (ECDSA with P-256 curve and SHA-256). "ES256"
Payload claims (required)
Claim Type Description Example / Notes
iat number (Unix seconds) Issued-at time: when the token was generated. Used to detect clock drift or replay. 1739298000
exp number (Unix seconds) Expiration: absolute expiry of this Signed Params token. Must be short (≤ 15 min). ATG refuses expired or overly long-lived tokens. 1739298900
jti string (UUID/random) JWT ID: unique nonce for this token. Must be random for each issuance. 550e8400-e29b-41d4-a716-446655440000
Payload claims (optional)
Claim Type Description Example / Notes
external_user_ref string External user reference or ID from your system. Can be used to identify the user in agent instructions or logs. "user_12345"
entitlements object (JSON) User entitlements or permissions. Can be used by agent for access control logic. {'{"plan": "premium", "features": ["export"]}'}
context_metadata object (JSON) Additional context metadata about the session or user. {'{"department": "sales", "region": "EU"}'}
## FAQ ### How do you manage session refresh? ATG automatically rotates the session token **60 seconds before expiration** to ensure uninterrupted chat: 1. **Timer Setup**: When a session is initialized, a rotation timer is scheduled based on the expires_in value (typically 10 minutes). 2. **Pre-Rotation Request** (if signed parameters enabled): - 60 seconds before token expires, the iframe sends a postMessage to the widget: {'{ type: "ATG_REQUEST_SIGNED_PARAMS_FOR_ROTATION" }'} - Widget automatically calls your window.ATG.getSignedParams() callback to fetch a fresh signed JWT. - Your callback should call your backend's presign endpoint and return the new JWT. - Widget responds to iframe with the JWT and the iFrame rotates the session with ATG's server. ### Do you use any 3rd party cookie? No, we do not use 3rd party cookies as these would get blocked. For our access token, we use instead JWT + DPoP proof. ### How does ATG handle key rotation and the `kid` header? Each Signed Parameters JWT includes a `kid` (Key ID) in its header. ATG uses that value to instantly find the right public key you've uploaded in the console. When you rotate keys: 1. Generate a new signing keypair and give it a new `kid` (e.g. `key-2025-02`). 2. Add the new public key to ATG console while keeping the old one until all tokens signed with it expire (≤ 15 min). 3. Start signing new tokens with the new `kid`, then safely remove the old key. ATG automatically verifies each token against the public key that matches its `kid`, so rotation happens seamlessly, no downtime or manual reconfiguration. --- # Tailored Processing URL: https://www.askthisguy.com/en/doc/customizing-atg-to-you/tailored-processing/ Language: en Section: Documentation ## Tailor ATG to Your Organization's Unique Files **ATG can be customized** to intelligently handle **your organization's specific file types** - turning complex documents into actionable insights. ### What Can Be Processed? Whether you work with **Excel spreadsheets**, **product catalogs**, **sales reports**, **scientific datasets**, or any other specialized documents, ATG can learn to process them exactly the way you need: - **Contact databases** – Extract and organize stakeholder information - **Product listings** – Parse inventory and specifications - **Commercial reports** – Analyze sales performance and trends - **Scientific data** – Process research results and measurements - **Custom formats** unique to your industry ### How It Works Custom handling requires **two key components**: 1. **Trigger criteria** – Define what activates the custom processing (e.g., specific keywords in file names, file types, or content patterns) 2. **Processing rules** – Specify exactly how ATG should extract, transform, and structure the data **Once configured, the processing applies automatically** – no matter where the file comes from. Whether uploaded directly, synced via **Notion**, pulled from **Google Drive**, **Confluence**, **SharePoint**, or any other connector, your custom rules work seamlessly across all sources. See [Connectors](https://www.askthisguy.com/doc/admin-console/knowledge-management/connectors) for more information about connectors. This ensures that **your team gets the right information** from the right files, every time. ### Why Context Matters: No Generic CSV/Excel Processing You might wonder: **"Why not process all Excel and CSV files automatically?"** The answer is simple: **context is everything**. A spreadsheet without context is just raw data. Is that column "Amount" in euros or dollars? Does "Status" mean order status, project status, or employee status? Which rows are headers, which are totals, and which contain the actual data you need? **Generic automated processing often produces garbage**. Instead, we take a smarter approach: - **Understand your business first** – We learn how your organization structures data - **Design targeted rules** – Custom processing that knows what each column means and how to handle edge cases - **Deliver quality insights** – Your team gets meaningful, actionable information, not just parsed cells **Garbage in, garbage out.** By investing a small amount of time upfront to understand your specific context, we ensure ATG delivers high-quality knowledge that your team can actually use. ### Ready to Get Started? Custom file handling is **available as a bespoke development** tailored to your organization's needs. **Reach out to your ATG contact** to discuss your specific use case and explore how we can optimize ATG for your workflows. --- # Tools and MCP URL: https://www.askthisguy.com/en/doc/admin-console/tools-management/ Language: en Section: Documentation The **Tools and MCP** section lists the tools built into ATG and lets you connect external systems through the Model Context Protocol (MCP), including the **MCP catalog** to add third-party services quickly. In the console, open **Tools and MCP**, then the **MCP Servers** tab to manage your connections or browse the catalog. Tools are enabled agent by agent: each agent's **Tools** tab determines which built-in, custom, and MCP tools can be used in its conversations. See [Agents](https://www.askthisguy.com/doc/admin-console/how-to-configure-the-agents). ## In this section - **[Tools](https://www.askthisguy.com/doc/admin-console/tools-management/chat-tools)** - The built-in tools every organization gets: knowledge search, web browsing, file generation, email, press review. - **[MCP servers](https://www.askthisguy.com/doc/admin-console/tools-management/mcp-servers)** - Add and configure MCP endpoints (URL, authentication, transport, tool filters). - **[MCP catalog](https://www.askthisguy.com/doc/admin-console/tools-management/mcp-catalog)** - Discover pre-integrated third-party MCP services and add them to your organization, including open-access offerings and providers that require an API key. --- # ATG WordPress plugin URL: https://www.askthisguy.com/en/doc/atg-embedded/install-on-wordpress-with-the-atg-plugin/ Language: en Section: Documentation ## Overview The ATG plugin lets you activate a chat agent on your WordPress site and configure it in a few clicks: choose the widget shape, where it appears, its branding, scope which pages it shows on, and more. Optionally, you can also secure chat sessions so they are only accessible to authenticated users on your site. ## Prerequisites - **A WordPress site** running WordPress 6.0 or later, PHP 7.4 or later. For signed mode, the PHP `openssl` extension must be enabled (it is on virtually every production host). - **A Widget agent UUID.** Create an ATG agent and choose the **Widget** type. The type cannot be changed after creation. See [Configure Agents](https://www.askthisguy.com/doc/admin-console/how-to-configure-the-agents). The UUID is available in the agent's Embed Code tab. - **Your WordPress site domains.** In the ATG admin console, add your site domains (e.g. `https://yoursite.com`, `https://staging.yoursite.com`) to the agent's allow-listed origins. The chat will only work on those domains. ## Step 1: Download and install the plugin Download the plugin ZIP: [atg-chat-widget.zip](https://www.askthisguy.com/downloads/atg-chat-widget.zip) Then install it like any other WordPress plugin: 1. In your WordPress admin, go to **Plugins → Add New → Upload Plugin**. 2. Choose the `atg-chat-widget.zip` file you just downloaded and click **Install Now**. 3. Click **Activate Plugin**. A new **Settings → Ask This Guy Chat** menu appears. ## Step 2: Paste your agent UUID 1. Go to **Settings → Ask This Guy Chat**. 2. Paste your agent UUID into the **Agent UUID** field. 3. Click **Save Changes**. Visit your site front-end; the chat launcher should appear in the bottom-right corner. ![Ask This Guy Chat plugin settings page in the WordPress admin](https://www.askthisguy.com/doc/wordpress-plugin-settings.webp) ## Step 3: Configure display options On the same settings page, you can refine where and how the widget appears:
Setting What it controls
Launcher position Bottom-right (default), bottom-left, floating, or hidden. Hidden loads the widget without a launcher button so you can wire up your own trigger via the window.ATG JS API.
Display mode Bubble (default): compact panel, expandable to a centered modal. Drawer: full-height panel anchored right.
Language Auto-detect from the WordPress site locale, or force English / French.
Show on Site-wide, restricted to selected post types, or everywhere except a list of URL paths.
Accessibility label Override the launcher button's aria-label.
Theme overrides Brand color, corner radius, font family, shadow. The full default theme JSON is shown as a reference you can paste-and-edit.
## Step 4 (optional): Enable signed mode to restrict chat sessions to authenticated users This mode guarantees that the whole chat session is signed with a private/public key system. The widget signs a short-lived JWT so the chat is tied to a logged-in user. Anonymous visitors get no widget at all when signed mode is on, and any session is refused. > **Privacy notice.** Signed mode sends the WordPress user ID, roles, login, display name, and email to Ask This Guy. You should disclose this in your site's privacy policy before enabling it. The plugin's `readme.txt` includes a suggested clause you can copy. To enable it: 1. On the settings page, go to the **Signed mode (advanced)** section. 2. Tick **A JWT token will be signed with your private key to grant chat access to authenticated users**. 3. Click **Save Changes**. The plugin generates a private/public keypair. 4. Copy the **public key** displayed below the toggle, along with the `kid` shown next to it. 5. In your ATG admin console, under your agent's **Signed parameters**, register that public key with this `kid`. The private key never leaves your WordPress install. It lives in the standard `wp_options` table on your own database. ### Rotating the signing key Rotation happens in two phases, so the active key keeps signing while you register the new one in the ATG console. No chats break. In **Settings → Ask This Guy Chat → Rotate signing key**: 1. Click **Stage new key**. A new keypair is generated and a new `kid` is shown, but the active key keeps signing chats. 2. Copy the **new public key** and register it in your ATG console, alongside the active key (don't remove the old one yet). 3. Click **Validate the new key**. The plugin now signs new JWTs with the new `kid`. You can then remove the old key from your ATG console. If needed, **Discard new key** cancels the staged key: the active key keeps signing as before. --- # Tailored Tools URL: https://www.askthisguy.com/en/doc/customizing-atg-to-you/tailored-tools/ Language: en Section: Documentation ## Query Your Enterprise Tools Beyond documents and knowledge bases, ATG can **call your enterprise systems** so that the assistant can answer questions using live data from your CRM, internal tools, or other APIs. ### The idea We can develop **custom tools** that the ATG **orchestrator agent (AI)** can invoke when needed. These tools talk to **your APIs**: for example your CRM, ticketing system, HR tools, or any other service your organization uses. The agent decides when to use each tool, sends the right parameters, and uses the results to answer the user in natural language. ### Typical use cases - **CRM** – “What’s the status of opportunity X?” or “List open deals for region Y.” - **Internal apps** – Check inventory, orders, or project status from your own systems. - **HR / directory** – Who does what, who to contact for a given topic. - **Reporting** – Pull figures or summaries from business tools instead of static documents. This turns the assistant into a **single entry point** for both your knowledge and your operational data. ### Ownership As with other custom developments for your instance, **the client-specific source code** (the tool implementation for your APIs) **remains your property**. ATG delivers and maintains it for you, but you own the code. **Reach out to your ATG contact** to discuss which of your systems could be exposed as tools and how. --- # Tools URL: https://www.askthisguy.com/en/doc/admin-console/tools-management/chat-tools/ Language: en Section: Documentation **Tools** are the capabilities built into ATG that an agent can call during a conversation: searching your knowledge base, browsing the web, producing an Office file, sending you an email, and more. Every organization starts from the same catalog, without any development work. ## How a tool becomes usable 1. **Organization level.** Open **Tools and MCP** in the admin console to see the catalog. Most tools are active for new organizations; a few are opt-in and must be turned on explicitly. 2. **Agent level.** Each agent's **Tools** tab decides which of those tools it may use. See [Agents](https://www.askthisguy.com/doc/admin-console/how-to-configure-the-agents). 3. **Conversation.** The agent picks the right tool by itself, based on the request and its instructions. Users cannot enable a tool from the chat: if the agent does not have it, the capability is simply unavailable. In the tables below, **Widget** tells you whether the tool works for [widget agents](https://www.askthisguy.com/doc/atg-embedded/how-to-integrate-atg-embedded-in-your-webapp) embedded on a public website. Tools marked **No** run only in authenticated webapp conversations, because they write to a signed-in user's files or mailbox. ## Knowledge and documents These tools work together: one searches the content, another locates a specific file, a third reads it in full, and the last one answers inventory questions about the library itself.
ToolWhat it doesWidgetActive by default
Knowledge base searchSearches the meaning of your indexed [documents](https://www.askthisguy.com/doc/admin-console/knowledge-management) and returns the relevant passages.YesYes
Find relevant documentsIdentifies which documents match a description, when the user is looking for a file rather than an answer.YesYes
Get document contentReads a document in full, once it has been identified, including files the user uploaded themselves.YesYes
Query document catalogAnswers questions about the library itself: how many documents, which folders, which source, what status.Yes**No**
Organization contextRetrieves the free-text description of your organization set in [Organization settings](https://www.askthisguy.com/doc/admin-console/organization-settings).YesYes
**Query document catalog is opt-in.** Enable it when your users ask counting or inventory questions ("how many contracts are indexed?", "list the subfolders of this Drive"). Search alone cannot answer those reliably, because it looks at content rather than at the catalog. All of these tools respect the knowledge categories granted to the agent. A user never sees a document their agent is not allowed to read. ## Web content
ToolWhat it doesWidgetActive by default
Web searchSearches the public web for recent information that your documents and the model do not cover.YesYes
Fetch web page contentReads the pages behind the URLs given by the user, or behind a link found in your knowledge base.YesYes
Assign these two only to agents where consulting external sources is acceptable. ## Files and visuals These tools produce a downloadable file, saved in the user's personal files. They are therefore reserved for the webapp.
ToolWhat it doesWidgetActive by default
Generate Word documentTurns a written answer into a `.docx` file, with its headings and lists.NoYes
Generate PowerPoint presentationBuilds a `.pptx` deck, one slide per main heading.NoYes
Generate spreadsheetExports structured data as a CSV or Excel file.NoYes
Generate imageCreates or modifies an illustration from a text description.NoYes
Image generation is meant for illustrations, not for charts. Figures produced from your data are rendered directly in the conversation, with no tool call required. ## Communication
ToolWhat it doesWidgetActive by default
Email meSends the current user an email containing content produced in the conversation.NoYes
The recipient is always the address on the signed-in user's profile. The agent never chooses who receives the message, and cannot send anything to a third party. Administrators can adjust the email colors from **Tools and MCP**. ## Monitoring and specialized data
ToolWhat it doesWidgetActive by default
Press reviewProduces a news digest following the brief defined in [Press review](https://www.askthisguy.com/doc/admin-console/organization-settings/press-review).YesYes
BDNB building databaseQueries the French national building database (BDNB) for public data about a building or a plot.Yes**No**
BDNB serves a specific business need, mainly real estate and energy renovation. Enable it only for the agents concerned. ## Salesforce Salesforce can be connected to ATG through an integration tailored to your instance. Because its data model is often customized, a light integration and configuration phase will be necessary to identify the relevant objects, fields, relationships, and business rules. The tool can then use Salesforce data with the right context. ## Going further Built-in tools cover the most common needs. Two options extend them: - **[MCP servers](https://www.askthisguy.com/doc/admin-console/tools-management/mcp-servers)** and the **[MCP catalog](https://www.askthisguy.com/doc/admin-console/tools-management/mcp-catalog)** connect third-party services through a standard protocol. - **[Tailored tools](https://www.askthisguy.com/doc/customizing-atg-to-you/tailored-tools)** call your own systems (CRM, ticketing, internal APIs) when no standard tool fits. --- # MCP servers URL: https://www.askthisguy.com/en/doc/admin-console/tools-management/mcp-servers/ Language: en Section: Documentation The **MCP Servers** screen is the place to connect AI agents to external tools and data stores through a **standard protocol** (Model Context Protocol), instead of building a separate integration for every product. In the admin console, open **Tools and MCP**, then the **MCP Servers** tab. You can manage servers you added manually or through the [MCP catalog](https://www.askthisguy.com/doc/admin-console/tools-management/mcp-catalog). The list of configured MCP servers appears in this view. ![MCP Servers list under Tools and MCP](https://www.askthisguy.com/doc/mcp-01-en.webp) ## Role and behavior MCP acts as a bridge between the AI and your systems. Rather than custom code per application, the protocol lets the AI discover what a remote MCP server can do and call it when needed. - **Centralized management** - Third-party systems (SaaS apps, internal databases, business APIs) are configured and supervised from one admin interface. - **On-demand use** - The model interprets the user's request and invokes the right MCP server only when it needs information or actions it cannot satisfy from built-in tools or internal knowledge alone. ## Adding and configuring a server Click **+ MCP Server** to create a server. A dialog opens where you enter the settings below. ![Add MCP Server configuration dialog](https://www.askthisguy.com/doc/mcp-02-en.webp) Connecting an MCP server is designed to be manageable without deep development expertise: - **Server Name** - Give the server a clear label so administrators can see which data source or integration it represents. - **Server URL** - Enter the MCP **base URL**. You can type it **with or without a trailing slash**, depending on what the MCP provider documents; what matters is that the combined URL matches the endpoint they expect. - **Authentication Method** - Choose how credentials are sent when connecting to the server. - **None** - Connect without credentials when the MCP endpoint allows unauthenticated access. - **Bearer token** - Provide a secret in the configuration; it is sent as a **Bearer** token in the request headers (not in the URL path). - **API key in URL path** - Provide a secret that is sent as the **last segment of the path** after the base URL (for example `…/your-base-url/`). No Bearer header is used. Choose this when the MCP or upstream API requires a key in the path, which is common for some legal databases, registries, or other providers that document URL-based keys. Credentials are **stored securely**. When you **edit** an existing server, **leave the secret field empty** to keep the current saved value; enter a new value only when you want to rotate or replace it. - **Transport Type** - Choose how the client talks to the server. - **HTTP Streaming** - Recommended default for most MCP deployments. - **SSE** (Server-Sent Events) - Use when the remote server is built for SSE instead of HTTP Streaming; match the option to the provider's documentation. In practice: prefer **HTTP Streaming** unless the MCP host explicitly requires **SSE**. ## Discovering and selecting tools After the connection details are set, use **Test connection** so the product can reach the MCP server and **list the tools** it exposes. Then configure **which tools are available**: - Choose a **filter mode**: offer **all** discovered tools, **include only** the tools you select, or **exclude** specific tools from the list. - Use the **checkboxes** next to each tool to define what is included or excluded, depending on the mode you chose. You can mark the server **inactive** (or turn it **off**) when you want to stop exposing it in chat without deleting its configuration; set it **active** again when you are ready. Adjust these choices at any time as your integrations evolve. ## Combined analysis across sources The value of MCP grows when it works alongside your other context: - **Multiple sources** - The AI can combine an MCP server (for specialized or live data), the internal knowledge base (for company context), and the web (for current events), according to what each query needs. - **Synthesized answers** - Results from MCP are merged into a coherent reply rather than a raw dump of tool output. In short, **MCP Servers** turns the assistant into an orchestrator that can reach data where it lives, while you retain full control over which external tools are exposed. --- # MCP catalog URL: https://www.askthisguy.com/en/doc/admin-console/tools-management/mcp-catalog/ Language: en Section: Documentation The **MCP catalog** helps you add third-party MCP services to your organization without assembling every connection detail from scratch. In **Tools and MCP**, open the **MCP Servers** tab, then choose **Browse Catalog** (as opposed to **My Servers**, which lists what you already configured). ![MCP catalog: Browse Catalog view with integration cards](https://www.askthisguy.com/doc/mcp-catalog-01-en.webp) Each card summarizes a service (description, category tags such as France or Legal, and a link to the provider’s documentation). Use **+ Add** to start adding a catalog entry to your organization. When a service is already connected, the card can show **Configured** instead. ## Open access and API keys Catalog entries fall into two broad patterns: - **Open or public access** - Some endpoints do not require you to register with the third party or paste a secret; the product can mark them as ready to use once added (for example open government data sources such as **datagouv**). - **Provider account and key** - Others expect you to sign up on the provider’s site, generate an API token, and paste it in the admin console. The token is stored securely and sent according to the service (often as a **Bearer** token). Always check the provider’s documentation linked from the card for pricing, quotas, and terms. ## Add to organization When you add a service that needs credentials, a dialog such as **Add to Organization** collects the server label, **Server URL** (often prefilled from the catalog), **Authentication** (for example **Bearer Token**), and the **API Token** field. Use **Test & Add** to verify the connection before saving. ![Add to Organization: example with Bearer token and Test & Add](https://www.askthisguy.com/doc/mcp-catalog-02-en.webp) After a successful add, the server appears under **My Servers** and follows the same lifecycle as any other MCP server (tool selection, active/inactive, edits). See [MCP servers](https://www.askthisguy.com/doc/admin-console/tools-management/mcp-servers) for connection options and tool filtering. ## Featured integrations ### Normi - DVF and French real estate **Normi** exposes cleaned French property transaction data (DVF), DPE (energy performance) cross-references and market analytics through more than 25 MCP tools: comparables, trends, neighborhood comparisons, and more. Create an account on Normi's site, get the API token and activate it in ATG through the MCP catalog. --- # Agents URL: https://www.askthisguy.com/en/doc/admin-console/how-to-configure-the-agents/ Language: en Section: Documentation Every ATG conversation uses an **agent**. An agent defines the instructions, knowledge, and tools available during the conversation. ATG supports two agent types: - **Webapp**: used by authenticated members of your organization in the ATG webapp. - **Widget**: embedded in a website, SaaS product, or application. The two types share the same configuration area and core settings, but each type also has dedicated tabs. **The agent type is permanent.** Choose Webapp or Widget when creating the agent. To change the deployment type later, create another agent. ## Create an agent In the Admin Console, open **Agents**, then create an agent with: - **Agent name**: a clear name that helps administrators and users identify its role. - **Description**: a short explanation of its purpose. - **Specific instructions**: the role, objectives, tone, response rules, and boundaries of the agent. - **Agent type**: Webapp or Widget. ![Create an ATG agent and choose between Webapp and Widget](https://www.askthisguy.com/doc/agents-create-type-en.webp) The selected type determines which dedicated settings become available after creation. ## Compare Webapp and Widget agents
SettingWebappWidget
ConfigurationYesYes
KnowledgeYesYes
ToolsYesYes
PlaygroundYesYes
Access to internal usersYesNo
Source visibilityNoYes
JWT security and allowed originsNoYes
Embed code and agent UUIDNoYes
## Configure the shared settings Select an agent to open its settings. The **Configuration**, **Knowledge**, and **Tools** tabs, as well as the Playground, are available for both agent types. ### Configuration Use the Configuration tab to update: - the agent name and description; - its specific instructions; - its AI policy; - its active or inactive status. Instructions are the main behavioral setting. State what the agent should do, what it should avoid, how it should guide users, and which tone it should use. ![Configuration tab for a Webapp agent with the Playground](https://www.askthisguy.com/doc/agents-webapp-configuration-en.webp) ### Knowledge Select the knowledge categories the agent can search. Categories group the sources required for a role or use case. Knowledge categories are assigned to **agents, not users**. A user who can access an agent can use the knowledge categories configured for that agent. See [Knowledge](https://www.askthisguy.com/doc/admin-console/knowledge-management) for the complete access model. Limit each agent to the categories it genuinely needs. A focused knowledge scope usually produces more relevant answers and makes access easier to manage. ### Tools Select every tool the agent is allowed to use, such as knowledge base search, web search, document retrieval, image generation, or custom tools. The agent configuration **fully determines the tools available in a conversation**. Users cannot enable additional tools from the webapp. If a tool is not enabled for the selected agent, the agent cannot use it. ![Tools enabled for a Webapp agent in the Admin Console](https://www.askthisguy.com/doc/agents-webapp-tools-en.webp) See [Tools](https://www.askthisguy.com/doc/admin-console/tools-management/chat-tools) for what each built-in tool does, and [Tools and MCP](https://www.askthisguy.com/doc/admin-console/tools-management) for MCP servers and custom tools. ### Playground The Playground appears beside the settings. Use it to test the agent after changing its instructions, knowledge, or tools. Reset the test conversation when you need to validate a change from a clean context. ## Configure a Webapp agent Webapp agents add an **Access** tab. ### Control who can use the agent Choose one of these access modes: - **Open to all**: every user in the organization can see and use the agent. - **Restricted**: only selected users can see and use the agent. ![Access tab for a Webapp agent with open and restricted modes](https://www.askthisguy.com/doc/agents-webapp-access-en.webp) Only active Webapp agents available to a user appear in that user's agent selector. Access can be managed from the agent or from the user's profile. See [Users](https://www.askthisguy.com/doc/admin-console/users-management). The workspace initially includes a default internal agent. It can be reconfigured, restricted, or deleted. To start a webapp conversation, a user must have access to at least one active Webapp agent. ## Configure a Widget agent Widget agents add the **Sources**, **Security**, and **Embed Code** tabs. ### Source visibility The Sources tab controls how references appear to widget users: - show or hide document and web sources by default; - override visibility for individual sources; - configure URL conversion for supported web sources. ![Source visibility settings for a Widget agent](https://www.askthisguy.com/doc/agents-sources-tab.webp) ### Personalized greetings Widget greetings can use values from the signed session JWT. Any value in `context_metadata` is available as a `{{placeholder}}`. Two forms are supported: - `{{first_name}}`: replaced by `first_name`, or by an empty value when the key is missing. - `{{first_name|there}}`: replaced by `first_name`, or by the fallback `there` when the key is missing or empty. For example: > `Hi {{first_name|there}}, how can I help you today?` Key names are matched without considering case or underscores. `firstName`, `first_name`, and `FirstName` all match `{{first_name}}`. ### Security Use the Security tab to: - require a signed JWT for each chat session; - configure the origins allowed to embed the widget; - manage public keys used for JWT verification. ![Modern Security tab with allowed domains and JWT keys for a Widget agent](https://www.askthisguy.com/doc/agents-widget-security-en.webp) ### Embed code The Embed Code tab provides: - the unique agent UUID; - JavaScript integration examples with or without JWT authentication; - the information required to load and configure the widget. See [Integrate the ATG widget in your webapp](https://www.askthisguy.com/doc/atg-embedded/how-to-integrate-atg-embedded-in-your-webapp) for the complete integration process. ## Manage the agent lifecycle - **Deactivate** an agent to remove it from use without deleting its configuration. - **Delete** an agent that is no longer needed. - **Create a new agent** when you need another deployment type, since the Webapp or Widget type cannot be changed after creation. - **Test changes** in the Playground before making the agent available to users. --- # Database Query URL: https://www.askthisguy.com/en/doc/customizing-atg-to-you/database-query/ Language: en Section: Documentation ## Business value Many questions your teams ask are about **structured data**: sales figures, inventory, project status, or any other information stored in a database. Writing SQL or waiting for a report is slow—and for many users, **SQL is simply out of reach** (too technical). Asking in **plain language** is faster and **accessible to everyone** who needs the answer. **Database Query** lets users phrase questions naturally and get answers from your data, without writing a single query. Another common pain point is **combining information that lives in different places**: several SQL databases or schemas, **structured tables** alongside **unstructured knowledge** (documents, wikis, chat), or operational data vs. narrative context. The **orchestrator agent** can use the Database Query tool **together with other tools and knowledge sources** (e.g. [Tailored Tools](https://www.askthisguy.com/doc/customizing-atg-to-you/tailored-tools), organization documents) so one conversation can cross those boundaries instead of forcing users to jump between systems. ATG can generate and run **SQL** against **your own database** or a **database hosted and managed for you** (for example a dedicated PostgreSQL schema). The assistant exposes this as a **tool** to the orchestrator agent: when a question is about this data, the agent calls the tool, which turns the question into SQL, runs it, and returns an interpreted result. ## How it can be deployed A typical setup is: - A **dedicated client database** (e.g. a **dedicated PostgreSQL schema** – an isolated set of tables in the same database). This keeps your data separate and manageable. - A **dedicated Database Query tool** exposed to the **orchestrator agent (AI)**. The agent sees this tool among the others it can use and decides when to call it. The tool is driven by **three configuration texts**: 1. **Tool description** – Shown to the orchestrator agent so it knows **when and how** to call the tool (e.g. what kinds of questions it can answer). 2. **SQL generation instructions** – A description of the schema (tables, columns, business context) used by a **dedicated SQL-generation AI** to produce the SQL from the user’s natural-language question. 3. **Result interpretation** – A short text that is sent back to the orchestrator together with the query result, so it can interpret the data correctly (column meanings, units, business context). The tool allows **read-only** access: only **SELECT** queries are permitted. No data is modified. **Scope of the schema** – The full schema does not need to be exposed to the AI. Prefer **well-documented tables or views** that are clear and useful for business questions. That way the SQL-generation AI works on a controlled, readable scope. ## End-to-end flow ```mermaid sequenceDiagram participant U as User participant A as Workflow manager (ATG) participant O as Main AI (AI) participant T as Database Query tool (ATG) participant S as SQL-generation (AI) participant B as Database (Customer or ATG managed) U->>A: Message A->>O: Dialogue Turn (context + message + tool definitions) O->>A: Tool call (natural-language question) A->>T: Tool call T->>S: Ask for SQL query (question + instructions) S->>T: SQL query T->>B: Execute SQL query B->>T: Result T->>A: Result + explanation A->>O: Dialogue Turn (context + message + tool result) O->>A: Response for the user A->>U: Reply ```

The diagram follows one question end to end: the main AI decides to call the Database Query tool by phrasing a natural-language question, a dedicated AI turns that question into SQL, and the tool runs the read-only query before returning the result along with its explanation. Several dialogue turns are possible, and the Database Query tool is only one tool among others.

**[Book a demo](https://www.askthisguy.com/demo)** to discuss connecting your database or setting up a managed one for this capability. --- # Configure voice mode URL: https://www.askthisguy.com/en/doc/admin-console/voice-mode/ Language: en Section: Documentation Voice mode is configured separately for each agent. When enabled, it turns the agent into an AI voice assistant: users dictate their messages and hear its responses in the authenticated ATG webapp. **Scope:** the behavior documented here has been verified in the main authenticated webapp. Do not assume that voice mode is available in the embedded widget or shared conversations. ## Enable voice mode 1. In the Admin Console, open **Agents**. 2. Select the agent you want to configure. 3. Open the **Configuration** tab. 4. Turn on **Enable voice mode**. 5. Review the speech-to-text provider, text-to-speech provider, and voice. Voice mode settings in the Configuration tab of an ATG agent Once the agent is active and available to a user, a **Speak** microphone button appears in the webapp message field. ## Choose the voice services The exact providers and voices available depend on the services configured in your environment. - **Speech-to-text provider:** transcribes the user's recording into editable text. - **Text-to-speech provider:** turns the agent's completed response into audio. - **Voice:** selects the voice used to read responses. The **Default** option uses the default service available on the platform. When selecting a specific voice, check that its language suits the agent's intended audience. ## What enabling voice mode changes For users of the configured agent: - a microphone button becomes available in new and existing conversations; - each recording is transcribed and prepared for automatic sending; - a response to a dictated message is read aloud automatically; - any completed response can also be played on demand. Voice mode supplements the written chat. It does not disable typing, attachments, response modes, or other chat features, and it does not create a continuous real-time voice call. ## Voice mode, voice chatbot, or voicebot? Voice mode covers a specific need. Before rolling it out, check that it matches the expected use case. - **ATG voice mode:** dictated messages and spoken responses, agent by agent, in the authenticated webapp. It is an internal AI voice agent backed by your knowledge and your tools. - **Voice chatbot on a public website:** the [ATG Embedded](https://www.askthisguy.com/doc/atg-embedded) widget is not covered by this page. Do not assume that voice is available there. For website conversational agents, see the [Website chatbot](https://www.askthisguy.com/solutions/website-chatbot/) page. - **Voicebot or phone callbot:** out of scope. Voice mode does not place phone calls and does not hold a continuous real-time audio conversation. ## Validate the configuration Test the feature with a user account that can access the agent: 1. Confirm that **Speak** appears for the agent. 2. Allow microphone access and record a short question. 3. Check the transcription and the two-second automatic-send countdown. 4. Cancel the countdown and confirm that the text remains editable. 5. Send a voice message and confirm that the completed response is read aloud. 6. Stop playback, then use **Read aloud** on a previous response. Also test the experience in the browsers supported by your organization. Browser microphone permissions and autoplay policies can affect recording and playback. ## Current constraints - Each recording is limited to 60 seconds. - Transcription and speech synthesis require a network connection. - Users cannot choose a provider or voice from the chat, and voice preferences are not stored per user. - Speaking does not automatically interrupt audio already playing. - Provider availability can vary between environments. Do not make assumptions about how long audio clips are retained. Confirm your organization's privacy requirements and the policies of the configured voice providers before rollout. Share [Use voice mode](https://www.askthisguy.com/doc/webapp/using-voice-mode) with your users for operating instructions and troubleshooting. --- # Tags & Alerts URL: https://www.askthisguy.com/en/doc/admin-console/tags-alerts/ Language: en Section: Documentation **Tags & Alerts** is where you define rules that automatically **tag** conversations and optionally **send email notifications** when a conversation matches a condition you describe in plain language—not a fixed list of keywords. ## List and filters The main view shows your tags in a table. Use the **agent** dropdown at the top to manage rules **for a specific assistant** (each tag is scoped to one agent). ![Tags & Alerts overview: list of tags, agent filter, and New Tag](https://www.askthisguy.com/doc/tags-alerts-01-en.webp) ### Table columns - **Tag** — The label applied to matching conversations (and used in analytics elsewhere). - **Condition** — A short description of when the tag applies; the full wording is edited in the side panel. - **Email** — How many email notification targets are configured for this tag. - **Active** — Enable or disable the rule without deleting it. - **Actions** — Edit or delete the tag. ## Creating or editing a tag Choose **+ New Tag** or open an existing row. A **side panel** opens for the tag definition. ![Edit tag: label, condition, agent, tagging toggle, email alert toggle](https://www.askthisguy.com/doc/tags-alerts-02-en.webp) ### Required fields - **Tag label** — Clear name for the tag (for example “Purchase intent” or “Wants to cancel”). - **Condition** — Describe in **natural language** what should count as a match (for example interest in a higher plan, request for a quote, or churn risk). The system evaluates **conversation context**; you can phrase the rule the way your team thinks about the scenario. - **Agent** — The chatbot this rule applies to. ### Analyze conversations Turn **Tag conversations that match this condition** on to apply this tag when the condition matches. ### Email notifications Turn **Send an email when this condition matches a conversation** on to notify one or more addresses when a match occurs. Add the recipient email(s) in the field provided. Save your changes with the action at the bottom of the panel. ## Using tags with Insights Tagged conversations feed into **Insights** (for example breakdowns by tag). Define stable tags here, then review volume and trends in [Insights](https://www.askthisguy.com/doc/admin-console/insights). --- # Agent evaluation URL: https://www.askthisguy.com/en/doc/admin-console/agent-evaluation/ Language: en Section: Documentation ## What is Agent Evaluation? **Agent Evaluation** helps you test how your agent responds to a large set of questions. **Use it for:** - Quality assurance before launching your agent - Identifying areas where your agent needs improvement - Regression testing after making changes to your knowledge base - Benchmarking agent performance over time ![Agent Evaluation Interface](https://www.askthisguy.com/doc/documentation-for-administrators-admin-console-agent-evaluation-interface-en.webp) ## Getting Started ### 1. Select an Agent Choose which agent you want to evaluate from the **Agent** dropdown at the top of the page. ### 2. Choose Test Language Select the language for your test questions: - **EN** - English - **FR** - French Your set of questions in english and in french are separate and the agent will respond in the same language as the question. ## Adding Questions You can: - type your questions manually - import a file of questions - ask the platform to generate questions for you ### Uploading Questions **Supported formats:** CSV or TXT files 1. Click **Upload Questions** 2. Select a `.csv` or `.txt` file from your computer 3. Questions should be one per line/row 4. For CSV files, use only the first column (delete any extra columns) 5. If your question already exists in your set it will simply not be added so you don't have duplicates **Important notes:** - Maximum 50 questions per test run - If uploading from spreadsheet software (Excel, Numbers), export as CSV first - Files are automatically saved to your question set ### Option B: Generate Questions Let the system automatically generate questions from your agent's knowledge base: 1. Click **Generate Questions** 2. Choose the number of questions (5-50) 3. Select content types to include (documents, files, web sources) 4. Review the generated questions 5. Select which ones to keep and click **Add Selected** To give you a complete picture of your agent's performance, the evaluation feature generates a mix of relevant and off-topic questions. This helps you see how well your agent handles queries that fall outside its intended scope. **Time Saver:** Generate questions automatically to get started quickly, then refine your test set based on real-world usage patterns. ## Managing Your Question Set Once you have questions loaded, you can: - **Select/deselect** questions using checkboxes (only selected questions will run) - **Edit** question text by clicking on it - **Delete** questions you don't need - **Add** new questions manually using the "+ Add Question" button ### Download Questions Export your questions as a CSV file using the **Download Questions** button. Useful for: - Backing up your question set - Sharing with team members - Editing in bulk using a spreadsheet ## Running Tests ### Start a Test 1. Ensure you have questions selected (checkboxes checked) 2. Click the **Run Test** button 3. Watch real-time progress as each question is answered 4. Results appear one by one as they complete **Maximum:** 50 questions per run You can only run one evaluation at a time for a specific agent across your organisation. ### During Test Execution You'll see: - **Progress bar** showing completion status - **Live results** appearing as each question finishes - **Execution time** for each response - **Success/failure** indicators ### Stop a Running Test If you need to stop a test before completion: 1. Click the **Stop** button in the progress area 2. Wait for the system to safely stop processing 3. Partial results will be preserved ## Understanding Results ### For Each Question-Response Pair Click any question to expand and view: **Response Details:** - Full agent response (with markdown formatting) - Execution time (how long it took to generate) - Tools used (search, document retrieval, etc.) - Sources cited (documents or web pages) **Feedback Options:** - **Thumbs up** - Good response - **Thumbs down** - Problematic response (add details about why) ### Feedback Details When you mark a response as negative, you can add specific notes: - What was wrong with the response - What you expected instead - Any patterns you notice This feedback helps you identify: - Knowledge gaps in your agent - Questions that need better training data - Common failure patterns ### Export Results Download test results as CSV using the **Download Results** button. The export includes: - Question text - Agent response - Success/failure status - Execution time - Error messages (if any) - Feedback ratings ## History Tab ### View Past Test Runs Switch to the **History** tab to see all previous evaluations: **Run List View:** - Date and time of each run - Status (Completed, Stopped, In Progress, Error) - Total questions tested - Success/failure counts **Run Details View:** 1. Click any run to see detailed results 2. Expand individual question-response pairs 3. Add feedback to past responses 4. Export specific run results as CSV ### Pagination - **Runs list:** 10 runs per page - **Run details:** 50 results per page Use the pagination controls at the bottom to navigate through larger result sets. ## Best Practices ### Creating Effective Question Sets - Cover different topics from your knowledge base - Include edge cases and tricky questions - Mix simple and complex questions - Test common user queries ### Regular Testing Schedule Consider running evaluations: - Before major releases or updates - After adding new content to knowledge base - When users report issues with specific topics - Monthly for quality monitoring **Iterate:** Start with a small set (10-15 questions), refine based on results, then expand. Run the same questions periodically to track improvements over time! ## Troubleshooting ### "Maximum of 50 questions reached" You've selected too many questions. Uncheck some questions or split into multiple test runs. ### "Test already running" Another test is in progress. Wait for it to complete or stop it first. ### File Upload Errors **"Invalid file type"** - Use only `.csv` or `.txt` files - If using spreadsheet software, export as CSV **"Multiple columns detected"** - Delete all columns except the first (questions) column - Or save as plain text (.txt) with one question per line **"No questions found"** - Check that your file isn't empty - Ensure each row contains text ### Cannot See Results If a test is running but you don't see results: 1. Check the **History** tab 2. Look for the in-progress run 3. Click **Reconnect** to resume viewing live results ## Limits and Constraints - **Max questions per run:** 50 - **Max questions stored:** 100 per agent - **File size:** Reasonable CSV/TXT files only - **Concurrent runs:** One test per agent at a time **Remember:** Agent evaluation is an ongoing process, not a one-time task. Regular testing helps you maintain high-quality AI interactions as your knowledge base grows and user needs evolve! --- # Insights URL: https://www.askthisguy.com/en/doc/admin-console/insights/ Language: en Section: Documentation **Insights** is the analytics area of the Admin Console. It helps you understand how assistants are used, how users feel about the experience, and where attention may be needed—using the same filters across metrics and charts. ## Filters At the top of the page you can narrow what the dashboard shows: - **Agents** — Select one or more agents. Only conversations handled by the chosen agents are included. - **Time presets** — Quick ranges: **7 days**, **30 days**, or **90 days**. - **Custom range** — Set a **from** and **to** date to analyze any period you need. - **Comparison period** — The dashboard compares the selected range to the **previous period of the same length** (for example, if you pick a 7-day window, metrics are compared to the 7 days immediately before). The comparison dates are shown next to the filters so you always know what “previous” means. ## Summary metrics The top row summarizes key indicators for the selected period, each with a **change versus the previous period** (percentage or percentage points, depending on the metric): - **Conversations** — Total number of conversations in the range. - **Messages per conversation** — Average number of messages per conversation (a simple proxy for depth of engagement). - **Sentiments** — Share of conversations classified with **positive** and **negative** sentiment (auto-detected by AI). - **Reactions** — Share of conversations where users left a **thumbs up** or **thumbs down** on the assistant’s reply, including change versus the previous period. These cards give you a quick health check before you dive into trends and breakdowns. ## Charts and breakdowns Below the summary, the dashboard visualizes the same period with several views (exact layout may vary as the product evolves): - **Trend over time** — Typically a line chart for **daily conversation volume**, and/or trends that split volume by **sentiment** (for example positive vs. negative) so you can spot spikes or shifts on specific days. - **By tag** — Horizontal charts that show how conversations **relate to tags** (for example volume per tag, or a **positive / neutral / negative** split per tag). Tags reflect how conversations were categorized in your workspace (for example topics such as onboarding or billing). - **By agent** — Similar breakdowns **per agent**, so you can compare workload and sentiment across assistants (for example customer success vs. product specialist). Tooltips on the charts help you read exact counts or percentages. ## How to use Insights - **Operational monitoring** — Watch conversation volume and reactions after a launch, a campaign, or a change in agent instructions. - **Quality and sentiment** — Track sentiment and thumbs up/down over time to see whether users are satisfied and where friction appears. - **Prioritization** — Use tag and agent breakdowns to see which areas drive volume or negative signal, and pair that with configuration or knowledge updates elsewhere in the Admin Console. Insights is read-only: it does not change agents or content; use it to decide **where** to act next. --- # Confluence URL: https://www.askthisguy.com/en/doc/admin-console/knowledge-management/connectors/conf-guides/confluence-conf-guide/ Language: en Section: Documentation **Looking for connector capabilities?** This page provides step-by-step configuration instructions. For an overview of the Confluence connector and its features, visit the [Confluence Connector](https://www.askthisguy.com/doc/admin-console/knowledge-management/connectors/confluence-connector) page. *Approximate time to complete: 5-7 minutes, excluding prerequisite* ## Before you begin To connect your Confluence space(s) to ATG, you will need to follow the steps below: [1. Create API Token on Atlassian Account](https://www.askthisguy.com/doc/admin-console/knowledge-management/connectors/conf-guides/confluence-conf-guide) : An Atlassian Administrator account is required. [2. Setup the Confluence Connector in ATG](https://www.askthisguy.com/doc/admin-console/knowledge-management/connectors/conf-guides/confluence-conf-guide): An ATG Administrator account is required. ## 1. Create API Token on Atlassian Account ### Navigate to your [Atlassian account](https://id.atlassian.com/manage-profile/security/api-tokens) dedicated page ![](https://www.askthisguy.com/doc/confluence-conf-1.webp) ### Click on *Create API token* ![](https://www.askthisguy.com/doc/confluence-conf-2.webp) ### Enter a name for your key ![](https://www.askthisguy.com/doc/confluence-conf-3.webp) ### Enter an expiration date ![](https://www.askthisguy.com/doc/confluence-conf-4.webp) You cannot set an expiration date longer than a year. Note that when the key expires, you will need to generate a new one and update the configuration of your connector. We recommend you add a reminder so you don't forget. ### Click on *Create* ![](https://www.askthisguy.com/doc/confluence-conf-5.webp) ### Copy your key ![](https://www.askthisguy.com/doc/confluence-conf-6.webp) Please save this API token in a secure tool, such as a password manager. If you do not save the token at this stage, it cannot be recovered later. You will need to generate a new one. ### Click on *Done* ![](https://www.askthisguy.com/doc/confluence-conf-7.webp) ![](https://www.askthisguy.com/doc/confluence-conf-8.webp) You see your new token appear in the table ## 2. Setup the Confluence Connector in ATG ### Go back to your ATG Administrator Console ![](https://www.askthisguy.com/doc/confluence-conf-9.webp) Enter the Domain name (e.g. ***yourcompany***.atlassian.net) Enter your email address (the one with wich the API key was created on Atlassian) Enter the API token previously generated Click on “Validate” ### Add one or several Sources from Confluence ### Click on "Add source" ![](https://www.askthisguy.com/doc/confluence-conf-10.webp) ### Select the spaces you want to include in the import ![](https://www.askthisguy.com/doc/confluence-conf-11.webp) ### Click on Next ![](https://www.askthisguy.com/doc/confluence-conf-12.webp) ### Configure the document filters ![](https://www.askthisguy.com/doc/confluence-conf-13.webp) Click on **"Next"** ### Chose your source name and Save configuration ![](https://www.askthisguy.com/doc/confluence-conf-14.webp) ### Check the documents Once all the documents are processed (it can take a few minutes depending on the number of documents to process), they will be listed in the source ![](https://www.askthisguy.com/doc/confluence-conf-15.webp) ## API key modification and update When your token expires, you will need to create a new token and update your Connector setup --- # Confluence Connector URL: https://www.askthisguy.com/en/doc/admin-console/knowledge-management/connectors/confluence-connector/ Language: en Section: Documentation **Looking to set up this connector?** This page provides an overview of the Confluence connector and its capabilities. For step-by-step configuration instructions, visit the [Confluence Conf Guide](https://www.askthisguy.com/doc/admin-console/knowledge-management/connectors/conf-guides/confluence-conf-guide). ## Connect Your Confluence Knowledge Base to ATG The **Confluence Connector** seamlessly syncs your organization's documentation from **Confluence Cloud** into ATG, making your team's collective knowledge instantly accessible through AI-powered search and chat. ### What Gets Synced? The connector can import content from: - **Collaboration Spaces** - Team spaces where your organization creates and shares documentation - **Personal Spaces** - Individual spaces for personal notes and content You maintain **full control** over what gets imported with powerful filtering options. ### Comprehensive Content Processing When syncing Confluence pages, ATG processes **both text and images** within your articles, ensuring complete knowledge capture. This multimodal approach means your AI assistant can understand and reference visual content alongside written documentation. Learn more about how ATG handles images and visual content: [How Documents & Images are Processed by ATG](https://www.askthisguy.com/doc/admin-console/knowledge-management/how-documents-images-are-processed-by-atg) ### Flexible Filtering Options Once connected, you can customize exactly what content ATG imports: - **Select specific Spaces** - Choose which Collaboration or Personal Spaces to sync - **Date filters** - Import only documents updated before a specific date, after a specific date, or between two dates - **Include/Exclude folders and files** - Specify particular folders or files to include or exclude - **Label-based filtering** - Use Confluence [labels](https://support.atlassian.com/confluence-cloud/docs/use-labels-to-organize-your-content/) to include or exclude content based on your organization's taxonomy This ensures ATG only processes the content that's relevant to your team, keeping your knowledge base focused and efficient. ### Automatic Updates After the initial sync, the connector refreshes on the **frequency set for the source**. New sources are set to **Daily**, and an administrator can switch them to Manual, Weekly, or Monthly, or run a refresh on demand, so your AI assistant has access to the latest versions of your documentation. See [Refresh frequency](https://www.askthisguy.com/doc/admin-console/knowledge-management/connectors#refresh-frequency). ### Ready to Get Started? Head over to the [Confluence Conf Guide](https://www.askthisguy.com/doc/admin-console/knowledge-management/connectors/conf-guides/confluence-conf-guide) for detailed setup instructions. --- # Users URL: https://www.askthisguy.com/en/doc/admin-console/users-management/ Language: en Section: Documentation The **Users** area lets administrators invite members, manage administrator privileges, and choose which Webapp agents each person can use. ## Invite and onboard users New users join an ATG organization by administrator invitation. They receive a validation email and complete the onboarding steps to activate their account. After activation, give the user access to the Webapp agents required for their role. A user needs at least one active, accessible Webapp agent to start a conversation. ## Understand the access model ATG separates two types of permission: - **Administrator access**: allows a user to manage users, agents, and organization settings. - **Agent access**: determines which Webapp agents the user can see and select in a new conversation. Knowledge categories are **not assigned to users**. Categories are configured on agents. When a user can access an agent, they can use the knowledge and tools configured for that agent. ## Manage access from a user profile Open a user from the list, then use **Agent Access** to select the agents available to that person. You can select all agents or choose them individually. Assign Webapp agents to a user from the Users area Save the changes when the selection is complete. Only active Webapp agents assigned to the user appear in their agent selector. ## Manage access from an agent You can manage the same relationship from the agent's **Access** tab: - **Open to all** makes the agent available to every user in the organization. - **Restricted** makes the agent available only to selected users. Changes made from a user profile and changes made from an agent update the same access rules. See [Agents](https://www.askthisguy.com/doc/admin-console/how-to-configure-the-agents). ## Administrator privileges Enable **Admin Access** only for people who need to manage the organization. Standard users can use their assigned Webapp agents but cannot change administrative settings. Administrator privileges and agent access are independent. An administrator can still have a limited set of Webapp agents for normal conversations. ## Best practices - **Apply least privilege**: give each user only the agents required for their work. - **Use specialized agents**: separate confidential or role-specific knowledge behind dedicated agents. - **Review access regularly**: remove agents that are no longer relevant to a user's responsibilities. - **Handle onboarding and offboarding promptly**: update agent access when someone joins, changes role, or leaves. - **Limit administrator access**: reserve it for people who manage the workspace. ## Example For an organization with HR, Finance, and Engineering teams: - create a Finance agent with finance knowledge and tools, then restrict it to the Finance team; - create an HR agent with HR knowledge, then restrict it to authorized HR users; - keep a general internal agent open to everyone for company-wide use cases. This model protects specialized knowledge by controlling access to the agents that can use it. --- # Google Drive URL: https://www.askthisguy.com/en/doc/admin-console/knowledge-management/connectors/conf-guides/google-drive-conf-guide/ Language: en Section: Documentation **Looking for connector capabilities?** This page provides step-by-step configuration instructions. For an overview of the Google Drive connector and its features, visit the [Google Drive Connector](https://www.askthisguy.com/doc/admin-console/knowledge-management/connectors/google-drive-connector) page. *Approximate time to complete: 5-10 minutes, excluding prerequisites* ## Before you begin The actions below can only be performed by your GCP Workspace Administrators. Ensure you have access to a GCP Administrator account of your Organization. To connect ATG to Google Drive, you will need to: - [1. Enable the Google Drive API](https://www.askthisguy.com/doc/admin-console/knowledge-management/connectors/conf-guides/google-drive-conf-guide#1-enable-the-google-drive-api): this will allow your GCP Service Account to use Google Drive. - [2. Setup the Service account in your GCP Cloud Console](https://www.askthisguy.com/doc/admin-console/knowledge-management/connectors/conf-guides/google-drive-conf-guide#2-setup-the-service-account-in-your-gcp-cloud-console): this will create a Service Account linked to your Google Drive. - [3. Create keys for the Service account](https://www.askthisguy.com/doc/admin-console/knowledge-management/connectors/conf-guides/google-drive-conf-guide#3-create-keys-for-the-service-account): this will allow you to create a key for your service account, and generate a JSON file you can export to ATG. - [4. Share content to ATG](https://www.askthisguy.com/doc/admin-console/knowledge-management/connectors/conf-guides/google-drive-conf-guide#4-share-content-to-atg): this will allow you to choose which drive(s) and content you authorize ATG to have access to. - [5. Connect Google Drive in ATG](https://www.askthisguy.com/doc/admin-console/knowledge-management/connectors/conf-guides/google-drive-conf-guide#5-connect-google-drive-in-atg): this will allow you to setup the connector and chose which folders will be accessible to ATG users. ## **1. Enable the Google Drive API** ### Navigate to Google Cloud Console Go to [https://console.cloud.google.com/](https://console.cloud.google.com/) ### Go to Enabled APIs & services section Open the navigation menu: ![Google Cloud Console navigation menu](https://www.askthisguy.com/doc/documentation-for-administrators-knowledge-management-how-to-configure-my-connectors-google-drive-conf-guide-image.webp) Select API & Services, then "Enabled APIs & services": ![Google Cloud Console Enabled APIs & services section](https://www.askthisguy.com/doc/documentation-for-administrators-knowledge-management-how-to-configure-my-connectors-google-drive-conf-guide-image-1.webp) ### Select a Project Click on 'Select a project' button: ![Google Cloud Console Select a project button](https://www.askthisguy.com/doc/documentation-for-administrators-knowledge-management-how-to-configure-my-connectors-google-drive-conf-guide-image-2.webp) If no project was previously created, click on ‘Create project’: ![Google Cloud Console Create project button](https://www.askthisguy.com/doc/documentation-for-administrators-knowledge-management-how-to-configure-my-connectors-google-drive-conf-guide-image-3.webp) ### Create your Project (if not done before) Enter a project name, select your organization, and choose a location for your project. Then click on 'Create': ![Google Cloud Console 'Create project' Menu](https://www.askthisguy.com/doc/documentation-for-administrators-knowledge-management-how-to-configure-my-connectors-google-drive-conf-guide-image-4.webp) ### Open "APIs & Services" Click on 'Enabled APIs and services' on the left menu: ![Google Cloud Console 'Enabled APIs and services' Menu](https://www.askthisguy.com/doc/documentation-for-administrators-knowledge-management-how-to-configure-my-connectors-google-drive-conf-guide-image-4.1.webp) ### Enable APIs and services Click on the '+ Enable APIs and services' button: ![Google Cloud Console 'Enable APIs and services' Button](https://www.askthisguy.com/doc/documentation-for-administrators-knowledge-management-how-to-configure-my-connectors-google-drive-conf-guide-image-4.2.webp) ### Search for Google Drive API Type 'google drive' in the search bar and press Enter, select 'google drive api' from the list of results: ![Google Cloud Console 'Google Drive API' Search Result](https://www.askthisguy.com/doc/documentation-for-administrators-knowledge-management-how-to-configure-my-connectors-google-drive-conf-guide-image-4.3.webp) Select Google Drive API: ![Google Cloud Console 'Google Drive API' Selection](https://www.askthisguy.com/doc/documentation-for-administrators-knowledge-management-how-to-configure-my-connectors-google-drive-conf-guide-image-4.4.webp) ### Enable Google Drive API Click on the 'Enable' button to activate the Google Drive API: ![Google Cloud Console 'Google Drive API' Enable Button](https://www.askthisguy.com/doc/documentation-for-administrators-knowledge-management-how-to-configure-my-connectors-google-drive-conf-guide-image-101.webp) ## **2. Setup the Service account in your GCP Cloud Console** ### Navigate to Google Cloud Console Come back to the 'Open API & services' section in the navigation menu and click on "Credentials": ![Google Cloud Console 'Open API & services' Credentials Menu](https://www.askthisguy.com/doc/documentation-for-administrators-knowledge-management-how-to-configure-my-connectors-google-drive-conf-guide-image-6.webp) ### Create Credentials Click on the '+ Create credentials' button: ![Google Cloud Console '+ Create credentials' Button](https://www.askthisguy.com/doc/documentation-for-administrators-knowledge-management-how-to-configure-my-connectors-google-drive-conf-guide-image-7.webp) Select ‘Service account’: ![Google Cloud Console 'Service account' Selection](https://www.askthisguy.com/doc/documentation-for-administrators-knowledge-management-how-to-configure-my-connectors-google-drive-conf-guide-image-100.webp) Create the service account. Enter a Service account name and (optionally) Service account description: ![Google Cloud Console 'Create service account' Menu](https://www.askthisguy.com/doc/documentation-for-administrators-knowledge-management-how-to-configure-my-connectors-google-drive-conf-guide-image-102.webp) Click on 'Create' and continue: ![Google Cloud Console 'Create service account' Menu](https://www.askthisguy.com/doc/documentation-for-administrators-knowledge-management-how-to-configure-my-connectors-google-drive-conf-guide-image-103.webp) Choose the role to grant access to the service account, click ‘Select a role’. ![Google Cloud Console 'Select role' Menu](https://www.askthisguy.com/doc/documentation-for-administrators-knowledge-management-how-to-configure-my-connectors-google-drive-conf-guide-image-104.webp) You can choose 'Viewer' role to grant read-only access to the service account. ![Google Cloud Console 'Select role' Menu](https://www.askthisguy.com/doc/documentation-for-administrators-knowledge-management-how-to-configure-my-connectors-google-drive-conf-guide-image-105.webp) Finish Creating Service account, clicking on 'Done' button. ![Google Cloud Console 'Finish Creating Service account' Button](https://www.askthisguy.com/doc/documentation-for-administrators-knowledge-management-how-to-configure-my-connectors-google-drive-conf-guide-image-106.webp) ## 3. Create keys for the Service account ### Select your Service account Go to the ‘Credentials’ section within the ‘APIs & Services’ menu, and click on the Service account created previously. ![Google Cloud Console 'Select your Service account' Menu](https://www.askthisguy.com/doc/documentation-for-administrators-knowledge-management-how-to-configure-my-connectors-google-drive-conf-guide-image-107.webp) ### Go to Keys Click on ‘Keys’ menu: ![Google Cloud Console 'Keys' Menu](https://www.askthisguy.com/doc/documentation-for-administrators-knowledge-management-how-to-configure-my-connectors-google-drive-conf-guide-image-9.webp) ### Create new key The Key section appears empty because no keys have been created yet. Click on ‘Add key’ and choose ‘Create new key’. ![Google Cloud Console 'Create new key' Button](https://www.askthisguy.com/doc/documentation-for-administrators-knowledge-management-how-to-configure-my-connectors-google-drive-conf-guide-image-108.webp) ### Choose JSON and Create Select the key type JSON and then click on ‘Create’. ![Google Cloud Console 'Choose JSON and Create' Menu](https://www.askthisguy.com/doc/documentation-for-administrators-knowledge-management-how-to-configure-my-connectors-google-drive-conf-guide-image-109.webp) Then **save the JSON key:** ![Google Cloud Console 'Save the JSON key' Button](https://www.askthisguy.com/doc/documentation-for-administrators-knowledge-management-how-to-configure-my-connectors-google-drive-conf-guide-image-110.webp) A message will appear indicating that the key was saved. Click ‘Close’. This key allows to access your Google Drive. **It is secret**. Please don't share it with anyone, and don’t include it in public code repositories. Store them in secure ways following [Google best practices](https://docs.cloud.google.com/iam/docs/best-practices-for-managing-service-account-keys) ### In case you encounter an error message during the key creation If you get the following error message: ![Google Cloud Console Error message'](https://www.askthisguy.com/doc/documentation-for-administrators-knowledge-management-how-to-configure-my-connectors-google-drive-conf-guide-image-10.webp) You will need to update the Organization policies. For this, your account should have the Administrator rights. Go to Organization Policies and search for `iam.disableServiceAccountKeyCreation` and disable it at the project level (or at the organization level if the project inherits the rules from the organizations) ![Google Cloud Console Organization policies](https://www.askthisguy.com/doc/documentation-for-administrators-knowledge-management-how-to-configure-my-connectors-google-drive-conf-guide-image-11.webp) ## 4. Share content to ATG By default, ATG will not have any access to your Google Drive. You will need first to share the content you want to import to ATG. You can now share any Google Drive content you want to ATG: Drives, folders, files, etc. just like you usually do. Generally speaking, as a good security practice, do not share more than what is needed to any external system. Do not worry: the fact that content to ATG does not mean it will give it access to any organization’s user. You can configure the access in ATG directly (see later in the document). First, you have to find the email address associated to your service account, you can find it in the Service account details or in the JSON file you saved earlier. It should look like this: [`atg@master-puppets-493931-f4.iam.gserviceaccount.com`](mailto:atg@master-puppets-493931-f4.iam.gserviceaccount.com) for example. Then you can share any content to this email address (Reader access is enough): ![Share content with the service account in Google Drive — step 2](https://www.askthisguy.com/doc/google-drive-2.webp) ## 5. Connect Google Drive in ATG ### Go the the Connectors Menu in ATG Administrator Console Go to [the Connectors menu](https://app.askthisguy.com/admin/knowledge?tab=connectors): ![Connectors menu in Admin Console](https://www.askthisguy.com/doc/connectors-menu-1-en.webp) Click on 'Add connector', select 'Google Drive': ![Add a connector, select Google Drive](https://www.askthisguy.com/doc/connectors-menu-google-1-en.webp) Upload the JSON file with the credentials, that was previously generated: ![Credentials file upload](https://www.askthisguy.com/doc/connectors-menu-google-2-en.webp) Google Drive connector is now added to ATG: ![Connectors status view in Admin Console](https://www.askthisguy.com/doc/connectors-menu-google-3-en.webp) The Google Drive connector is successfully added to ATG! To add a source, go to [the Sources menu](https://app.askthisguy.com/admin/knowledge?tab=sources), and add a source (Google Drive Connector is now available in the list): ![Source add menu in Admin Console](https://www.askthisguy.com/doc/connectors-menu-google-4-en.webp) --- # Connectors URL: https://www.askthisguy.com/en/doc/admin-console/knowledge-management/connectors/ Language: en Section: Documentation **ATG Connectors** automate the process of importing and keeping your organization's knowledge up to date. Instead of manually uploading files one by one, connectors integrate directly with your existing tools - like **Google Drive**, **Confluence**, or **Slack** - to sync documents automatically. Each connector can be configured with **specific parameters** to control exactly what gets imported (e.g., specific folders, date ranges, or content types). Once set up, connectors can **refresh automatically** or on demand, ensuring your AI assistant always has access to the latest information. **Custom Connectors:** Need to connect to a tool that's not listed below? That's where ATG's real value shines. **We can build custom connectors tailored to your specific needs** - whether it's a proprietary system, a niche platform, or a unique integration requirement. Reach out to discuss your use case. ## Available Connectors Learn about each connector and what it can do: **Cloud Storage** [Google Drive Connector](https://www.askthisguy.com/doc/admin-console/knowledge-management/connectors/google-drive-connector) [SharePoint & OneDrive Connector](https://www.askthisguy.com/doc/admin-console/knowledge-management/connectors/sharepoint-onedrive-connector) [FTP Connector](https://www.askthisguy.com/doc/admin-console/knowledge-management/connectors/ftp-connector) **Documentation & Communication Tools** [Confluence Connector](https://www.askthisguy.com/doc/admin-console/knowledge-management/connectors/confluence-connector) [Notion Connector](https://www.askthisguy.com/doc/admin-console/knowledge-management/connectors/notion-connector) [Slack Connector](https://www.askthisguy.com/doc/admin-console/knowledge-management/connectors/slack-connector) **Files** [File Upload](https://www.askthisguy.com/doc/admin-console/knowledge-management/file-upload) **Web sites** [Web Sites](https://www.askthisguy.com/doc/admin-console/knowledge-management/connectors/web-sites-connector) **Custom Connectors:** Need to integrate with a tool not listed here? We can build custom connectors tailored to your organization's specific needs - whether it's a proprietary system, an internal database, or any other platform your team relies on. Contact us to discuss your requirements. ## Refresh frequency The **refresh frequency** sets how often ATG updates the content imported from a source. It is configured per source, and only organization administrators can change it. At each refresh, ATG detects the files added, modified, and deleted since the previous run, and only reprocesses what is needed. 1. In the Admin Console, open **Knowledge**, then the **Sources** tab. 2. Find the source to configure and select **Edit**. 3. In the **Refresh frequency** field, choose **Manual**, **Daily**, **Weekly**, or **Monthly**. 4. Select **Save Changes**. The Refresh frequency field in the Edit Source panel of the ATG Admin Console The selected frequency appears on the source's row, next to its last processing date. On **Manual**, no automatic refresh runs: use **Refresh** on the source whenever you need an update. On creation, sources using the Google Drive, Confluence, Notion, Slack, SharePoint, and FTP/SFTP connectors are set to **Daily**, and web site sources to **Weekly**. ### What to keep in mind - Saving a new frequency does not restart importing. The new rhythm applies to the next runs of the scheduler. - An automatic refresh can be postponed if the source was processed too recently, or if another job is already running on it. - You cannot pick a specific time, a specific day, or a custom frequency. - A source being updated is shown as **refreshing** in the list. If it fails, read the message attached to the source, then run a manual refresh once the situation is fixed. ## Configuration Guides Step-by-step instructions for setting up each connector in your organization: [Google Drive](https://www.askthisguy.com/doc/admin-console/knowledge-management/connectors/conf-guides/google-drive-conf-guide) [SharePoint & OneDrive](https://www.askthisguy.com/doc/admin-console/knowledge-management/connectors/conf-guides/sharepoint-onedrive-conf-guide) [Confluence](https://www.askthisguy.com/doc/admin-console/knowledge-management/connectors/conf-guides/confluence-conf-guide) [Slack](https://www.askthisguy.com/doc/admin-console/knowledge-management/connectors/conf-guides/slack-conf-guide) [Notion](https://www.askthisguy.com/doc/admin-console/knowledge-management/connectors/conf-guides/notion-conf-guide) --- # Admin Console URL: https://www.askthisguy.com/en/doc/admin-console/ Language: en Section: Documentation The **Admin Console** is your command center for managing your ATG environment! Configure AI agents, organize knowledge, manage tools, and control user access - all in one place. **Customize your organization's ATG experience with ease.** Set up team members, define permissions, connect data sources, and curate AI knowledge using intuitive tools designed for efficiency. ![Admin Console overview](https://www.askthisguy.com/doc/documentation-for-administrators-admin-console-en.webp) Explore the sub-pages below for step-by-step guides on AI policies, data processing, user management, and more. Everything you need to master your administrative superpowers! **Organization** - [Organization](https://www.askthisguy.com/doc/admin-console/organization-settings) **Console menus** - [Knowledge](https://www.askthisguy.com/doc/admin-console/knowledge-management) - [Tools and MCP](https://www.askthisguy.com/doc/admin-console/tools-management) - [Agents](https://www.askthisguy.com/doc/admin-console/how-to-configure-the-agents) - [Tags & Alerts](https://www.askthisguy.com/doc/admin-console/tags-alerts) - [Agent evaluation](https://www.askthisguy.com/doc/admin-console/agent-evaluation) - [Insights](https://www.askthisguy.com/doc/admin-console/insights) - [Users](https://www.askthisguy.com/doc/admin-console/users-management) **Infrastructure & Security** - [Infrastructure & Security](https://www.askthisguy.com/doc/infrastructure-and-security) ## Ready to dive-in? Access the Admin Console at [https://app.askthisguy.com/admin/](https://app.askthisguy.com/admin) and explore the features below! --- # Google Drive Connector URL: https://www.askthisguy.com/en/doc/admin-console/knowledge-management/connectors/google-drive-connector/ Language: en Section: Documentation **Looking to set up this connector?** This page provides an overview of the Google Drive connector and its capabilities. For step-by-step configuration instructions, visit the [Google Drive Conf Guide](https://www.askthisguy.com/doc/admin-console/knowledge-management/connectors/conf-guides/google-drive-conf-guide). ## Connect Your Google Workspace to ATG The **Google Drive Connector** seamlessly syncs your organization's documents from **Google Workspace** (Enterprise) into ATG, making your team's knowledge instantly accessible through AI-powered search and chat. **Note:** This connector works exclusively with **Google Workspace** (formerly G Suite) accounts. Consumer Google Drive accounts are not supported. ### What Gets Synced? The connector can import documents from: - **Shared Drives** - Team drives accessible to your organization - **Shared Folders** - Individual folders shared from collaborators' Google Drives You maintain **full control** over what gets imported with powerful filtering options. ### Flexible Filtering Options Once connected, you can customize exactly what content ATG imports: - **Select specific Drives** - Choose which Shared Drives or folders to sync - **Date filters** - Import only documents updated before a specific date, after a specific date, or between two dates - **Include/Exclude rules** - Specify particular folders or files to include or exclude This ensures ATG only processes the content that's relevant to your team, keeping your knowledge base focused and efficient. ### Automatic Updates After the initial sync, the connector refreshes on the **frequency set for the source**. New sources are set to **Daily**, and an administrator can switch them to Manual, Weekly, or Monthly, or run a refresh on demand, so your AI assistant has access to the latest versions of your documents. See [Refresh frequency](https://www.askthisguy.com/doc/admin-console/knowledge-management/connectors#refresh-frequency). ### Supported File Types The Google Drive connector handles a **comprehensive range** of file formats: **Native Google Workspace files:** - Google Docs - Google Slides - Google Drawings **Standard document formats:** - PDF (.pdf) - Word documents (.docx) - PowerPoint presentations (.pptx) - HTML files (.html) - Markdown (.md) - Plain text (.txt) - Rich Text Format (.rtf) **Images:** - PNG (.png) - JPEG (.jpg) **Custom file types (Excel for example):** - [Tailored Processing](https://www.askthisguy.com/doc/customizing-atg-to-you/tailored-processing) - ATG can be customized to handle your organization's unique file formats with specialized processing rules. ### Ready to Get Started? Head over to the [Google Drive Conf Guide](https://www.askthisguy.com/doc/admin-console/knowledge-management/connectors/conf-guides/google-drive-conf-guide) for detailed setup instructions. --- # File Upload URL: https://www.askthisguy.com/en/doc/admin-console/knowledge-management/file-upload/ Language: en Section: Documentation ## Upload Your Documents Directly to ATG **File Upload** provides the simplest way to get your organization's documents into ATG: just **drag, drop, and done**. Upload files through the Admin Console and assign them to specific knowledge categories. ### Perfect for Quick Knowledge Sharing This is ideal when you need to: - **Make documents available** to agents that use the selected knowledge category - **Add one-off files** without setting up a full integration - **Test content** before connecting larger document repositories - **Upload files** that live outside your cloud storage systems After processing, the files become available to agents that have both the selected category and the Knowledge Base Search tool enabled. Users cannot receive direct access to a knowledge category. ### Supported File Formats File Upload processes a **comprehensive range** of document formats: **Standard formats:** - PDF PDF documents (.pdf) - Plain text Plain text (.txt) - Markdown Markdown (.md) - HTML HTML files (.html) **Office documents:** - Word Word documents (.docx) - PowerPoint PowerPoint presentations (.pptx) All uploaded files are processed with **both text and image extraction**, ensuring complete content capture for your AI assistant. Learn more about how ATG handles images and visual content: [Documents & Images](https://www.askthisguy.com/doc/admin-console/knowledge-management/how-documents-images-are-processed-by-atg) **Custom file types:** - [Tailored Processing](https://www.askthisguy.com/doc/customizing-atg-to-you/tailored-processing) - ATG can be customized to handle your organization's unique file formats with specialized processing rules. ### How to upload files Adding files to ATG is incredibly simple: 1. **Open the Admin Console** and navigate to the **Knowledge** section 2. **Select a knowledge category** where you want to add files 3. **Drag and drop your files** into the interface, or click to browse and select them 4. **Done!** Your files are automatically processed and ready to use No complex configuration or authentication setup is required. ### Automatic Processing Once uploaded, your files are automatically: - **Extracted**: text and images are processed for complete content understanding - **Indexed**: the content becomes searchable in ATG's knowledge base - **Categorized**: the content is organized within your chosen knowledge category After processing, agents that have the selected category and the Knowledge Base Search tool can retrieve the uploaded documents. ### Best Practices - **Organize by category**: upload related documents to the same knowledge category for better context - **Keep files updated**: upload newer versions when your documents change - **Use descriptive filenames**: clear names help users and agents understand document content --- # Notion URL: https://www.askthisguy.com/en/doc/admin-console/knowledge-management/connectors/conf-guides/notion-conf-guide/ Language: en Section: Documentation **Looking for connector capabilities?** This page provides step-by-step configuration instructions. For an overview of the Notion connector and its features, visit the [Notion Connector](https://www.askthisguy.com/doc/admin-console/knowledge-management/connectors/notion-connector) page. *Approximate time to complete: 3-5 minutes* ## Before you begin To connect ATG to Notion, you will need: - A **Notion workspace** where you have permission to create integrations and manage page connections - An **ATG Administrator** account to configure the connector in the [Admin Console](https://app.askthisguy.com/admin/knowledge?tab=connectors) The setup involves four steps: - [1. Create a Notion connection](#1-create-a-notion-connection) - [2. Configure permissions and copy the access token](#2-configure-permissions-and-copy-the-access-token) - [3. Grant access to your Notion content](#3-grant-access-to-your-notion-content) - [4. Connect Notion in ATG](#4-connect-notion-in-atg) ## 1. Create a Notion connection ### Open the Notion Developer portal Go to the [Notion Developer portal](https://www.notion.so/developers/connections) and open the **Connections** page. ![Notion Developer portal, Connections page](https://www.askthisguy.com/doc/notion-01-en.webp) Click **+ New connection** to create a new integration. ### Create the connection In the **New connection** dialog: - Enter a **Connection name** (for example, `Ask This Guy` or `ATG`) - Select **Access token** as the authentication method. This is the workspace-scoped token ATG uses to read your content. - Choose the **workspace** where the connection will be installed ![Notion, New connection dialog](https://www.askthisguy.com/doc/notion-02-en.webp) Click **Create connection**. ## 2. Configure permissions and copy the access token After creation, you are redirected to the connection configuration page. ![Notion, Connection configuration](https://www.askthisguy.com/doc/notion-03-en.webp) Under **Capabilities**, enable the permissions ATG needs:
CapabilityRequired
**Read content**Yes. Allows ATG to import pages and databases.
**Read user information including email addresses**Yes. Allows ATG to attribute content to the right users.
Update contentNo
Insert contentNo
Read / Insert commentsNo
Before saving, copy the **Access token** from the **Integration token** section using the copy button. You will paste this token in ATG later. Store it securely, for example in a password manager. The access token grants read access to any Notion page you explicitly connect to this integration. **It is secret.** Do not share it or commit it to public code repositories. Click **Save connection** to apply your changes. ## 3. Grant access to your Notion content Notion integrations only access pages you explicitly authorize. For each page (or top-level page whose subtree you want to sync), you must add the connection. ### Open page settings Navigate to the Notion page you want to make available to ATG. Click the **⋯** menu in the top-right corner, scroll down to **Connections**, then click **+ Add connection**. ![Notion, Page menu, Connections section](https://www.askthisguy.com/doc/notion-04-en.webp) ### Select your connection In the **Add connection** panel, search for the connection you created (for example, `ATG`), then select it from the results. ![Notion, Add connection search](https://www.askthisguy.com/doc/notion-05-en.webp) ### Confirm access Review the permissions in the confirmation dialog. ATG only needs **read** access. You should see **Can read content** enabled and write/comment permissions disabled. Click **Add to page** to grant access to this page and all its child pages. ![Notion, Confirm connection on page](https://www.askthisguy.com/doc/notion-06-en.webp) Repeat this step for every top-level page or database you want ATG to sync. Child pages inherit access from their parent, so you typically only need to connect the root pages of each space or section you want to import. ## 4. Connect Notion in ATG ### Open the Connectors menu Go to the [Connectors tab](https://app.askthisguy.com/admin/knowledge?tab=connectors) in the ATG Admin Console. Click **Add connector** and select **Notion**. ### Paste your access token Paste the **Access token** you copied from the Notion Developer portal, then click **Validate**. ### Add a source Once the connector is validated, go to the [Sources tab](https://app.askthisguy.com/admin/knowledge?tab=sources) and click **Add source**. Select the **Notion** connector, then configure which spaces and pages to import. You can include or exclude specific content to keep your knowledge base focused. Click **Save** to start the initial sync. Your Notion connection is ready. *Ask This Guy* will now be able to access the pages you authorized and use them as data sources. The connector then refreshes on the frequency set for the source, Daily by default, to pick up the latest changes. --- # Notion Connector URL: https://www.askthisguy.com/en/doc/admin-console/knowledge-management/connectors/notion-connector/ Language: en Section: Documentation **Looking to set up this connector?** This page provides an overview of the Notion connector and its capabilities. For step-by-step configuration instructions, visit the [Notion](https://www.askthisguy.com/doc/admin-console/knowledge-management/connectors/conf-guides/notion-conf-guide) page ## Connect Your Notion Workspace to ATG The **Notion Connector** seamlessly syncs your organization's pages and databases from **Notion** into ATG, making your team's knowledge instantly accessible through AI-powered search and chat. ### What Gets Synced? The connector can import content from: - **Team Spaces** - Shared workspaces where your organization collaborates - **Private Spaces** - Individual workspaces for personal notes and content You maintain **full control** over what gets imported with simple yet powerful filtering options. ### Comprehensive Content Processing When syncing Notion pages, ATG processes **both text and images** within your content, ensuring complete knowledge capture. This multimodal approach means your AI assistant can understand and reference visual content alongside written documentation. Learn more about how ATG handles images and visual content: [Documents & Images](https://www.askthisguy.com/doc/admin-console/knowledge-management/how-documents-images-are-processed-by-atg) ### Simple Filtering Options Once connected, you can customize exactly what content ATG imports: - **Select specific Spaces** - Choose which Notion spaces to sync - **Include/Exclude folders and files** - Specify particular pages or databases to include or exclude This ensures ATG only processes the content that's relevant to your team, keeping your knowledge base focused and efficient. ### Automatic Updates After the initial sync, the connector refreshes on the **frequency set for the source**. New sources are set to **Daily**, and an administrator can switch them to Manual, Weekly, or Monthly, or run a refresh on demand, so your AI assistant has access to the latest versions of your Notion content. See [Refresh frequency](https://www.askthisguy.com/doc/admin-console/knowledge-management/connectors#refresh-frequency). ### Ready to Get Started? Head over to the [Notion](https://www.askthisguy.com/doc/admin-console/knowledge-management/connectors/conf-guides/notion-conf-guide) for detailed setup instructions. --- # Data & RAG URL: https://www.askthisguy.com/en/doc/admin-console/knowledge-management/how-is-my-companys-data-processed-what-is-rag/ Language: en Section: Documentation At *Ask this Guy*, we understand how important it is for you to know what happens to your data when you interact with our platform. This page explains, in clear and simple terms, how your data is handled, organized, and used to provide accurate and reliable answers - always with privacy and security in mind. We use advanced Retrieval-Augmented Generation (RAG) technology to ensure that your questions are answered using both the latest information and your organization's own knowledge, without compromising data integrity. To make these concepts easy to grasp, imagine our system as a highly skilled librarian working in a modern, well-organized library. ![The Best Librarian Ever](https://www.askthisguy.com/doc/documentation-for-administrators-knowledge-management-how-is-my-companys-data-processed-what-is-rag-image.webp) ## What is RAG? Imagine your AI assistant as a very smart librarian. Traditionally, this librarian only knows what's in their head (the LLM's training data). With RAG, the librarian can also search through the latest books, documents, and web pages in the library and online to find the best answer for you. **Technically:** RAG lets an LLM "look up" relevant information from external sources - like documents, databases, or the web - at the moment you ask a question. The AI combines its own knowledge with what it finds, giving you a more reliable and current answer. ## Why use RAG? - **Up-to-date answers:** RAG fetches the latest information, overcoming the LLM's knowledge cutoff. - **Domain expertise:** It connects the AI to your internal company knowledge for tailored answers. - **Fact-checking:** RAG can cite its sources, making it easier to verify information and trust the results. ## How does RAG work? Let's keep using the librarian metaphor: The LLM is like a librarian who knows a lot from years of reading and study (its training data). With RAG, the librarian can also walk through the library stacks and even search online databases to find the latest and most relevant information for your question. **The RAG process:** 1. **Indexing (Cataloging the library)** - All documents and data are converted into "embeddings" - mathematical fingerprints that capture their meaning. These are stored in a vector database, like a modern, super-efficient card catalog, making it easy to find relevant information quickly. 2. **Retrieval (Searching the stacks)** - When you ask a question, the librarian searches the catalog for the most relevant books, articles, or documents using: - **Keyword Search:** Looking for exact words in titles or text. - **Semantic Search:** Understanding the meaning behind your question to find related materials, even if they use different words. 3. **Chunking (Dividing books into chapters or sections)** - Large documents are broken into smaller, meaningful sections ("chunks"), so the librarian can pull just the chapters or pages that matter for your question. 4. **Augmentation (Gathering and preparing the materials)** - The librarian collects the relevant sections and combines them with your question, preparing a reading list or summary to help answer you accurately. 5. **Generation (Crafting the answer)** - The librarian uses both their own expertise and the fresh materials to provide a complete, well-sourced answer - often pointing you to the exact book or page where the information was found. ## Multi-agent RAG System *This Guy* democratizes internal knowledge pre-processing, making it accessible to all users. Traditionally, such pipelines are deployed by large enterprises on extensive projects requiring AI expertise. With *This Guy*, the process is streamlined to run in minutes, eliminating the need for any prior AI skills. ![RAG - visual selection.svg](https://www.askthisguy.com/doc/documentation-for-administrators-knowledge-management-how-is-my-companys-data-processed-what-is-rag-RAG_-_visual_selection.svg) ## Key concepts explained ### **Chunking** Breaking large texts into smaller, meaningful parts. This allows the system to retrieve only the sections most relevant to your question, improving accuracy and efficiency. ### **Embeddings** Think of embeddings as unique "fingerprints" for pieces of text. They are mathematical representations that capture the meaning of a sentence or paragraph, enabling the system to compare and find similar content - even if different words are used. ### Tokenizers Think of tokenizers as the librarian’s reading glasses that help them break down text into understandable pieces. Just like how a librarian might read a sentence word by word, a tokenizer breaks down your text into smaller units called “tokens” - which can be whole words, parts of words, or even individual characters. For example, if you ask “What’s our remote work policy?”, the tokenizer might break this into tokens like: “What”, “’s”, “our”, “remote”, “work”, “policy”, “?”. Each token gets assigned a unique number (like a library catalog number), so the AI can process your question mathematically. A helpful rule of thumb is that one token generally corresponds to ~4 characters of text for common English text. This translates to roughly ¾ of a word (so 100 tokens ~= 75 words). *Tokenization example: see [OpenAI tokenizer](https://platform.openai.com/tokenizer).* ### **Semantic Search vs. Keyword Search** - **Keyword Search:** Like searching for a book by its exact title. - **Semantic Search:** Like asking a librarian for "books about starting a business," and they find relevant books even if they use different words (e.g., "entrepreneurship"). ### **Vector Database** A vector database is like a super-organized library catalog. It stores all the embeddings and lets the system quickly find the most relevant information for your question. ### Keyword Search Database Search Database is like the librarian’s traditional card catalog system for finding books by specific keywords. When you search for “remote work policy,” it looks through all the documents to find ones that contain those exact words. However, *This Guy* is smarter than a simple word count. It considers: - How often the term appears in each document (but doesn’t overvalue documents that repeat the same word 500 times) - How rare or common the term is across all documents (rare terms like “sabbatical” are more valuable than common ones like “the”) - Document length - shorter documents with your keywords get higher scores than very long documents where the keywords might be less relevant **Example:** If you search for “expense report,” *This Guy* might rank a short 2-page expense policy higher than a 50-page general HR manual that only mentions expenses once, even though both contain your keywords. ### **Prompt engineering** This involves carefully designing how the retrieved information and your question are combined before being sent to the LLM. [LLM Best Practices](https://www.askthisguy.com/doc/webapp/llm-best-practices) helps the LLM understand the context and generate better answers. ### **Updating external data** To keep answers current, *This Guy* regularly update their external data sources and re-calculate embeddings. This ensures the AI always has access to the latest information. ### **Source attribution (Citations)** *This Guy* can provide references or citations for the information it uses, making it easier for users to verify facts and trust the AI's answers. ## Real-world example Suppose you ask *This Guy:* *"What is our policy on remote work for new hires?"* The system will: 1. Breaks your HR handbook into chapters or sections. 2. Uses semantic search to find the relevant section about remote work. 3. Feeds that section, along with your question, to the LLM. 4. The LLM (your expert librarian) generates an answer, citing the exact page or section it used. ## Summary
**Concept****What It Means****Example**
RAGLLM + real-time search for grounded answersLibrarian with access to all resources
EmbeddingsMathematical fingerprints of text meaningUnique ID for every book in a library
Vector databaseStores and organizes embeddings for fast retrievalLibrary catalog for quick searching
Semantic SearchFinds meaning, not just wordsLibrarian who "gets" what you mean
Keyword SearchFinds exact word matchesSearching by book title
ChunkingBreaks large texts into smaller, meaningful piecesDividing a book into chapters
Prompt engineeringDesigning how info is presented to the LLMGiving the librarian a clear question
Updating external dataRefreshing sources and embeddings regularlyUpdating the library with new books
Source attributionProviding references for answersFootnotes in a research paper
RAG technology makes *This Guy* more reliable and trustworthy by letting them "look up" the latest and most relevant information - just like a well-prepared librarian who always checks the stacks and cites their sources before giving you an answer. --- # SharePoint & OneDrive URL: https://www.askthisguy.com/en/doc/admin-console/knowledge-management/connectors/conf-guides/sharepoint-onedrive-conf-guide/ Language: en Section: Documentation **Looking for connector capabilities?** This page provides step-by-step configuration instructions. For an overview of the SharePoint connector and its features, visit the [SharePoint Connector page](https://www.askthisguy.com/doc/admin-console/knowledge-management/connectors/sharepoint-onedrive-connector). *Approximate time to complete: 5 minutes if Option A, 10-15 minutes if Option B* ## Before you begin The actions below can only be performed by your Microsoft Entra Administrators (formerly Azure AD). Ensure you have access to an Administrator account of your Organization. To connect ATG to SharePoint, you will need to follow the steps below: 1. [Create an enterprise application in Microsoft Entra](#1-create-an-entreprise-application-in-microsoft-entra) 2. [Configure API permissions for the application](#2-configure-microsoft-graph-api-permissions) 3. (Option B only) [Configure site-specific permissions using PowerShell](#3-configure-site-specific-permissions-using-powershell-option-b-only) 4. [Create a client secret](#4-create-a-client-secret) 5. [Retrieve credentials to connect SharePoint in ATG](#5-gather-credentials-for-atg) 6. [Configure your SharePoint sites in ATG](#6-connect-sharepoint-in-atg) ## 1. Create an entreprise application in Microsoft Entra ### Go to App Registrations menu Navigate to [Microsoft Entra Admin Center](https://entra.microsoft.com/), and go to 'App registrations' in the left menu. ![Microsoft Entra Admin Center](https://www.askthisguy.com/doc/sharepoint-1-en.webp) ### Create a new app registration Click on "+ New registration" on the top menu. Fill in "Ask This Guy" (or another name if you prefer) as the name, leave the default settings below, and click "Register": ![App registration creation](https://www.askthisguy.com/doc/sharepoint-2-en.webp) ### Application overview After registration, the application management page appears. You will need to note two important values from this page later: - Application (client) ID - Directory (tenant) ID ![App registration overview](https://www.askthisguy.com/doc/sharepoint-3-en.webp) ## 2. Configure Microsoft Graph API permissions You have two options for configuring permissions: **[Option A: Global permissions for all SharePoint/OneDrive sites](#option-a-global-permissions-for-all-sharepointonedrive-sites)**. This configuration is the easiest one: you will grant ATG with reading privileges on all SharePoint sites and enable space discovery. You can configure everything in the ATG Admin Console easily. **[Option B: Restricted permissions for specific SharePoint sites](#option-b-restricted-permissions-for-specific-sharepoint-sites)** This configuration is for additional security: you will select the sites you want to grand access to ATG. You will need to manually configure the list of authorized sites in the admin console. ### Option A: Global permissions for all SharePoint/OneDrive sites Navigate to "API permissions" and click on "+ Add a permission": ![Add a permission](https://www.askthisguy.com/doc/sharepoint-4-en.webp) Click on "Microsoft Graph": ![Microsoft Graph](https://www.askthisguy.com/doc/sharepoint-6-en.webp) Then click on "Application permissions": ![Application permissions](https://www.askthisguy.com/doc/sharepoint-7-en.webp) Then, add the following permissions: - Sites.Read.All - User.Read.All - Files.Read.All and click on "Add permissions": ![Add permissions](https://www.askthisguy.com/doc/sharepoint-8-en.webp) You should now see the permissions on your application, like this: ![Application permissions](https://www.askthisguy.com/doc/sharepoint-9-en.webp) One last step: grant admin consent for the application. Click on "Grant admin consent for [your organization]" ![Grant admin consent](https://www.askthisguy.com/doc/sharepoint-11-en.webp) Confirm when prompted: ![Grant admin consent](https://www.askthisguy.com/doc/sharepoint-12-en.webp) You should now see green checks, like this: ![Grant admin consent](https://www.askthisguy.com/doc/sharepoint-13-en.webp) That's all! **You can now jump to the [4th step: Create a client secret](#4-create-a-client-secret).** ### Option B: Restricted permissions for specific SharePoint sites Navigate to "API permissions" and click on "+ Add a permission": ![Add a permission](https://www.askthisguy.com/doc/sharepoint-4-en.webp) Click on "Microsoft Graph": ![Microsoft Graph](https://www.askthisguy.com/doc/sharepoint-6-en.webp) Then click on "Application permissions": ![Application permissions](https://www.askthisguy.com/doc/sharepoint-7-en.webp) Then, add the following permission: - Sites.Selected and click on "Add permissions": ![Add permissions](https://www.askthisguy.com/doc/sharepoint-10-en.webp) ## 3. Configure site-specific permissions using PowerShell (Option B only) With **Sites.Selected**, you must explicitly grant access to each SharePoint site using PowerShell. This provides granular control over which sites ATG can access. ### 3.1. Launch PowerShell On your machine, you will need to have PowerShell installed. If that's not the case, [follow this guide to install PowerShell](https://learn.microsoft.com/en-us/powershell/scripting/install/install-powershell) Then launch it using: ```bash pwsh ``` ### 3.2 Install PnP PowerShell module In PowerShell, you will need Microsoft's [PnP PowerShell module](https://pnp.github.io/powershell/). If you don't already have the module installed, simply run the following command: ```powershell Install-Module PnP.PowerShell -Scope CurrentUser -Force ``` ### 3.3 Create a helper app for PowerShell authentication To connect to SharePoint using modern authentication, you'll need to create an additional Entra ID app registration specifically for PowerShell access. Return to the Microsoft Entra admin center, in the [App Registrations menu](https://entra.microsoft.com/#view/Microsoft_AAD_RegisteredApps/ApplicationsListBlade/quickStartType~/null/sourceType/Microsoft_AAD_IAM), and create a **new app registration**: 1. Click "+ New registration" and enter the following details: - Name: "PowerShell Helper App" - Supported account types: "Single tenant only" - Redirect URI: select "Pblic client/native (mobile & desktop)" and put `http://localhost` as the URI ![New app registration](https://www.askthisguy.com/doc/sharepoint-14-en.webp) 2. Click on "Register" Your application should appear in your app registrations list: ![New app registration](https://www.askthisguy.com/doc/sharepoint-15-en.webp) Notice that your helper app has an Application (client) ID, you will need it later. ### 3.4 Configure API permissions for the helper app In your newly created helper app, navigate to "API permissions". For the moment, your application should have only one permission: "User.Read": ![API permissions](https://www.askthisguy.com/doc/sharepoint-16-en.webp) We need to add new permissions.Click "+ Add a permission" and select "Microsoft Graph": ![Microsoft Graph](https://www.askthisguy.com/doc/sharepoint-17-en.webp) Click on "Delegated permissions": ![Delegated permissions](https://www.askthisguy.com/doc/sharepoint-18-en.webp) Add the following delegated permission: - Sites.FullControl.All and click on "Add permissions": ![Add permissions](https://www.askthisguy.com/doc/sharepoint-19-en.webp) Your application should now have the following permissions: - User.Read - Sites.FullControl.All ![Application permissions](https://www.askthisguy.com/doc/sharepoint-20-en.webp) Click "Grant admin consent for [your organization]": ![Grant admin consent](https://www.askthisguy.com/doc/sharepoint-21-en.webp) Confirm: ![Grant admin consent](https://www.askthisguy.com/doc/sharepoint-22-en.webp) You should now see green checks, like this: ![Grant admin consent](https://www.askthisguy.com/doc/sharepoint-23-en.webp) ### 3.5 Enable public client flows Navigate to "Authentication (Preview)" in the left menu Go to the "Settings" menu Set "Allow public client flows" to **Enabled** Click "Save" ![Public client flows](https://www.askthisguy.com/doc/sharepoint-24-en.webp) ### 3.6 Connect to SharePoint using PowerShell Now you can connect to SharePoint as an administrator using the helper app you just created. Run the following command, replacing: - `` with your tenant name (e.g., if your SharePoint sites are at [https://contoso.sharepoint.com](https://contoso.sharepoint.com), use "contoso") - `` with the Application (client) ID from the helper app overview page ```powershell Connect-PnPOnline ` -Url https://-admin.sharepoint.com ` -ClientId ` -Interactive ``` A browser window will open for you to authenticate with your administrator credentials. You are now connected to SharePoint as an administrator using modern authentication. ### 3.7 List available SharePoint sites (optional) To see all SharePoint sites in your tenant: ```powershell Get-PnPTenantSite | Where-Object { $_.Url -like "*/sites/*" } | Select Url, Title ``` ### 3.8 Grant site permissions to the ATG app For each SharePoint site you want ATG to access, run the following command: Replace: - `` with your tenant name - `` with the site name (e.g., "TeamSite") - `` with the **Application (client) ID** from your **ATG app** (the first app you created, not the helper app) - `` with a friendly name (e.g., "Ask This Guy Connector") ```powershell Grant-PnPAzureADAppSitePermission ` -Site https://.sharepoint.com/sites/ ` -AppId ` -DisplayName "" ` -Permissions Read ``` **Example:** ```powershell Grant-PnPAzureADAppSitePermission ` -Site https://contoso.sharepoint.com/sites/Engineering ` -AppId b742cb55-dc46-4a46-adc4-72a5a28c4b64 ` -DisplayName "Ask This Guy Connector" ` -Permissions Read ``` Repeat this command for each site you want to authorize. ### 3.9 Verify permissions (optional) To view the permissions granted to a specific site: ```powershell Get-PnPAzureADAppSitePermission -Site ``` You have successfully configured site-specific permissions! The ATG app can now access only the SharePoint sites you explicitly authorized. ## 4. Create a client secret Navigate to "Certificates & secrets" in the left menu of the app registration: ![Certificates & secrets](https://www.askthisguy.com/doc/sharepoint-25-en.webp) Click on "+ New client secret", enter a description (optional) and select an expiration period, then click "Add": ![New client secret](https://www.askthisguy.com/doc/sharepoint-26-en.webp) **Important:** - Copy the **Value** of the secret immediately! You won't be able to see it again after leaving this page. - If you set an **expiration date** of the secret, keep track of it, you will need to renew your secret before it expires and configure it in ATG. ## 5. Gather credentials for ATG You will need the following three values to configure the SharePoint connector in ATG: 1. **Tenant ID**: Found on the application overview page 2. **Client ID**: Found on the application overview page under "Application (client) ID" 3. **Client Secret Value**: The value you copied from the client secret creation step Keep these credentials secure. They provide access to your SharePoint content. ## 6. Connect SharePoint in ATG ### Go the the Connectors Menu in ATG Administrator Console Go to [the Connectors menu](https://app.askthisguy.com/admin/knowledge?tab=connectors): ![Connectors menu in Admin Console](https://www.askthisguy.com/doc/connectors-menu-1-en.webp) Click on 'Add connector', select 'Sharepoint': ![Add a connector, select SharePoint](https://www.askthisguy.com/doc/connectors-menu-sharepoint-1-en.webp) Add the credentials you gathered: - Tenant ID - Application (client) ID - Client secret then click on "Save": ![Add credentials](https://www.askthisguy.com/doc/connectors-menu-sharepoint-2-en.webp) Well done! SharePoint connector is now added to ATG! You can now add sources to your connector. The SharePoint connector is successfully added to ATG! To add a source, go to [the Sources menu](https://app.askthisguy.com/admin/knowledge?tab=sources), and add a source (SharePoint Connector is now available in the list). --- # Documents & Images URL: https://www.askthisguy.com/en/doc/admin-console/knowledge-management/how-documents-images-are-processed-by-atg/ Language: en Section: Documentation *This Guy* AI assistant implements a sophisticated **multimodal document processing pipeline** that transforms complex documents into intelligently indexed knowledge bases. The system achieves **95%+ accuracy** in text extraction and supports **50+ languages** with automatic detection. One differentiator of *This Guy* is to be able to smartly handle images within documents, and be able to reuse images in its replies. Here is how the pipeline works: ![*Image processing and integration pipeline in ATG*](https://www.askthisguy.com/doc/documentation-for-administrators-knowledge-management-how-documents-images-are-processed-by-atg-image.webp) *Image processing and integration pipeline in ATG* ## Guidelines for your documents formatting To optimize the work and accuracy of *This Guy* it is essential to make your (future) documents as explicit as possible. Here are some tips to help your teams structure their documents so that they are more easily interpretable by AI tools like Mistral or others: **Clarity and precision:** Ensure that the content of your documents is clear and precise. Avoid ambiguities and be as detailed as possible. **Consistent structure:** Maintain a consistent structure between textual and visual information. Use headings and subheadings to organize the content and facilitate understanding. **Separation of elements:** Clearly distinguish between different types of information. For example, separate text paragraphs from images or graphics. **Use of keywords:** Integrate relevant keywords that help identify the content and context of the information presented. **Uniform formatting:** Use uniform formatting for similar elements. For example, if you have multiple images, make sure they are all formatted in the same way. **Annotations and captions:** Add annotations and captions to images and graphics to provide additional context and clarify their content. By following these tips, you will help *This Guy* better understand and process your documents, thereby improving the accuracy and efficiency of its work. ## Pipeline architecture overview ![ATG image processing pipeline integration](https://www.askthisguy.com/doc/documentation-for-administrators-knowledge-management-how-documents-images-are-processed-by-atg-cf20a0ee-ffbf-457e-bfc8-d1f389c74988.webp) ATG image processing pipeline integration The ATG document integration system operates through a **five-stage pipeline** that seamlessly processes documents from initial upload to final knowledge indexing. This architecture follows enterprise-grade standards for scalability and reliability. ### Stage 1: Document ingestion The system accepts multiple document formats including PDF, Word, PowerPoint, and many more. Documents are immediately validated and queued for processing with automatic format detection and metadata extraction. ### Stage 2: Content extraction & separation The pipeline intelligently separates textual content from embedded images, maintaining document structure while preparing assets for specialized processing workflows. ### Stage 3: AI processing layer The AI processing stage implements **parallel multimodal analysis** using state-of-the-art computer vision and natural language processing technologies. This stage processes both text and images simultaneously to maximize efficiency. **Text processing stream:** - Advanced OCR for scanned documents and embedded text - Language detection and text normalization - Semantic analysis and entity extraction **Image processing stream:** - Visual content analysis and description generation - Chart, diagram, and table recognition - Contextual image understanding with business logic ### Stage 4: Content integration & enrichment The system combines processed text and image descriptions into **structured markdown format**, creating a unified document representation that preserves both visual and textual information. **Markdown generation process:** - Images are stored securely in ATG cloud storage - AI-generated descriptions serve as alt-text for accessibility - Hierarchical structure preservation with proper headings and formatting - Cross-referencing between images and related text content ### Stage 5: Knowledge indexing & search The final stage implements **advanced vectorization and embedding** techniques to enable semantic search capabilities. **Indexing features:** - **Chunking strategy**: Documents are segmented into logical chunks for optimal retrieval - **Vector embeddings**: Both text and image descriptions are converted to high-dimensional vectors - **Hybrid search**: Combines keyword and semantic search for comprehensive results - **Real-time updates**: Automatic re-indexing when documents are modified ## Technology stack The ATG system leverages cutting-edge AI technologies while maintaining flexibility and data sovereignty (depending on the AI policy chosen by administrators): ### OCR Processing - **OCR**: High-accuracy text recognition with **>95% precision** on standard documents - **Multilingual support**: Automatic detection of 50+ languages - **Handwriting recognition**: Advanced capabilities for manuscript processing ### Multimodal vision AI - Enterprise-grade multimodal understanding for comprehensive document analysis - **Context-aware descriptions**: Detailed image analysis with business context integration - **Technical diagram recognition**: Specialized processing for charts, graphs, and technical illustrations ### European AI solutions - EU-compliant hosting for data sovereignty requirements - Include, when applicable, open-weight models in the processing workflows - Efficient multimodal processing with European data residency ### Language enhancement - Advanced text enhancement and semantic analysis - Automatic improvement of document structure and readability --- # SharePoint & OneDrive Connector URL: https://www.askthisguy.com/en/doc/admin-console/knowledge-management/connectors/sharepoint-onedrive-connector/ Language: en Section: Documentation **Looking to set up this connector?** This page provides an overview of the SharePoint & OneDrive connector and its capabilities. For step-by-step configuration instructions, visit the [SharePoint & OneDrive](https://www.askthisguy.com/doc/admin-console/knowledge-management/connectors/conf-guides/sharepoint-onedrive-conf-guide) ## Connect Your Microsoft 365 to ATG The **SharePoint & OneDrive Connector** seamlessly syncs your organization's documents from **Microsoft 365** into ATG, making your team's knowledge instantly accessible through AI-powered search and chat. **Note:** This connector works exclusively with **SharePoint** (organization sites) and **OneDrive for Business**. Personal OneDrive accounts are not supported. ### What Gets Synced? The connector can import documents from: - **SharePoint Sites** - Team sites and document libraries accessible to your organization - **OneDrive for Business** - Individual OneDrive folders from collaborators in your organization You maintain **full control** over what gets imported with powerful filtering options. ### Flexible Filtering Options Once connected, you can customize exactly what content ATG imports: - **Select specific sites or folders** - Choose which SharePoint sites or OneDrive folders to sync - **Date filters** - Import only documents updated before a specific date, after a specific date, or between two dates - **Include/Exclude rules** - Specify particular folders or files to include or exclude ### Smart Tag-Based Filtering This is where SharePoint & OneDrive shine with a **powerful exclusive feature**: **tag-based filtering** compatible with [Microsoft's **Term Store**](https://learn.microsoft.com/en-us/sharepoint/managed-metadata). Tags let you **precisely control** which documents get synced based on their metadata, making it incredibly easy to select only the reference documents that matter. **How it works:** - **Inclusion tags** - Only sync documents tagged with specific terms (e.g., "Approved", "Final Version", "Public") - **Exclusion tags** - Skip documents tagged with certain terms (e.g., "Draft", "Archived", "Internal Only") **Example use case:** Let's say your legal team tags all finalized contracts with **"Signed Contract"** in SharePoint. You can configure ATG to **only import documents with this tag**, ensuring your AI assistant only references validated, signed agreements - not drafts or templates. This keeps your knowledge base clean, accurate, and trustworthy. This ensures ATG only processes the content that's relevant to your team, keeping your knowledge base focused and efficient. ### Automatic Updates After the initial sync, the connector refreshes on the **frequency set for the source**. New sources are set to **Daily**, and an administrator can switch them to Manual, Weekly, or Monthly, or run a refresh on demand, so your AI assistant has access to the latest versions of your documents. See [Refresh frequency](https://www.askthisguy.com/doc/admin-console/knowledge-management/connectors#refresh-frequency). ### Supported File Types The SharePoint & OneDrive connector handles a **comprehensive range** of file formats: **Standard document formats:** - Markdown (.md) - PDF (.pdf) - Plain text (.txt) - Rich Text Format (.rtf) - HTML files (.html) **Microsoft Office files:** - Word documents (.docx) - PowerPoint presentations (.pptx) **Images:** - PNG (.png) - JPEG (.jpg) **Custom file types:** - [Tailored Processing](https://www.askthisguy.com/doc/customizing-atg-to-you/tailored-processing) - ATG can be customized to handle your organization's unique file formats with specialized processing rules. ### Ready to Get Started? Head over to the [SharePoint & OneDrive](https://www.askthisguy.com/doc/admin-console/knowledge-management/connectors/conf-guides/sharepoint-onedrive-conf-guide) for detailed setup instructions, or reach out to your ATG contact if you need assistance. --- # Slack URL: https://www.askthisguy.com/en/doc/admin-console/knowledge-management/connectors/conf-guides/slack-conf-guide/ Language: en Section: Documentation **Looking for connector capabilities?** This page provides step-by-step configuration instructions. For an overview of the Slack connector and its features, visit the [Slack Connector](https://www.askthisguy.com/doc/admin-console/knowledge-management/connectors/slack-connector) page. In order to connect ATG to Slack, you will need to get a token from Slack. To get started, you'll need to create a Slack app. Your app will be a container for your credentials; you can't get a token without one. You can follow the Slack quickstart guide on how to create an app: [Quickstart](https://api.slack.com/quickstart) Below step-by-step instructions to create, install and setup your ATG connection to Slack: [1. Creating an app](https://www.askthisguy.com/doc/admin-console/knowledge-management/connectors/conf-guides/slack-conf-guide) [2. Defining the scopes of your app](https://www.askthisguy.com/doc/admin-console/knowledge-management/connectors/conf-guides/slack-conf-guide) [3. Installing and authorizing the app](https://www.askthisguy.com/doc/admin-console/knowledge-management/connectors/conf-guides/slack-conf-guide) [4. Importing the token in ATG](https://www.askthisguy.com/doc/admin-console/knowledge-management/connectors/conf-guides/slack-conf-guide) ## 1. Creating an app ### Navigate to your Slack apps [Slack API: Applications | Slack](https://api.slack.com/apps) ### Start Creating a New App ![](https://3wnk7clnt5z9buow.public.blob.vercel-storage.com/99fb1a0f-6283-46c3-a73c-353aa14c3996/19ce2399-95ad-4f5c-85e4-b10bc40061a2-thumb.png) Click the ‘Create New App’ button. ### Option 1 (recommended): choose “From a manifest” ![](https://3wnk7clnt5z9buow.public.blob.vercel-storage.com/7618db6f-9e6a-4db5-8cb9-157e230de247/13b92304-1439-416a-b010-f71ebcd49ff2-thumb.png) Select the option to create the app from a manifest file. ### Select workspace ![](https://3wnk7clnt5z9buow.public.blob.vercel-storage.com/7618db6f-9e6a-4db5-8cb9-157e230de247/64a04729-0c58-458e-a4df-e8077238af72-thumb.png) Choose the workspace where you want to develop your app and click ‘Next’. ### Confirm Workspace Selection ![](https://3wnk7clnt5z9buow.public.blob.vercel-storage.com/7618db6f-9e6a-4db5-8cb9-157e230de247/3c42a47b-dac3-4a48-b4e7-ad78fb60c027-thumb.png) Click the ‘Next’ button. ### Copy and Paste the JSON manifest below ```json { "display_information": { "name": "Ask This Guy" }, "oauth_config": { "scopes": { "user": [ "channels:history", "channels:read", "files:read", "users:read" ] } }, "settings": { "org_deploy_enabled": false, "socket_mode_enabled": false, "token_rotation_enabled": false } } ``` ![](https://3wnk7clnt5z9buow.public.blob.vercel-storage.com/7618db6f-9e6a-4db5-8cb9-157e230de247/fb1e4c01-10cb-4103-a9e4-ed79a21fff90-thumb.png) Click the ‘Next’ button. ### Option 2: choose “From scratch” ![](https://3wnk7clnt5z9buow.public.blob.vercel-storage.com/99fb1a0f-6283-46c3-a73c-353aa14c3996/6183d7cf-1f70-46ce-b242-aeee50db3e4f-thumb.png) Select ‘From scratch’. ### Name Your App ![](https://3wnk7clnt5z9buow.public.blob.vercel-storage.com/99fb1a0f-6283-46c3-a73c-353aa14c3996/0aa24e46-157e-4f3d-acdd-6b2dcc1e18c4-thumb.png) Enter an app name and choose a workspace. ### Select Your Workspace ![](https://3wnk7clnt5z9buow.public.blob.vercel-storage.com/99fb1a0f-6283-46c3-a73c-353aa14c3996/c8b30019-3490-4938-917b-0b7e0b0ff4af-thumb.png) Chose an App Name, select the workspace you want to develop your app in and then click ‘Create App’. ## 2. Defining the scopes of your app Scopes give your app permission to perform actions, such as reading messages in your workspace. If you created your app from scratch, you'll need to setup/modify [**scopes**](https://api.slack.com/scopes) for your app. If you created your app from a manifest, the recommended scopes are already setup. You can modify them later if needed following the below steps: ### Navigate to your Slack apps and select your app [Slack API: Applications | Slack](https://api.slack.com/apps) ### Navigate to OAuth & Permissions ![image.png](https://www.askthisguy.com/doc/documentation-for-administrators-knowledge-management-how-to-configure-my-connectors-slack-conf-guide-image.webp) Click on ‘OAuth & Permissions’ in the Features section. ### Add an OAuth Scope ![image.png](https://www.askthisguy.com/doc/documentation-for-administrators-knowledge-management-how-to-configure-my-connectors-slack-conf-guide-image-1.webp) Scroll down to the Scopes section, and ‘Add an OAuth Scope’ button under ‘User Token Scopes’. ### Add OAuth Scopes Scroll down to the Scopes section, and ‘Add an OAuth Scope’ button under ‘User Token Scopes’. We recommend to limit the scopes to the **minimal configuration** for ATG to work:
[**channels:history](https://api.slack.com/scopes/channels:history)**View messages and other content in a user’s public channels
[**channels:read**](https://api.slack.com/scopes/channels:read)View basic information about public channels in a workspace
[**files:read**](https://api.slack.com/scopes/files:read)View files shared in channels and conversations that a user has access to
[**users:read**](https://api.slack.com/scopes/users:read)View people in a workspace
## 3. Installing and authorizing the app ### Navigate to the Install App Section ![](https://3wnk7clnt5z9buow.public.blob.vercel-storage.com/07e20523-1de6-4060-85ff-534e9d98e8ca/1ee99e74-f129-4f0e-9932-13f4516ed9eb-thumb.png) On the Slack API settings page, click on the ‘Install App’ option in the left-hand menu. ### Begin the Installation Process ![image.png](https://www.askthisguy.com/doc/documentation-for-administrators-knowledge-management-how-to-configure-my-connectors-slack-conf-guide-image-2.webp) Click on the Install button to start the app installation for the chosen workspace ### Authorize the App ![](https://3wnk7clnt5z9buow.public.blob.vercel-storage.com/07e20523-1de6-4060-85ff-534e9d98e8ca/5313c9e1-4189-4e98-bf73-ee6bdb081376-thumb.png) Review the permissions the app requests and then click ‘Allow’ to authorize the app within your Slack workspace. ### View/copy the OAuth Token ![](https://3wnk7clnt5z9buow.public.blob.vercel-storage.com/07e20523-1de6-4060-85ff-534e9d98e8ca/8e37297d-d4f0-4302-bf5a-22f3f6499b79-thumb.png) After successful installation, the ‘Installed App Settings’ page displays your Bot User OAuth Token. This is the token that you will use to make calls to the Slack API on behalf of your app. Click on Copy to copy it to your clipboard for later use in ATG. Access tokens represent the permissions delegated to your app by the installing user. These credentials allow your app to access the Slack API. They are secret. Please don't share your app credentials with anyone, and don’t include them in public code repositories. Store them in secure ways. ## 4. Importing the token in ATG ### Open Knowledge categories ![](https://3wnk7clnt5z9buow.public.blob.vercel-storage.com/473e6c56-a7a7-467f-863c-f486d9fc0474/7cf6de35-1186-4b71-ad4f-80e569c675c8-thumb.png) Open the Knowledge Categories section of [ATG Administration Console](https://www.notion.so/Id-es-produit-Admin-Console-1519e2c651328097894af50682e0c098?pvs=21). ### Add a Connector ![](https://3wnk7clnt5z9buow.public.blob.vercel-storage.com/473e6c56-a7a7-467f-863c-f486d9fc0474/03b690cd-55eb-4fc0-8631-fbb862e94fb6-thumb.png) Click on ‘Add a connector’ to open the connector selection menu and choose the Slack connector from the available options. ### Paste your token ![](https://3wnk7clnt5z9buow.public.blob.vercel-storage.com/473e6c56-a7a7-467f-863c-f486d9fc0474/5e9396c1-b61a-47e7-b8cb-2cf7e44e881a-thumb.png) Paste your token generated previously in Slack administration console. ### Validate Slack connector ![](https://3wnk7clnt5z9buow.public.blob.vercel-storage.com/473e6c56-a7a7-467f-863c-f486d9fc0474/40a7b4d4-a6f6-456a-8cd4-b813398874db-thumb.png) Click on the ‘Validate’ button to confirm the token. Your Slack connection is ready, *Ask This Guy* will now be able to access your Slack workspace and use it in its data sources. --- # FTP Connector URL: https://www.askthisguy.com/en/doc/admin-console/knowledge-management/connectors/ftp-connector/ Language: en Section: Documentation ## Connect remote file servers to ATG The **FTP Connector** syncs documents from your organization’s **FTP**, **FTPS**, or **SFTP** servers into ATG, so your team can search and chat over that content with the same experience as other knowledge sources. ### Supported protocols - **FTP** — classic file transfer - **FTPS** — FTP over TLS - **SFTP** — SSH file transfer ### What gets synced? The connector imports files from the **remote paths** you configure on the server (folders and subfolders you allow). You stay in control of scope through the filtering options below. ### Filtering options You can narrow exactly what ATG imports: - **Include / exclude rules** — Target specific folders or files to include or leave out - **File modification date** — Import only files updated before a date, after a date, or between two dates ### Supported file types The connector handles a **wide range** of formats: **Documents** - Markdown (.md) - PDF (.pdf) - Plain text (.txt) - Rich Text Format (.rtf) - HTML (.html) **Microsoft Office** - Word (.docx) - PowerPoint (.pptx) **Images** - PNG (.png) - JPEG (.jpg) **Other formats** - [Tailored Processing](https://www.askthisguy.com/doc/customizing-atg-to-you/tailored-processing) — ATG can be customized for additional file types your organization needs. ### Keeping content up to date After the initial sync, the connector refreshes on the **frequency set for the source**. New sources are set to **Daily**, and an administrator can switch them to Manual, Weekly, or Monthly, or run a refresh on demand, so your knowledge base stays aligned with the server. See [Refresh frequency](https://www.askthisguy.com/doc/admin-console/knowledge-management/connectors#refresh-frequency). --- # Slack Connector URL: https://www.askthisguy.com/en/doc/admin-console/knowledge-management/connectors/slack-connector/ Language: en Section: Documentation **Looking to set up this connector?** This page provides an overview of the Slack connector and its capabilities. For step-by-step configuration instructions, visit the [Slack](https://www.askthisguy.com/doc/admin-console/knowledge-management/connectors/conf-guides/slack-conf-guide) page ## Connect Your Slack Workspace to ATG The **Slack Connector** seamlessly syncs your team's conversations, shared files, and collaborative knowledge from **Slack** into ATG, making your entire Slack history instantly searchable and accessible through AI-powered chat. ### What Gets Synced? The connector imports content from: - **Public Channels** - All messages and threads from channels accessible to the connected user - **User Information** - Team member profiles for proper context and attribution You maintain **full control** over access through Slack's native permissions - ATG respects your workspace's existing security settings. ### Comprehensive Content Processing When syncing Slack channels, ATG processes **both messages and attached files**, ensuring complete conversation capture. This means your AI assistant can understand the full context of discussions, including shared documents, images, and collaborative exchanges. Learn more about how ATG handles images and visual content: [Documents & Images](https://www.askthisguy.com/doc/admin-console/knowledge-management/how-documents-images-are-processed-by-atg) ### Smart Channel Access The connector automatically syncs all **public channels** that the connected user has access to, preserving your organization's existing access controls and security boundaries. This ensures team members only access conversations they're authorized to see. ### Automatic Updates After the initial sync, the connector refreshes on the **frequency set for the source**. New sources are set to **Daily**, and an administrator can switch them to Manual, Weekly, or Monthly, or run a refresh on demand, so your AI assistant has access to the latest messages and shared content from your Slack workspace. See [Refresh frequency](https://www.askthisguy.com/doc/admin-console/knowledge-management/connectors#refresh-frequency). ### Ready to Get Started? Head over to the [Slack](https://www.askthisguy.com/doc/admin-console/knowledge-management/connectors/conf-guides/slack-conf-guide) for detailed setup instructions. --- # Web Sites URL: https://www.askthisguy.com/en/doc/admin-console/knowledge-management/connectors/web-sites-connector/ Language: en Section: Documentation ## Import Web Content Into ATG The **Web Sites Connector** lets you bring **external web content** directly into your organization's knowledge base. By defining a starting URL, ATG will crawl and index the site, making its content searchable and accessible through AI-powered chat. ### How It Works Simply provide a **URL** to start crawling from, and ATG will: - **Download web pages** from the specified site or section - **Track each page individually** - Every page becomes a searchable resource - **Respect your scope** - Control which parts of the site to include This is perfect for importing documentation sites, knowledge bases, internal wikis, or any web-based content relevant to your team. ### Control What Gets Imported You have **full control** over the crawling scope: - **Define the starting URL** - Choose where the crawler begins - **Set boundaries** - Import the entire site or just specific sections - **Filter content** - Specify which pages or paths to include or exclude ### Refresh Frequency New web site sources are set to a **Weekly** refresh. An administrator can change that frequency, or switch the source to **Manual** to decide exactly when the site is crawled again, keeping control over how often external content is synced. See [Refresh frequency](https://www.askthisguy.com/doc/admin-console/knowledge-management/connectors#refresh-frequency). ### What Gets Indexed? The connector processes **HTML web pages** and extracts their text content, links, and structure. Each page becomes a distinct, citable resource in your ATG knowledge base. ### Ready to Get Started? **Quick setup in 4 steps:** 1. In your **Admin Console**, go to **Knowledge** and select a category 2. Click **+ Add** next to **Web Sites** 3. Enter the URL(s) you want to crawl - type manually or select from suggested sites ![Select Web Sites screen from the Admin Console](https://www.askthisguy.com/doc/documentation-for-administrators-knowledge-management-how-to-configure-my-connectors-web-sites-connector-image.webp) Select Web Sites screen from the Admin Console 1. Name your source and click **Create** Your web content will start importing immediately! --- # ATG Widget URL: https://www.askthisguy.com/en/doc/atg-embedded/ Language: en Section: Documentation **Essential guides:** - [Agents](https://www.askthisguy.com/doc/admin-console/how-to-configure-the-agents): Set up and configure your agents in the Admin Console - [Integrate in your webapp](https://www.askthisguy.com/doc/atg-embedded/how-to-integrate-atg-embedded-in-your-webapp): Embed the widget in your site or app (iframe, modes, JWT) ## Transform Your Platform with AI Agents The **ATG widget** lets you embed ATG agents into third-party websites, SaaS products, or internal tools without the complexity or cost of building from scratch. Create a **Widget agent** in the Admin Console, configure its knowledge and tools, then integrate that specific agent into your platform. Whether you're looking to enhance customer support, automate internal workflows, or create intelligent user experiences, the ATG widget makes it fast, flexible, and cost-effective. ## Use Cases: Where AI Agents Shine ### **Public Websites** Add an intelligent assistant to your institutional or marketing website that: - **Answers visitor questions** instantly using your website content and knowledge base - **Guides prospects** through your products and services - **Captures intent** (e.g., purchase interest, demo requests) and triggers notifications to your sales team - Works for **non-authenticated users** with zero friction ### **SaaS Applications & Web Apps** Embed a smart AI copilot directly in your product that: - **Helps users navigate** complex features and workflows - **Provides contextual support** based on where users are in your app - **Executes actions** on behalf of users (e.g., creating records, updating settings, triggering workflows) - **Personalizes responses** using client-specific data and user context - Fully **white-labeled** to match your brand ### **Internal Tools & Platforms** Empower your team with AI agents that: - **Search across knowledge bases** (Notion, Confluence, Google Drive, SharePoint, Slack, etc.) - **Answer employee questions** about processes, policies, and documentation - **Automate repetitive tasks** and information retrieval - **Integrate with internal systems** to fetch data or trigger actions ## Why Choose the ATG Widget? ### **Fast & Cost-Effective Deployment** No need to build AI infrastructure from scratch. Our **ready-to-integrate API** requires only minimal front-end and back-end development. Configure your agents with a **no-code admin console** - drastically reducing time-to-market and development costs. ### **Superior AI Quality** Leverage state-of-the-art **Retrieval Augmented Generation (RAG)** to deliver accurate, relevant answers grounded in your knowledge base. Our system minimizes AI "hallucinations" and ensures trustworthy responses your users can rely on. ### **Effortless Knowledge Management** Keep your AI's knowledge **automatically up-to-date** by connecting to your existing data sources: - **Notion**, **Confluence**, **Google Drive**, **SharePoint**, **Slack** - **Direct file uploads** and **web page crawling** - **Automatic synchronization** ensures your AI always has the latest information ### **Full Customization & Control** - **Custom instructions** to shape your agent's personality and behavior - **Visual branding** to match your platform's look and feel - **Knowledge categories** for granular control over what each agent can access - **Custom tools** to interact with your platform (read data, trigger actions, send notifications) - **Tool approval mechanism** for safe write operations ### **Intent Detection & Automation** Configure your agents to **recognize user intentions** (e.g., purchase signals, churn risk, support escalation) and **automatically trigger actions** like sending notifications or creating tickets. ## How It Works 1. **Configure Your Knowledge Base**: Connect your data sources through our admin console - no coding required 2. **Create a Widget Agent**: Choose the Widget type, define its instructions, select its knowledge categories and tools, then configure security 3. **Integrate the API**: Add our lightweight API to your platform with minimal front-end and back-end work 4. **Launch & Iterate**: Your AI agents are live and continuously learning from your updated knowledge base ## Extensibility Need something specific? The ATG widget supports: - **Custom connectors** for unique data sources - **Custom tools** tailored to your platform's functionality - **Flexible API integration** pattern ### Where to go next [Agents](https://www.askthisguy.com/doc/admin-console/how-to-configure-the-agents) [Integrate in your webapp](https://www.askthisguy.com/doc/atg-embedded/how-to-integrate-atg-embedded-in-your-webapp) --- # AI Policy URL: https://www.askthisguy.com/en/doc/admin-console/organization-settings/choosing-the-right-ai-policy/ Language: en Section: Documentation ATG gives you full control over which AI providers can access your data. Behind the scenes, ATG integrates with several leading AI providers, including: ## European Providers - [**Scaleway**](http://scaleway.com/): French cloud provider hosting open-weight models - [**Nebius**](https://nebius.com/): European AI infrastructure provider, specialized in AI, hosting open-weight models - [**Mistral**](https://mistral.ai/): French AI company with their own models (commercial or open-weight) - [**Black Forest Labs**](https://bfl.ai/): European AI research and development company, building its own model and specialized in image generation ## Worldwide Providers In addition to all European providers listed above, worldwide policy includes: - [**Google**](https://gemini.google.com/): US-based provider with Gemini models - [**Cerebras**](https://www.cerebras.ai/): US-based AI infrastructure provider specialized in ultra-fast inference - [**Groq**](https://groq.com/): US-based AI infrastructure provider specialized in ultra-fast inference - [**SambaNova**](https://sambanova.ai/): US-based AI infrastructure provider specialized in ultra-fast inference - [**OpenAI**](https://openai.com/): US-based provider of GPT models (ChatGPT) - [**DeepInfra**](https://deepinfra.com/): US-based AI infrastructure provider ## Commercial vs. Open-Weight Models Providers use different approaches to AI models: - **Commercial models:** Proprietary models developed and maintained by the provider (e.g., Mistral's models, Google's Gemini, OpenAI's GPT) - **Open-weight models:** Models with publicly available weights that can be downloaded, inspected, and hosted independently. Providers like Scaleway host these models on their infrastructure, giving you the benefits of open-weight transparency with European hosting. Open-weight models offer greater transparency since their architecture and parameters are publicly accessible, allowing independent security audits and reducing vendor lock-in. ## Two Privacy Policy Levels Because protecting your data is our top priority, ATG offers two privacy policy levels: - **EU Providers Only:** Restricts AI processing to European providers (Scaleway, Nebius, Mistral, Black Forest Labs). This ensures your data remains within EU jurisdiction and is protected by GDPR. - **Worldwide Providers:** Allows all providers, including US-based companies (OpenAI, Google, DeepInfra) in addition to European providers. **Important:** Selecting worldwide providers may subject your data to US regulations including the Patriot Act and Cloud Act, which can require US companies to provide data access to US authorities, even for data stored outside the US. Choosing EU-only providers protects you from these regulations. To configure the AI policy, go to the [Admin console](https://admin.askthisguy.com), select Organization ⇒ Settings ⇒ AI Policy ![AI Policy](https://www.askthisguy.com/doc/documentation-for-administrators-organization-settings-choosing-the-right-ai-policy-image.webp) ## European Infrastructure Beyond AI Regardless of your AI policy choice, all ATG platform infrastructure and data storage (outside of LLM processing) are hosted exclusively by European providers in European data centers. This ensures that your core data remains under EU jurisdiction and GDPR protection at all times. We recommend choosing the privacy level that best aligns with your organization's data protection requirements and compliance obligations. This flexibility ensures you can balance innovation, compliance, and peace of mind as AI technology evolves. ## Resources [AI and data privacy: What your company needs to know](https://usercentrics.com/guides/data-privacy/ai-and-data-privacy/) [Rethinking Privacy in the AI Era: Policy Provocations for a Data-Centric World | Stanford HAI](https://hai.stanford.edu/policy/white-paper-rethinking-privacy-ai-era-policy-provocations-data-centric-world) [The growing data privacy concerns with AI: What you need to know](https://www.dataguard.com/blog/growing-data-privacy-concerns-ai/) --- # Predefined Prompts URL: https://www.askthisguy.com/en/doc/admin-console/organization-settings/predefined-prompts/ Language: en Section: Documentation ## Standardize AI Interactions Across Your Organization **Predefined Prompts** let you create **reusable prompt templates** that your entire team can use with just two clicks. Instead of every employee crafting their own prompts from scratch, you define professional, optimized templates once - and everyone benefits from consistent, high-quality AI outputs. ### What Are Predefined Prompts? Think of Predefined Prompts as **AI interaction blueprints** for your organization. They're pre-configured prompt templates that: - **Standardize workflows** - Ensure everyone uses best practices when working with AI - **Save time** - Users insert proven prompts in two clicks instead of writing from scratch - **Improve quality** - Well-crafted templates produce better, more consistent results - **Capture expertise** - Codify your organization's knowledge into reusable AI instructions ### Common Use Cases Organizations use Predefined Prompts for a wide variety of tasks: **Document classification:** - Standardize tagging systems across departments - Apply consistent categorization to files and content - Automate content organization with predefined taxonomies **Content creation:** - Generate product documentation following your style guide - Draft blog articles with your brand voice - Create marketing copy that matches your messaging - Write customer communications with consistent tone **Data processing:** - Extract structured information from unstructured documents - Summarize reports in your organization's preferred format - Translate content while maintaining technical terminology **Analysis & research:** - Analyze feedback with standardized evaluation criteria - Review documents against specific quality checklists - Generate insights following your analytical frameworks ### How It Works **For Administrators (in the Admin Console):** 1. **Create a template** - Write your prompt with clear instructions and any necessary context 2. **Optimize with AI** - Use the built-in AI rewriting feature to automatically enhance your prompt 3. **Publish** - Make the template available to your team You maintain full control over which prompts are available and can update them anytime. **AI-Powered Prompt Optimization** Not sure if your prompt is optimized? ATG includes a **built-in AI rewriting feature** that automatically refines your prompts for maximum effectiveness. Simply write your initial prompt, then click the AI optimization button - ATG will restructure and enhance it using proven prompt engineering best practices. This ensures every Predefined Prompt delivers the **best possible results**, even if you're not a prompt engineering expert. ![Prompt configuration example in Admin Console](https://www.askthisguy.com/doc/predefined-prompts-config.webp) Prompt configuration example in Admin Console **For Users (in the web app at [app.askthisguy.com](http://app.askthisguy.com)):** 1. **Browse available prompts** - See all templates configured by your admin team 2. **Select a prompt** - Click to insert it into your conversation 3. **Add specifics** - Fill in any required variables or context 4. **Get results** - ATG processes your request with the optimized template It takes just **two clicks** to access professional-grade AI prompts. ![Prompt selection illustration in ATG's webapp](https://www.askthisguy.com/doc/documentation-for-administrators-smart-ai-services-for-your-users-predefined-prompts-image.webp) Prompt selection illustration in ATG's webapp ### Benefits **For the organization:** - **Consistency** - Everyone uses proven, high-quality prompts - **Efficiency** - Reduce time spent crafting and refining prompts - **Knowledge sharing** - Best practices spread across the team - **Control** - Administrators ensure AI usage aligns with company standards **For users:** - **Speed** - Insert expert-level prompts instantly - **Learning** - See examples of effective AI interactions - **Results** - Get better outputs without prompt engineering expertise - **Simplicity** - Focus on work, not on figuring out how to ask the AI ### Getting Started Administrators can create and manage Predefined Prompts directly from the **Admin Console**. Start with a few high-impact templates for your most common tasks, then expand your library based on team feedback and usage patterns. Users will find Predefined Prompts readily available in the ATG web app, making AI assistance as simple as point-and-click. --- # Press Review URL: https://www.askthisguy.com/en/doc/admin-console/organization-settings/press-review/ Language: en Section: Documentation ## Get AI-Powered News Briefings on What Matters to You **Press Review** delivers **custom news digests** tailored to your organization's interests. Write a brief describing what you want to track, and ATG will automatically search, filter, and compile relevant news on demand. ### What Is Press Review? Press Review is your **AI news researcher**. Instead of spending hours browsing news sites, define your interests once - then generate fresh, focused briefings whenever you need them. **Track anything:** - **Competitors** - Product launches, funding rounds, strategic moves - **Industry trends** - Regulations, innovations, market shifts - **Key accounts** - Customer or partner company news - **Specific topics** - Technologies, markets, geographic regions - **General themes** - Broad industry developments and patterns The brief is **completely flexible** - you decide what matters. ### How It Works **Administrators** configure Press Review in the Admin Console: 1. **Write a brief** - Describe what news to track in plain language (competitors, topics, industries, companies, keywords - whatever matters to you) 2. **Optimize with AI** - Use the built-in AI rewriting feature to enhance your brief for maximum relevance 3. **Publish** - Make it available to your team **AI-Powered Brief Optimization** Not sure how to structure your brief? ATG's **built-in AI rewriting feature** automatically refines it for optimal results. Simply write your initial description, then click the AI optimization button - ATG will restructure and enhance your brief using proven techniques, ensuring you get the **most relevant news** every time. ![Press review configuration in Admin Console](https://www.askthisguy.com/doc/documentation-for-administrators-smart-ai-services-for-your-users-press-review-image.webp) Press review configuration in Admin Console **Users** generate digests from the web app at [`app.askthisguy.com`](http://app.askthisguy.com): 1. **Select a Press Review** - Choose from configured digests 2. **Generate** - ATG searches the web, filters relevant articles, and compiles a structured briefing 3. **Read insights** - Get a comprehensive, easy-to-scan digest with the latest relevant news ![Press review example in ATG's webapp ](https://www.askthisguy.com/doc/press-review-example.webp) Press review example in ATG's webapp Each digest is **generated fresh** on demand, so you always get current information. ### Benefits **Save time** - Minutes instead of hours researching news **Stay focused** - Only see what's relevant to your business **Spot opportunities** - Catch competitive moves and market trends early **Make better decisions** - Base strategy on fresh market intelligence ### Use Cases - **Competitive intelligence** - Track what your competition is doing - **Account management** - Monitor customer and prospect news for timely outreach - **Strategic planning** - Gather market context for leadership discussions - **Industry awareness** - Stay current on sector developments and regulations ### Getting Started Administrators can configure Press Review in the **Admin Console**. The more specific your brief, the more relevant your digests will be. But don't worry about perfection - the AI optimization feature helps refine any brief for better results. Users generate digests anytime from the **ATG web app** - fresh intelligence, on demand. --- # Webapp URL: https://www.askthisguy.com/en/doc/webapp/ Language: en Section: Documentation The ATG webapp gives authenticated members of your organization access to AI agents configured for their work. Go to [app.askthisguy.com](https://app.askthisguy.com) and sign in to start a conversation. ## Start a conversation with an agent Every conversation requires an agent. When you start a new chat: 1. Open **New chat**. 2. Open the agent selector in the message composer. 3. Choose the agent that matches your task. 4. Write your message and send it. The selector only lists **active Webapp agents that you are allowed to use**. ATG preselects the agent you used most recently. ![Choose an agent before starting a new conversation in the ATG webapp](https://www.askthisguy.com/doc/webapp-select-agent-en.webp) The selected agent remains attached to the conversation after the first message. Start a new chat to use another agent. ## What the selected agent controls Your administrator configures each agent with: - **Instructions**: its role, behavior, tone, and response rules. - **Knowledge**: the knowledge categories and organizational sources it can search. - **Tools**: the capabilities it can use, such as knowledge search, web search, document retrieval, image generation, or custom tools. The agent configuration fully determines which tools are available. The webapp no longer provides buttons for users to enable Organization Knowledge or Web Search. You can describe the result you need, and the agent decides how to answer using only its enabled tools. If the agent does not have a required tool or knowledge category, start a new conversation with another available agent or contact your administrator. ## Add context to your request The message composer also lets you: - **Attach files** for the agent to analyze in the current conversation. - **Use predefined prompts** created by your organization. - **Choose the response mode** when this option is available. Personal attachments are specific to the conversation. They are different from the organization's knowledge sources. See [Using Attachments](https://www.askthisguy.com/doc/webapp/using-attachments) for supported files and usage details. ## Navigate the webapp The sidebar gives you access to: - **New chat**: start a conversation and choose an agent. - **Prompts**: open the prompt library. - **Press Reviews**: access configured press review features when available. - **Conversation history**: reopen previous conversations with their original agent and context. From your profile menu, you can change language, sign out, and open the Admin Console if you have administrator permissions. ## Share a conversation Conversation sharing passes an ATG conversation on to colleagues in the same organization, for review, alignment, or handing over a result. Only the conversation owner can start or stop sharing it. 1. Open a conversation from your history. 2. Select **Share** in the conversation header. 3. In the share panel, choose **Share with organization**. 4. Select **Copy link**, then send that link to the people concerned. The Share with organization panel opened from the header of an ATG conversation Once sharing is active, the button reads **Shared**. Reopen its menu at any time to copy the link again, or select **Stop sharing** to revoke access. Menu of a shared conversation, with the link to copy and the Stop sharing action ### What the recipient sees Anyone signed in to ATG, belonging to your organization and holding the link, opens the conversation in a dedicated read-only view. They can read the messages and see who shared the conversation, but they cannot reply, continue the discussion, or modify it. The shared conversation is not added to their history or sidebar. ### Sharing rules - Sharing covers every authenticated member of your organization. It is neither a per-person share nor a public link. - The link does not work for someone who is not signed in, for an account without an organization, or for a member of another organization. - **Stop sharing** revokes access immediately, including for people who already received the link. You can share again later: the same link works again as long as sharing is active. - A deleted conversation, or one whose sharing has been stopped, is shown as unavailable. - A link gives access to that single conversation, never to your history or to other conversations in the organization. Before sharing, check that the conversation can be seen by your whole organization. Stop sharing as soon as that is no longer the case. ## Get better answers - Choose the agent whose role best matches your task. - Give clear context, expected format, and relevant constraints. - Attach the specific files needed for the request. - Continue with follow-up questions inside the same conversation when you want to preserve context. For more guidance, see: - [LLM Best Practices](https://www.askthisguy.com/doc/webapp/llm-best-practices) - [Using Attachments](https://www.askthisguy.com/doc/webapp/using-attachments) --- # Voice mode: use an AI voice agent URL: https://www.askthisguy.com/en/doc/webapp/using-voice-mode/ Language: en Section: Documentation Voice mode lets you talk to an Ask This Guy agent like an AI voice assistant, instead of typing your entire message. Your conversation remains available in writing, and you can continue to use the keyboard, attach files, and choose a response mode as usual. **Scope:** voice mode is enabled separately for each agent. This page describes the feature in the authenticated ATG webapp. ## Check that voice mode is available Select an agent. If voice mode is enabled for it, a microphone button labeled **Speak** appears below the message field. Speak button below the message field for a voice-enabled agent If the button is missing or unavailable, one of the following may apply: - voice mode is not enabled for the selected agent or your organization; - the browser does not support the required audio recording; - the conversation is read-only or message input is temporarily disabled. ## Dictate a message 1. Select **Speak**. The button changes to a red stop button and a waveform shows that the microphone is listening. 2. If this is your first recording, allow the browser to use your microphone. 3. Speak naturally. The interface language helps the transcription service recognize the recording in the appropriate language. 4. Finish by selecting the red stop button, or pause after speaking. Recording stops automatically about **1.5 seconds after silence is detected** and is always limited to **60 seconds**. 5. Wait while **Transcribing…** is displayed. The recognized text is added to the message field. The transcript is ordinary text. It is appended to anything already in the field, so you can combine typing and dictation or record several successive segments. ## Review or cancel automatic sending After transcription, ATG displays **Sending in 2s**, then **Sending in 1s**. - Do nothing to send the message automatically. - Select **Cancel** to keep the transcript in the field and edit, complete, send, or discard it yourself. - Select the microphone again to cancel the countdown and start another dictation. Always review names, numbers, sensitive information, and technical references before sending them. ## Hear the agent's response When at least part of a sent message was dictated, ATG treats it as a voice turn and reads the agent's completed response aloud automatically. Editing or completing the transcript with the keyboard does not disable this behavior. While the agent is working, brief spoken updates may announce activities such as searching the knowledge base, browsing the web, consulting documents or data, or preparing a chart. If the operation takes longer, ATG may also ask you to wait a little longer. Each type of update is spoken only once per response. The audio bar shows **Preparing audio…** during speech synthesis and **Playing…** during playback. Select **Stop** to interrupt playback and clear any queued audio. If response generation fails, automatic playback is canceled. The spoken version is adapted for natural listening: Markdown markers, table separators, code blocks, images, and technical source markers are omitted. Link labels may be read, while the complete formatted response and its sources remain visible on screen. ## Listen to any response on demand Every completed agent response has a **Read aloud** action. You can use it even when the original question was typed, or to replay an older response in the conversation. Selecting **Read aloud** prepares and starts the audio. Select the square stop button to interrupt it. Starting another response replaces the audio already playing, so only one response is read at a time. ## Allow microphone access Your browser asks for microphone access on first use. The recording indicator remains active only while you are speaking, and the microphone stream stops when the recording ends. The audio clip is then sent for transcription. If access is blocked, ATG asks you to allow the microphone in your browser. Open the browser's site permissions, enable microphone access for ATG, and start a new recording. ## Current limitations - Voice mode may not be enabled for every organization or agent. - A single recording can last up to 60 seconds. - Transcription and speech synthesis require a network connection and do not work offline. - Voice mode uses separate recordings and reads the completed answer; it is not a continuous, real-time audio conversation. - The transcription provider, speech synthesis provider, and voice are configured for the agent. Users cannot change them from the chat. - There is no voice preference stored for each user. - Speaking does not automatically interrupt playback. Select **Stop** before using the microphone. - If the browser blocks automatic playback, use **Read aloud** on the completed response. ## Troubleshooting
SituationWhat to do
The microphone does not appearSelect another voice-enabled agent or ask your administrator to enable voice mode.
Microphone access is blockedAllow microphone access in the browser's site settings, then start a new recording.
ATG cannot transcribe the audioCheck your connection, reduce background noise, and try again.
Playback does not start automaticallySelect **Read aloud** below the completed response.
You need to correct the transcriptSelect **Cancel** during the two-second sending countdown.
## Frequently asked questions about voice mode ### Is ATG voice mode a phone voicebot? No. Voice mode works inside the ATG webapp: you dictate a message, the agent answers, and its response is read aloud. It does not place phone calls and does not hold a continuous real-time audio conversation, unlike a **voicebot** or a contact-center callbot. ### How is it different from a website voice chatbot? Voice mode runs in the authenticated webapp, with an AI voice agent connected to your internal knowledge and your tools. A website **voice chatbot** serves anonymous visitors. The [ATG Embedded](https://www.askthisguy.com/doc/atg-embedded) widget is not covered by this page: do not assume that voice is available there. See also the [Website chatbot](https://www.askthisguy.com/solutions/website-chatbot/) page. ### Is voice mode available for every agent? No. An administrator enables it agent by agent in the Admin Console. If the **Speak** button does not appear, select another voice-enabled agent or ask your administrator to enable it. ### Can I correct the transcript before sending? Yes. After transcription, ATG shows a two-second countdown. Select **Cancel** during that delay: the dictated text stays in the message field and can be edited like any written message. For configuration details, see [Configure voice mode for an agent](https://www.askthisguy.com/doc/admin-console/voice-mode). --- # LLM Best Practices URL: https://www.askthisguy.com/en/doc/webapp/llm-best-practices/ Language: en Section: Documentation > Large Language Model (LLM) chatbots like the ones underlying in Ask This Guy are powerful tools for accessing and managing information. To help you get the most out of your chatbot experience, here are some practical tips and important guidelines to keep in mind. Following this framework will help you craft effective prompts, ensuring better results and smoother interactions with ATG > ## Framework for writing good instructions (prompts) - **Be clear and specific:** State exactly what you want the chatbot to do or answer. - **Provide context:** include relevant background information to help the AI understand your intent. - **Use polite and concise language:** be respectful and keep your instructions brief but complete. - **Give examples when possible:** show the chatbot what kind of output you expect by including sample responses or formats. - **Rephrase or break down complex requests:** if your request is complicated, split it into smaller, simpler instructions. - **Ask for clarification if needed:** if the response isn't what you wanted, follow up with more specific questions or requests. ### Be clear and specific Always try to express your questions or requests as clearly as possible. Instead of saying, "Show me the report," try "Can you show me the sales report for Q1 2024?" This helps the chatbot understand exactly what you need. ### Provide context when needed If your question is about a specific project, team, or topic, mention it. For example, "How do I submit an expense report for the marketing team?" This extra context helps the chatbot give you a more accurate answer. ### Engage in dialogue If the chatbot's answer isn't quite what you expected, don't hesitate to ask follow-up questions or request clarification. You can say, "Can you explain that in simpler terms?" or "Could you give me an example?" ### Rephrase or simplify your questions If the chatbot doesn't understand your question, try rewording it or breaking it into smaller parts. For example, instead of asking a multi-part question, ask one part at a time. ### Use examples in your prompts Providing examples can help ATG better understand your intent. For instance, if you want a summary in a specific style, you can say, "Summarize this article in bullet points, like this: example." This makes it easier for the AI to match your expectations. ### Always verify important information ATG is designed to be helpful, but it can sometimes make mistakes or provide outdated information. For critical decisions or important tasks, double-check the chatbot's answers against official sources or documentation. LLMs are advanced, but they are not perfect. Their answers may sometimes be incorrect or incomplete. Always use your judgment and verify important information. ### Cite your sources when sharing answers If you share information from the chatbot with others, let them know where the information came from. This builds trust and helps others verify the information if needed. ### Respect confidentiality Only share information that you are authorized to access. Avoid entering sensitive or personal data unless you are sure the chatbot's privacy and security settings are appropriate. ### Don't share sensitive data unnecessarily Be mindful of the information you provide. If you're not sure whether something is confidential, check with your administrator or team leader before sharing. ### Avoid using only keywords Typing just keywords or very short phrases can confuse the chatbot. Always try to use complete sentences. ### Don't overload with jargon While LLMs understand a lot of technical language, using too much jargon or acronyms can sometimes lead to misunderstandings. Keep your language simple and clear, especially when you're just starting out. ### Use polite language While chatbots don't have feelings, using polite language (like "please" and "thank you") can make your interactions feel more natural and positive. --- # Using Attachments URL: https://www.askthisguy.com/en/doc/webapp/using-attachments/ Language: en Section: Documentation Attachments let you give **Ask This Guy** direct context from your files and your organization's documents, so answers can be **more accurate** and **traceable**. ### What you can do with attachments - **Use two kinds of sources** - **Organizational Documents**: shared resources available in your workspace. Your administrator defined which documents you have access to. - **My Files**: your personal uploads for the current workspace. This also includes files generated by ATG (e.g. images) - **Search by meaning (AI Search)** - Turn on **Activate AI Search** to find documents by concepts, not only filenames. This is a powerful feature to find files and documents that correspond to your request, whatever its origin. It searches in all organizational documents you have access to. - **Attach multiple files** - Ask cross-document questions and compare sources. ### How to attach a document (step by step) #### 1) Open the attachment menu In the chat input, click the **paperclip** icon. #### 2) Choose the source In the modal, pick one of the tabs: - **Documents** (Organizational Documents) - **My Files** #### 3) Find the right document - **Browse** the list - **Search by filename** using the search bar - **Search by meaning** - Toggle **Activate AI Search** - Type a natural-language query ![Attach Files dialog with AI search results](https://www.askthisguy.com/doc/attachments-ai-search.webp) #### 4) Attach and ask your question - Tick the checkbox next to one or more files. - Click **Attach item**. - When the file chip appears in your message bar, type your request and send. **Example questions** - "Summarize the key points of this document." - "What does this say about pricing for offer X?" - "Compare the requirements in file A vs file B." ### Options & tips - **Sorting**: sort results by **Recently updated** or **Alphabetical**. - **When to use AI Search**: it works best when you do not know the exact filename, or when you are looking for a concept. - **Be explicit**: if you want a quote or an exact paragraph, ask for it (e.g., "include the exact excerpt"). ### Limitations - **File size**: uploads are currently capped at **20 MB** per file. - **Minimum query length**: AI Search needs at least **3 characters**. --- # AI providers management URL: https://www.askthisguy.com/en/doc/infrastructure-and-security/ai-providers/ Language: en Section: Documentation ## Choose the right AI policy The AI models used by ATG depend on your organization's **AI policy** setting. - **EU-only**: only European providers are used - **Worldwide**: EU providers plus selected non-EU providers Learn more: [AI Policy](https://www.askthisguy.com/doc/admin-console/organization-settings/choosing-the-right-ai-policy) ## Secure provider usage All LLM interactions occur **exclusively through APIs** with contractual data protection guarantees: - **Your data is never used for model training** — every provider contract includes strict non-training clauses - **No risk of data leakage via training** or provider data collection This ensures that your organization's knowledge remains confidential and is never exposed through AI model training or third-party data collection. ## Provider scope **EU providers** (data sovereignty guaranteed):
Mistral Nebius Scaleway Black Forest Labs
- **Mistral** - French AI leader - **Nebius** - European AI infrastructure - **Black Forest Labs** - German AI innovation - **Scaleway** - French cloud & AI services **Worldwide providers** All EU providers plus: - **Cerebras** - **Groq** - **SambaNova** - **Google Gemini** - **OpenAI** - **DeepInfra** ## Our own GPU infrastructure On top of these providers, ATG also builds its **own GPU infrastructure** with **Verda**, a Finnish provider running data centers in **Finland** and **Iceland**. - We deploy and operate some open-weights models ourselves, on GPUs dedicated to ATG - We control the model version, its configuration, and its update cycle - Inference stays within a European perimeter: Finland is in the European Union, Iceland is in the European Economic Area, and both are covered by the GDPR These self-hosted models can be used under the **EU-only** policy, just like the European providers listed above. See [Our approach to sovereign AI](https://www.askthisguy.com/doc/infrastructure-and-security/sovereign-ai). **Note:** The provider list is subject to evolution as the AI landscape develops. All LLM costs are **included in your ATG subscription** - no surprise charges regardless of usage. --- # Your Data Management URL: https://www.askthisguy.com/en/doc/infrastructure-and-security/data-management/ Language: en Section: Documentation ## Why your data protection matters Your organization’s data is critical. It can include confidential documents, customer information, internal knowledge, and sensitive business context. ATG is designed to prevent this data from being exposed to unauthorized third parties, foreign jurisdictions, or uncontrolled “shadow AI” usage. ## Key risks, and how ATG addresses them ```mermaid flowchart TB subgraph risks["Risks"] R1[LLM training leakage] R2[Files over-retention] R3[US data transfers] end subgraph atg["How ATG addresses them"] A1[No training on your data] A2[Minimal retention, no 3rd-party storage] A3[EU-only policy blocks US providers] end R1 --> A1 R2 --> A2 R3 --> A3 ```

The diagram lines up the three main risks to your data with ATG's answer to each: no model training on your content, minimal retention with no third-party storage, and an EU-only policy that blocks US providers.

### 1) Public AI training & shadow AI leakage Many public AI systems can use consumer usage to improve models. Put simply: if an employee pastes confidential information into a public chatbot, it may end up contributing to a future model version, with no reliable traceability. **Our guarantee:** ATG only uses AI providers through APIs that contractually guarantee they **do not train models** on your data. ### 2) Minimal retention by design We follow a **minimal retention** approach: ATG keeps only what is necessary to operate the service. - We avoid storing raw files when they are not needed. - We do not store your data with third-party “hosted data” features (some AI providers offer this, we deliberately do not use it). ### 3) EU-only policy means no US transfers If your **AI policy** is set to **EU-only**, ATG does not transfer anything to US providers. Learn more: [AI Policy](https://www.askthisguy.com/doc/admin-console/organization-settings/choosing-the-right-ai-policy) ## Data transit: two distinct phases ATG handles data in two separate phases: 1. **Document preparation** (turning documents into an internal knowledge base) 2. **User answers** (answering questions using internal retrieval + controlled LLM calls) The **AI policy** has the biggest impact in phase 2 (LLM providers used for generation). ## Phase 1 — Document preparation (ingestion & RAG prep) ATG performs a full RAG preparation pipeline: text and images are extracted, processed, split into chunks, vectorized, and indexed. Learn more: [How is my company’s data processed? What is RAG?](https://www.askthisguy.com/doc/admin-console/knowledge-management/how-is-my-companys-data-processed-what-is-rag) ```mermaid flowchart LR Source["Customer sources (Drive, etc.)"] --> ATG["ATG backend"] ATG --> Prep["Extract + process"] Prep --> Vec["Vectorize (EU providers)"] Prep --> Img["Image understanding (EU providers)"] Prep --> OCR["OCR (full-document) via Mistral (when required)"] Vec --> Store["PostgreSQL + PGVector + S3 (self-hosted Supabase)"] Img --> Store OCR --> Prep ```

The diagram details the preparation phase: documents from your sources are extracted and processed by the ATG backend, then vectorized and analyzed by European providers, with a detour through Mistral OCR only when text conversion requires it. The result is stored on our side, in PostgreSQL with PGVector and S3 on a self-hosted Supabase.

### What may be sent to external services in phase 1 Some calls to external AI services can happen during preparation, strictly controlled by the backend: - **Image understanding**: European providers only - **Vectorization**: European providers only - **Full-document OCR**: the only time a whole document can be sent to a third party is for **conversion to text**, via **Mistral OCR** ### What is stored after preparation After preparation, ATG primarily stores: - the extracted text, split into **chunks** - vectors (embeddings) for search - selected images when they are kept ATG does **not** keep original files unless it is necessary: - **Uploaded files** can be kept **only** if an admin explicitly wants end users to be able to download them later - If documents come from an external drive/connector, ATG does not keep raw files (it is not needed) ## Phase 2 — Answering users (chat & search) ATG never sends your organization’s documents to LLM providers. The information retrieval happens **internally** (on OVHCloud ATG servers). What is sent to an AI provider is: - the user query - the small set of **relevant snippets** (chunks) selected by ATG as useful context ```mermaid sequenceDiagram participant U as User browser participant B as ATG backend participant DB as Storage/DB participant LLM as LLM providers U->>B: Send query B->>DB: Retrieve relevant chunks (PGVector) DB-->>B: Top-k snippets B->>LLM: Query + selected snippets (no full docs) LLM-->>B: Generated answer B-->>U: Answer + citations (frontend displays the response) ```

The diagram follows one question end to end: the ATG backend retrieves the relevant snippets from the vector store itself, then sends the LLM provider nothing but the user query and those few snippets. Full documents never leave ATG's infrastructure.

### Where AI policy matters The AI policy determines which external providers can be used in phase 2: - **EU-only**: European providers only - **Worldwide**: EU providers plus selected worldwide providers See: [AI providers management](https://www.askthisguy.com/doc/infrastructure-and-security/ai-providers) --- # Our approach to sovereign AI URL: https://www.askthisguy.com/en/doc/infrastructure-and-security/sovereign-ai/ Language: en Section: Documentation ## Our definition of sovereign AI For ATG, **sovereign AI** is not just about using a European model. Sovereignty depends on control over three complementary elements: 1. **The law that applies to the company** providing the service 2. **The infrastructure** that hosts the platform and the data 3. **The AI models** that process requests and their context This distinction matters. A platform can be hosted in Europe while calling an AI provider subject to a non-European jurisdiction. Conversely, a European model is not enough to make a solution sovereign if its infrastructure or operator falls outside the European perimeter. This page describes **our own implementation**. For the general definition, the assessment criteria and the questions to ask any vendor, see our [sovereign AI](https://www.askthisguy.com/sovereign-ai/) page. To go deeper into dependency and digital sovereignty issues, see [our articles on sovereignty](https://www.askthisguy.com/blog/tag/souverainete/). ## 1. A French company under European law Ask This Guy is a French company. Our contractual commitments and decisions about data processing sit within French and European law, including the GDPR. This first level of sovereignty gives you a counterpart established in France and a European legal framework. It is not enough on its own: infrastructure location and AI provider choices matter just as much. ## 2. European infrastructure, with an on-premise path The ATG platform is hosted in the European Union by companies under European law. Our main infrastructure relies in particular on dedicated OVHcloud servers in Gravelines, France, with redundancy in Frankfurt, Germany. The essential components stay within that perimeter: - ATG frontend and backend; - PostgreSQL and PGVector databases; - document and media storage; - backups and replication. The ATG backend is the control point for calls to external services. It accesses storage, applies access rules, and only sends the information required to the AI providers authorized by your policy. ### Our own GPU infrastructure in Europe ATG does not only consume external inference APIs. We also build our **own GPU infrastructure** with **Verda**, a Finnish provider running its data centers in **Finland** and **Iceland**. There, we deploy and operate some models ourselves, on GPUs dedicated to ATG. This layer complements the use of external providers and brings: - **AI hosted in Europe** all the way to the inference layer, with no context leaving our perimeter; - control over the model served: version, configuration, update cycle; - an operator under European law, since Finland is in the European Union and Iceland is in the European Economic Area, and therefore covered by the GDPR. Depending on the use case, ATG combines its own GPUs with selected third-party inference providers, within the limits of the AI policy your organization has chosen. ### Going further with on-premise For some organizations, sovereignty requires the platform to run in their own environment. We want **on-premise** to remain a possible option to go further in controlling infrastructure, network, and data location. Depending on context, scope, and security requirements, a dedicated deployment can be reviewed with your teams. The goal is to bring ATG closer to your trusted infrastructure, without giving up search, knowledge management, and AI assistance capabilities. ## 3. AI models: full sovereignty or better performance The AI market is moving fast. At this stage, there is still, depending on tasks and models compared, a performance gap between some US and European providers. That gap combines in particular: - inference speed; - reasoning and generation quality; - multimodal capabilities and native attachment support. We therefore prefer to be transparent about this trade-off rather than present theoretical sovereignty as a universal answer. ATG lets you choose the level that fits your organization. ## Two AI policies based on your requirements ### EU-only: maximum sovereignty The **EU-only** policy limits AI processing to providers under European law that run their services in Europe, plus the models we operate ourselves on our GPUs at Verda. This is the preferred choice when control of jurisdiction and European residency of processing are priorities. This policy fits an **AI hosted in Europe** approach and AI aligned with GDPR compliance requirements. It may, however, reduce model choice, speed, or capabilities for some use cases. ### Worldwide: an exception limited to the AI layer The **Worldwide** policy allows, in addition to European providers, selected international providers. It lets you benefit from the most capable or fastest models when that brings concrete value to your users. This exception concerns the AI layer. ATG's core infrastructure, storage, and databases remain hosted in Europe. Even with this policy, ATG: - only sends what is needed to process the request; - generally transmits the question and relevant excerpts, rather than full documents; - uses providers through governed APIs; - does not allow the LLMs used via ATG to train their models on your data. Choosing worldwide therefore does not remove our minimization and control requirements. It lets you explicitly trade off maximum sovereignty against operational performance. ## You stay in control at all times The AI policy can be changed at any time from the **AI Policy** menu in the admin console: [Configure the AI policy](https://www.askthisguy.com/doc/admin-console/organization-settings/choosing-the-right-ai-policy) You can start with a worldwide policy to evaluate performance, then switch to EU-only when your compliance requirements or use case require it. The reverse is also possible if your priorities change. For the exact available providers and their guarantees, see [AI providers management](https://www.askthisguy.com/doc/infrastructure-and-security/ai-providers). For data flow details, see [Your Data Management](https://www.askthisguy.com/doc/infrastructure-and-security/data-management). ## Our roadmap: letting you choose your AI Our longer-term goal is to offer a **Bring Your Own AI** mode. It will let organizations that want to connect their own models, providers, or inference endpoints keep more autonomy over the last link in the chain. This capability is on our roadmap. In the meantime, the EU-only and Worldwide policies already let you adapt the sovereignty level to each organization's risk, regulatory constraints, and performance goals. ## In summary Our approach to sovereign AI rests on three commitments: - **A French company** under French and European law - **European infrastructure**, including our own GPUs at Verda in Finland and Iceland, with an on-premise option for the most demanding needs - **An explicit choice for AI**, between European providers only and access to worldwide providers for better performance Sovereignty is not a slogan or a single switch. It is a documented trade-off that you can evolve as your constraints and model performance change. ## Frequently asked questions about sovereign AI ### What is sovereign AI for an enterprise? **Sovereign AI** is a solution where an organization controls the applicable legal framework, the infrastructure hosting its data, and the AI providers processing its requests. Using a European model alone is not enough if the operator or infrastructure falls outside that perimeter. ### Is AI hosted in Europe necessarily sovereign? No. European hosting is important, but it does not guarantee sovereignty on its own. You must also examine the law governing the operator and the AI providers processing requests. A solution may store its data in Europe while depending on a provider subject to a non-European jurisdiction. ### Is ATG a French AI company? Ask This Guy is a French company subject to French and European law. **French AI** is not the right description: we primarily provide a French platform for using AI. ### What is the difference between the EU-only and Worldwide policies? The **EU-only** policy limits AI processing to providers under European law that run their services in Europe. The **Worldwide** policy also allows selected international providers, while ATG's core infrastructure, storage, and databases remain in Europe. You can therefore choose between maximum sovereignty and access to a broader range of models. ### Does ATG run its own GPU infrastructure? Yes. On top of external AI providers, ATG builds its own GPU infrastructure with **Verda**, a Finnish provider whose data centers are located in **Finland** and **Iceland**. We deploy and operate some models there ourselves, which keeps inference within a European, GDPR-covered perimeter, alongside the platform hosted at OVHcloud. ### Can ATG be deployed on-premise? On-premise is an option considered for organizations that need more control over their infrastructure, network, and data location. Depending on the context, scope, and security requirements, a dedicated deployment can be reviewed with your teams. --- # Customizing ATG to YOU URL: https://www.askthisguy.com/en/doc/customizing-atg-to-you/ Language: en Section: Documentation This section describes how *Ask This Guy* (ATG) can be **adapted to your organization** beyond the standard, out-of-the-box setup. Different approaches are possible; ATG follows a **90-10** philosophy to keep most of the system generic while focusing customization where it brings the most value. **In this section** - [Introduction](https://www.askthisguy.com/doc/customizing-atg-to-you/introduction) – Approaches and the 90-10 model - [Tailored Processing](https://www.askthisguy.com/doc/customizing-atg-to-you/tailored-processing) – Custom document handling for your file types - [Tailored Tools](https://www.askthisguy.com/doc/customizing-atg-to-you/tailored-tools) – Query your enterprise APIs (CRM, internal tools, etc.) - [Database Query](https://www.askthisguy.com/doc/customizing-atg-to-you/database-query) – Natural-language SQL over your data --- # Infrastructure & Security URL: https://www.askthisguy.com/en/doc/infrastructure-and-security/ Language: en Section: Documentation ## Built for Performance, Security, and Data Sovereignty ATG's infrastructure has been **carefully designed** to deliver performance, security, and flexibility - while ensuring **complete control** over your data. Every technical choice reflects our commitment to **European data sovereignty** and best-in-class security practices. ### Architecture All of ATG’s infrastructure — **frontend**, **backend**, and **storage/databases** — runs on **dedicated ATG servers at OVHCloud**, with redundancy on a second physical site. That means a **European provider** and data not subject to US legislation (e.g. Cloud Act, Patriot Act). Primary site: **Gravelines (France)**; secondary: **Frankfurt (Germany)**. Your device talks only to the frontend and backend; the backend alone accesses storage and databases and is the only component that calls **external services** (e.g. LLMs, web search). Your data stays on ATG’s European servers; any call to an AI or other external provider goes through our backend under strict control. **Our own GPUs, on top of external providers:** ATG does not only call external AI providers. We also build our **own GPU infrastructure** with **Verda**, a Finnish provider running data centers in **Finland** and **Iceland**. We deploy and operate some models there ourselves, on dedicated GPUs, without leaving the European perimeter (Finland is in the European Union, Iceland is in the European Economic Area, and both are covered by the GDPR). Details on the [AI providers management](https://www.askthisguy.com/doc/infrastructure-and-security/ai-providers) page. **Technologies in use:** - **Python** for the entire backend, enabling seamless integration across platform services and modules - **PostgreSQL** for structured data and metadata, **PGVector** for AI-powered semantic search, **S3** for documents and media. In practice this is **Supabase**, but **self-hosted** on ATG’s OVHCloud servers and fully managed by ATG
Python PostgreSQL OVHcloud
### Hosting & Data Redundancy **European infrastructure with European providers** - Primary site: **Gravelines (France)**; secondary site: **Frankfurt (Germany)** for physical redundancy - **Hourly backups** are automatically sent to the secondary site - All data resides on **OVHCloud virtual private servers** with high-performance **SSD storage** - Some AI processing runs on **GPUs dedicated to ATG** at **Verda**, in **Finland** and **Iceland** **Security certifications:** - OVHCloud maintains **ISO/IEC 27001, ISO/IEC 27017, and ISO/IEC 27018** certifications - These certifications guarantee compliance with international best practices for security and data protection **Data sovereignty principles:** - All sensitive information is handled in a **sovereign manner** within Europe - Data sharing with non-European entities is **limited or eliminated** based on your organization's AI policy choice - ATG follows a **minimal data retention** policy - we notably **do not store files** from external connectors after processing This ensures your knowledge stays under your control, within European borders. Continue reading: - **[Our approach to sovereign AI](https://www.askthisguy.com/doc/infrastructure-and-security/sovereign-ai)**: the three levels of sovereignty and the choice between EU-only and worldwide policy - **[AI providers management](https://www.askthisguy.com/doc/infrastructure-and-security/ai-providers)**: how ATG selects and uses LLM providers based on your AI policy - **[Your Data Management](https://www.askthisguy.com/doc/infrastructure-and-security/data-management)**: a didactic view of how your data is processed, retained, and protected ### Why This Matters These technical choices ensure that ATG delivers: - **Performance** - Fast, reliable AI-powered search and chat - **Security** - Enterprise-grade protection with ISO-certified infrastructure - **Sovereignty** - Your data stays in Europe, under your control. And is not subject to Patriot Act, Cloud Act or other foreign legislations in you stay in EU policy - **Privacy** - Minimal data retention and no unnecessary file storage - **Flexibility** - Choose the AI providers that match your compliance requirements Your knowledge, your rules, your infrastructure. --- # Frequently Asked Questions URL: https://www.askthisguy.com/en/doc/frequently-asked-questions/ Language: en Section: Documentation ### Where are ATG's servers located? All This Guy servers are **hosted in the European Union** by EU providers, ensuring data sovereignty and GDPR compliance by default. Key security features: - **EU data residency** with replication across European data centers - **Minimal data retention** policy - only what's necessary for service delivery - **Original documents not stored** - only converted, indexed versions - **Flexible AI provider selection** - choose EU-only or worldwide providers This EU-first approach means your data stays within European jurisdiction, giving you full compliance and control. *Learn more: [Infrastructure & Security](https://www.askthisguy.com/doc/infrastructure-and-security)* ### How does ATG handle user permissions and data access? ATG uses **agent-based access control** for Webapp users: - Administrators make a Webapp agent open to everyone or restrict it to selected users. - Knowledge categories are assigned to agents, not users. - Tools are enabled on each agent by administrators. - Users only see active Webapp agents they are allowed to use. To protect sensitive information, create a specialized agent with the required knowledge categories and restrict that agent to authorized users. *Learn more: [Webapp](https://www.askthisguy.com/doc/admin-console/users-management)* ### Can ATG perform actions in our internal systems? Yes! Beyond searching and answering questions, Ask This Guy (ATG) can be extended with **custom tools** that integrate with your business systems. Custom tools can: - **Update your CRM** with customer information - **Trigger workflows** in your business applications - **Query internal databases** for specific data - **Create tickets** in your support system - **Send notifications** to team members - **Execute business-specific actions** unique to your organization These custom tools are developed specifically for your needs and can make Ask This Guy a truly integrated part of your tech stack. For write operations, the system always prompts users for approval before executing actions, ensuring control and preventing unintended consequences. *Learn more: [Tools and MCP](https://www.askthisguy.com/doc/admin-console/tools-management)* ### General Information ### What exactly is Ask This Guy? Ask This Guy (ATG) is an intelligent AI-powered assistant designed for businesses that helps teams quickly find information from their company's internal data or the web, and leverage AI to perform various tasks. Accessible through a simple chat interface or embeddable widgets, it delivers accurate, reliable, and contextualized answers wherever employees need them. Powered by leading AI models, ATG clearly indicates its sources for every answer, allowing organizations to verify information and retain control over the content they produce. ### When was the company created? Ask This Guy was created in **February 2025**. ### Where is the company based? The company is **domiciled and based in France**. ### Who are the founders of Ask This Guy? Ask This Guy was founded by **Rémi Chkaibane** and **Jean-Christophe Budin**, experienced engineers from **INSA Lyon**. ### Is Ask This Guy already commercialized? Yes. Ask This Guy has been **commercially available since 2025**. - **Clients are already deployed** in production environments (deployments since 2025). - The company is **profitable from its first fiscal year** and **self-funded**. ### How is pricing determined, and what is the minimum subscription? Ask This Guy offers **three pricing models** depending on your use case: - **Website chatbot**: **€90/month** all-inclusive (up to 200 messages/month). - **Product support assistant**: **€190/month** (up to 500 messages/month). - **Other solutions** (RAG, Talk to Data, automation, custom AI): pricing **set with you** after a needs assessment, based on the number of users and/or the volume of messages handled. In all cases: - **Flat-rate billing**: no per-token surprises or opaque charges. - **No commitment** beyond the first month. - **Integrations and custom development**: fixed-price quotes (your requirements → our firm proposal), no unpleasant surprises; code and intellectual property remain with the client. Contact [bonjour@askthisguy.com](mailto:bonjour@askthisguy.com) for a quote tailored to your context. ### Which AI models and providers does Ask This Guy use? ATG is powered by leading AI models from providers including Cerebras, Groq, SambaNova, Gemini, Mistral, Nebius, DeepInfra, OpenAI, Black Forest Labs, and Scaleway. Organizations can choose between EU-based providers (ensuring data sovereignty with servers hosted in the European Union) or worldwide providers, depending on their compliance requirements and preferences. ### What languages can ATG speak? ATG supports nearly any language. Ask your questions in the language you're most comfortable with, and it will understand and respond accordingly. ### How does ATG decide which tools and sources to use? Administrators determine the tools available to each agent. Depending on its configuration, an agent might: - **Search your company's knowledge base** for internal documentation and information - **Search the web** for current news, trends, or external information - **Look for specific documents** by name or content within your organization - **Fetch content from URLs** you provide or that are relevant to your question - **Access connected platforms** like Confluence, Notion, or Slack The agent selects the relevant tools among those enabled for it. Users cannot enable or disable tools from the webapp. You can describe the desired result or ask the agent to use a particular source, but it can only use tools and knowledge configured by an administrator. ### Using Ask This Guy ### What kind of tasks can I use This Guy for on a daily basis? Ask This Guy (ATG) is truly a versatile assistant! You can use it just like you might use other AI chatbots, for a wide range of tasks: - **Content Creation:** Ask it to write emails, summaries, reports, LinkedIn posts, or even brainstorm marketing ideas. - **Collaboration:** Use it to brainstorm with you, help structure a project, or improve existing texts. - **Information Retrieval:** Simply ask your questions and get answers based on your internal documents, the Internet, or the AI's general intelligence. - **Data Queries:** Ask questions in natural language to query structured databases directly, making it easy to extract insights without needing technical query languages. - **Embedded Support:** Access This Guy directly within your institutional websites, IT tools, and web applications through embedded widgets, providing assistance exactly where you need it. The main goal is to provide you with relevant, rapid responses that are perfectly adapted to your professional context! ### Can you give me some examples of questions or prompts I can use? Absolutely! Here are some common use cases to get you started: - "Write a follow-up email to a prospect who's been inactive for 2 weeks." - "What are the key findings of our latest sales report?" - "Tell me the latest news from our competitors." - "Summarize our HR maternity leave policy for me." - "Explain how our latest product offer works in 3 simple sentences." Here are examples using This Guy within embedded widgets and querying structured data: **Widget Context Examples:** - "I'm on the employee portal - what's the process for requesting remote work?" - "I'm looking at our product catalog - can you explain the pricing tiers for our enterprise plan?" - "I'm in the customer support tool - what's our standard response time policy?" - "I'm on the IT help desk page - how do I reset my VPN credentials?" **Querying Structured Data Examples:** - "What were our total sales in Q3 2024 by region?" - "Show me the top 5 performing products from last month's sales data." - "Which experiments in our research database had a success rate above 85%?" - "What's the average customer satisfaction score for our support team this year?" - "How many units of Product X were sold in France during the last quarter?" - "Compare our monthly revenue growth between January and October 2024." These examples show how Ask This Guy (ATG) can assist you directly within your workflow tools and help you extract insights from complex datasets using simple, natural language questions. ### How does Ask This Guy ensure the information it provides is reliable and traceable? Ask This Guy (ATG) is designed to keep you in control. With each answer, it clearly indicates its sources, whether they are internal documents or web links. This allows you to easily verify the information and trace its origin, ensuring you retain control over the content you produce while gaining efficiency. ### Ask This Guy and Your Organization's Knowledge ### How does Ask This Guy manage my organization's internal knowledge? Ask This Guy (ATG) is designed to give you quick access to your company's essential information without you having to sift through countless files or tools. Here's a quick peek behind the curtain: - **Curated Knowledge Base:** Your This Guy workspace administrators are the ones who select, centralize, organize, and categorize the information that becomes accessible through the assistant. This ensures the data is always relevant and reliable. - **Diverse Information Sources:** Administrators can include data from various platforms, such as: - Confluence (spaces, pages, documentation bases) - Files (PDF, Word, PowerPoint, etc.) uploaded directly - Notion workspaces - Slack conversations and shared files - Automatically selected and crawled web pages - **Structured Categories:** Each source is linked to a knowledge category. Administrators assign categories to agents according to their role and use case. - **Agent-Based Access:** Users receive access to Webapp agents, not to individual categories. A restricted agent can protect confidential categories. - **Controlled Search:** An agent can search its assigned categories only when the Knowledge Base Search tool is enabled for that agent. Users do not activate knowledge search from the chat interface. - **Traceable Answers:** When the agent uses organizational knowledge, it cites the documents or pages used in its answer. ### Tips for Effective Interaction ### What are the best practices for writing effective instructions (prompts) for This Guy? To get the most accurate and useful responses from This Guy, how you phrase your questions (we call them "prompts" in AI-speak!) is really important. Here are some tips to help you craft effective prompts: - **Be Clear and Specific:** Always try to express your questions or requests as clearly as possible. For example, instead of "Show me the report," try "Can you show me the sales report for Q4 2025?" - **Provide Context:** If your question relates to a specific project, team, or topic, be sure to mention it. For instance, "How do I submit an expense report for the marketing team?" - **Engage in Dialogue:** If the initial answer isn't quite what you expected, don't hesitate to ask follow-up questions or request clarification. You could say, "Can you explain that in simpler terms?" or "Could you give me an example?" - If Ask This Guy (ATG) doesn't seem to understand your question, try rewording it or breaking it down into smaller, more manageable parts. - **Use Examples:** Providing an example can help This Guy understand your intent better. If you want a summary in a particular style, you could say, "Summarize this article in bullet points, like this: [example bullet points]." ### Is it necessary to verify the information provided by This Guy? Yes, absolutely! While Ask This Guy (ATG) is a powerful tool designed to be very helpful, it's an AI, and like all AI models, it can sometimes make mistakes or provide information that's outdated. For critical decisions or important tasks, it's always a good practice to double-check the answers against official sources or documentation. Your judgment is key! ### What should I keep in mind regarding data privacy and confidentiality when using This Guy? Your data security is important! Here are a couple of things to remember: - **Respect Confidentiality:** Only share information that you are authorized to access - **Avoid Unnecessary Sensitive Data:** Be mindful of the information you provide. Unless you are absolutely sure that Ask This Guy's privacy and security settings are appropriate for it, avoid entering sensitive or personal data. If you're ever in doubt, it's best to check with your administrator or team leader first. ### What should I avoid when interacting with This Guy? To ensure you have the smoothest and most effective interactions, try to steer clear of these: - **Using Only Keywords:** Typing just keywords or very short phrases can sometimes confuse the chatbot. Always try to use complete sentences! - **Overloading with Jargon:** While This Guy understands a lot of technical language, using too much jargon or too many acronyms can occasionally lead to misunderstandings. Keep your language simple and clear, especially when you're just getting started. ### Should I use polite language when talking to This Guy? While This Guy doesn't have feelings (it's an AI, after all! ), using polite language like "please" and "thank you" can make your interactions feel more natural and positive. It's a nice habit to maintain! ### AI Agents & Customization ### What are AI Agents in This Guy? Every ATG conversation uses an **agent**. Agents can be tailored for specific purposes within your organization. Each agent can have: - **Unique instructions and personality:** Define how the agent interacts and responds (e.g., customer support bot, sales assistant, technical helper) - **Specific tools:** Choose which capabilities the agent can use (knowledge search, web search, image generation, custom tools, etc.) - **Knowledge access:** Control which knowledge categories and information sources the agent can access - **AI policy:** Select EU-based or worldwide AI providers based on your compliance needs This means you can create different agents for different teams or use cases, each optimized for its specific role! Choose **Webapp** when the agent will be used by authenticated members of your organization, or **Widget** when it will be embedded in a website or application. The type is permanent after creation. *Learn more: [Agents](https://www.askthisguy.com/doc/admin-console/how-to-configure-the-agents) • [ATG Widget](https://www.askthisguy.com/doc/atg-embedded)* ### How do users choose an agent in the ATG webapp? Users choose an active Webapp agent they are authorized to use when starting a new chat. ATG preselects the last agent used. After the first message, the selected agent remains attached to the conversation, so users start a new chat to choose another agent. *Learn more: [Webapp](https://www.askthisguy.com/doc/webapp)* ### What's the difference between built-in tools and custom tools? **Built-in tools** come standard with This Guy and include capabilities like web search, knowledge base search, document retrieval, URL fetching, and image generation. Administrators can enable or disable these for each agent. **Custom tools** are developed specifically for your organization to address unique needs, such as integrating with proprietary systems, performing specialized data queries, or triggering specific business workflows. These tools extend This Guy's capabilities beyond the standard feature set. Both types of tools are configured per agent. Users can benefit from a tool only through an agent on which that tool is enabled. *Learn more: [Tools and MCP](https://www.askthisguy.com/doc/admin-console/tools-management)* ### ATG Widget & Integration ### Can we embed Ask This Guy directly into our websites or applications? Absolutely! Ask This Guy (ATG) offers **embeddable widgets** that can be integrated into: - Your **corporate websites** for visitor assistance - **Internal systems and tools** for employee support - **SaaS products and web applications** for customer-facing AI assistance The **ATG widget** can be fully customized with your branding, configured with a dedicated Widget agent, and integrated with your platform's data and workflows. It's perfect for providing AI assistance exactly where your users need it, without leaving your application. *Learn more: [ATG Widget](https://www.askthisguy.com/doc/atg-embedded)* ### How does the ATG widget differ from the standard web app? The ATG widget is designed for **integration into your own platforms**, while the standard web app at [app.askthisguy.com](http://app.askthisguy.com) is for internal employee use. **ATG widget features:** - Full visual customization and branding - API-based integration requiring minimal development - Context-aware responses using your platform's data - Client-specific metadata support for personalized interactions - Custom tool integration for platform-specific actions - No user management required (uses your existing authentication) Both solutions share the same underlying knowledge base and can use the same configured sources, ensuring consistency across all deployment channels. *Learn more: [ATG Widget](https://www.askthisguy.com/doc/atg-embedded)* ### Advanced Services ### What is the Press Review service? **Press Review** is an AI-powered news digest service that helps teams stay informed about relevant topics without spending hours researching. Administrators create "briefs" with specific topics, keywords, and focus areas. Users can then generate fresh, customized news digests on demand that: - Search the web for current, relevant articles - Filter content based on the configured brief - Compile a structured, easy-to-scan report - Provide insights on competitive intelligence, market trends, and industry news It's perfect for competitive intelligence, account management, strategic planning, and staying on top of what matters to your business. *Learn more: [Press Review](https://www.askthisguy.com/doc/admin-console/organization-settings/press-review)* ### What are Predefined Prompts? **Predefined Prompts** are ready-to-use templates that help users get professional-quality results with just a few clicks. Administrators create and optimize prompts for common tasks (like writing follow-up emails, summarizing reports, or analyzing data). Users can then: - Browse available prompt templates - Select a prompt with one click - Add specific details or variables - Get consistent, high-quality results This ensures everyone uses proven, effective prompts without needing to be prompt engineering experts. ATG even includes an AI-powered optimization feature that helps administrators refine prompts for maximum effectiveness. *Learn more: [Predefined Prompts](https://www.askthisguy.com/doc/admin-console/organization-settings/predefined-prompts)* ### Data Sources & Connectors ### What types of data sources can This Guy connect to? This Guy can integrate with a wide range of platforms and data sources: **Standard Connectors:** - **Confluence** (spaces, pages, documentation) - **Notion** (workspaces, pages, databases) - **Google Drive** (documents, spreadsheets, presentations) - **SharePoint/OneDrive** (Microsoft document repositories) - **Slack** (conversations and shared files) - **File uploads** (PDF, Word, Excel, PowerPoint, images, etc.) - **Web pages** (automated crawling of specified sites) - **Email** (share documents via email) **Custom Connectors:** ATG can develop specialized connectors for your proprietary systems or unique data sources on demand. All connectors automatically sync to keep your knowledge base up to date! *Learn more: [Connectors](https://www.askthisguy.com/doc/admin-console/knowledge-management/connectors)* ### How does This Guy handle images and visual content in documents? This Guy uses **advanced multimodal AI processing** to understand both text and images within your documents. The system: - **Extracts images** from PDFs, Word documents, presentations, and other files - **Analyzes visual content** using computer vision AI (charts, diagrams, photos, technical illustrations) - **Generates detailed descriptions** of each image with business context - **Indexes both text and images** for comprehensive search - **Can reference images** in responses, providing context-aware answers that include visual information This means when you ask questions, This Guy can draw insights from both the written content AND the visual elements in your documents - achieving 95%+ accuracy with support for 50+ languages. *Learn more: [Documents & Images](https://www.askthisguy.com/doc/admin-console/knowledge-management/how-documents-images-are-processed-by-atg)* ### Can users attach files directly in conversations? Yes! Users can attach files directly to their messages, including: - **Documents:** PDF, Word, PowerPoint, text files - **Media:** Images, videos, audio files - **Spreadsheets:** Excel and other structured data This Guy will analyze the attached files immediately and provide answers based on their content, making it easy to get insights from files without needing to add them to the knowledge base permanently. ### Technical & Security ### What is RAG and why does it matter? **RAG (Retrieval Augmented Generation)** is the technology that makes This Guy's answers accurate and trustworthy. Here's how it works: 1. **You ask a question** 2. **This Guy searches** your knowledge base using both semantic and keyword search 3. **Relevant documents are retrieved** and provided as context 4. **The AI generates an answer** based on the retrieved information (not just from memory) 5. **Sources are clearly cited** so you can verify the information This approach **minimizes AI "hallucinations"** (made-up information) and ensures answers are grounded in your actual documents and data. The RAG system converts all documents - including images - to markdown format and creates vector embeddings for intelligent semantic search. *Learn more: [Data & RAG](https://www.askthisguy.com/doc/admin-console/knowledge-management/how-is-my-companys-data-processed-what-is-rag)* ### Can we control which AI providers process our data? Yes! This Guy offers flexible **AI policy selection**: - **EU Policy:** Data is processed only by EU-based AI providers with servers in the European Union - **Worldwide Policy:** Allows use of additional global providers like OpenAI Administrators can choose the policy that matches your compliance requirements. ATG integrates with multiple leading providers including Mistral, Nebius, Scaleway, Cerebras, Groq, SambaNova, Gemini, DeepInfra, OpenAI, and Black Forest Labs, giving you both flexibility and control. *Learn more: [AI Policy](https://www.askthisguy.com/doc/admin-console/organization-settings/choosing-the-right-ai-policy)* ### Troubleshooting ### I'm not receiving emails (invitations, confirmation codes, etc.) If you're not receiving emails sent by Ask This Guy (invitations, confirmation codes, notifications), here are the steps to follow based on your environment: **Microsoft 365 environment:** - First, check your **Junk Email** folder - Check the **Microsoft quarantine**: [https://security.microsoft.com/quarantine](https://security.microsoft.com/quarantine) - If you find the emails, ask your IT administrator to add [team@askthisguy.com](mailto:team@askthisguy.com) to the allowlist **Google Workspace environment:** - First, check your **Spam** folder - Contact your **IT administrator** to check the quarantine: [**admin.google.com**](http://admin.google.com) ⇒ Apps > Google Workspace > Gmail > Quarantine - If emails are in quarantine, ask your administrator to configure rules to allow Ask This Guy senders **General tip:** Make sure the email address used in your This Guy profile is correct and active. **Still having issues?** Contact our support team at [support@askthisguy.com](mailto:support@askthisguy.com) ### This Guy can't find the information I'm looking for If This Guy cannot find the expected information: - **Check your wording:** Try rephrasing your question more clearly and specifically - **Provide context:** Mention the document name, project, or knowledge category concerned - **Check the selected agent:** Start a new chat with another available agent if the subject does not match the current agent's role - **Contact your administrator:** The selected agent may not have the required knowledge category or Knowledge Base Search tool ### This Guy is slow or not responding If you're experiencing performance issues: - **Check your Internet connection:** An unstable connection can affect performance - **Refresh the page:** A simple reload can resolve temporary issues - **Try another browser:** Some browsers may work better than others - **Check extensions:** Some browser extensions can interfere with This Guy - **Contact support:** If the problem persists, report it to your administrator or contact ATG support at [support@askthisguy.com](mailto:support@askthisguy.com) --- # Comment fonctionne l'IA : les 10 concepts à comprendre avant de signer URL: https://www.askthisguy.com/fr/blog/how-ai-works-key-concepts/ Language: fr Section: Blog Cet article s'adresse à celles et ceux qui s'intéressent à l'IA, en perçoivent le potentiel, mais n'ont ni le temps ni l'envie d'en faire leur métier. Vous voudrez probablement déléguer vos besoins d'IA à une équipe interne ou à des prestataires. C'est légitime. Mais vous ne ferez pas l'économie de les challenger, et pour ça il faut comprendre quelques concepts clés, et surtout ce qu'ils impliquent pour un projet d'entreprise. Voici donc dix notions à connaître. Pas de maths, pas plus de jargon que le minimum. De quoi comprendre de quoi on parle, suffisamment pour gérer la partie métier d'un projet d'IA. *Le contenu de cet article a d'abord été publié cet été [sur LinkedIn](https://www.linkedin.com/posts/budin_internet-%C3%A7a-ne-marchera-jamais-cette-activity-7486371581913456640-wWIV), un concept par jour.* ## Si vous ne devez retenir qu'une chose Il n'y a rien de magique là-dedans. Des poids numériques réglés par l'exemple, du texte découpé en fragments, des outils branchés autour, vos documents posés au bon moment sur le bureau du modèle, et beaucoup d'ingénierie pour que l'ensemble tienne debout. Ce que ces dix concepts vous apprennent tient en deux phrases. **Votre facture ne dépend presque jamais du modèle que vous choisissez, mais de la façon dont vous vous en servez.** Et **le POC, la démonstration qui vous a convaincu, représente environ 20 % du coût total du projet.** Rien là-dedans ne justifie de survendre. Rien non plus ne justifie d'attendre. --- ## Partie 1 : de quoi un modèle est fait ### 1. Le réseau de neurones Un logiciel classique est une suite d'instructions écrites par un humain. « Si le client a plus de trois commandes, applique 10 % de remise. » Une règle, appliquée bêtement, avec un résultat prévisible. Pour l'écrire, encore faut-il pouvoir la formuler. Écrivez-moi maintenant la règle qui reconnaît si une photo représente un chat. Vous n'y arriverez pas. Un cerveau le fait sans effort, alors les informaticiens s'en sont inspirés. Un **réseau de neurones**, c'est une entrée qui traverse des millions ou des milliards de poids numériques et qui ressort en une sortie. Ces poids n'ont pas été programmés : ils se sont réglés d'eux-mêmes à partir d'exemples. Si vous les ouvrez, vous n'y verrez aucune logique. ![Schéma d'un réseau de neurones : une couche d'entrée reçoit des photos de chats et de chiens, les signaux traversent plusieurs couches internes de neurones interconnectés, et la couche de sortie sépare les images en deux catégories, chats et chiens](https://www.askthisguy.com/blog/how-ai-works-key-concepts/schema-reseau-de-neurones.webp) Un chat sur une photo, une phrase à compléter, un contrat à résumer : toujours le même principe. **Des poids, pas des règles.** La conséquence est considérable, et elle vous concerne directement. Personne, pas même ceux qui ont construit le modèle, ne peut vous dire précisément pourquoi il a répondu ceci plutôt que cela. Ce n'est pas un défaut de fabrication, c'est la nature de la chose. Sur un chat, on s'en moque. Sur un refus de crédit, un diagnostic ou un devis, beaucoup moins. C'est toute la raison pour laquelle la manière d'encadrer l'IA en entreprise n'est pas un détail d'implémentation. ### 2. Les paramètres Ces poids portent un autre nom : les **paramètres**. Ce sont les fameux « 8B », « 70B », « 405B » que vous voyez accolés aux noms de modèles. Pour donner une échelle : reconnaître un chat sur une photo demande environ 2,5 millions de paramètres. Comprendre et écrire le langage humain est une autre affaire, et les plus gros modèles dépassent aujourd'hui les 1 000 milliards. À titre de comparaison, l'équivalent biologique du poids serait la synapse : une mouche en a 50 millions, une souris 1 000 milliards, un humain 100 000 milliards. Ce que contiennent ces poids, personne ne peut le lire. On peut les voir comme deux choses mélangées : de la connaissance et une capacité de raisonnement. La seconde compte davantage, et elle vient surtout de la façon dont le modèle est affiné après son apprentissage initial. C'est pour cette raison que **la course à la taille s'est calmée**. En 2020, les 175 milliards de paramètres de GPT-3 étaient un record. Aujourd'hui, un modèle de 8 milliards fait mieux que lui sur la plupart des tâches. Mieux entraîné, mais plus petit. ![Nuage de points comparant le niveau des modèles ouverts à leur nombre de paramètres, en échelle logarithmique. La courbe monte fortement jusqu'à une trentaine de milliards de paramètres, puis s'aplatit : au-delà, multiplier la taille par cent ne fait plus gagner que quelques points](https://www.askthisguy.com/blog/how-ai-works-key-concepts/intelligence-vs-parametres-modeles.webp) À entraînement comparable, un gros modèle reste plus capable qu'un petit. Mais regardez où la courbe s'aplatit : passé quelques dizaines de milliards de paramètres, chaque décuplement de taille ne rapporte plus que quelques points. **La taille seule ne dit plus qui gagne.** Pourquoi ça vous concerne : plus gros signifie plus cher, plus lent, plus gourmand en énergie. Comptez 0,35 € le million de tokens générés pour un Mistral Small chez Scaleway, contre 50 $ pour le modèle le plus cher d'Anthropic. Plus de cent fois l'écart, alors que pour résumer un compte rendu de réunion ou détecter des avis négatifs, le petit modèle fait le travail. Les plus petits tournent même en local, sur un portable ou un smartphone, sans que vos données ne sortent. Dans un projet d'IA, l'enjeu n'est pas de prendre le meilleur modèle. C'est de prendre le bon modèle pour chaque tâche. Pas besoin d'un humain pour trouver la sortie du labyrinthe. La souris sait le faire aussi. ### 3. L'entraînement Si personne ne sait ce que contiennent ces milliards de poids, comment les a-t-on déterminés ? On ne les a pas écrits : on les a fait émerger, par **l'entraînement**. C'est un chantier industriel qui mobilise des milliards de dollars en calcul, en énergie et en expertise. Il se déroule en deux temps. Le **pré-entraînement** part de paramètres aléatoires. On fait avaler au modèle un corpus énorme, tout Internet, les livres, et on lui demande de prédire le mot suivant. « Le médecin examine le patient avec son… » donne « stéthoscope ». À chaque prédiction, on mesure l'erreur et on corrige les poids. Des milliards de fois. Peu à peu, le modèle construit des représentations internes des structures du langage. Le **post-entraînement** affine ensuite cette base : des résultats vérifiables, l'imitation d'un modèle plus performant, des arbitrages humains du type « vous préférez la réponse A ou la réponse B ». À la sortie, on obtient un modèle aux **poids figés**. Retenez ce mot, figés. C'est lui qui rend fausse la promesse commerciale la plus répandue du marché, celle qu'on entend dans à peu près toutes les réunions d'avant-projet : > « On va entraîner une IA sur les données de votre entreprise. » Le modèle que vous utilisez ne change pas quand vous vous en servez, et il n'apprend rien de vos documents. ![Classement des modèles selon un indice de niveau général, avec le drapeau du pays d'origine. Les deux premiers sont américains, les deux suivants chinois et très proches, les modèles français arrivent nettement derrière et le modèle suisse ferme la marche](https://www.askthisguy.com/blog/how-ai-works-key-concepts/intelligence-index-modeles-par-pays.webp) Deux pays dominent aujourd'hui cette étape, les États-Unis et la Chine, et l'Europe a perdu cette bataille pour l'instant. C'est moins grave qu'il n'y paraît : beaucoup de modèles chinois et quelques américains sont ouverts, donc téléchargeables et exécutables chez vous. Nous détaillons ce que « ouvert » recouvre vraiment dans notre article sur l'[open source et les open weights](https://www.askthisguy.com/fr/blog/open-source-vs-open-weights-ai/). À choisir, perdre la bataille des modèles est moins grave que perdre celle de l'inférence, c'est-à-dire du moment où on les utilise. --- ## Partie 2 : ce que vous payez vraiment ### 4. Le token Un réseau de neurones a besoin d'entrées exprimées dans un alphabet fermé, un nombre fini de valeurs que la machine sait manipuler. Pour lui faire lire notre langue, il faut donc découper nos textes. Mais comment ? Par caractères ? Faisable, mais un « c » isolé ne veut rien dire et le modèle mettrait une éternité à calculer le sens d'un paragraphe. Par mots entiers ? Impossible : entre les langues, les conjugaisons, les fautes de frappe, le code et la ponctuation, il faudrait stocker des dizaines de millions d'entrées. Le compromis trouvé s'appelle le **token**. Imaginez une boîte de Lego de la langue : au lieu de tous les mots du monde, un dictionnaire de 100 000 à 200 000 fragments. Un mot très courant comme « bonjour » vaut un seul token. Un mot plus long se compose comme un puzzle : « développerait » peut devenir [dé] + [velop] + [per] + [ait], où le quatrième fragment porte à lui seul l'information du conditionnel. Ce découpage est le travail du *tokenizer*, un traducteur qui transforme votre texte en une suite de codes avant de l'envoyer au modèle. **Pourquoi ce mot revient sur toutes vos factures.** Deux points comptent. D'abord, **la facture dépend de la langue**. Les modèles ayant été entraînés majoritairement sur de l'anglais, leur dictionnaire favorise cette langue. ![Le même texte découpé en tokens dans trois langues. En français, 2 658 caractères donnent 692 tokens. En anglais, 2 589 caractères n'en donnent que 606. En swahili, 2 688 caractères en produisent 835](https://www.askthisguy.com/blog/how-ai-works-key-concepts/tokens-francais-anglais-swahili.webp) Le même texte, à longueur de caractères quasi identique, coûte **14 % de plus en français qu'en anglais**, et près de 40 % de plus en swahili. Vous payez une taxe sur votre langue de travail, et elle ne se négocie pas. Ensuite, **l'entrée et la sortie comptent toutes les deux**. Vous payez les tokens que vous envoyez, votre question mais aussi les consignes, l'historique et les documents joints, et ceux que le modèle génère. Un document de dix pages n'est pas « un fichier », c'est environ 5 000 tokens d'entrée à traiter, à chaque fois. ### 5. L'inférence Entraîner un grand modèle a coûté plus d'un milliard à quelqu'un. Vous n'en paierez jamais un centime. En revanche, vous paierez chaque réponse. Ce calcul à la demande s'appelle **l'inférence**. Contrairement à un logiciel classique qui tourne sur des processeurs ordinaires, l'inférence est très gourmande et réclame des puces spécialisées, les GPU. C'est ce qui a permis à Nvidia de multiplier sa valeur par dix en cinq ans. Plus le modèle est grand, plus l'infrastructure est lourde. Un tout petit modèle tient sur un PC. Un modèle moyen demande des serveurs à quelques dizaines de milliers d'euros, encore envisageables en interne. Un gros modèle est hors de portée : il faut louer, et en pratique passer par un fournisseur d'inférence payé au token. C'est ici que se concentrent vos coûts, et pas là où vous le croyez. **Choisir le bon modèle pour la bonne tâche, et ne pas refaire calculer deux fois la même chose.** Ces deux décisions pèsent bien plus lourd que le prix affiché du million de tokens. Et c'est aussi ici que se joue la souveraineté, puisque celui à qui vous envoyez vos données les voit, et qu'il obéit à son gouvernement. Or sur cette couche, l'écart n'est pas seulement politique, il est technique. ![Vitesse de génération d'un même modèle ouvert selon le fournisseur qui l'exécute, avec le drapeau du pays. Les quatre premiers sont américains, le plus rapide dépassant 1 900 tokens par seconde ; les deux fournisseurs européens ferment la marche, à 243 et 159 tokens par seconde](https://www.askthisguy.com/blog/how-ai-works-key-concepts/vitesse-fournisseurs-inference.webp) Le modèle est le même dans les six cas. Seul change celui qui le fait tourner, et le rapport entre le fournisseur américain le plus rapide et le meilleur européen dépasse un facteur huit. C'est un point à connaître avant de promettre à vos utilisateurs une IA souveraine aussi réactive que celle qu'ils utilisent chez eux. Le sujet mérite mieux qu'un paragraphe : nous avons détaillé les [sept façons de faire tourner un modèle en entreprise](https://www.askthisguy.com/fr/blog/enterprise-ai-inference/) et ce qu'elles coûtent réellement. ### 6. La fenêtre de contexte La **fenêtre de contexte** est la mémoire de travail du modèle : tout ce qu'il peut lire d'un seul coup, vos instructions, les documents joints, l'historique de la conversation et votre question. Elle se mesure en tokens et oscille aujourd'hui entre 128 000 et 1 000 000. Ce chiffre en forte hausse donne lieu à un genre de publication devenu régulier : « le RAG, c'est fini, on peut tout mettre dans la fenêtre de contexte ». C'est faux, pour trois raisons. - **Plus la fenêtre se remplit, plus vous payez.** Chaque échange relit tout ce qui précède. Une seule requête peut coûter plusieurs euros. - **Plus elle se remplit, moins le modèle est précis.** Une information noyée au milieu de 500 pages passe à la trappe bien plus souvent qu'en début ou en fin de document. - **Un million de tokens, ce n'est pas grand-chose** au regard des volumes documentaires réels d'une entreprise. Une grande fenêtre n'est donc pas une invitation à tout y déverser. C'est même précisément pour cela que le RAG existe : mieux vaut cinq bons passages que deux mille pages en vrac. --- ## Partie 3 : ce qui rend le modèle utile chez vous ### 7. Les outils Un modèle est figé et n'a jamais vu la moindre de vos données. Pourtant votre IA sait commenter l'actualité du matin, répondre sur un contrat confidentiel et analyser votre trimestre commercial. Comment ? Souvenez-vous de fin 2022 : le ChatGPT des débuts était incapable de vous donner la météo. En 2023, la recherche web arrive, puis d'autres **outils**, et tout change. Concrètement, quand vous envoyez une requête à un modèle équipé d'outils, il a deux options : vous répondre directement, ou déclencher un outil. L'outil s'exécute et lui renvoie son résultat. Le modèle le lit, puis choisit à nouveau : répondre, ou appeler d'autres outils. Et ainsi de suite. ![Schéma d'un appel d'outil : la question de l'utilisateur arrive au modèle, qui choisit soit de répondre directement, soit de déclencher un outil exécuté par le logiciel de l'entreprise (ERP, CRM, base documentaire, recherche web, calculs, envois d'e-mails) avant de formuler sa réponse](https://www.askthisguy.com/blog/how-ai-works-key-concepts/schema-appel-outil.webp) Les rôles sont nets. **Le modèle décide, le logiciel exécute.** Cette exécution passe par du logiciel traditionnel, ce qu'on appelle parfois le harnais, et c'est là que se gèrent les droits d'accès, les journaux et les validations. L'idée forte, celle qui change la façon d'évaluer un prestataire : on additionne le logiciel et le réseau de neurones. Le modèle comprend, réfléchit, orchestre. Le logiciel calcule, accède aux vraies données et agit de façon fiable et traçable. **Dans un projet d'IA sérieux, le logiciel compte aujourd'hui autant que le modèle, souvent davantage.** Deux approches coexistent pour ces outils. Les outils propriétaires, développés pour un logiciel donné et qui ne fonctionnent que chez lui. Et les outils standard, au premier rang desquels [MCP](https://www.askthisguy.com/fr/blog/how-mcp-accelerate-agentic-ai/) : vous exposez votre système une fois, et n'importe quelle IA compatible s'y branche. La différence n'est pas technique, elle est contractuelle. Chez les grands éditeurs, vos connecteurs et vos automatisations restent chez eux. Le jour où vous partez, vous repartez de zéro. ### 8. Le RAG Un modèle ne connaît rien de vos contrats, de vos procédures ni de votre historique client. Il faut donc lui donner l'information au moment où vous posez la question. C'est le principe du **RAG**, pour *Retrieval-Augmented Generation*. Dans sa forme classique, cela tient en quatre étapes. Vous sélectionnez vos documents et les remettez dans un format exploitable. Vous les découpez en morceaux, stockés dans une base adaptée à la recherche sémantique, c'est-à-dire par proximité de sens. Quand un utilisateur pose une question, le système retrouve les passages les plus utiles et les ajoute à la question. Le modèle répond à partir de ces éléments. **On n'a rien entraîné ni modifié dans le modèle.** Vos documents sont consultés au moment de la question, c'est tout. Retenez cette phrase : elle resservira au moment du fine-tuning. Un exemple pour saisir l'intérêt de la recherche sémantique : si vous demandez « combien de jours de télétravail ? », une recherche par mots-clés peut rater un passage intitulé « travail à distance ». La recherche par le sens comprend que les deux parlent probablement de la même chose. Mais les mots-clés restent indispensables, parce qu'une référence produit comme XR-4471B doit être retrouvée au caractère près. C'est tout l'objet de la [recherche hybride](https://www.askthisguy.com/fr/blog/hybrid-search-retrieval-methods/). Le mot RAG donne l'impression d'une recette simple. En production, c'est devenu un système complet : connecteurs, préparation des documents, droits d'accès, choix de la méthode de recherche, citations, évaluation, supervision. Nous avons écrit un [guide complet du RAG en entreprise](https://www.askthisguy.com/fr/blog/rag-tutorial/) pour ceux qui veulent entrer dans le détail. ### 9. L'IA agentique Une IA qui sait appeler un outil n'est pas encore un agent. **L'IA agentique**, c'est l'étape d'après : quand le modèle décompose un objectif en plusieurs étapes, les orchestre, et se corrige pour atteindre son but. La différence se voit à l'usage. Avec une IA classique, vous demandez « analyse ce fichier et donne-moi les trois produits les moins rentables », l'IA appelle l'outil qui lit le fichier et répond. Avec une IA agentique, vous demandez « prépare la revue commerciale de la semaine », et elle récupère les chiffres dans le CRM, les compare à la semaine précédente, repère les écarts inhabituels, cherche les explications dans les comptes rendus, rédige une synthèse, demande une validation humaine, puis envoie. Un agent n'est donc pas un nouveau type de modèle. C'est un modèle placé au centre d'un système qui lui fournit des outils, une mémoire de travail, des règles, des permissions, parfois un budget, et un objectif. Nous détaillons les cas d'usage, les coûts et le retour sur investissement d'un [agent IA en entreprise](https://www.askthisguy.com/fr/blog/enterprise-ai-agents/) dans un article dédié. **La limite à connaître avant de signer.** Un modèle reste probabiliste, donc moins fiable qu'un logiciel simple. Prenez un agent qui enchaîne dix étapes, chacune réussissant dans 95 % des cas. La probabilité que les dix réussissent est de 0,95 puissance 10, soit environ 60 %. Le calcul est volontairement simpliste, mais l'idée est essentielle : **plus on enchaîne d'actions, plus il faut vérifier les résultats intermédiaires.** Une bonne automatisation n'utilise l'IA que là où elle est nécessaire, un principe que nous développons dans notre article sur l'[automatisation IA minimale](https://www.askthisguy.com/fr/blog/use-minimal-ai-automation/). Et comme il est très difficile de distinguer un bon agent d'un mauvais de l'extérieur, si vous externalisez ces développements, demandez un prix forfaitaire et un engagement de résultat. --- ## Partie 4 : les deux confusions qui coûtent cher ### 10. Le fine-tuning Nous y voilà. Le **fine-tuning** consiste à reprendre un modèle déjà entraîné et à retoucher légèrement ses poids sur quelques milliers de vos exemples. C'est une petite reprise d'entraînement, pas un entraînement. Et c'est le concept le plus survendu du marché, celui que des prestataires vous présentent en promettant « d'entraîner une IA sur les données de votre entreprise ». Ce qu'il faut retenir tient en une phrase. > Le fine-tuning change le comportement, pas les connaissances. Vous voulez que le modèle réponde toujours dans un format précis, adopte le ton de votre maison, manie le jargon de votre secteur ? Fine-tuning. Vous voulez améliorer son taux de succès sur une tâche bien délimitée, une classification ou de la génération de code ? Fine-tuning. Vous voulez qu'il connaisse vos 40 000 documents ? RAG. Pas fine-tuning. Un dernier point à ne pas oublier : **le fine-tuning est à refaire à chaque changement de modèle**. C'est-à-dire souvent. ### 11. L'hallucination Une **hallucination IA**, c'est une réponse fausse produite avec l'assurance d'une réponse vraie. Une jurisprudence qui n'existe pas, une clause inventée dans un contrat, un chiffre plausible mais faux. L'erreur courante consiste à traiter cela comme un bug qu'un éditeur finira par corriger. Ce n'en est pas un. Reprenez le concept numéro 1 : un modèle n'applique pas de règles, il produit la suite la plus probable à partir de poids réglés par l'exemple. Quand il ne dispose pas de l'information, rien dans son fonctionnement ne l'amène à dire « je ne sais pas » plutôt qu'à produire quelque chose de vraisemblable. **L'hallucination est structurelle, pas accidentelle.** Ce qui veut dire qu'on ne la supprime pas. On la réduit et on la rend détectable, avec des moyens qui sont tous des choix d'architecture, pas des réglages de modèle : fournir les bons documents au bon moment plutôt que compter sur la mémoire du modèle, exiger des citations vérifiables sur chaque réponse, faire vérifier les résultats intermédiaires par du logiciel déterministe, et mesurer en continu. Quand un éditeur vous annonce une IA « sans hallucination », il vous vend soit un abus de langage, soit une méconnaissance de son propre produit. La bonne question n'est pas « est-ce que ça hallucine », mais **« comment je le vois quand ça arrive »**. --- ## Ce qui décide de la survie du projet : les LLMOps Le concept le moins vendeur de la liste, et de loin le plus décisif. Les **LLMOps** regroupent tout ce qu'il faut autour du modèle pour qu'un projet tienne en production. Le logiciel classique, on sait faire depuis quarante ans. Avec un agent, plus rien ne fonctionne pareil. **Les tests ne sont plus binaires.** Deux fois la même question, deux réponses différentes. Et vos utilisateurs ne suivent pas dix parcours balisés, ils formulent leur demande comme ils veulent. Le « je clique là, il se passe ça » ne suffit plus : il vous faut un jeu de questions avec les réponses attendues, validé par vos experts métier. **Vous n'achèterez pas l'infrastructure.** Un H100 loué en continu revient à près de 2 000 € par mois pour une seule carte. Vous dépendrez donc de fournisseurs tiers. **Et ces fournisseurs tombent.** Leurs pages de statut affichent 99 à 99,5 % de disponibilité, soit jusqu'à plusieurs jours d'arrêt par an. Soit vous payez très cher un engagement contractuel, soit vous en branchez plusieurs et basculez dès que l'un décroche. C'est tout l'enjeu d'un [SLA sur un service d'IA](https://www.askthisguy.com/fr/blog/enterprise-ai-sla/). **La facture se compte en tokens** et elle dérive vite, un agent qui boucle quinze fois relisant tout son historique à chaque tour. Pilotez au coût par requête utile, pas au prix du million de tokens. **Les modèles changent tout le temps.** Votre fournisseur en sort un meilleur, déprécie l'ancien avec quelques mois de préavis, et votre prompt réglé au millimètre ne rend plus la même chose. Il faut pouvoir tester, basculer et revenir en arrière sans réécrire l'application. **Le comportement se pilote chaque semaine** : tracer les questions, les outils appelés, les sources utilisées. Sinon, quand un utilisateur vous dit « il m'a raconté n'importe quoi », vous débattez d'une perception et vous n'améliorez rien. Ce que nous voyons sur le terrain : les projets d'IA internes qui n'échouent pas au POC échouent au RUN. Plus personne n'est vraiment en charge, les réponses se dégradent, l'usage baisse, et dix-huit mois plus tard on arrête l'outil. **Le POC représente souvent 20 % du coût total. Un prestataire qui ne chiffre que la démo ne vous a pas chiffré le projet.** Le POC réussit presque toujours. C'est justement le problème. --- ## Questions fréquentes sur les concepts de l'IA ### Qu'est-ce qu'un LLM ? Un LLM, pour *large language model* ou grand modèle de langage, est un réseau de neurones entraîné à prédire la suite d'un texte. Il est constitué de milliards de poids numériques, appelés paramètres, qui ont été réglés automatiquement sur d'immenses corpus de textes plutôt que programmés par des humains. Une fois cet entraînement terminé, ces poids sont figés : le modèle ne change plus et n'apprend rien des questions qu'on lui pose. C'est ce qui le distingue radicalement d'un logiciel classique, dont chaque règle a été écrite explicitement et peut être relue. ### Comment fonctionne une IA générative ? Une IA générative produit du texte en prédisant, morceau par morceau, la suite la plus probable de ce qui précède. Votre question est d'abord découpée en tokens, ces fragments de mots que le modèle sait manipuler. Ces tokens traversent ensuite les milliards de poids du réseau, qui calculent le fragment suivant le plus vraisemblable, puis le suivant, jusqu'à la fin de la réponse. Il n'y a ni base de connaissances consultée, ni règle métier appliquée : uniquement un calcul de probabilité sur des poids figés. C'est pourquoi la même question peut donner deux réponses différentes. ### Une IA peut-elle apprendre à partir des documents de mon entreprise ? Non, pas au sens où on l'entend généralement. Les poids d'un modèle sont figés après son entraînement et ne se modifient pas quand vous l'utilisez. Pour qu'une IA réponde sur vos documents, on ne modifie pas le modèle : on lui fournit les bons extraits au moment de la question, une technique appelée RAG. Vos documents sont consultés à la demande puis oubliés. La formulation « entraîner une IA sur vos données », courante dans les propositions commerciales, décrit donc mal ce qui se passe réellement et mérite d'être clarifiée avant de signer. ### Qu'est-ce qu'un token IA ? Un token est l'unité de texte qu'un modèle d'IA manipule réellement : un mot court, ou un fragment de mot plus long. Les modèles disposent d'un dictionnaire de 100 000 à 200 000 fragments, et le texte est découpé selon ce dictionnaire avant d'être traité. C'est l'unité de facturation de la quasi-totalité des services d'IA, en comptant séparément ce que vous envoyez et ce que le modèle génère. Un texte français consomme environ 14 % de tokens de plus que le même texte en anglais, parce que les dictionnaires sont majoritairement construits sur de l'anglais. ### Pourquoi l'IA coûte-t-elle plus cher en français qu'en anglais ? Parce que les dictionnaires de tokens des grands modèles ont été construits majoritairement à partir de textes anglais. Les mots anglais courants y occupent un seul token, alors que leurs équivalents français doivent souvent être reconstitués à partir de plusieurs fragments. À longueur de texte comparable, le français consomme environ 14 % de tokens de plus que l'anglais, et certaines langues peu représentées dépassent 40 %. Comme la facturation se fait au token, cette différence se retrouve directement sur votre facture, sans qu'aucune négociation commerciale puisse l'effacer. ### Que signifient 8B, 70B ou 405B dans le nom d'un modèle d'IA ? Ces mentions indiquent le nombre de paramètres du modèle, exprimé en milliards : 8B signifie huit milliards de poids numériques. Ce chiffre donne un ordre de grandeur de la taille du modèle, donc de son coût d'exécution, de sa vitesse et de la puissance matérielle nécessaire. Il ne mesure pas directement la qualité : depuis 2023, un modèle de 8 milliards de paramètres bien entraîné dépasse GPT-3 et ses 175 milliards sur la plupart des tâches. Au-delà de quelques dizaines de milliards, chaque décuplement de taille n'apporte plus que quelques points de performance. ### Qu'est-ce que la fenêtre de contexte d'un modèle d'IA ? La fenêtre de contexte est la quantité de texte qu'un modèle peut lire en une seule fois : vos instructions, les documents joints, l'historique de la conversation et votre question. Elle se mesure en tokens et va aujourd'hui de 128 000 à environ un million selon les modèles. Deux limites la rendent moins utile qu'il n'y paraît : plus elle se remplit, plus chaque échange coûte cher puisque tout le contenu est relu à chaque tour, et plus la précision baisse, une information noyée au milieu de centaines de pages étant fréquemment ignorée. ### Quelle différence entre le fine-tuning et le RAG ? Le fine-tuning retouche les poids du modèle sur vos exemples et modifie son comportement : format de réponse, ton, jargon métier, taux de succès sur une tâche précise. Le RAG ne touche pas au modèle : il retrouve les passages utiles de vos documents et les lui fournit au moment de la question. Pour qu'une IA connaisse vos documents internes, c'est du RAG. Pour qu'elle réponde toujours d'une certaine manière, c'est du fine-tuning. La confusion entre les deux est à l'origine de la promesse commerciale « entraîner une IA sur vos données », qui ne décrit correctement ni l'un ni l'autre. ### Pourquoi une IA hallucine-t-elle ? Parce qu'un modèle de langage ne consulte pas une base de faits : il produit la suite la plus probable à partir de poids réglés statistiquement sur des exemples. Quand l'information lui manque, rien dans son fonctionnement ne le pousse à répondre « je ne sais pas » plutôt qu'à générer un contenu vraisemblable. L'hallucination est donc structurelle et ne se supprime pas par un correctif. Elle se réduit et se détecte : en fournissant les bons documents au moment de la question, en exigeant des citations vérifiables, et en faisant contrôler les résultats intermédiaires par du logiciel déterministe. ### Faut-il choisir le modèle le plus puissant pour un projet d'IA en entreprise ? Non, et c'est souvent une erreur coûteuse. L'écart de prix entre un petit modèle et un très gros dépasse le facteur cent pour un million de tokens générés, alors que de nombreuses tâches d'entreprise comme le résumé de comptes rendus ou la classification de messages sont correctement traitées par un petit modèle. Depuis 2023, la taille seule ne détermine plus la qualité : un modèle de 8 milliards de paramètres bien entraîné dépasse GPT-3 et ses 175 milliards sur la plupart des tâches. La bonne pratique consiste à affecter le bon modèle à chaque tâche plutôt qu'à en choisir un seul pour tout. ### Qu'est-ce que les LLMOps ? Les LLMOps désignent l'ensemble des pratiques nécessaires pour maintenir un système à base de modèle de langage en production : constituer un jeu de questions avec les réponses attendues pour tester la qualité, tracer les questions posées, les outils appelés et les sources utilisées, piloter le coût par requête utile, et pouvoir changer de modèle ou de fournisseur sans réécrire l'application. Cette discipline diffère du DevOps classique parce qu'un modèle n'est pas déterministe, que les fournisseurs déprécient régulièrement leurs modèles, et que la qualité se dégrade silencieusement plutôt que de provoquer une panne visible. ### Peut-on garantir qu'une IA n'hallucine jamais ? Non. L'hallucination découle du fonctionnement même des modèles de langage, qui produisent une suite probable plutôt qu'un fait vérifié, et aucun éditeur ne peut l'éliminer complètement. Ce qui se maîtrise, c'est sa fréquence et sa détectabilité : fournir les documents pertinents au moment de la question, exiger des citations vérifiables sur chaque réponse, faire contrôler les résultats intermédiaires par du logiciel déterministe, et mesurer la qualité en continu. Une promesse commerciale d'IA « sans hallucination » signale une méconnaissance du produit ou un abus de langage. ### Combien d'étapes un agent IA peut-il enchaîner de façon fiable ? Le nombre d'étapes est limité par la composition des taux de réussite. Si chaque étape réussit dans 95 % des cas, dix étapes enchaînées ne réussissent ensemble que dans environ 60 % des cas, puisque 0,95 puissance 10 vaut 0,60. Ce calcul est simplificateur, mais il explique pourquoi les agents fiables ne sont pas ceux qui enchaînent le plus d'actions : ce sont ceux qui vérifient leurs résultats intermédiaires et qui n'emploient le modèle que là où un logiciel déterministe ne suffirait pas. ### Combien coûte un projet d'IA une fois le POC terminé ? Le POC représente en général autour de 20 % du coût total du projet sur sa durée de vie. Les 80 % restants se répartissent entre l'inférence facturée au token, la maintenance du système autour du modèle, les changements de modèles imposés par les fournisseurs, l'évaluation continue de la qualité des réponses et le pilotage du comportement de l'agent. Un chiffrage qui ne couvre que la phase de démonstration n'est pas un chiffrage de projet, et c'est la principale cause d'abandon des projets d'IA internes après dix-huit mois. --- ## Conclusion Dix concepts, et au fond une seule idée : il n'y a rien de magique là-dedans. Des poids réglés par l'exemple. Du texte découpé en tokens. Des outils branchés autour. Vos documents posés au bon moment sur le bureau. Et beaucoup de travail d'ingénierie pour que ça tienne debout en production. Ce que ces notions vous donnent, ce n'est pas une compétence technique. C'est la capacité de poser les trois ou quatre questions qui séparent un prestataire qui sait d'un prestataire qui récite. La prochaine fois qu'on vous propose « d'entraîner une IA sur les données de votre entreprise », vous savez quoi répondre. Demandez si l'on parle de RAG ou de fine-tuning. La réponse vous en dira long. Si vous préparez un projet et que vous voulez confronter votre cas d'usage à ces arbitrages : **[réservez une démo](https://www.askthisguy.com/fr/demo/)**. --- # Recherche hybride : les 6 façons de retrouver une information URL: https://www.askthisguy.com/fr/blog/hybrid-search-retrieval-methods/ Language: fr Section: Blog Un mardi matin ordinaire, dans une entreprise de 300 personnes. Six collaborateurs cherchent une information. Aucun ne cherche la même chose, et aucune de leurs questions ne se résout par le même mécanisme. - « Est-ce qu'on peut télétravailler trois jours par semaine ? » - « Où en est la commande de JP Dupont, la référence XOD1132 ? » - « Est-ce que ce client a un ticket support ouvert en ce moment ? » - « Combien de commandes sont en retard sur le site de Lyon ? » - « Combien de contrats sont rangés dans le dossier Clients 2026, et lesquels ? » - « Quelles options sont incluses dans la gamme Horizon ? » Ces six questions ont l'air de se ressembler. Techniquement, elles n'ont presque rien en commun : comprendre un sens, retrouver une chaîne exacte, appeler un système tiers, calculer un résultat, lire une arborescence. La sixième, on le verra, ne se joue même pas au moment de la question. Et elles restent faciles, puisque chacune se règle par une seule voie. Un manager, lui, pose des questions qui en combinent plusieurs, dans un ordre qu'on ne connaît pas d'avance. D'où la **recherche hybride**. Un assistant qui ne maîtrise qu'une de ces voies ne répondra qu'à une fraction des questions de vos équipes. Les six, donc, puis ce qui se passe quand il faut les enchaîner. ## 1. L'information est noyée dans un document : la recherche sémantique « Est-ce qu'on peut télétravailler trois jours par semaine ? » La réponse existe. Elle est page 34 d'un accord d'entreprise de 60 pages, dans un paragraphe qui ne contient ni le mot « trois » ni le mot « télétravail », mais la formule « modalités de travail à distance, dans la limite de 60 % du temps mensuel ». Aucune recherche par mot exact ne trouvera ce passage. La recherche sémantique le trouve, parce qu'elle compare du sens plutôt que des mots : les documents sont découpés puis convertis en vecteurs, et la question passe par la même conversion. Deux formulations qui veulent dire la même chose se retrouvent voisines dans cet espace. C'est la brique fondatrice du [RAG](https://www.askthisguy.com/fr/blog/rag-tutorial/), et celle que tout le monde branche en premier. À juste titre, elle est spectaculaire. Le problème commence quand on s'arrête là. ## 2. L'information tient dans un nom ou une référence : la recherche par mots-clés « Où en est la commande de JP Dupont, la référence XOD1132 ? » `XOD1132` est une clé, pas un concept. Idem pour `JP Dupont`, `Projet Atlas` ou `PRD-19-B`. Ces chaînes n'ont pas de voisinage sémantique : un modèle d'embedding ignore que XOD1132 est plus proche de XOD1133 que de la politique de congés, et il n'a aucune raison de le savoir. Sur ce type de requête, la recherche vectorielle seule ramène du bruit plausible. Il faut une recherche lexicale, qui retrouve la chaîne exacte là où elle apparaît. Or vos équipes emploient ce vocabulaire toute la journée. Une entreprise parle en références clients, en codes projet et en acronymes maison bien plus qu'en concepts. D'où notre classement du « tout vectoriel » parmi les [erreurs qui rattrapent un RAG après le POC](https://www.askthisguy.com/fr/blog/enterprise-rag-production-mistakes/) : la démo passe, la production casse. > La recherche sémantique trouve ce que vous vouliez dire. La recherche par mots-clés trouve ce que vous avez écrit. Il vous faut les deux. ## 3. L'information n'est dans aucun document : l'outil connecté au SI « Est-ce que ce client a un ticket support ouvert en ce moment ? » Ici, ni le sens ni les mots-clés ne servent : l'information n'existe dans aucun document. Elle vit dans l'outil de ticketing, dans le CRM, dans l'ERP. Et comme elle change dans l'heure, l'indexer serait de toute façon une mauvaise idée. Il faut donc **appeler le système qui détient la donnée**, au moment de la question. Via un [serveur MCP](https://www.askthisguy.com/fr/doc/admin-console/tools-management/mcp-servers) quand l'éditeur en fournit un, ou via un [outil sur mesure](https://www.askthisguy.com/fr/doc/customizing-atg-to-you/tailored-tools) quand il faut se brancher sur une API interne. Le [protocole MCP](https://www.askthisguy.com/fr/blog/how-mcp-accelerate-agentic-ai/) a rendu ce branchement beaucoup moins coûteux qu'il y a deux ans. ## 4. L'information n'existe pas encore, elle se calcule : la requête en base « Combien de commandes sont en retard sur le site de Lyon, et quels clients sont concernés ? » Cette réponse n'est écrite nulle part. Elle se calcule, en croisant des lignes de commande, des dates promises et un code site. C'est le rôle d'un outil de [requête en base de données](https://www.askthisguy.com/fr/doc/customizing-atg-to-you/database-query) : l'assistant traduit la question en requête SQL, l'exécute en lecture seule sur un périmètre autorisé, et rend le résultat. Vos données les plus fiables et les plus fraîches sont souvent là, dans des bases structurées que personne n'interroge parce qu'il faut passer par un ticket au service data. Nous avons développé ce point dans [Vos bases de données sont une mine d'or](https://www.askthisguy.com/fr/blog/databases-gold-mine-ai-shovels/). ## 5. La question porte sur les documents eux-mêmes : le catalogue documentaire « Combien de contrats sont rangés dans le dossier Clients 2026, et lesquels ? » Question piège pour un RAG classique. Une recherche sémantique va rapporter dix passages qui *parlent* de contrats, sans savoir les compter ni garantir qu'elle a tout vu. Sur une question d'inventaire, un système qui répond « environ une quinzaine » est pire qu'un système qui ne répond pas. La question porte sur la **base documentaire elle-même** : son arborescence, ses chemins, ses sources, ses dates. Il faut un outil qui interroge le catalogue de façon déterministe, et non le texte. C'est ce que fait notre [interrogation du catalogue documentaire](https://www.askthisguy.com/fr/doc/admin-console/tools-management/chat-tools). Elle répond aux « combien », aux « liste les sous-dossiers de », aux « quels documents viennent de ce SharePoint », et elle sert aussi à localiser un fichier précis avant d'aller en lire le contenu. ## 6. L'information est là, mais illisible : le traitement sur mesure « Quelles options sont incluses dans la gamme Horizon ? » La réponse est dans un fichier que vous avez déjà indexé. Elle est dans un tableur de 40 colonnes, où chaque ligne est une référence et chaque colonne une option, avec des croix, des cellules fusionnées et trois lignes d'en-tête. Ou dans un plan d'implantation, ou dans un catalogue produit exporté d'un ERP. Aucune des cinq méthodes précédentes ne sauvera ce fichier. Découpé en morceaux de texte comme un document ordinaire, un tableur produit des chunks du genre `Horizon ; X ; ; X ; 2 ; ; oui`. C'est syntaxiquement du texte, sémantiquement du bruit. Le passage sera peut-être retrouvé, mais il ne voudra rien dire, ni pour le modèle, ni pour l'utilisateur qui lira la citation. Cette sixième voie est d'une autre nature : **elle rend cherchable ce qui ne l'était pas**. Elle intervient à l'indexation, pas au moment de la question. Concrètement, notre [traitement sur mesure](https://www.askthisguy.com/fr/doc/customizing-atg-to-you/tailored-processing) associe un critère de déclenchement (un type de fichier, un motif dans le nom, une structure reconnaissable) et des règles d'extraction écrites pour ce format précis : ce que signifie chaque colonne, quelles lignes sont des totaux, quelle unité s'applique. Le fichier entre en tableur, il ressort en connaissance exploitable, avec ses citations. Nous n'appliquons volontairement aucun traitement générique à tous les Excel. Un tableur sans son contexte métier reste de la donnée brute : la colonne « Montant » est en euros ou en dollars, le « Statut » est celui de la commande ou du projet. Un parsing automatique produit du bruit qui a l'air d'une réponse, et c'est le pire résultat possible. ![Schéma des six voies complémentaires pour retrouver une information : en amont, à l'indexation, le traitement sur mesure des fichiers complexes ; puis, au moment de la question, la recherche sémantique, la recherche par mots-clés, l'outil connecté au système d'information, la requête en base de données et l'interrogation du catalogue documentaire, mobilisées par un même agent pour produire une réponse unique et sourcée](https://www.askthisguy.com/blog/hybrid-search-retrieval-methods/schema-methodes-recherche-complementaires.svg) ## Quand une seule question en réclame plusieurs Mes six exemples ont un défaut : ils sont trop propres. Chacun désigne sa voie presque tout seul. Un directeur d'exploitation, lui, pose plutôt ça : > « Est-ce qu'on tient nos engagements avec Durand cette année ? » Rien dans cette phrase ne dit où chercher, ni quels engagements sont visés, ni sur quelle période. Aucune des six voies ne suffit, et **on ne peut pas décider à l'avance dans quel ordre les emprunter**. L'assistant doit d'abord trouver ce qui matérialise l'engagement : un contrat, un avenant, une convention de service. Voie 1, plus la 5 s'il faut localiser le bon fichier dans la bonne arborescence. Il y lit les seuils, délai de prise en charge, nombre d'interventions incluses, taux de disponibilité. Et il y apprend au passage que la période court sur l'année civile, pas sur douze mois glissants. À ce moment seulement, il sait quoi demander à l'outil de ticketing. Voie 3 se déclenche, avec un filtre qu'il vient de découvrir dans le contrat. Si les volumes dorment dans une base plutôt que dans le ticketing, ce sera la voie 4. Puis il compare, et il répond. **La deuxième requête ne pouvait pas être formulée avant d'avoir lu le résultat de la première.** Un agent mène une enquête là où un simple aiguillage se contente de router : il évalue ce qu'il obtient et décide s'il en sait assez pour répondre, ou s'il doit repartir chercher. Le principe est détaillé dans notre article sur le [RAG agentique](https://www.askthisguy.com/fr/blog/rag-tutorial/). Deux conséquences, en général découvertes trop tard. La première, il faut savoir s'arrêter : une enquête consomme du temps et des tokens, et sans bornes sur le nombre d'allers-retours, le système devient lent et cher, donc inutilisable même quand ses réponses sont bonnes. La seconde, il faut tracer. Quand une réponse résulte de quatre appels à trois sources, l'utilisateur doit pouvoir vérifier d'où vient chaque élément. Sans citations, personne n'accorde sa confiance, et une réponse à laquelle on ne se fie pas ne sert à rien. ## Ce que vous avez, sans doute, aujourd'hui Le test est simple. Reprenez les six questions du début et posez-les à l'assistant que vous utilisez déjà. Avec **Copilot**, vous êtes bien servi sur les questions 1, 2 et 5, tant que l'information est dans Microsoft 365. Vous vous arrêtez à la frontière de votre SI métier et de vos bases : les questions 3 et 4 restent sans réponse, ou renvoient une approximation. Et vos fichiers métier atypiques sont traités comme des fichiers ordinaires. Avec un **RAG développé en interne**, vous avez presque certainement la 1, parfois la 2. C'est le chemin naturel, le vectoriel est ce qu'on branche en premier et ce qui fait une belle démo. Les autres voies demandent des intégrations, des droits d'accès et de l'exploitation, donc du travail après le POC. Avec un **moteur de recherche d'entreprise classique**, vous avez la 2 et la 5, avec des filtres. C'est rapide et solide, mais il faut savoir quoi taper. Personne ne trouve la politique de télétravail en cherchant « télétravail » quand le document dit « travail à distance ». Aucun de ces outils n'est mauvais, je tiens à le dire. Ils couvrent une partie du besoin, correctement. Le problème est que vos équipes découvrent l'autre partie en s'y cognant, question après question, et qu'elles arrêtent vite de demander. ## L'approche Ask This Guy Nous avons pris le problème par l'autre bout. Plutôt que d'optimiser une méthode de recherche, nous en avons câblé cinq, plus une sixième qui prépare le terrain, et nous avons mis un agent au-dessus. C'est lui qui décide. Il reformule la question, choisit la ou les voies à emprunter, lit ce qu'il obtient, et juge s'il en sait assez. Sinon il relance, mieux ciblé, avec ce qu'il vient d'apprendre. Sur le cas Durand plus haut, il enchaîne documents puis ticketing sans que personne lui ait dit dans quel ordre. Et si le contrat vit dans un tableur de suivi maison, c'est le traitement sur mesure, configuré une fois, qui lui a permis de le lire correctement. La [documentation](https://www.askthisguy.com/fr/doc/admin-console/knowledge-management/how-is-my-companys-data-processed-what-is-rag) détaille la mécanique. Chaque élément de la réponse renvoie à sa source, quelle que soit la voie qui l'a trouvé. Côté utilisateur, il n'y a rien à savoir de tout cela. Il pose sa question en français. C'est bien le minimum : demander à un commercial de choisir entre « recherche sémantique » et « requête SQL » avant de taper sa phrase, ce serait lui transférer un problème d'ingénierie. **Si vous ne devez retenir qu'une chose.** La qualité d'un assistant d'entreprise tient au nombre de voies qu'il sait emprunter, et surtout à sa capacité à les enchaîner sans qu'on lui dise dans quel ordre. Le modèle employé compte beaucoup moins qu'on ne le croit. Une seule méthode de recherche, c'est mécaniquement une majorité de questions sans réponse fiable. ## Questions fréquentes sur la recherche hybride ### Qu'est-ce que la recherche hybride ? La recherche hybride consiste à combiner plusieurs méthodes de recherche complémentaires au lieu d'une seule. Au sens strict, elle associe la recherche sémantique (par le sens, via des embeddings) et la recherche par mots-clés (par correspondance exacte). Au sens large, elle intègre aussi l'appel à des outils métier, la requête en base de données et l'interrogation du catalogue documentaire, pour couvrir les questions dont la réponse n'est dans aucun document. S'y ajoute une voie en amont : le traitement sur mesure des fichiers complexes, qui rend exploitables des tableurs ou des catalogues qu'un découpage classique transformerait en bruit. ### Quelle différence entre recherche sémantique et recherche par mots-clés ? La recherche sémantique compare le sens : elle retrouve « modalités de travail à distance » à partir de la question « peut-on télétravailler ? ». La recherche par mots-clés compare les chaînes de caractères : elle retrouve la référence exacte `XOD1132` ou le nom `JP Dupont`, que la recherche sémantique manque parce que ces chaînes n'ont pas de sens propre. Les deux sont nécessaires, car une entreprise manipule autant de concepts que de références internes. ### Pourquoi la recherche vectorielle seule ne suffit-elle pas ? Parce qu'une part importante des questions en entreprise porte sur des identifiants sans valeur sémantique (références produit, codes projet, noms de clients), sur des données vivantes stockées dans le SI, sur des chiffres à calculer en base, ou sur la structure même de la base documentaire. Elle échoue aussi sur les fichiers dont la structure porte le sens, comme les tableurs, qu'un découpage en texte réduit à des suites de cellules. Aucun de ces cas n'est correctement traité par la proximité vectorielle, qui reste pourtant l'unique mécanisme de beaucoup de projets RAG. ### Comment un assistant sait-il quelle méthode de recherche utiliser ? C'est l'agent qui décide, à partir de la formulation de la question et de la description des outils dont il dispose. Une question conceptuelle déclenche une recherche sémantique, une référence explicite déclenche une recherche par mots-clés, une demande de dénombrement déclenche une interrogation du catalogue. Sur les questions complexes, il en enchaîne plusieurs, en se servant du résultat de la première pour formuler la suivante, jusqu'à estimer qu'il en sait assez pour répondre. ### Pourquoi un fichier Excel est-il mal exploité par un RAG classique ? Parce que dans un tableur, le sens est porté par la structure autant que par le texte. Une cellule ne veut rien dire sans son en-tête de colonne, son unité et sa ligne de référence. Un découpage en morceaux de texte, qui fonctionne bien sur un contrat ou une procédure, produit ici des suites de valeurs sans contexte. Il faut un traitement adapté au format, qui reconstitue ce que signifie chaque colonne avant l'indexation. --- ## Conclusion Tout le monde sait répondre à la question facile, celle dont la réponse tient dans un paragraphe bien écrit d'un document bien rangé. Un assistant se juge sur les cinq autres : celles où l'information est ailleurs, où elle n'existe pas encore sous forme de texte, ou bien où elle dort dans un fichier que personne n'a pris la peine de rendre lisible. Si vous voulez voir ce que donnent vos propres questions, celles que vos équipes posent vraiment, **[réservez une démo](https://www.askthisguy.com/fr/demo/)** : nous partirons de vos sources réelles. Le détail de l'approche est sur la page [RAG entreprise clé en main](https://www.askthisguy.com/fr/solutions/knowledge-rag/), et l'interrogation de vos bases sur [Talk to Data](https://www.askthisguy.com/fr/solutions/talk-to-data/). --- # IA française pour entreprises : ce qu'il y a derrière le mot « souverain » URL: https://www.askthisguy.com/fr/blog/ia-francaise-souverainete/ Language: fr Section: Blog **Avant-propos : note méthodologique** Ce travail repose sur des **sources publiques uniquement** : sites éditeurs, mentions légales, politiques de confidentialité, annexes de DPA, listes de sous-traitants, registre national des entreprises, EDGAR, presse spécialisée. Les données légales viennent de l'API officielle `recherche-entreprises.api.gouv.fr`. Le périmètre est celui des **solutions d'IA vendues en SaaS aux entreprises** : assistants, RAG, suites IA. Les plateformes collaboratives et réseaux sociaux d'entreprise en sont exclus, même quand ils embarquent une couche IA, parce que ce n'est ni le même produit ni le même acheteur. Nous n'avons interrogé aucun éditeur. Quand une information n'est pas publique, c'est écrit tel quel, et **aucune conclusion n'est tirée d'une absence d'information**. Nous éditons Ask This Guy, qui figure dans ce panel et qui a été passé aux mêmes critères que les autres. Une erreur, une imprécision, une information qui a changé, un éditeur qui manque : écrivez à **bonjour@askthisguy.com**. Nous corrigeons et nous datons la correction. Nous observons (et nous en réjouissons) que de plus en plus d'entreprises se soucient de la souveraineté de leurs solutions, notamment dans l'IA. Et nous avons un écosystème particulièrement riche en France d'entreprises de services et d'éditeurs de logiciels. Depuis Snowden, nous savons que toute donnée à leur disposition est surveillée par l'administration américaine. Depuis le second mandat Trump, l'exécutif choisit de [couper l'accès de façon ciblée à des services américains](https://www.askthisguy.com/fr/blog/souverainete-numerique-dependance-americaine/). Il est probable que cette tendance aille crescendo, et dès lors, elle fait courir un risque important aux entreprises. Or, choisir un fournisseur fondé par des Français dans une structure américaine ne protège pas. De même, si les données de votre entreprise sont hébergées dans un cloud américain ou envoyées à un fournisseur d'IA américain, la problématique reste la même. Nous avons donc voulu vérifier quelles entreprises françaises étaient en mesure de garantir la souveraineté de leurs solutions et de protéger leurs clients. ## Les trois questions qui comptent, et ce qu'elles vous coûtent ### Avec qui vous contractez, et qui détient le capital Deux vérifications, dans cet ordre, parce que la première est éliminatoire. **D'abord, quelle société signe le contrat.** Une équipe française, des fondateurs français et un bureau à Paris ne disent rien de l'entité qui vous vend le service. Un groupe peut parfaitement avoir une filiale française qui emploie les salariés, et une société américaine qui commercialise le produit et se déclare responsable de traitement. Dans ce cas, vous contractez avec une société de droit américain, et le reste de l'analyse devient sans objet : peu importe où sont les serveurs, l'entreprise qui détient vos données relève d'une juridiction étrangère. Cela se vérifie en trois minutes sur les mentions légales ou la page `/legal`. **Ensuite, qui possède le capital.** Là, une société peut être parfaitement française, immatriculée, sans société mère étrangère, et avoir un capital majoritairement extra-européen après quelques tours de table. Ce que ça change pour vous : rien aujourd'hui, sur vos données. Mais qui contrôle le capital contrôle la suite. Une revente, un changement de siège, l'abandon de la ligne souveraine si elle coûte trop cher, un basculement de l'infrastructure vers un fournisseur que les nouveaux actionnaires connaissent mieux : ce sont des décisions qui se prennent au conseil, pas dans l'équipe produit. Le risque porte donc sur trois à cinq ans, et il mérite d'être connu sans qu'on en fasse un drame. ### Qui héberge vos données Celui-là est le plus important des trois, et de loin le critère qui aurait pu être rempli le plus facilement. Un hébergeur de droit américain reste soumis au droit américain, y compris quand ses serveurs sont à Paris ou à Francfort. Le CLOUD Act, adopté en 2018, permet aux autorités américaines d'exiger d'une société américaine les données qu'elle détient, y compris lorsqu'elles sont stockées à l'étranger. La localisation des serveurs n'est pas un moyen de défense. L'autre risque a mis plus longtemps à devenir crédible : la coupure du service. Depuis 2025, plusieurs décisions unilatérales américaines ont suspendu des accès pour des raisons politiques, sans préavis utile pour le client européen. Ce qui rend ce critère frustrant, c'est qu'il est **entièrement évitable et qu'il n'apporte rien à l'utilisateur**. OVHcloud, Scaleway et 3DS Outscale hébergent des bases de données et des serveurs applicatifs aussi bien qu'AWS ou Google Cloud. Personne, dans votre entreprise, ne verra jamais la différence à l'usage. Un éditeur français qui héberge chez un hyperscaler américain a fait un choix de confort d'ingénierie, pas un choix de produit. ### Qui opère l'inférence L'inférence, c'est le moment où l'IA est exécutée, et transforme un *input* (requête, documents, etc.) en *output* (réponse à un message, génération de documents, de contenus, etc.). Concrètement : des données de votre entreprise qui accompagnent votre requête partent chez celui qui exécute le modèle. Ici, l'éditeur a une circonstance atténuante. Les meilleurs modèles du marché sont américains, et celui qui branche GPT ou Claude rend souvent un meilleur service à ses utilisateurs. Le choix se défend très bien. Il est simplement rarement écrit noir sur blanc sur les pages produit. **Localisation n'est pas juridiction.** GPT, Claude et Gemini sont des modèles fermés. Personne d'autre qu'OpenAI, Anthropic et Google ne détient les poids, donc personne d'autre ne peut les exécuter sans un partenariat stratégique (car ils doivent protéger leur propriété intellectuelle). En pratique, ce sont des acteurs américains qui exécutent ces modèles (Microsoft, Amazon, etc.). Que le serveur soit à Paris, à Dublin ou en Virginie, **le traitement est réalisé par une société de droit américain**. Une région européenne satisfait une clause de localisation dans un contrat. Elle ne change pas qui peut être contraint de produire les données. La seule inférence réellement européenne passe par des modèles à poids ouverts opérés par un acteur européen, ou par un éditeur qui produit ses propres modèles. Et il reste une question, celle que presque personne ne pose. **« Au choix », mais au choix de qui ?** Presque tous ces produits sont multi-modèles. Certains permettent de choisir le modèle ou la famille de modèles, d'autres pas. Si l'arbitrage est à la main d'un **administrateur**, c'est une décision d'entreprise : prise une fois, elle est valable pour tout le monde. Si l'arbitrage est à la main de l'**utilisateur**, tout repose sur la discipline de chacun. Il est donc peu probable que ces derniers appliquent tous les critères de souveraineté. ## Le tableau Quatorze éditeurs, par ordre alphabétique. **Légende.** ✅ le critère est tenu en standard. 🟠 il est atteignable, mais il faut une manœuvre : demande écrite, clause contractuelle, désactivation manuelle fournisseur par fournisseur. ❌ il n'est pas tenu. ? l'information n'est pas publique. | Éditeur | Entité et capital | Hébergement des données | Inférence maîtrisable par l'entreprise | |---|---|---|---| | **Ask for the Moon** | ✅ Entité FR, capital FR et DE | ❌ Microsoft Azure, Paris | ? | | **Ask This Guy** | ✅ Entité FR, capital 100 % FR | ✅ OVHcloud, Gravelines | ✅ réglage « UE uniquement » en console admin | | **Cominty** | ✅ Entité FR, capital non publié | ? | ? | | **Craft AI** | ✅ Entité FR, contrôlée par une holding FR | 🟠 AWS en production, 3 clouds FR autorisés au contrat | 🟠 2 fournisseurs européens sur 8 (Mistral, Scaleway) | | **Delos** | ✅ Entité FR, capital non publié | ✅ Scaleway, région parisienne | ❌ modèles fermés US, choix laissé à l'utilisateur | | **Dust** | 🟠 Entité FR, capital majoritairement US | ❌ Google Cloud imposé | 🟠 opt-out fournisseur par fournisseur | | **IA-Souveraine.fr (DRI)** | ✅ Entité FR, holding FR | ✅ DRI est son propre hébergeur, datacenter au Mans | ✅ modèles ouverts exécutés sur les machines de DRI, en France | | **LightOn** | ✅ Entité FR cotée à Paris | ? | ✅ modèles propres, on-premise et air-gap | | **Limova** | ✅ Entité FR, capital non publié | ? | ? | | **Mistral AI** | ✅ Entité FR, capital et droits de vote à majorité européenne après le tour de 3 Md€ de septembre 2026 mené par Samsung | 🟠 datacenters propres, Microsoft cité pour Studio UE | 🟠 verrouillage UE sur demande écrite | | **Outmind** | ✅ Entité FR, capital non publié | ❌ AWS EMEA, Paris | ? | | **Prisme.ai** | ✅ Entité FR, capital non publié | 🟠 déployé chez le client, l'éditeur ne garantit rien | ? | | **Slite** | ❌ **Entité américaine**, Slite, Inc. (Delaware) | ❌ Google Cloud, Belgique | ? | | **Wikit** | ✅ Entité FR, capital non publié | ✅ OVHcloud, France | 🟠 configuration au niveau du projet | ## Les éditeurs, un par un Nous les avons classé en cinq groupes. Une précision utile avant d'entrer dans le vif du sujet : ces trois critères ne disent rien de la qualité du produit ni du sérieux de l'équipe. Un éditeur peut être excellent sur son métier et se retrouver dans le dernier groupe. De même, nous n'avons pas détecté de mensonge dans les discours commerciaux : les éditeurs qui n'ont pas fait des choix souverains ne se vantent pas de le faire et assument leur positionnement. ### Groupe 1 : Hébergement européen et inférence européenne Ask This Guy **Ask This Guy.** ATGU SAS, 100% de l'actionnariat chez des personnes physiques ou holdings personnelles françaises. Données sur serveurs dédiés OVHcloud à Gravelines, redondance à Francfort + des GPU propres chez Verda, société finlandaise. Deux politiques d'inférence au niveau de l'organisation, « UE uniquement » ou « Monde entier », modifiables depuis la console d'administration. C'est notre produit, nous y revenons plus bas. *Sources : [notre approche de l'IA souveraine](https://www.askthisguy.com/fr/doc/infrastructure-and-security/sovereign-ai/), [gestion des fournisseurs IA](https://www.askthisguy.com/fr/doc/infrastructure-and-security/ai-providers/).* IA-Souveraine.fr, par DRI **IA-Souveraine.fr.** Édité par **DRI (Digital Rural Informatique)**, SAS créée en 2001 au Mans, contrôlée par une holding française. C'est le dossier le plus intégré du panel : DRI n'est pas un éditeur de logiciel qui loue du cloud, c'est un hébergeur de vingt-cinq ans qui a ajouté une couche IA. L'indépendance porte sur l'infrastructure, pas sur les modèles, qui restent des poids ouverts publiés par d'autres, Google, Meta ou Mistral selon les cas. Ses mentions légales le disent en toutes lettres, il est « éditeur **et** hébergeur » de la plateforme. Datacenter en propre au Mans, réseau et numéro de système autonome en propre, certifications ISO 27001 et ISO 14001, conformité HDS disponible, hébergement exclusivement en France pour l'offre souveraine. Sur l'inférence, l'offre souveraine est limpide : les modèles à poids ouverts sont exécutés sur les machines de DRI, en France, donc par une société française. Et contrairement aux plateformes multi-modèles de cette liste, il n'y a rien à verrouiller, puisqu'il n'y a rien à exclure. La souveraineté est le produit, pas une option à activer. Une réserve tout de même : la plateforme annonce plus de 80 modèles au total, dont des « modèles commerciaux de référence » qui ne sont jamais nommés. Nous les lisons comme une offre distincte de l'offre souveraine, ce qui est cohérent avec la façon dont DRI présente les deux, mais la question mérite d'être posée si vous souscrivez. *Sources : [mentions légales](https://www.ia-souveraine.fr/mentions-legales), [politique de confidentialité](https://www.ia-souveraine.fr/confidentialite), [page souveraineté](https://www.ia-souveraine.fr/souverainete), [communiqué de lancement DRI](https://www.dri.fr/communique-de-presse-national-ia-souveraine).* LightOn **LightOn.** Société anonyme cotée sur Euronext Growth Paris depuis novembre 2024. Modèles développés en interne, déploiement possible en on-premise et jusqu'à l'air-gap pour des environnements classifiés. Information que nous n'avons pas trouvée : LightOn ne nomme nulle part l'hébergeur de son offre SaaS, présentée comme un « cloud européen souverain » sans plus de précision. *Sources : [politique de confidentialité développeurs](https://developers.lighton.ai/legal/privacy-policy), [options de déploiement](https://lighton.ai/deployment-options), [fiche IPO Euronext Growth](https://live.euronext.com/en/ipo-showcase/lighton).* Mistral AI **Mistral AI.** Le seul éditeur du panel qui produit ses propres modèles et opère ses propres datacenters : Bruyères-le-Châtel et Les Ulis dans l'Essonne, Borlänge en Suède, avec un campus francilien annoncé à 1,4 GW à pleine capacité. En septembre 2026, la société a levé 3 milliards d'euros, le plus gros tour jamais bouclé par une tech européenne, portant sa valorisation à environ 21 milliards. Le tour est mené par le sud-coréen Samsung, premier contributeur de l'opération, aux côtés du fonds Scale-up Europe de la Commission européenne, de PSG Equity, d'ASML, de Nvidia et de BNP Paribas CIB. Les fonds doivent financer des datacenters en propre et le doublement, en cinq ans, de la puissance de calcul détenue par la société. Sur le capital, Mistral revendique un actionnariat à majorité européenne : d'après franceinfo, les investisseurs européens représentent environ la moitié de ce tour, et l'Europe conserve après l'opération à peu près deux tiers du capital et trois quarts des droits de vote au conseil. On y trouve ASML, entré fin 2025 comme premier actionnaire à environ 11 %, Bpifrance, des fonds américains et le fonds souverain émirati MGX. Deux nuances, qui n'enlèvent rien à la profondeur industrielle du dossier. Et signalons d'emblée que **nous ne les connaissons que parce que Mistral les publie** : son Trust Center est l'un des plus complets du panel, avec un onglet listant nommément ses sous-traitants. Beaucoup d'éditeurs de cette liste n'exposent rien de comparable, et c'est précisément ce qui rend leurs fiches plus courtes. Ce Trust Center cite donc **deux sociétés américaines dans la chaîne** : Microsoft comme fournisseur d'infrastructure cloud pour les clients Studio européens, et CoreWeave comme fournisseur de calcul d'inférence. Et le verrouillage européen **passe par une demande écrite** : les clients Enterprise font désactiver au niveau de l'organisation les fonctionnalités qui impliquent un transfert hors UE, en le demandant à Mistral. *Sources : [où sont stockées mes données ?](https://help.mistral.ai/en/articles/347629-where-do-you-store-my-data-or-my-organization-s-data), [documentation de l'inférence régionale](https://docs.mistral.ai/inference/regional-inference), [Trust Center, onglet Subprocessors](https://trust.mistral.ai/subprocessors), [annonce infrastructure et modèles ouverts](https://mistral.ai/news/regional-inference-open-models-new-compute/), [levée de fonds de septembre 2026, franceinfo](https://www.franceinfo.fr/internet/intelligence-artificielle/la-start-up-francaise-mistral-annonce-une-nouvelle-levee-de-fonds-de-trois-milliards-d-euros-portant-sa-valorisation-a-plus-de-21-milliards-d-euros_8182583.html), [détail des investisseurs, Clubic](https://www.clubic.com/actualite-628704-mistral-ai-boucle-la-plus-grosse-levee-de-fonds-jamais-realisee-par-une-tech-europeenne.html).* Wikit **Wikit.** Wikit SAS, Lyon, spécialiste de l'assistant de support interne. Hébergement OVHcloud en France. Wikit nomme **sept tiers au total**, ce qui est déjà rare, et surtout il publie **la meilleure documentation du panel sur la couche modèle** : un tableau qui indique, fournisseur par fournisseur, si les données restent dans l'UE, avec une ligne qui répond franchement « non » pour OpenAI. Personne d'autre ne fait cela. Le choix des fournisseurs se règle au niveau du projet ; aucune console d'administration accessible au client n'est documentée. *Source : [confidentialité et sécurité, documentation Wikit](https://docs.wikit.ai/privacy_and_security/).* ### Groupe 2 : L'infrastructure est là, la porte reste ouverte Craft AI **Craft AI.** Craft.ai SAS, présidée par une holding française. Le dossier illustre bien le piège du « listé n'est pas imposé » : l'annexe de son DPA autorise cinq clouds, dont 3DS Outscale, OVHcloud et Scaleway, alors que la production tourne sur AWS et Scaleway. Autrement dit, la brique française existe, contractuellement, mais elle n'est jamais présentée comme une option catalogue. Côté modèles, sur les huit fournisseurs autorisés, **cinq sont américains** (AWS Bedrock, Google Vertex AI, Microsoft AI Foundry, OpenAI, Voyage AI), un est canadien (Cohere), et **deux seulement sont européens** : Mistral AI et Scaleway. Une configuration d'inférence entièrement européenne est donc possible sur le papier, mais elle suppose de s'en tenir à ces deux lignes. *Sources : [annexes du DPA](https://www.craft.ai/en/cgu-craft-ai/annexes), annexe B pour l'hébergement effectif et annexe C pour les sous-traitants autorisés, [conditions complémentaires sur les modèles de fondation](https://www.craft.ai/en/cgu-craft-ai/conditions-complementaires-relatives-a-lutilisation-des-modeles-de-fondation-ccmf).* Delos **Delos.** Le dossier le plus frustrant du panel. Delos Intelligence héberge **toutes les données chez Scaleway en région parisienne**, avec triple réplication, certification ISO 27001 et un trust center. Sur l'hébergement, rien à redire, et il s'agit de l'offre standard, pas d'une option payante. La suite se complique. La page sécurité affirme que les modèles sont « hébergés exclusivement dans l'Union européenne ». Mais le catalogue affiché est GPT 5.2, Claude Opus 4.5, Gemini 3 Pro et Mistral Large 3 : **trois modèles fermés sur quatre, donc nécessairement opérés par leurs éditeurs américains**, où que tourne le serveur. Et l'interface laisse l'**utilisateur** choisir son modèle, sans que rien ne documente la possibilité pour un administrateur de restreindre la liste. À porter à son crédit tout de même, et c'est la seule atténuation sérieuse quand les modèles sont fermés : la page sécurité mentionne un **traitement sur données pseudonymisées** avant transmission au modèle. Reste à faire préciser ce qui est pseudonymisé, et à quel moment de la chaîne. Si ce réglage d'administrateur existait, Delos deviendrait l'une des solutions les plus souveraines du marché sans toucher à son infrastructure. *Sources : [page sécurité](https://www.delos.so/fr/security), [politique de confidentialité](https://www.delos.so/fr/politique-de-confidentialite), [page produit Assistant](https://www.delos.so/fr/applications/assistant) pour la liste des modèles, [levée de fonds, FrenchWeb](https://www.frenchweb.fr/delos-leve-25-millions-deuros-pour-imposer-un-os-francais-de-lia-dans-lentreprise/453448).* ### Groupe 3 : Adossés à un hyperscaler américain Ask for the Moon **Ask for the Moon.** Capital franco-allemand, 2,5 M€ levés en mars 2024 auprès de Matterwave Ventures et UI Investissement, sans investisseur extra-européen identifié : c'est le point fort du dossier. Les services sont hébergés chez **Microsoft Azure à Paris**, et l'inférence n'est pas documentée publiquement. Un point à faire confirmer par écrit : leur propre page de protection des données indique que les données au repos ne sont pas chiffrées, ce qui est inhabituel. *Sources : [protection de vos données](https://askforthemoon.com/fr/protectingYourData), [portrait et levée de fonds, Maddyness](https://www.maddyness.com/2024/03/13/cette-startup-dune-ancienne-dg-de-la-sncf-utilise-lia-pour-relier-les-intelligences-humaines/).* Dust **Dust.** Permutation Labs SAS, société française. Le capital, lui, est majoritairement américain. **L'hébergement repose exclusivement sur Google Cloud**, seule la région varie, et il n'existe aucune alternative documentée : c'est le seul point du dossier qui ne se corrige pas par un réglage. Deux choses à mettre à leur crédit. Dust est très transparent : mentions légales, page des entités du groupe, mesures de sécurité, liste de sous-traitants datée, conditions spécifiques aux modèles de fondation, tout est public. Et c'est le seul à avoir contractualisé publiquement un droit d'opt-out par fournisseur, en libre-service pour l'inférence. Le mécanisme est cependant une liste noire, pas une liste blanche : la conformité s'obtient en désactivant cinq fournisseurs pour en garder un, et en mode strictement européen, il ne reste que Mistral. *Sources : [mesures de sécurité](https://dust-tt.notion.site/816d4ef898364ba180973a2c883b6d32), [liste des sous-traitants](https://dust-tt.notion.site/Sub-Processors-cb656ff3093c4aee9e080e3021e71f9c), [conditions sur les modèles de fondation](https://dust-tt.notion.site/9ed7e35633084d5fa03ebb02286de0da), [entités et affiliés](https://dust-tt.notion.site/20f5657d59a34c38a40e2567ec59db25).* Outmind **Outmind.** Outmind SAS, Palaiseau. Traitements par défaut dans l'EEE, hébergeur **AWS EMEA à Paris**, instance dédiée par client avec clé de chiffrement propre. L'inférence n'est pas documentée. Autre point de vigilance : l'authentification des utilisateurs passe par Clerk, société de San Francisco, et rien n'indique qu'elle soit optionnelle. *Sources : [page sécurité](https://www.outmind.ai/security), [politique de confidentialité](https://www.outmind.ai/data-privacy).* ### Groupe 4 : Trop peu d'information publique pour conclure Pour ces trois-là, nous n'avons tout simplement pas trouvé assez de matière publique. Une demi-heure d'entretien ferait bouger les trois fiches, dans un sens comme dans l'autre. Cominty **Cominty.** Cominty SAS. Le produit est présenté comme « agnostique » : Docker, GCP, AWS, OVH. C'est vraisemblablement un choix laissé au client, mais l'hébergement par défaut n'est pas documenté, et aucun fournisseur de modèle n'est nommé. Sur la sécurité en revanche, Cominty en dit plus que la moyenne du groupe : **SOC 2 Type II**, conformité RGPD, chiffrement AES-256 au repos et TLS 1.2+ en transit. Attention à ne pas conclure trop vite : l'agnosticité peut tout aussi bien recouvrir un réglage d'organisation qu'un libre choix d'utilisateur. *Sources : [site cominty.ai](https://www.cominty.ai/), [trust center](https://trust.cominty.ai).* Limova **Limova.** Marque exploitée par Kainotom.ia SAS, à Nice. La politique de confidentialité affirme un hébergement « exclusivement sur des serveurs situés au sein de l'Union européenne », mais le seul sous-traitant nommé de toute la documentation est Google Firebase, service de Google LLC. La documentation ne décrit ni fournisseur de modèle ni chaîne de traitement, pour un produit dont les agents lisent les emails et prennent les appels téléphoniques. À noter aussi, sur la forme : les mentions légales ne publient ni le SIREN, ni le numéro RCS, ni l'hébergeur, alors que la loi les impose. *Sources : [mentions légales](https://www.limova.ai/legal/mentions-legales), [politique de confidentialité](https://www.limova.ai/legal/politique-de-confidentialite), [le modèle Limova, Maddyness](https://www.maddyness.com/2026/01/29/agents-ia-entreprises/).* Prisme.ai **Prisme.ai.** Prisme.ai SAS. La particularité change toute la lecture : la plateforme se déploie en **auto-hébergement ou en cloud privé du client**, par Kubernetes, aussi bien sur OVHcloud que sur AWS ou Azure. La souveraineté est donc entièrement déléguée au client : celui qui déploie sur OVHcloud obtient une pile française, celui qui déploie sur AWS n'en obtient pas, et l'éditeur ne garantit ni l'un ni l'autre. Aucun fournisseur de modèle n'est nommé, aucune certification n'est mentionnée, et le capital n'est pas publié. *Sources : [documentation Prisme.ai](https://docs.prisme.ai/), [pages produit](https://www.pages.prisme.ai/fr).* ### Groupe 5 : Le faux ami Slite **Slite.** Slite est régulièrement rangé parmi les alternatives françaises : fondateurs français, équipe française, bureau parisien, produit de gestion de connaissance avec une recherche par IA. Sa propre page légale est pourtant sans ambiguïté. > L'entité contractante et responsable de traitement est **Slite, Inc., société du Delaware**, domiciliée à San Francisco. Slite France SAS « ne commercialise pas le Service et n'agit pas comme entité contractante pour les clients : elle fournit des services d'emploi et de support au sein du groupe ». Les données de production sont hébergées sur Google Cloud, à Saint-Ghislain en Belgique. Un client européen contracte donc avec une société américaine, sur une infrastructure américaine, avec des serveurs en Belgique. C'est parfaitement légal, l'entreprise ne s'en cache pas, et sa sécurité est solide, avec un SOC 2 Type II. Slite ne promet pas la souveraineté. C'est aussi, sur quatorze éditeurs, **le seul cas de société contrôlée depuis l'étranger**. *Sources : [informations légales](https://slite.com/legal), [politique de confidentialité](https://slite.com/privacy), [page sécurité](https://slite.com/security).*## Petit reality check complémentaire : où est hébergé leur propre site Celui-là n'a aucune portée opérationnelle. Un site vitrine ne porte pas vos données, et le confier à un prestataire américain n'engage rien sur l'architecture du produit. Mais c'est le seul test que vous pouvez faire vous-même, en trente secondes, avant même le premier rendez-vous. Et il en dit un peu sur l'état d'esprit de la maison. Voici ce que nous avons pu déterminer : | Hébergeur du site institutionnel | Éditeurs | |---|---| | **Hébergeur français** | Ask This Guy et Wikit (OVHcloud, Scaleway) ; IA-Souveraine.fr sur son propre réseau | | **AWS (Etats-Unis)** | Prisme.ai | | **Webflow (États-Unis)** | Ask for the Moon, Cominty, Craft AI, Delos, LightOn, Limova, Outmind | | **Google Cloud ou Netlify (États-Unis)** | Dust, Mistral AI, Slite | ## Les trois questions à poser en démonstration S'il ne fallait retenir qu'une chose de cet article, ce serait ces trois questions. Elles se posent en dix minutes et elles appellent des réponses vérifiables. 1. **« Qui héberge nos données, nommément, et existe-t-il une alternative européenne à votre offre standard ? »** Un éditeur sérieux nomme son hébergeur. Refuser de le nommer est en soi une réponse. 2. **« Peut-on choisir de façon pérenne et simple de ne jamais utiliser de fournisseurs d'inférence non européens ? »** 3. **« Si nous passons en configuration entièrement européenne, combien de fournisseurs nous reste-t-il ? »** Une conformité qui repose sur un fournisseur unique est un point de défaillance unique. ## Ce que nous en avons fait, chez Ask This Guy Nous avons construit notre produit en essayant de répondre d'avance à ces questions, et c'est aussi pour ça qu'on avait envie d'écrire cet article. Notre offre est présentée en détail sur notre page [IA souveraine](https://www.askthisguy.com/fr/ia-souveraine/). Concrètement : l'infrastructure et les bases de données sont sur des serveurs dédiés OVHcloud à Gravelines, avec une redondance à Francfort, et nous opérons nos propres GPU chez Verda, en Finlande et en Islande, pour exécuter nous-mêmes des modèles à poids ouverts. Sur l'inférence, un administrateur bascule toute son organisation entre deux politiques depuis un menu de la console : « UE uniquement », qui n'autorise que des fournisseurs européens et nos modèles auto-hébergés, ou « Monde entier », qui ouvre la couche modèle sans jamais déplacer l'hébergement. Le réglage se change à tout moment. Nous ne prétendons pas que ce soit la seule bonne architecture. Plusieurs éditeurs de cette liste ont fait des choix différents et parfaitement défendables. Nous pensons simplement qu'un acheteur doit pouvoir constater, verrouiller et prouver, sans avoir à négocier. Le détail de notre chaîne de traitement est documenté publiquement dans notre [approche de l'IA souveraine](https://www.askthisguy.com/fr/doc/infrastructure-and-security/sovereign-ai/) et dans notre [gestion des fournisseurs d'IA](https://www.askthisguy.com/fr/doc/infrastructure-and-security/ai-providers/). ## Questions fréquentes sur les IA françaises et souveraines ### Qu'est-ce qu'une IA souveraine pour une entreprise ? Une IA souveraine est une solution dont la société éditrice, l'hébergeur des données et l'opérateur de l'inférence relèvent tous du droit européen, de sorte qu'aucune autorité étrangère ne peut exiger l'accès aux données ni interrompre le service. Le terme n'a aucune définition légale ni label officiel : il faut donc vérifier les trois maillons séparément, dans les documents publics de l'éditeur. ### Une IA hébergée en France est-elle forcément souveraine ? Non. Un hébergement en France chez AWS, Microsoft Azure ou Google Cloud reste opéré par une société de droit américain, soumise au CLOUD Act quelle que soit la localisation des serveurs. La résidence des données satisfait une clause contractuelle de localisation, mais elle ne change pas la juridiction applicable au prestataire. C'est la distinction la plus souvent escamotée dans les argumentaires commerciaux. ### Mistral AI est-elle une entreprise française ? Oui. Mistral AI est une société par actions simplifiée de droit français, immatriculée sous le SIREN 952 418 325, sans société mère hors Union européenne identifiée. En septembre 2026, elle a bouclé un tour de 3 milliards d'euros mené par le sud-coréen Samsung, pour une valorisation d'environ 21 milliards. Malgré l'arrivée d'investisseurs non européens (Samsung, Nvidia), la société revendique un actionnariat à majorité européenne : d'après franceinfo, environ deux tiers du capital et trois quarts des droits de vote au conseil restent européens après l'opération. Parmi les actionnaires figurent le néerlandais ASML, entré fin 2025 à environ 11 %, Bpifrance, des fonds américains et le fonds souverain émirati MGX. ### Dust est-elle une entreprise française ? Oui sur le plan juridique. L'entité contractante est Permutation Labs SAS, société française immatriculée sous le SIREN 949 205 314, sans société mère étrangère, ce que confirment ses mentions légales et sa page des entités du groupe. Son capital est en revanche majoritairement américain après deux tours menés par Sequoia, et son infrastructure repose exclusivement sur Google Cloud. ### Peut-on utiliser ChatGPT ou Claude en restant souverain ? Non, au sens strict. GPT et Claude sont des modèles fermés dont seuls OpenAI et Anthropic détiennent les poids : eux seuls peuvent les exécuter, et le traitement relève donc du droit américain même sur un serveur européen. Les configurations réellement européennes reposent sur des modèles (à poids ouverts ou non) opérés par un acteur européen, ou sur un éditeur qui produit ses propres modèles. ### Comment vérifier soi-même si un éditeur d'IA est réellement français ? Ouvrez trois pages, cela prend une dizaine de minutes. Les mentions légales ou la page `/legal` donnent l'entité contractante et permettent de repérer une société mère étrangère. La politique de confidentialité ou l'annexe du DPA nomme l'hébergeur et les sous-traitants. Le numéro SIREN se recoupe gratuitement sur `annuaire-entreprises.data.gouv.fr`. Si l'une de ces trois informations est absente, c'est déjà un résultat. --- ## En résumé Sur quatorze éditeurs, treize sont bien des sociétés européennes. Bonne nouvelle, mais c'est aussi le point le moins discriminant du marché. Tout se joue sur deux décisions d'ingénierie. **L'hébergement**, où quatre éditeurs seulement s'appuient en standard sur un prestataire de droit européen, alors que le choix ne coûte rien à l'utilisateur final. Et **le contrôle de l'inférence**, où presque personne ne permet à un administrateur d'imposer une configuration européenne à toute son organisation, sans demande écrite ni désactivation manuelle. Le mot « souverain » n'est défini nul part ni protégé par rien. Demandez le nom des hébergeurs et des fournisseurs d'IA pour bien comprendre où partent vos données. Si vous préparez un projet d'IA d'entreprise et que vous voulez confronter ces critères à votre contexte : **[réservez une démo](https://www.askthisguy.com/fr/demo/)**. --- # Inférence IA : les 7 façons de faire tourner vos modèles en entreprise URL: https://www.askthisguy.com/fr/blog/enterprise-ai-inference/ Language: fr Section: Blog « On achète des GPU et on héberge tout nous-mêmes. » « Non, on branche une API et on avance. » Cette discussion est un grand classique des philosophies qui s'affrontent sur l'inférence IA en entreprise. Elle arrive tôt dans un projet d'IA, en général au moment de chiffrer le budget. D'un côté ceux qui veulent l'IA à la maison : on achète les cartes, on installe les modèles, rien ne sort de l'entreprise. De l'autre ceux qui veulent consommer un service : une clé d'API ou un abonnement, on paie à l'usage, aucun matériel à gérer. Les deux camps ont de bons arguments. Le souci, c'est qu'ils débattent de deux options sur sept. Ce qu'ils se disputent porte un nom : **l'inférence**. ## L'inférence, c'est quoi exactement L'inférence, c'est le moment où un modèle d'IA répond à une question. Pas son apprentissage, qui a déjà eu lieu et qui a coûté des millions à quelqu'un d'autre : juste le fait de lui soumettre une requête et d'obtenir un texte en retour. L'inférence revient tous les jours. Elle est proportionnelle à votre usage, aussi longtemps que votre service tourne. C'est elle qui détermine la vitesse, la facture et le niveau de confidentialité de votre projet. Un **token** est une petite unité de texte, un mot ou un morceau de mot. Les fournisseurs facturent au million de tokens, en comptant séparément l'entrée et la sortie. Les **tokens d'entrée** sont tout ce que vous envoyez au modèle : la question de l'utilisateur, mais aussi les consignes, l'historique de la conversation, les extraits de documents et la description des outils disponibles. Les **tokens de sortie** sont ce que le modèle génère en réponse. À volume égal, la sortie coûte en général trois à cinq fois plus cher, parce que chaque token produit demande un passage complet dans le modèle là où l'entrée est traitée d'un bloc. Le rapport entre les deux dépend beaucoup de votre cas d'usage, et c'est lui qui façonne votre facture. Un assistant généraliste envoie peu et reçoit beaucoup : question courte, réponse développée. Une [IA agentique](https://www.askthisguy.com/fr/blog/enterprise-ai-agents/) fait l'inverse. À chaque étape, l'agent renvoie tout le contexte accumulé, les résultats de ses appels d'outils et l'historique de ses tentatives, pour produire parfois trois lignes de décision. L'entrée gonfle à chaque tour de boucle. C'est pour cette raison que les fournisseurs proposent des tarifs réduits sur la part du contexte réutilisée d'un appel à l'autre. Reste la vitesse, mesurée en **tokens par seconde**. Pour du chat simple ou de la complétion, 100 tokens/s donnent une réponse qui paraît fluide. Pour de l'agentique, où le modèle enchaîne plusieurs appels avant d'afficher quoi que ce soit, il faut plutôt viser 500 tokens/s. Nous détaillons ces seuils dans notre article sur le [LLM en local](https://www.askthisguy.com/fr/blog/llm-local-enterprise-sovereignty-illusion/). ## Si vous ne devez retenir qu'une chose Le monde n'est pas binaire. Entre « tout acheter » et « tout consommer », le marché propose une panoplie de solutions valables, toutes avec de bonnes raisons d'exister, et la plupart des entreprises qui tournent en production en panachent plusieurs. Le bon choix dépend de votre contexte, pas d'une position de principe. Deux façons raisonnables d'aborder le sujet. La première : ne pas vous prendre la tête, prendre une solution chez un fournisseur, et concentrer votre vigilance sur un seul point, sa métrique de facturation. Une offre facturée au message, à l'utilisateur ou au forfait reste prévisible. Une offre facturée au token, beaucoup moins. La seconde : y passer quelques jours, parce que l'écart de coût entre les sept approches se compte en ordres de grandeur et non en pourcentages. Dans les deux cas, ce que vous cherchez à éviter s'appelle le *bill shock*, et il arrive régulièrement. En juin 2025, [Cursor](https://cursor.com/blog/june-2025-pricing) bascule ses abonnements individuels vers une facturation à l'usage sans que ses utilisateurs comprennent que l'« illimité » annoncé ne couvrait qu'un seul modèle ; l'éditeur a publié ses excuses le 4 juillet et remboursé trois semaines de dépassements. Sur le dépôt de [Gemini CLI](https://github.com/google-gemini/gemini-cli/discussions/4472), des développeurs persuadés de rester dans une limite de 1 000 requêtes par jour ont découvert des factures de 2 000, 6 400, parfois 10 000 dollars : leur clé d'API facturait au token, et les boucles de raisonnement du modèle en consommaient des centaines de millions. Même racine dans les deux cas. L'utilisateur raisonnait en requêtes, le fournisseur facturait en tokens. ## Quatre choses se jouent sur la couche d'inférence ### Vos utilisateurs comparent avec ChatGPT Ils arrivent avec une référence en tête, et cette référence s'appelle ChatGPT, Gemini ou Mistral. Ils ont pris l'habitude d'un texte qui se déroule instantanément. Si votre assistant interne met quinze secondes à démarrer sa réponse, personne ne dira que l'infrastructure est sous-dimensionnée. On dira que votre outil ne marche pas, et on retournera à celui d'avant. Beaucoup de solutions B2B tournent à ce régime aujourd'hui. Le produit fait ce qu'il promet, la démo passe bien, et personne ne l'ouvre une deuxième fois. Cette latence se joue presque entièrement au niveau de l'inférence, et c'est de loin le premier motif d'abandon que nous constatons sur les assistants internes. Un projet techniquement correct meurt très bien de quinze secondes de trop. ### Personne ne tient 99,9 % tout seul Les grands fournisseurs d'IA tournent autour de 99 à 99,5 % de disponibilité, soit plusieurs jours d'indisponibilité cumulés par an. Vos utilisateurs, eux, ont l'habitude des quatre neuf sur leurs outils bureautiques. L'écart se voit. Nous avons publié les chiffres réels par fournisseur dans [SLA IA entreprise](https://www.askthisguy.com/fr/blog/enterprise-ai-sla/). Le défaut de conception le plus fréquent que nous croisons n'a pas bougé depuis deux ans : un seul fournisseur, aucun repli. ### Vous envoyez vos documents à quelqu'un Faire de l'inférence, c'est transmettre à un tiers la question de votre utilisateur et les extraits de documents qui servent à y répondre. Contrats, notes internes, données clients. Mieux vaut savoir à qui, sous quel droit, avec quelle politique de rétention et quel engagement de non-entraînement. Il n'y a pas de bonne réponse universelle ici, seulement un curseur à placer. Nous avons documenté le nôtre sur la page [IA souveraine](https://www.askthisguy.com/fr/ia-souveraine/). ### Le modèle en tête du classement coûte cher pour rien Il n'est presque jamais celui qu'il vous faut. Pour classer un ticket, extraire un champ ou reformuler une réponse à partir de documents fournis, un modèle plus petit et plus rapide fait le travail. Surtout, l'écart de prix n'a aucun rapport avec l'écart de capacité. Voici quatre offres du marché, placées selon leur coût moyen au million de tokens et leur indice d'intelligence : ![Nuage de points comparant coût au million de tokens et indice d'intelligence pour quatre offres. DeepSeek V4 Flash servi par le français Umans atteint un indice de 50 pour 0,11 € au MTok, quand GPT-5.6 Sol d'OpenAI atteint 56 pour 7,35 €, et GPT-5.6 Luna 46 pour 0,29 €.](https://www.askthisguy.com/blog/enterprise-ai-inference/cout-vs-intelligence-modeles-ia.webp) **GPT-5.6 Sol coûte 7,35 € au MTok pour un indice « d'intelligence » de 56. DeepSeek V4 Flash servi par Umans coûte 0,11 € pour un indice de 50.** Six points d'écart, un facteur 69 sur la facture. Regardez ensuite GPT-5.6 Luna, en bas du nuage : près de trois fois le prix de l'offre Umans, pour un indice inférieur de quatre points. Payer plus ne garantit même pas d'obtenir mieux. Le classement vous dit ce qu'un modèle sait faire, jamais ce qu'il va vous coûter. Un dernier point, et c'est celui que nous répétons le plus souvent : un benchmark classe les modèles sur des tâches génériques, jamais sur la vôtre. Un indice d'intelligence ne dit rien de la façon dont un modèle se comporte sur votre jargon métier, vos documents, votre langue ou le format de sortie que vous attendez. Prenez deux jours pour faire tourner trois ou quatre candidats sur un échantillon représentatif de vos cas réels, et comparez ce qui sort. C'est le seul classement qui compte pour vous, et il bouscule régulièrement l'ordre officiel. *Indice d'intelligence : [Artificial Analysis](https://artificialanalysis.ai/), relevés d'août 2026. Coût moyen calculé sur un mélange de 40 % d'entrée en cache, 40 % d'entrée fraîche et 20 % de sortie, à raison de 1 € = 1,15 $. Les mentions max et high désignent le niveau d'effort de raisonnement du modèle.* ## Les sept approches ### 1. Acheter vos GPU et les exploiter vous-même Vous achetez les cartes, vous les installez, vous déployez les modèles, vous maintenez l'ensemble. Maîtrise maximale : vos données ne sortent jamais, vous choisissez tout, et personne ne change vos conditions du jour au lendemain. CAPEX maximal aussi. Pour un modèle vraiment rapide et capable, comptez six chiffres, plus les compétences à recruter pour opérer la machine. Votre infrastructure IA devient un projet à part entière, avec son budget et son équipe. Nous avons fait le calcul en détail dans [RAG on premise : que peut-on faire avec 60 k€ ?](https://www.askthisguy.com/fr/blog/llm-local-enterprise-sovereignty-illusion/). À réserver aux contraintes réglementaires absolues, aux volumes massifs et stables, et aux entreprises qui ont déjà une équipe infrastructure. Ou à celles qui comptent revendre leur capacité quand elle est inactive, et nous y revenons à l'approche 4. ### 2. Louer des GPU dédiés chez un fournisseur cloud Même architecture, même travail de déploiement, mais le matériel ne vous appartient plus. Le CAPEX devient de l'OPEX prévisible, électricité et refroidissement compris, et les pannes matérielles regardent votre fournisseur. Méfiez-vous du prix affiché à l'heure. Un service disponible en continu tourne 730 heures par mois, donc ce prix horaire est en réalité un loyer mensuel. Un H100 chez [Scaleway](https://www.scaleway.com/fr/tarifs/gpu/) est à 2,73 € l'heure, ce qui passe très bien en réunion, et coûte **près de 2 000 € par mois, 24 000 € par an, pour une seule carte**. Chez [Verda](https://verda.com/pricing), opérateur finlandais dont les centres de données sont en Finlande et en Islande, le H100 SXM5 est à 3,25 $ l'heure, avec 8 % de remise sur un an et 25 % sur deux ans. Le réflexe suivant, c'est de comparer avec l'achat. Un H100 PCIe [se négocie](https://www.cloudzero.com/blog/h100-gpu-cost/) entre 25 000 et 33 000 $ sur le marché, un H100 SXM5 entre 35 000 et 40 000 $. Louer une carte en continu coûte donc son prix d'achat en douze à dix-sept mois selon le modèle et le fournisseur. Et une carte suffit rarement : un serveur à huit H100, dimensionné pour servir correctement un gros modèle, tourne autour de 19 000 $ par mois, soit 228 000 $ par an, quand la machine équivalente s'achète au-delà de 350 000 $. Dix-huit mois de retour sur investissement. Sur le papier, c'est excellent. Sauf que la comparaison oppose une carte à un service. Le prix d'achat n'inclut ni le data center, ni l'électricité, ni le refroidissement, ni le réseau, ni les équipes qui exploitent l'ensemble. Et l'actif se déprécie vite : un H100 d'occasion se revend 60 à 70 % du neuf pendant que les B200 et B300 arrivent et tirent les prix de location vers le bas. Vous amortissez sur trois ans un matériel dont le loyer équivalent aura baissé avant la fin de la période. À cette échelle, la location ne fait pas disparaître les six chiffres de l'approche 1 : elle les transforme en loyer annuel. {/* SLOT PARTENAIRE : Verda. Mention factuelle en place (grille tarifaire publique + localisation UE/EEE). Emplacement prêt pour une citation partenaire enrichie après accord. */} ### 3. Ne monter les GPU que lorsque vous en avez besoin Vous allumez la machine, ou plutôt un container dans la plupart des cas, vous faites le travail, vous l'éteignez. Certains fournisseurs facturent par tranche de durée utilisée, dix minutes chez Verda par exemple, ce qui veut dire qu'un traitement bouclé en 45 minutes en coûte 50. Beaucoup proposent aussi des tarifs *spot*, sur capacité disponible, à moitié prix. Deux heures de traitement par nuit font une soixantaine d'heures par mois, soit environ 98 $ en spot, là où la même carte tenue en continu coûte 2 370 $. Facteur vingt-quatre. C'est la meilleure affaire du marché pour du traitement de fond : réindexation documentaire, calcul d'embeddings, classification en masse, extraction sur un stock de PDF. Pour un service ouvert en journée, oubliez. Démarrer une machine et charger un modèle prend des minutes, et une instance spot peut vous être reprise en cours de route. Personne n'attend cinq minutes que son assistant se réveille. {/* SLOT PARTENAIRE : Verda (offre spot / à la demande). Emplacement prêt après accord. */} ### 4. Louer de la capacité excédentaire à ceux qui en ont trop Ceux qui ont choisi l'approche 1 ont des GPU inactifs une partie du temps. Un marché s'est monté pour revendre ces heures creuses, souvent bien en dessous des prix des grands fournisseurs, puisque le matériel est déjà amorti de toute façon. Cette catégorie couvre deux réalités très différentes. À une extrémité, des acteurs qui en ont fait un service d'entreprise : capacité réservée par contrat, engagement de disponibilité, opérateur identifié, matériel hébergé dans des data centers connus. Vous y accédez comme chez n'importe quel fournisseur cloud, avec une facture et un interlocuteur, mais à un tarif tiré vers le bas par le fait que les cartes existaient déjà. {/* SLOT PARTENAIRE : Hexa Compute. Emplacement principal de cette section, à insérer ici après accord : c'est le bout "service d'entreprise" du spectre. */} À l'autre extrémité, le marché de particulier à particulier. [Darkbloom](https://www.darkbloom.dev/), issu d'Eigen Labs, fait tourner de l'inférence sur des Mac Apple Silicon inactifs, avec un chiffrement conçu pour que le propriétaire de la machine ne puisse pas lire ce qui y transite. Le projet est encore expérimental et nous n'y mettrions pas un service critique aujourd'hui. L'idée tient debout : des dizaines de millions de Mac récents dorment une bonne partie de la journée avec beaucoup de mémoire disponible. Dans les deux cas, regardez qui opère la machine, ce qu'il peut voir, et quel engagement de disponibilité il signe. C'est ce qui sépare une bonne affaire d'un pari. ### 5. Passer par un fournisseur d'inférence Plus aucune machine à gérer. Vous appelez une API, vous payez au token, et quelqu'un d'autre garde des GPU chauds en permanence pour vous. Deux familles cohabitent. Les pure players de l'inférence servent des modèles [open weights](https://www.askthisguy.com/fr/blog/open-source-vs-open-weights-ai/) et se battent sur la vitesse et le prix : Cerebras, Groq, DeepInfra, Nebius. Les acteurs grand public, OpenAI, Anthropic, Google, Mistral, servent leurs propres modèles. La nuance se voit sur la facture. À qualité comparable sur beaucoup de tâches, les premiers sont sensiblement moins chers, parce que les seconds facturent aussi leur notoriété et l'exclusivité de leurs modèles. Comme un même modèle ouvert tourne chez une dizaine de fournisseurs, vous pouvez changer d'avis sans retoucher vos prompts. Choisissez un acteur qui publie un vrai engagement de service, pas seulement une page de statut. Et prévoyez un repli dès le premier jour. {/* SLOT PARTENAIRE : Umans. Emplacement prêt, à insérer après accord, dans la famille "pure players". */} ### 6. Mettre une passerelle devant plusieurs fournisseurs Vous en branchez plusieurs derrière une couche unique, qui mesure leur santé, arbitre selon la vitesse et le prix, et bascule automatiquement quand l'un décroche. C'est ce qu'on appelle une passerelle multi-fournisseurs, ou *AI gateway*. Aucun fournisseur n'atteint seul les 99,9 %. Mis bout à bout derrière une passerelle qui teste et bascule, on y arrive. Nous avons consacré un article entier au sujet, chiffres et produits du marché compris : [SLA IA entreprise](https://www.askthisguy.com/fr/blog/enterprise-ai-sla/). {/* SLOT PARTENAIRE : Eden AI. À insérer après discussion sur le périmètre de la réciprocité. Eden AI est déjà cité dans blog/enterprise-ai-sla. */} ### 7. Laisser votre plateforme s'en charger Vous achetez un produit d'IA d'entreprise et l'inférence devient le problème de quelqu'un d'autre. Aucun GPU à exploiter, pas de passerelle à construire, et la veille sur les modèles ne vous concerne plus. En échange, vous héritez des choix de votre fournisseur IA. D'où la question à lui poser avant de signer : **est-il capable de décrire sa chaîne d'inférence ?** Quels fournisseurs, dans quelle juridiction, avec quel repli, sous quel engagement de non-entraînement. Celui qui reste vague sur cette partie vous demande de lui faire confiance sur le maillon le plus sensible. ## Les sept approches d'inférence IA comparées *Lecture : le vert est favorable, le rouge défavorable. Le signe ± marque un critère qui dépend du fournisseur retenu.* | # | Approche | Modèle de coût | Légèreté d'exploitation | Fiabilité | Souveraineté | Mise en route | Quand c'est le bon choix | | --- | --- | --- | --- | --- | --- | --- | --- | | 1 | Acheter les GPU | CAPEX élevé | −−− | ++ | +++ | Mois | Contrainte réglementaire absolue, volume massif | | 2 | Louer du GPU dédié | OPEX élevé, prévisible | −− | ++ | ++ | Jours | Volume stable, exigence de localisation | | 3 | GPU à la demande | OPEX à l'usage | | −− | ++ | Heures | Traitement de fond, batch, pics ponctuels | | 4 | Capacité excédentaire | OPEX très faible | | | ± | Heures | Budget contraint, opérateur vérifié | | 5 | Fournisseur d'inférence | Au token | ++ | | ± | Minutes | La majorité des projets | | 6 | Passerelle multi-fournisseurs | Au token, plus la couche | ++ | +++ | ± | Jours | Dès qu'un vrai niveau de service est attendu | | 7 | Plateforme clé en main | Abonnement | +++ | +++ | ± | Minutes | Vous achetez un résultat métier | ## En pratique, une entreprise combine souvent plusieurs solutions Une seule approche peut très bien suffire, et c'est souvent le cas quand le périmètre est clair et les usages homogènes. Mais dès que les cas d'usage se diversifient, les entreprises finissent régulièrement avec deux ou trois régimes différents. Dans un cas comme dans l'autre, partez de votre contrainte la plus dure et laissez le reste s'organiser autour. Une contrainte réglementaire ne porte presque jamais sur la totalité de votre périmètre. Isolez le cas d'usage réellement sensible sur une infrastructure dédiée, laissez le reste sur du mutualisé. C'est souvent ce découpage qui débloque un budget, parce qu'il ramène l'exigence forte à la part du projet qu'elle concerne vraiment. Quand c'est la latence qui commande, elle ne commande que l'interactif. Une entreprise que nous accompagnons fait tourner sa réindexation documentaire nocturne sur du GPU à la demande, pour quelques dizaines d'euros par mois, et sert son assistant en journée via un fournisseur d'inférence rapide. Deux régimes de coût, un seul projet. Et si c'est le budget, commencez par l'approche 5 ou 7, sans hésiter. Six mois d'usage réel vous diront si l'internalisation a le moindre sens. Elle est presque toujours plus chère que prévu, et personne ne s'en rend compte avant d'avoir les chiffres sous les yeux. Pour fixer les ordres de grandeur, voici le même H100 vu sous trois angles : | Accès à un H100 | Coût | Base de calcul | | --- | --- | --- | | Achat | ~30 000 $, soit ~26 000 €, la carte seule | Prix marché PCIe et SXM5 | | Location dédiée, 24/7 | ~2 000 € par mois | Scaleway, 2,73 €/h × 730 h | | À la demande, 2 h par nuit | ~98 $ par mois | Verda spot, 1,63 $/h × 60 h | Le matériel est identique dans les trois cas, seul le régime d'usage change. Combien de temps faut-il louer avant d'avoir dépensé le prix de la carte ? En continu, à 2 000 € par mois, il vous faut **treize mois** pour atteindre les 26 000 € d'achat. Sur le régime à la demande, à 85 € par mois, il vous en faut **plus de vingt-cinq ans**. C'est là que se joue la décision, et pas ailleurs. L'achat ne devient intéressant que si vous savez que la machine tournera vraiment en continu, pendant plusieurs années, sur des volumes que vous avez déjà mesurés. ## Chez Ask This Guy Aujourd'hui, nos clients sont dans le cas 7. Ils n'opèrent aucun GPU, ne construisent aucune passerelle, et l'inférence ne figure pas à leur budget. Ça ne tient que parce que nous panachons nous-mêmes les approches 2, 3 et 5. Nous montons nos propres infrastructures GPU chez Verda, en Finlande et en Islande, où nous déployons et opérons certains modèles, et nous consommons en parallèle des fournisseurs d'inférence sélectionnés derrière notre [passerelle de fournisseurs IA](https://www.askthisguy.com/fr/doc/infrastructure-and-security/ai-providers/). Vous placez ensuite le curseur, politique UE uniquement ou monde entier, modifiable à tout moment depuis la console. Tout est public dans notre [approche de l'IA souveraine](https://www.askthisguy.com/fr/doc/infrastructure-and-security/sovereign-ai/). Si nous écrivons cet article, c'est que les arbitrages décrits ici, nous les avons payés. ### Bring Your Own AI : branchez votre propre inférence Le cas 7 ne devrait pas être une impasse. Si vous avez déjà des GPU, un contrat chez un fournisseur d'inférence ou votre propre passerelle, vous devez pouvoir les brancher plutôt que de les mettre au rebut. C'est ce que permet notre mode **Bring Your Own AI** : connecter vos propres modèles, vos fournisseurs ou vos points d'inférence à la plateforme. Il est disponible **aujourd'hui sur demande**, et sera bientôt proposé en standard. Concrètement, les six autres approches restent ouvertes. Des GPU achetés l'an dernier se branchent. Un tarif négocié chez un fournisseur d'inférence se conserve. Et si vous préférez démarrer clé en main pour internaliser dans dix-huit mois, une fois vos volumes réellement connus, vous n'aurez pas à changer d'outil en route. ## Questions fréquentes sur l'inférence IA ### Qu'est-ce que l'inférence en IA ? L'inférence est la phase où un modèle d'intelligence artificielle déjà entraîné traite une requête et produit une réponse. Elle s'oppose à l'entraînement, qui est la phase d'apprentissage du modèle. Pour une entreprise, l'entraînement est un coût rare et souvent inexistant, alors que l'inférence est un coût récurrent proportionnel à l'usage réel du service. ### Combien coûte l'inférence d'un LLM en entreprise ? Le coût d'une inférence LLM dépend entièrement de l'approche retenue. En location de GPU dédié, un H100 tenu en continu revient à environ 2 000 à 2 400 € par mois, soit près de 24 000 € par an pour une seule carte, et un serveur à huit cartes dépasse 200 000 € par an. En passant par un fournisseur d'inférence facturé au token, un assistant interne pour quelques centaines d'utilisateurs se chiffre le plus souvent en centaines d'euros par mois. L'écart entre les deux modèles justifie de mesurer ses volumes réels avant d'internaliser. ### Faut-il acheter des GPU pour faire de l'IA en entreprise ? Dans la grande majorité des cas, non. L'achat de GPU se justifie quand une contrainte réglementaire interdit toute sortie des données, quand le volume est massif et stable, et quand une équipe infrastructure existe déjà pour exploiter le matériel. En dehors de ces conditions, la location ou le recours à un fournisseur d'inférence coûte moins cher et se met en place en quelques minutes plutôt qu'en quelques mois. ### Qu'est-ce qu'une infrastructure IA ? Une infrastructure IA regroupe tout ce qui permet d'exécuter des modèles d'intelligence artificielle : les GPU, les serveurs qui les hébergent, le réseau, le stockage, et la couche logicielle qui sert les modèles. En entreprise, la question n'est pas seulement de savoir quels composants choisir, mais qui les exploite : vous, un fournisseur cloud, un fournisseur d'inférence, ou l'éditeur de votre plateforme. ### Quelle différence entre un fournisseur d'inférence et une API gateway ? Un fournisseur d'inférence exécute lui-même les modèles sur ses propres GPU et vous facture les tokens consommés. Une API gateway, ou passerelle multi-fournisseurs, n'exécute aucun modèle : elle se place devant plusieurs fournisseurs, mesure leur disponibilité et leur vitesse, et bascule automatiquement de l'un à l'autre. On utilise généralement les deux ensemble, la passerelle servant à obtenir un niveau de service qu'aucun fournisseur n'atteint seul. --- ## Conclusion Votre projet d'IA vous obligera à trancher la question de l'inférence, et probablement dès le chiffrage du budget. Vous pouvez bâtir votre propre infrastructure IA, tout déléguer, ou assembler quelque chose entre les deux. Les projets qui tiennent en production ne sont pas ceux qui ont choisi le bon camp. Ce sont ceux qui savaient qu'il y en avait sept. L'inférence se paie tous les mois, pour toute la durée de vie du service. Partez de votre contrainte la plus dure, le reste s'organise autour. Si vous préparez un projet d'IA et que vous voulez confronter votre cas d'usage à ces arbitrages : **[réservez une démo](https://www.askthisguy.com/fr/demo/)**. --- # Agent IA en entreprise : cas d'usage et coûts réels URL: https://www.askthisguy.com/fr/blog/enterprise-ai-agents/ Language: fr Section: Blog Depuis dix-huit mois, tout le monde vous parle d'**agents IA**. Les démonstrations sont impressionnantes : on pose une question, l'IA consulte trois outils, recoupe, agit et rend un résultat propre. Puis vous essayez de reproduire ça sur vos propres processus, et le sol se dérobe. La technologie marche. Entre la démo et un **agent IA en entreprise** qui tourne tous les jours, il y a une liste de sujets qu'on n'aborde jamais en kick-off : la mission exacte de l'agent, les cas limites, la part du travail qu'il ne faut surtout pas confier à un modèle, la façon dont on vérifie le résultat, et le nom de la personne qu'on appellera quand l'agent se trompera un vendredi à 18 h. Ce sont eux qui décident du sort d'un projet, et on va les prendre un par un : la méthode qui sépare une démo d'une production, les six agents que nous mettons en service chez nos clients, et les prix. **En une phrase.** Un agent IA est un modèle de langage placé dans une boucle, équipé d'outils et d'un objectif, qui décide lui-même de la séquence d'actions à mener, observe le résultat de chaque action et recommence jusqu'à atteindre son but. ## Ce qu'on appelle un agent IA La définition tient en quatre briques. Un agent, c'est : 1. **Un modèle de langage**, qui comprend la demande et raisonne. 2. **Des outils**, c'est-à-dire des fonctions que le modèle peut déclencher : `chercher_client`, `lire_facture`, `creer_ticket`, `envoyer_rapport`. Chaque outil est décrit au modèle, qui choisit lequel appeler et avec quels paramètres. 3. **Une boucle**. À chaque tour, l'agent regarde où il en est, décide de l'action suivante, l'exécute, observe le résultat, recommence. C'est cette itération qui lui permet de se corriger. 4. **Un périmètre** : ce qu'il a le droit de faire, sur quelles données, avec quelles limites, et éventuellement un budget en temps ou en tokens. ```mermaid flowchart LR O[Objectif] --> M[Modèle
décide de l'action suivante] M --> T[Outils
lire, calculer, écrire, envoyer] T --> R[Résultat observé] R --> V{Objectif atteint ?} V -- Non --> M V -- Oui --> F[Réponse ou action finale] P[Périmètre
droits, limites, budget] --- M ```

Le schéma montre la boucle d'un agent : à partir d'un objectif, le modèle choisit une action, l'exécute via un outil, observe le résultat et recommence tant que l'objectif n'est pas atteint. Le périmètre, rattaché au modèle, borne en permanence ce que l'agent a le droit de faire.

Un agent est donc un modèle placé au centre d'un système logiciel qui l'encadre. Rien de plus. Le protocole **MCP** (Model Context Protocol) a beaucoup simplifié la brique outils : au lieu de redévelopper chaque intégration pour chaque agent, on expose une fois un serveur que n'importe quel agent peut consommer. Nous détaillons ce mécanisme dans notre article sur [MCP et l'intégration d'outils](https://www.askthisguy.com/fr/blog/how-mcp-accelerate-agentic-ai/). > Un agent n'est pas plus intelligent qu'un modèle seul. Il est simplement autorisé à agir plusieurs fois, avec des outils. Toute sa valeur vient de ce que vous branchez au bout. ## Un agent, c'est un chatbot équipé d'outils On oppose souvent chatbot et agent. Un agent, c'est un chatbot auquel on a donné des outils. Le reste est une question de degré : la nature des outils et ce qu'ils ont le droit de faire. Chez Ask This Guy, **tout est agent**. Le même socle porte l'assistant qui répond à une question RH et celui qui met à jour une fiche client dans votre SaaS. | Niveau | Ce que l'agent sait faire | Outils typiques | | --- | --- | --- | | Répondre | Questions générales, reformulation, rédaction | Aucun | | Répondre sur vos données | Procédures, contrats, historique projet | Recherche documentaire ([RAG](https://www.askthisguy.com/fr/blog/rag-tutorial/)), requête SQL en lecture | | Consulter vos systèmes | État réel d'un dossier, d'un stock, d'un ticket | API métier en lecture, serveurs MCP | | Agir | Créer, modifier, envoyer, clôturer | API métier en écriture, envoi d'e-mail | | Orchestrer | Enchaîner plusieurs étapes vers un objectif | Combinaison des précédents, validation humaine | Ce tableau est une gradation, pas une typologie de produits. Un [assistant interne](https://www.askthisguy.com/fr/blog/internal-company-chatbot/) commence souvent au deuxième niveau, puis descend le tableau au fil des mois, à mesure que la confiance s'installe et que les outils s'ajoutent. Et les outils ne sont pas forcément génériques. Ils peuvent être très spécialisés, et contenir eux-mêmes de l'intelligence : un extracteur adapté à vos documents contractuels, un contrôleur de cohérence qui applique vos règles métier, un générateur de rapport au format que vos clients attendent. Nous en développons régulièrement sur mesure, et le code de ces [outils spécifiques](https://www.askthisguy.com/fr/doc/customizing-atg-to-you/tailored-tools) vous appartient. Ce qui change vraiment entre le haut et le bas du tableau, c'est la nature du risque. Un agent qui se trompe en répondant produit une phrase imprécise que l'utilisateur peut ignorer. Un agent qui se trompe en agissant crée une ligne dans votre ERP ou envoie un e-mail à un client. **C'est ce niveau de risque qui doit gouverner la conception.** L'étiquette qu'on colle au produit n'a aucune importance. ## L'IA n'est jamais déterministe : c'est le point de départ de la conception Un modèle de langage est **probabiliste**. Deux fois la même entrée peuvent donner deux sorties différentes. Un algorithme, lui, est déterministe : la même entrée donne toujours la même sortie, et vous pouvez le prouver. Sur une tâche donnée, un logiciel classique sera toujours plus fiable qu'un modèle, surtout si la tâche est simple. D'où la règle que nous appliquons partout : **toute tâche qu'un algorithme sait faire doit être faite par l'algorithme.** - Vérifier qu'une adresse e-mail est valide, ou qu'une adresse postale existe : c'est une regex et un appel à une base d'adresses, pas une question à poser à une IA. - Calculer un total, appliquer un barème, contrôler qu'une somme de lignes correspond au pied de facture : du code. - Interroger une base : plutôt qu'un modèle qui écrit du SQL libre, un outil paramétré, avec des requêtes cadrées, des droits explicites et un jeu de paramètres que le modèle se contente de remplir. C'est plus fiable, moins cher, et le modèle ne peut pas écrire une requête que vous n'aviez pas prévue. Le modèle garde ce qu'il est le seul à savoir faire : comprendre du langage, lire un document non structuré, arbitrer entre plusieurs chemins selon le contexte, rédiger. C'est déjà énorme. Cette discipline n'est pas cosmétique, elle est arithmétique. Imaginez un agent qui enchaîne dix étapes. Si chaque étape réussit dans 95 % des cas, la probabilité que les dix réussissent est de 0,9510, soit environ **60 %**. Le calcul est volontairement simpliste, mais l'ordre de grandeur est le bon : chaque étape confiée au modèle multiplie le risque, alors qu'une étape confiée à du code le laisse intact. Nous avons développé cette logique dans notre article sur l'[automatisation IA minimale](https://www.askthisguy.com/fr/blog/use-minimal-ai-automation/). ## Définir la mission de l'agent Un agent qui marche est presque toujours un agent dont la mission a été écrite correctement, et ça se décide bien avant le choix du modèle. Commencez par un objectif, pas par une intention. « Traiter les factures fournisseurs », ce n'est pas un objectif. « Pour chaque facture reçue sur la boîte compta, extraire les dix champs de la liste, vérifier la correspondance avec le bon de commande, créer l'écriture si tout concorde et déposer dans la file d'attente humaine sinon », ça en est un. Écrivez les cas limites noir sur blanc, un par un. Que fait l'agent si le document est illisible, si le fournisseur est inconnu, si la facture est un avoir, si le montant dépasse un seuil, si deux bons de commande correspondent ? Ces questions n'ont pas de bonne réponse par défaut : elles ont votre réponse. Un agent à qui personne ne les a posées inventera une moyenne plausible, et une moyenne plausible fait plus de dégâts qu'une erreur franche. Nous demandons systématiquement une vingtaine de cas réels, pris tels quels, y compris les moches : le scan de travers, le contrat avec l'avenant manuscrit, le fichier client mal renseigné. C'est sur ceux-là que se conçoit l'agent. L'échantillon propre que tout le monde propose en premier ne sert à rien. Enfin, pour chaque cas, quelqu'un doit pouvoir dire si la sortie est bonne ou mauvaise. Si personne ne sait trancher, vous ne pourrez ni évaluer l'agent ni le laisser tourner seul. ## Mettre l'agent sous contrôle Un agent se met sous contrôle à trois niveaux, tous à prévoir dès la conception. **Les vérifications dans la boucle.** À chaque étape sensible, un contrôle déterministe : le champ extrait a-t-il le bon format, la référence existe-t-elle vraiment dans la base, le total est-il cohérent. Quand un contrôle échoue, l'agent recommence ou passe la main. C'est ce qui fait remonter les 60 % de tout à l'heure à un niveau exploitable. **L'évaluation avant chaque mise en production.** Un jeu de cas de référence, avec le résultat attendu, rejoué à chaque changement de prompt, d'outil ou de modèle. Vous faites évoluer l'agent sans repartir en phase de test manuel, et vous voyez une régression avant vos utilisateurs. Reste le suivi une fois en production, et c'est celui qu'on abandonne le plus vite. Taux de traitement automatique, taux de reprise humaine, coût par exécution, latence, cas signalés comme incertains par l'agent lui-même. Un agent qu'on ne surveille pas ne casse pas bruyamment : il devient silencieusement moins juste, pendant que vos formats de fichiers changent et que les modèles évoluent sous vos pieds. Ajoutez un humain dans la boucle sur les actions irréversibles et sur les cas que l'agent signale lui-même comme douteux. Le mettre partout ferait disparaître l'intérêt de l'agent. ## Six agents que nous mettons en production Tous les six tournent chez des clients en ce moment. ### Agir dans un SaaS depuis la conversation Un outil métier est équipé d'un agent capable de le modifier. L'utilisateur écrit « crée ce client avec ces informations » ou « passe le dossier en statut traité, je viens de faire l'intervention », et l'agent exécute l'action dans l'application, avec les droits de la personne qui parle. On supprime dix clics et trois écrans, et on capte l'information au moment où elle existe, pas trois jours plus tard. ### Traiter des documents spécialisés Des documents métier arrivent : bons de commande, formulaires administratifs, contrats, comptes rendus, pièces réglementaires. L'agent en extrait les bonnes informations, applique vos règles de contrôle, enrichit avec vos référentiels, alimente la base et signale ce qui sort du cadre. C'est le cas d'usage le plus rentable, parce que le volume est là et que la règle est explicite. Un bon de commande client ou un formulaire Cerfa se traitent très bien ainsi : le format varie d'un émetteur à l'autre, mais les champs attendus, eux, ne bougent pas. ### Générer des rapports personnalisés à partir de fichiers d'entrée Vos clients ou vos équipes déposent des fichiers. L'agent les analyse, applique vos règles de calcul et votre grille de lecture, produit un rapport au format attendu et l'envoie par e-mail aux bons destinataires. La personne qui y passait une demi-journée le relit maintenant en vingt minutes. ### Qualifier un lead et alerter le commerce Tout commence par une conversation banale sur le [chatbot de votre site web](https://www.askthisguy.com/fr/solutions/website-chatbot/). Un visiteur pose une question sur une offre, l'agent répond depuis votre contenu, puis enchaîne sur le contexte, la taille de l'entreprise, l'échéance. Quand les signaux d'un vrai lead sont réunis, il envoie dans la foulée un e-mail à l'équipe commerciale, avec le verbatim de la conversation, la qualification et l'action recommandée. Rappel dans l'heure au lieu du surlendemain. Nous avons décrit ce mécanisme en détail dans notre article sur les [leads qualifiés via le chatbot de site](https://www.askthisguy.com/fr/blog/qualified-leads-website-chatbot/). Le même schéma vaut pour un ticket de support ou une demande interne : l'agent recoupe avec le CRM ou la base de connaissances, classe, priorise et route vers la bonne personne avec un résumé déjà rédigé. ### Réconcilier et surveiller Comparer deux référentiels qui devraient dire la même chose, détecter les écarts, produire la liste des anomalies avec un diagnostic. Personne n'aime faire ça à la main, et personne ne le fait aussi régulièrement qu'il le faudrait. ### Anticiper, en combinant machine learning et veille Certains agents servent à prévoir plutôt qu'à réagir. C'est là que la répartition entre logiciel et modèle se voit le mieux. Prenons la gestion des stocks et des flux, dans la distribution ou l'industrie. La prévision elle-même relève du **machine learning classique** : un modèle statistique entraîné sur votre historique de ventes, vos saisonnalités et vos délais fournisseurs prévoit la demande bien mieux qu'un modèle de langage, et de façon reproductible. L'agent apporte deux choses que le modèle statistique ne sait pas faire. Il intègre le contexte non structuré, une veille sur vos fournisseurs, un mouvement social annoncé, une actualité réglementaire, un lancement concurrent. Et il traduit la prévision en action lisible, en signalant les références à risque de rupture ou de surstock avec l'explication associée. Le déterministe calcule, le modèle interprète et rédige. ## Les cas d'usage qui échouent, et pourquoi Autant être direct : certains projets ne devraient pas démarrer, et il nous arrive d'en écarter. - **Le processus n'est pas écrit.** Si personne ne sait le décrire en dix lignes, l'agent ne l'inventera pas. - **Le résultat n'est pas vérifiable.** Sans critère de succès, pas d'évaluation, donc pas d'autonomie possible. - **Le volume est faible et les cas sont tous différents.** Vingt dossiers par mois, tous atypiques : le coût de conception ne sera jamais amorti. - **L'action est irréversible et non supervisée.** Virement, envoi client, suppression de données. Techniquement possible, opérationnellement imprudent tant que l'agent n'a pas fait ses preuves. ## Combien coûte un agent IA en entreprise ? Le **coût d'un agent IA** se décompose en trois postes. ### 1. La conception et le développement C'est le poste dominant. Il couvre la formalisation de la mission, le développement des outils, les connecteurs vers vos systèmes, la gestion des droits, les tests sur cas réels, le jeu d'évaluation et le passage en production. Chez Ask This Guy, un agent **production-ready** se situe classiquement **entre 2 000 et 5 000 €** de développement. On parle d'un agent branché sur vos systèmes, avec ses droits, ses vérifications, sa journalisation et sa supervision, qui traite vos vrais dossiers dès le premier jour, pas d'un POC de démonstration. Le prix dépend fortement de la complexité, mais il reste dans cet ordre de grandeur parce que nous ne partons jamais de zéro : la plateforme apporte déjà les connecteurs, l'ingestion documentaire, la gestion des droits, le catalogue d'outils MCP, la journalisation et le socle LLMOps. Le travail spécifique porte sur votre règle métier, pas sur la plomberie. Deux comparaisons utiles : - **Tout reconstruire de zéro** se compte en dizaines de milliers d'euros, l'essentiel partant dans ce qui n'a aucune valeur métier pour vous. - **Faire poser votre automatisation sur une plateforme tierce grand public** (les outils de type no-code d'orchestration) coûte moins cher à l'entrée, mais pose un problème de pérennité. Ces plateformes évoluent très vite. Le jour où l'une d'elles change son fonctionnement, votre automatisation s'arrête et vous repayez le prestataire. Et par construction, un prestataire qui ne maîtrise pas la plateforme sur laquelle il construit ne peut pas s'engager sur un SLA. ### 2. Le coût d'exécution C'est le coût en tokens, et il n'obéit à aucune règle générale : tout dépend de ce que fait l'agent. Un agent qui traite 500 dossiers par mois, avec environ 30 000 tokens par dossier en comptant les allers-retours d'outils, coûte quelques dizaines d'euros mensuels sur un modèle de milieu de gamme. À l'inverse, une analyse à contexte long, un raisonnement poussé ou un volume important changent complètement l'ordre de grandeur, et un agent mal conçu qui boucle sans garde-fou peut multiplier la note par dix. C'est donc un poste à estimer cas par cas. Chez nous, il est **forfaitaire et connu d'avance** : vous savez ce que coûte l'agent avant de le mettre en service, et une dérive de consommation est notre problème, pas le vôtre. ### 3. La maintenance et l'industrialisation Le poste que tout le monde oublie, et celui qui casse le plus de projets. Vos outils évoluent, vos règles changent, un fournisseur modifie un format, un modèle est déprécié et son remplaçant ne se comporte pas exactement pareil. Il faut donc du LLMOps, de la supervision, un jeu d'évaluation rejouable et une veille sur l'obsolescence des modèles. Nous intégrons ces éléments dans notre offre plutôt que de les facturer au coup par coup. Un agent livré sans eux est une démo avec une date de péremption, et c'est aussi ce qui rend un engagement de service tenable dans la durée, sujet que nous traitons dans notre article sur le [SLA d'une IA en entreprise](https://www.askthisguy.com/fr/blog/enterprise-ai-sla/). ### Le ROI, systématiquement calculé Nous ne démarrons pas un projet sans avoir posé le calcul : temps gagné mensuel contre coût total de possession sur un an. **Visez un retour sur investissement en moins de six mois, idéalement en moins de trois.** Avec des développements dans la fourchette 2 000 à 5 000 € et des automatisations qui économisent couramment une vingtaine d'heures par mois à l'équipe concernée, l'objectif est atteignable dans la grande majorité des cas. Si ça ne l'est pas sur le vôtre, mieux vaut le savoir avant de commencer que six mois plus tard. ## S'engager sur le résultat Un dernier point, qui vous servira surtout à choisir un prestataire. Nous nous engageons sur le résultat et sur un prix forfaitaire, mais seulement après avoir regardé vos exemples réels et compris votre processus et votre attendu. Dans l'autre ordre, l'engagement ne vaudrait rien. **Privilégiez une entreprise qui procède de la même façon.** Un prestataire qui vend un agent en régie, sans avoir vu vos cas réels et sans s'engager sur un résultat mesurable, vous transfère l'intégralité du risque. Vu de l'extérieur, un bon et un mauvais agent se ressemblent beaucoup en démonstration. Ils ne se ressemblent plus du tout au bout de trois mois. ## L'approche Ask This Guy Nous construisons des agents sur une plateforme qui porte déjà les briques communes, ce qui nous permet de concentrer le budget sur votre métier. Trois choix guident notre pratique : - **Commencer petit et mesurable.** Un workflow, un gain chiffré, une mise en production rapide. L'ambition vient après la preuve. - **Rester souverain.** Hébergement européen, possibilité de restreindre les traitements aux fournisseurs de droit européen, aucun entraînement sur vos données. Le sujet est détaillé sur notre page [IA souveraine](https://www.askthisguy.com/fr/ia-souveraine/). - **Vous laisser partir.** Les développements réalisés pour vous, vos configurations et vos connecteurs vous appartiennent. La réversibilité fait partie du contrat. Pour voir ce que cela donne concrètement, notre page [IA agentique et automatisation](https://www.askthisguy.com/fr/solutions/agentic-automation/) détaille les workflows types et leurs coûts. ## Questions fréquentes sur les agents IA en entreprise ### Qu'est-ce qu'un agent IA en entreprise ? Un agent IA d'entreprise est un modèle de langage placé dans une boucle, équipé d'outils et d'un objectif métier. Il choisit lui-même la séquence d'actions à mener, exécute ces actions dans vos systèmes via ses outils, observe le résultat et recommence jusqu'à atteindre son but ou constater qu'il n'y arrivera pas. Techniquement, c'est un modèle de langage encadré par du logiciel. ### Quelle différence entre un agent IA et un chatbot ? La différence est dans l'équipement : un agent est un chatbot à qui on a donné des outils. Un chatbot sans outil se contente de répondre. Dès qu'on lui branche une recherche documentaire, une base de données ou une API métier, il peut consulter puis agir. La frontière qui compte se situe entre lecture et écriture : à partir du moment où l'IA modifie quelque chose dans vos systèmes, les exigences de fiabilité, de droits et de traçabilité changent d'échelle. ### Quelles tâches ne faut-il jamais confier au modèle dans un agent ? Toutes celles qu'un algorithme sait faire. Un modèle est probabiliste, un algorithme est déterministe et donc plus fiable. Valider un format d'e-mail, vérifier l'existence d'une adresse, calculer un total, appliquer un barème, exécuter une requête en base : tout cela doit passer par du code ou par un outil paramétré. Le modèle garde la compréhension du langage, la lecture de documents non structurés, l'arbitrage contextuel et la rédaction. ### Combien coûte un agent IA pour une entreprise ? Le développement d'un agent production-ready se situe classiquement entre 2 000 et 5 000 € lorsqu'on s'appuie sur une plateforme existante, et bien au-delà si l'on repart de zéro. S'y ajoutent le coût d'exécution en tokens, très variable selon la tâche et donc à estimer cas par cas, et la maintenance : LLMOps, supervision, évaluation rejouable et gestion de l'obsolescence des modèles. Chez Ask This Guy, l'ensemble est forfaitaire et connu avant la mise en service. ### En combien de temps un agent IA est-il rentabilisé ? L'objectif à poser avant de démarrer est un retour sur investissement en moins de six mois, et il est fréquemment atteint en moins de trois. Le calcul est simple : temps gagné mensuel multiplié par le coût horaire chargé, comparé au coût de développement et de maintenance sur un an. Si le calcul ne tient pas, le projet ne doit pas démarrer. ### Un agent IA peut-il accéder à nos données sensibles ? Il n'accède qu'à ce que vous lui donnez. La bonne pratique est de faire hériter l'agent des permissions de l'utilisateur qui le déclenche, ou de lui attribuer un compte de service au périmètre explicitement limité, et de journaliser chaque accès. Un agent qui a un accès global à votre système d'information est un risque. ### Combien de temps pour mettre un agent en production ? Quelques jours pour un premier workflow simple sur une plateforme existante. Quelques semaines si les connecteurs sont à créer, si les règles métier doivent être formalisées, ou si le processus touche des actions irréversibles nécessitant une validation humaine. --- ## Ce qu'il faut retenir Un agent IA, c'est un chatbot équipé d'outils, autorisé à agir dans un périmètre que vous définissez. Sa valeur vient de la qualité de sa mission, de ses outils et de ses vérifications, beaucoup plus que du modèle lui-même. Les projets qui réussissent partagent le même profil : une mission écrite avec ses cas limites, des exemples réels dès la conception, tout ce qui peut être fait par un algorithme confié à un algorithme, un jeu d'évaluation rejouable, un suivi en production, et un ROI posé avant de commencer. Vous avez un processus manuel en tête ? [Réservez une démo](https://www.askthisguy.com/fr/demo/) : en 30 minutes, nous vous dirons s'il est automatisable, à quel coût, et avec quel gain attendu. --- # Chatbot interne entreprise : bien cadrer votre projet URL: https://www.askthisguy.com/fr/blog/internal-company-chatbot/ Language: fr Section: Blog Dans la plupart des entreprises, l'information existe. Elle est écrite, quelque part. Le problème n'est pas qu'elle manque, c'est que **personne ne sait où elle est**, ou que la seule personne qui sait est en congés. Alors les collaborateurs font ce qu'ils ont toujours fait : ils demandent à un collègue. Une question qui aurait pris trente secondes à un moteur de recherche efficace mobilise deux personnes pendant dix minutes, et la réponse obtenue n'est pas forcément la bonne version. C'est ce qu'un **chatbot interne entreprise** est censé régler. Encore faut-il savoir ce qu'on construit : la moitié des projets qui portent ce nom fabriquent en réalité autre chose. **En une phrase.** Un chatbot interne est un assistant conversationnel réservé aux collaborateurs, branché sur les sources documentaires de l'entreprise, qui répond aux questions internes en citant les documents dont il tire sa réponse. ## Chatbot interne, chatbot de site : même outil, deux projets différents C'est la confusion à lever en premier, parce qu'elle décide du budget comme des critères de réussite. Un **chatbot de site web** parle à vos visiteurs. Il répond à des questions publiques, qualifie des prospects, oriente vers un commercial. Son corpus est petit et vous l'avez écrit vous-même, ses réponses sont validées à l'avance, et le risque principal est commercial : mal répondre, c'est perdre un lead. Un **chatbot interne** parle à vos collaborateurs. Il répond à partir de vos procédures, contrats, comptes rendus, documentation technique et politiques RH. Son corpus est vaste, hétérogène, mal rangé, et surtout **soumis à des droits d'accès différenciés**. Le risque principal est la confidentialité : mal répondre, c'est exposer un document à quelqu'un qui n'aurait pas dû le voir. | | Chatbot de site | Chatbot interne | | --- | --- | --- | | Public | Visiteurs, prospects | Collaborateurs | | Corpus | Petit, public, curé | Vaste, privé, hétérogène | | Droits d'accès | Uniformes | Différenciés par personne | | Objectif | Convertir, orienter | Retrouver, décider, gagner du temps | | Risque principal | Manque à gagner | Fuite d'information interne | | Mesure du succès | Leads qualifiés | Temps de recherche évité | L'architecture, elle, peut être la même : même moteur, même socle RAG, même interface. Nous recommandons d'ailleurs de partir sur un seul outil, pour éviter d'en administrer deux. Ce qui change, c'est le corpus, les instructions données au modèle et la façon dont on suit les réponses. Un prestataire qui vous propose le même corpus et les mêmes instructions pour les deux usages se trompe de projet. Nous traitons le premier cas dans notre article sur le [chatbot de site et la génération de leads](https://www.askthisguy.com/fr/blog/qualified-leads-website-chatbot/). ## Ce qui fait fonctionner un chatbot interne : le RAG Un modèle de langage généraliste connaît le monde, pas votre entreprise. Interrogé sur votre politique de note de frais, il produira une réponse plausible et fausse, ce qui est le pire des cas. La réponse technique s'appelle le **RAG** (Retrieval Augmented Generation). À chaque question, le système cherche d'abord les passages pertinents dans vos propres sources, puis les transmet au modèle qui rédige sa réponse à partir de ces éléments, en citant d'où ils viennent. Le modèle ne « sait » rien de votre entreprise : il lit, à la demande, ce qu'on lui donne à lire. ![Schéma d'un chatbot interne entreprise : les sources (Drive, SharePoint, Confluence, Notion, intranet) alimentent un moteur RAG qui applique les droits de chacun et répond en citant l'accord RTT 2026](https://www.askthisguy.com/blog/internal-company-chatbot/chatbot-interne-entreprise-sources.webp) Nous détaillons [comment fonctionne le RAG en IA](https://www.askthisguy.com/fr/blog/rag-tutorial/) dans notre guide dédié. Trois conséquences, dans la pratique : - **La qualité des réponses dépend d'abord de l'ingestion**, pas du modèle. Un PDF scanné mal converti ou mal découpé produira des réponses médiocres avec n'importe quel LLM. - **Les sources citées font partie de la réponse.** C'est ce qui permet à l'utilisateur de vérifier, et donc de faire confiance. Un chatbot interne sans citations n'est plus ouvert au bout de quelques semaines. - **Les droits d'accès doivent être appliqués à la recherche**, pas au moment de l'affichage. Si le système retrouve un document confidentiel puis décide de ne pas le montrer, l'information a déjà fuité dans la réponse générée. ### Élargir ce que chacun consulte réellement Un effet que personne n'anticipe, et dont les utilisateurs parlent beaucoup : **le RAG élargit le corpus dans lequel travaille chaque collaborateur**. Au quotidien, chacun se sert des quelques dizaines de documents qu'il connaît et retourne toujours dans les mêmes dossiers. Le reste existe mais n'est jamais ouvert : la note juridique produite par une autre entité, le compte rendu d'un projet voisin, la fiche produit mise à jour le mois dernier. Un assistant qui cherche dans l'ensemble du corpus auquel l'utilisateur a droit ramène ces documents dans la réponse, avec leur source. L'utilisateur découvre ce qu'il ne savait pas qu'il fallait chercher. Le même raisonnement vaut pour les données. Une partie de l'information utile ne vit pas dans des documents mais dans le CRM, l'ERP, le ticketing ou l'outil de gestion de projet, que la plupart des collaborateurs ne consultent jamais : trop d'écrans, et trop de droits à demander pour une seule question. En branchant l'assistant sur ces systèmes via une [requête en base de données](https://www.askthisguy.com/fr/doc/customizing-atg-to-you/database-query), des [outils sur mesure](https://www.askthisguy.com/fr/doc/customizing-atg-to-you/tailored-tools) ou des [serveurs MCP](https://www.askthisguy.com/fr/doc/admin-console/tools-management/mcp-servers), une même réponse peut croiser la procédure écrite et l'état réel du dossier client, sans que personne n'ait à ouvrir l'ERP. ## Les cas d'usage qui rentabilisent un chatbot interne Les projets qui tiennent visent tous le même type de questions : **fréquentes, et dont la réponse est déjà écrite quelque part**. ### Support aux fonctions transverses RH, juridique, achats, IT. Ce sont les équipes les plus sollicitées pour des questions dont la réponse existe déjà dans un document. Congés, notes de frais, procédure d'achat, clauses standard, réinitialisation d'accès : un chatbot interne absorbe une bonne partie de ce flux et rend du temps à des équipes qui n'en ont jamais assez. ### Onboarding des nouveaux arrivants Les trois premiers mois d'un collaborateur sont une longue série de questions qu'il n'ose pas toujours poser. Un assistant interne raccourcit la montée en autonomie sans mobiliser un tuteur en permanence. ### Documentation technique et produit Équipes d'ingénierie, avant-vente, support. Retrouver la bonne section de la doc, la version applicable d'une spécification, ou un historique de décision technique dans un wiki de plusieurs milliers de pages. ### Réponse aux appels d'offres et aux questionnaires Sécurité, conformité, références clients : les mêmes questions reviennent, les réponses existent dans des documents antérieurs. C'est un des usages où le gain de temps est le plus facile à chiffrer. ### Mémoire des projets Comptes rendus, décisions, arbitrages. « Pourquoi avons-nous choisi ce fournisseur en 2024 ? » est une question à laquelle un chatbot interne bien alimenté répond mieux que la mémoire collective. ## Les cinq erreurs qui font échouer un projet de chatbot interne **1. Tout brancher d'un coup.** L'ambition « on indexe tout le SI » produit un assistant médiocre partout. Commencez par un périmètre où vous savez juger la qualité des réponses : un domaine, une équipe, un corpus. **2. Ignorer les droits d'accès jusqu'à la recette.** C'est le sujet qui fait échouer les projets en fin de parcours, quand la DSI découvre que l'assistant répond à tout le monde à partir de tout. Les permissions doivent être héritées des sources dès la conception. **3. Négliger la qualité documentaire.** Trois versions d'une même procédure, dont deux périmées, et l'assistant citera la mauvaise avec assurance. Un projet de chatbot interne est presque toujours, aussi, un projet de ménage documentaire. **4. Ne pas mesurer.** Deux mesures complémentaires manquent presque toujours. La première est un jeu de questions de référence, rejoué à chaque changement de modèle ou ajout de source : sans lui, vous ne saurez pas si l'assistant s'améliore ou se dégrade. C'est l'objet de l'[évaluation des agents](https://www.askthisguy.com/fr/doc/admin-console/agent-evaluation). La seconde est le retour des utilisateurs : pouce vers le haut ou vers le bas, commentaire libre, sentiment détecté automatiquement dans les conversations, le tout suivi dans la durée et ventilé par thème ou par tag pour repérer les sujets qui décrochent. C'est ce que notre console [Insights](https://www.askthisguy.com/fr/doc/admin-console/insights) rend visible. **5. Négliger l'expérience utilisateur.** Un assistant excellent sur le papier que personne n'ouvre une deuxième fois ne sert à rien. L'adoption se joue sur deux points très simples : une interface qui s'utilise sans mode d'emploi, et des réponses qui arrivent en quelques secondes. Un collaborateur qui attend, qui doit apprendre à formuler ses questions ou qui ne sait pas quoi faire de la réponse retourne chercher lui-même dans le drive, et ne revient pas. ## Faut-il le construire ou l'acheter ? Construire un chatbot interne à partir d'un modèle et d'une base vectorielle est facile, tant qu'il s'agit d'une démonstration. Ce qui coûte cher, c'est tout le reste : les connecteurs vers Google Drive, SharePoint, Confluence et Notion, la synchronisation incrémentale, l'extraction correcte des tableaux et des PDF scannés, la propagation des permissions, la recherche hybride, la citation fiable des sources, l'évaluation de la qualité, la supervision des coûts et le support aux utilisateurs. Nous détaillons ces écueils dans notre article sur les [erreurs classiques d'un RAG en production](https://www.askthisguy.com/fr/blog/enterprise-rag-production-mistakes/). Un build interne complet se compte en mois-homme, et il faudra le maintenir aussi longtemps qu'il tournera. Une plateforme qui apporte déjà ces briques réduit le coût total de possession de l'ordre de **80 %** par rapport à un projet mené de bout en bout en interne, et surtout raccourcit le délai avant les premiers usages réels. | Critère | Build interne | Plateforme existante | | --- | --- | --- | | Premier périmètre utile | Plusieurs mois si l'équipe part de zéro | Quelques jours à quelques semaines selon les sources | | Connecteurs et permissions | À construire, tester et maintenir | Briques standard déjà disponibles, adaptations sur les sources spécifiques | | Évaluation des réponses | Dispositif à concevoir | Méthode et suivi déjà intégrés | | Maintenance | À la charge de l'équipe interne | Portée par l'éditeur, avec les évolutions du socle | | Choix pertinent si… | La pile technique constitue un avantage stratégique | La valeur se trouve dans les usages, les règles et les données métier | La question à trancher est donc simple : votre valeur est-elle dans la plomberie, ou dans l'adaptation à vos métiers ? Nous n'avons encore jamais rencontré d'entreprise dont la réponse était la plomberie. ## Et la souveraineté dans tout ça ? Un chatbot interne lit vos documents les plus sensibles : contrats, dossiers RH, éléments financiers, propriété intellectuelle. Savoir où ces contenus sont traités, et par qui, se règle avant la signature. À vérifier avant de signer : - Où sont hébergés les documents, les index vectoriels, les journaux et les sauvegardes. - Quels fournisseurs de modèles sont appelés, depuis quelle juridiction, et si vous pouvez restreindre les traitements aux seuls fournisseurs européens. - Ce qui est réellement transmis au modèle à chaque question : les extraits pertinents, ou le document entier. Nous avons consacré une page complète à ces arbitrages : [IA souveraine, définition et critères](https://www.askthisguy.com/fr/ia-souveraine/). ## L'approche Ask This Guy Nous déployons des assistants internes sur une plateforme qui apporte déjà les connecteurs vers vos sources, l'ingestion documentaire, la recherche hybride, l'héritage des permissions, la citation des sources et la supervision. Le travail spécifique porte alors sur votre vocabulaire, vos règles et vos cas d'usage. Personne ne repart de zéro sur la pile technique. Ce que nous appliquons à chaque déploiement : - **Un périmètre d'abord étroit**, choisi pour que la qualité soit jugeable dès les premières semaines. - **Des permissions héritées de vos sources**, pour que l'assistant ne montre jamais à un collaborateur ce qu'il ne pourrait pas ouvrir lui-même. - **Un hébergement européen** et une politique IA paramétrable, jusqu'à l'option on-premise selon vos contraintes. Notre page [RAG entreprise clé en main](https://www.askthisguy.com/fr/solutions/knowledge-rag/) détaille les connecteurs disponibles et le déroulé d'un déploiement. Si votre sujet dépasse le choix de l'outil, nous traitons le fond dans [Knowledge management : pourquoi vos démarches échouent](https://www.askthisguy.com/fr/blog/knowledge-management-why-it-fails/). ## Questions fréquentes sur le chatbot interne en entreprise ### Qu'est-ce qu'un chatbot interne en entreprise ? Un chatbot interne est un assistant conversationnel réservé aux collaborateurs d'une entreprise. Connecté aux sources documentaires internes (drives, intranet, wikis, outils métier), il répond aux questions professionnelles à partir de ces documents et cite ses sources, plutôt que de s'appuyer sur des connaissances générales issues du web. ### Quelle différence entre un chatbot interne et un chatbot de site web ? Le chatbot de site s'adresse à des visiteurs externes, sur un corpus public et restreint, avec un objectif commercial. Le chatbot interne s'adresse aux collaborateurs, sur un corpus privé et vaste, avec des droits d'accès différenciés par personne. L'outil peut être le même, mais le corpus, les instructions, les risques et les critères de réussite diffèrent complètement. ### Un chatbot interne peut-il respecter les droits d'accès de chaque collaborateur ? Oui, à condition que les permissions soient héritées des sources et appliquées au moment de la recherche, et non filtrées après coup à l'affichage. Chaque utilisateur ne doit obtenir de réponses qu'à partir des documents qu'il pourrait ouvrir lui-même dans l'outil d'origine. ### Combien de temps pour déployer un chatbot interne ? Quelques jours pour un premier périmètre sur une plateforme existante avec des connecteurs standards. Quelques semaines si les sources sont hétérogènes, si la qualité documentaire doit être reprise, ou si des connecteurs spécifiques sont à développer. Un build complet en interne se compte plutôt en mois. ### Sur quelles sources un chatbot interne peut-il s'appuyer ? Les sources habituelles sont Google Drive, SharePoint et OneDrive, Confluence, Notion, Slack, les sites et intranets, les dépôts de fichiers ou FTP, et les bases de données métier. Le nombre de connecteurs compte moins que la qualité de l'ingestion : découpage, extraction des tableaux, gestion des PDF scannés et synchronisation des mises à jour. ### Quel est le retour sur investissement d'un chatbot interne ? Il se mesure en temps de recherche évité et en sollicitations évitées sur les fonctions transverses. L'approche la plus fiable consiste à choisir un périmètre étroit, à mesurer le nombre de questions traitées et le taux de réponses jugées utiles, puis à étendre sur cette base plutôt que sur une estimation théorique faite avant le démarrage. ## Ce qu'il faut retenir Un chatbot interne d'entreprise est un projet de **recherche documentaire à droits différenciés**. Sa réussite se joue sur l'ingestion, les permissions et la citation des sources, bien plus que sur le choix du modèle. Prendre un chatbot de site et le placer derrière une authentification ne donne pas un chatbot interne. Commencez petit, sur un périmètre où vous savez juger la qualité. Mesurez. Étendez ensuite. Les projets qui échouent sont presque toujours ceux qui ont voulu tout indexer avant d'avoir prouvé quoi que ce soit. Vous avez un corpus en tête et une équipe qui perd du temps à chercher ? [Réservez une démo](https://www.askthisguy.com/fr/demo/) : nous vous dirons rapidement ce qui est branchable, en combien de temps, et à quel niveau de qualité. --- # Knowledge management : pourquoi vos démarches échouent, et ce que l'IA change URL: https://www.askthisguy.com/fr/blog/knowledge-management-why-it-fails/ Language: fr Section: Blog Dans beaucoup d'entreprises, deux choses coexistent sans jamais se rencontrer. D'un côté, un espace Confluence, un SharePoint ou un Notion. Quatre cents pages. Une arborescence pensée avec soin il y a trois ans, avec des conventions de nommage et un modèle de page. La dernière modification significative date de dix-huit mois. De l'autre, à quinze mètres de là, une personne que tout le monde va voir. Elle répond dix fois par semaine aux mêmes questions : où trouver la dernière version du contrat cadre, pourquoi on ne facture pas ce client comme les autres, quelle clause a coûté cher en 2023. L'entreprise a donc un référentiel et un savoir. Simplement, ils ne sont pas au même endroit. Le réflexe, à ce stade, est de blâmer l'outil. On a choisi Confluence, il aurait fallu Notion. On a choisi Notion, il aurait fallu autre chose. C'est presque toujours une fausse piste : **l'outil n'a jamais été la cause de l'échec**, et le remplacer ne répare rien. **Le knowledge management, ou gestion des connaissances, désigne l'ensemble des pratiques par lesquelles une organisation capte, structure, retrouve et réutilise ce qu'elle sait.** Quatre opérations distinctes : une démarche ne vaut jamais mieux que la plus faible des quatre. L'entreprise du début a très bien structuré, et raté les trois autres. ## Le knowledge management, ce n'est pas de la documentation Capter, c'est sortir le savoir des têtes et des échanges informels. Structurer, lui donner une forme réutilisable. Retrouver, le remettre sous les yeux de quelqu'un au moment où la question se pose. Réutiliser est le seul des quatre qui rapporte quelque chose. Les trois autres coûtent. La distinction classique reste la plus utile. Le **savoir explicite** est celui qui a été écrit : procédures, comptes rendus, spécifications, contrats, retours d'expérience formalisés. Le **savoir tacite** vit dans les têtes : pourquoi on a perdu ce client, quel fournisseur tient réellement ses délais, quelle clause ne doit jamais être acceptée, comment on rattrape une situation quand le process officiel ne s'applique pas. Un référentiel documentaire ne traite que le premier, et seulement une fois qu'il a été écrit. Or la quasi-totalité des démarches de knowledge management en entreprise ont concentré leurs efforts sur une seule des quatre opérations : structurer. Une arborescence, des gabarits, une charte de nommage, un comité éditorial. Capter est resté un acte de bonne volonté. Retrouver a été délégué à un moteur de recherche interne médiocre. Réutiliser n'a jamais été mesuré. C'est un déséquilibre suffisant pour expliquer la suite. ### Et votre savoir écrit n'est pas là où vous croyez Il reste une erreur de cadrage, plus discrète, qui fausse la plupart des diagnostics : croire que le savoir explicite se trouve dans l'outil documentaire. Il n'y est presque jamais en totalité, et souvent il n'y est même pas majoritairement. Faites l'inventaire honnête de votre entreprise. Vous y trouverez : - **le fichier Excel des règles de tarification**, maintenu par une seule personne, qui fait autorité bien plus que la procédure commerciale officielle ; - **la colonne « commentaires » du fichier de suivi client**, où se trouve la vraie histoire du compte, celle que le CRM ne raconte pas ; - **l'outil de ticketing**, et ses milliers de cas résolus qui constituent le savoir de dépannage réel de l'entreprise ; - **les tables de référence de l'ERP**, codes articles, règles de gestion et paramétrages, qui encodent des décisions métier que plus personne ne sait justifier ; - **le drive partagé**, avec douze versions de la même proposition commerciale et aucun moyen de savoir laquelle a été signée ; - **les fils de mails et les canaux Teams ou Slack**, où l'arbitrage a réellement eu lieu, avant d'être résumé nulle part. Rien de tout cela n'a jamais été appelé « connaissance ». Ce sont des outils de production, et le savoir s'y dépose comme un sous-produit de l'activité. C'est pour cette raison qu'aucune démarche de knowledge management ne les a jamais inclus dans son périmètre. Ce n'est pas un signe de désordre. C'est le fonctionnement normal d'une organisation qui travaille : les gens déposent l'information là où ils la produisent, pas là où un comité a décidé qu'elle devrait vivre. **Toutes les entreprises fonctionnent ainsi, et il n'y a aucune raison de penser que la vôtre fasse exception.** Deux conséquences en découlent, et elles éclairent tout ce qui suit. D'abord, une démarche qui se limite à l'outil documentaire ne traite qu'une fraction du savoir explicite, souvent minoritaire : le remplacer par un autre outil ne pouvait donc rien changer. Ensuite, l'objectif de « tout ranger au même endroit » n'a jamais été atteignable, parce qu'il supposait de faire migrer des informations qui n'ont de sens que dans l'outil où elles sont produites. ## Pourquoi les démarches de gestion des connaissances échouent Cinq causes reviennent, et elles sont structurelles. Aucune ne se règle par un choix de logiciel. ### 1. L'effort est asymétrique Celui qui documente n'est pas celui qui en profite. Rédiger une fiche prend quarante minutes, aujourd'hui, sur du temps qui manque déjà. Le bénéfice arrive dans six mois, pour quelqu'un d'autre, et personne ne saura jamais qu'il vient de vous. Un coût immédiat et certain contre un bénéfice différé, incertain et non attribué : c'est un arbitrage perdu d'avance. Les collaborateurs qui ne documentent pas ne sont pas négligents, ils sont rationnels. ### 2. L'obsolescence est silencieuse Une page fausse ne lève aucune alerte. Elle reste en ligne, bien rangée dans la bonne rubrique, avec le bon gabarit, et elle inspire exactement la même confiance que le jour de sa rédaction. C'est le point que la plupart des démarches sous-estiment : **une documentation périmée coûte plus cher qu'une documentation absente**. Face à un vide, on va demander. Face à une page obsolète, on applique. Et il suffit de quelques mauvaises surprises pour que les équipes cessent durablement de faire confiance au référentiel, y compris à ses parties encore justes. ### 3. Chercher coûte plus cher que redemander C'est la cause la plus décisive et la moins souvent nommée. Retrouver l'information dans le référentiel demande d'ouvrir l'outil, de deviner le vocabulaire employé par le rédacteur, de trier des résultats, d'ouvrir trois pages, puis de vérifier laquelle est à jour. Quinze à vingt minutes, sans garantie de succès. Envoyer un message au collègue qui sait prend trente secondes, et la réponse arrive fiable et contextualisée. Tant que ce rapport de coûts tient, le référentiel perd systématiquement. Non pas parce qu'il est mal fait, mais parce qu'il est plus cher à utiliser que l'alternative humaine. Et cette alternative a un prix caché, payé par les trois ou quatre personnes que tout le monde sollicite. ### 4. Le KM a été traité comme un projet, pas comme un flux Un budget, un comité, une phase de migration, une recette, un lancement, une communication interne. Puis la fin du projet, et l'équipe qui se disperse sur autre chose. La connaissance d'une entreprise n'est pas un stock à constituer une fois, c'est un flux qui se renouvelle en continu. Un flux dont on coupe l'alimentation se vide. Les six premiers mois donnent le change, parce que la base initiale est encore fraîche. La dégradation devient visible vers dix-huit mois, quand plus rien ne correspond à la réalité. ### 5. On a confondu stocker et rendre trouvable Un SharePoint de trois téraoctets n'est pas un **système de gestion des connaissances**. C'est un entrepôt. Stocker est résolu depuis vingt ans et ne coûte presque rien. Rendre trouvable, au sens de « la bonne réponse, à la bonne personne, au moment où elle en a besoin, avec la source », n'a jamais été résolu par les outils de gestion documentaire. Ils indexent des mots, pas des questions. Un collaborateur qui cherche « est-ce qu'on peut décaler la facturation pour ce type de client » ne dispose d'aucun mot-clé qui figure dans le document qui contient la réponse. ## Ce que l'IA change réellement Quatre choses ont bougé, et aucune ne mérite le mot « révolution ». ### Elle inverse la charge Le modèle classique demandait de ranger en amont pour pouvoir retrouver en aval. Toute la rigueur devait être investie au moment de l'écriture, par le rédacteur, sans qu'il connaisse les questions futures. Une recherche en langage naturel adossée aux documents de l'entreprise inverse ce contrat. L'effort d'interprétation se paie au moment de la question, par la machine, et pour une question réelle. Le rédacteur n'a plus besoin d'anticiper le vocabulaire de celui qui cherchera. ### Elle rend exploitable une base imparfaite C'est le changement le plus sous-estimé. Un moteur classique exigeait une base propre pour donner de bons résultats. Un dispositif de type **RAG** (*Retrieval-Augmented Generation*) lit ce qui est mal rangé : comptes rendus de réunion, PDF scannés, tickets de support, fils de discussion, vieilles propositions commerciales. Nous détaillons le mécanisme dans notre [guide du RAG en IA](https://www.askthisguy.com/fr/blog/rag-tutorial/). Ce n'est pas un détail de mise en œuvre, c'est ce qui change la faisabilité économique du sujet. La condition d'entrée n'est plus « avoir un référentiel propre », prérequis que personne n'a jamais rempli. Elle devient « avoir des sources accessibles », ce que presque toutes les entreprises ont déjà. ### Elle casse l'économie qui tuait le référentiel Reprenons la cause n° 3. Si obtenir une réponse sourcée prend trente secondes au lieu de vingt minutes, l'arbitrage entre chercher et redemander bascule. Pour la première fois, le système devient moins cher à utiliser que le collègue. C'est le seul mécanisme qui, à notre connaissance, fait effectivement revenir les équipes vers la connaissance formalisée. Pas la charte, pas le comité, pas la communication interne : le fait que ce soit devenu le chemin le plus court. ### Elle vous dit enfin ce qui manque C'est le point le moins connu, et probablement le plus intéressant sur la durée. Un référentiel classique est aveugle. Il sait combien de pages il contient, jamais ce que les gens ont cherché sans le trouver. Vous pilotez donc la documentation à l'opinion : le comité décide qu'il faudrait « documenter les processus achats », parce que quelqu'un l'a dit en réunion. Dès qu'un assistant est branché sur vos sources, chaque question posée devient un signal exploitable. Et les questions arrivent en langage naturel, telles que les gens se les posent vraiment. En les analysant, on fait apparaître trois choses que personne ne voyait : - **Les manques.** Une question qui revient vingt fois par mois et pour laquelle aucune source ne répond correctement désigne précisément la fiche à écrire. Ce n'est plus un avis, c'est une mesure. - **Les contradictions.** Quand deux documents répondent l'inverse sur le même sujet, l'assistant le rencontre à chaque requête concernée. Ces conflits, invisibles tant que personne ne lisait les deux pages côte à côte, deviennent une liste. - **L'obsolescence utile.** Toutes les pages périmées ne se valent pas. Celle que personne n'a jamais sollicitée peut attendre. Celle qui sert de source à trente réponses par semaine doit être reprise cette semaine. Les questions réelles hiérarchisent l'effort de mise à jour à votre place. C'est ce qui referme la boucle. Les causes n° 2 et n° 4 vues plus haut, l'obsolescence silencieuse et le KM traité comme un projet, tenaient toutes les deux au même aveuglement : impossible de savoir où le référentiel décroche, donc impossible d'entretenir autre chose qu'un stock figé. L'usage devient la source de vérité sur ce qu'il faut documenter, et l'entretien redevient un flux piloté par des faits. Récapitulatif honnête : | Cause d'échec | Ce que l'IA change | Ce qui reste à votre charge | | --- | --- | --- | | Effort asymétrique | Réduit fortement le besoin de mise en forme et de rangement a priori | Il faut toujours que quelqu'un écrive au moins une fois | | Obsolescence silencieuse | La réponse cite sa source et sa date, et les questions réelles révèlent les pages qui décrochent | Décider quoi archiver et quoi maintenir | | Chercher coûte plus cher que redemander | Inverse le rapport de coûts, c'est le levier principal | Garantir la qualité des réponses dans la durée | | Projet plutôt que flux | Les sources vivantes sont réindexées en continu, et l'usage indique en continu quoi écrire ou corriger | Le pilotage reste une fonction permanente | | Stocker au lieu de rendre trouvable | Résout la partie « trouvable » | Résout la partie « fiable », qui reste humaine | ## Ce que l'IA ne change pas Un article qui s'arrêterait là serait malhonnête. Quatre limites tiennent bon. **Un savoir qui n'a jamais été écrit reste introuvable.** Aucun modèle ne retrouvera pourquoi vous avez renoncé à ce fournisseur en 2021 si cela n'existe que dans la mémoire de deux personnes. L'IA améliore considérablement les opérations « retrouver » et « réutiliser ». Elle ne fait rien pour « capter ». C'est ce qui reste le vrai travail de knowledge management, et le fait qu'il soit désormais le seul point dur est une bonne nouvelle : vous pouvez y concentrer vos efforts au lieu de les diluer. **Les droits d'accès deviennent plus critiques, pas moins.** Un assistant qui traverse les silos traverse aussi les cloisons que ces silos assuraient sans qu'on y pense. Un dossier RH mal protégé n'était pas un problème tant que personne ne savait qu'il existait. Il le devient dès qu'une question en langage naturel peut le faire remonter. Un assistant sérieux hérite des permissions des outils d'origine et ne répond que dans le périmètre de celui qui pose la question. **Les contradictions demandent toujours un arbitrage humain.** Quand deux documents disent l'inverse, un bon système cite les deux et signale le conflit. Il ne tranche pas, et il ne doit pas. C'est un point de gouvernance, pas de technologie. **La confidentialité reste un choix d'architecture.** Verser des documents internes dans une IA grand public revient à en confier le contenu à un tiers, sans traçabilité et sans retour en arrière possible. Nous détaillons ce point et ses conséquences concrètes dans [L'IA contextualisée pour votre entreprise](https://www.askthisguy.com/fr/blog/contextual-ai-rag-use-cases/). ## À quoi ressemble un système de gestion des connaissances en 2026 Non plus un outil unique où tout le monde devrait ranger, mais cinq couches qui s'appuient sur ce que vous avez déjà. ```mermaid flowchart LR A[Sources existantes
SharePoint, Confluence, Drive,
CRM, tickets, PDF] --> B[Ingestion et indexation
en continu] B --> C[Recherche sémantique
filtrée par les droits] C --> D[Assistant
Réponse en langage naturel] D --> E[Sources citées
et datées] E --> F[Vérification humaine
et correction à la source] F --> A ```

Le schéma se lit comme un circuit fermé : les documents restent dans les outils où ils vivent déjà, l'indexation continue et la recherche filtrée par les droits alimentent l'assistant, et la vérification humaine renvoie les corrections vers la source plutôt que vers une copie. C'est cette flèche de retour qui distingue un flux d'un projet ponctuel.

Les couches, dans l'ordre : les **sources là où elles sont déjà**, une **ingestion continue** plutôt qu'une migration ponctuelle, une **recherche sémantique** filtrée par les droits, une **restitution qui cite ses sources** avec leur date, et une **boucle de correction** qui permet à un utilisateur de signaler une réponse fausse et de faire corriger le document d'origine. Cette dernière couche est celle qu'on oublie, et c'est pourtant elle qui répond à la cause n° 4. Elle transforme chaque utilisation en occasion d'amélioration, et fait du dispositif un flux plutôt qu'un projet. Ajoutez une gouvernance légère : qui possède quelle source, à quel rythme on purge, qui arbitre les contradictions. Trois règles suffisent, à condition qu'elles aient un propriétaire. ### Faut-il encore un outil de gestion des connaissances dédié ? C'est la question qui revient systématiquement, et notre réponse est probablement à l'inverse de ce que vous attendez : la couche de stockage compte beaucoup moins qu'avant, la couche d'accès compte beaucoup plus. Autrement dit, ne remplacez pas votre Confluence ou votre SharePoint. Branchez-les. Une migration vers un nouveau **logiciel de gestion des connaissances** consomme six à douze mois, mobilise les mêmes personnes que celles dont vous voulez capter le savoir, et reproduit exactement les cinq causes d'échec dans un environnement plus récent. Vous aurez un entrepôt plus joli, avec le même problème. Le seul cas où changer d'**outil de gestion des connaissances** se justifie est celui où la source actuelle est techniquement fermée, c'est-à-dire sans API ni export exploitable. C'est rare, et cela se vérifie en une demi-journée. Pour le reste, le sujet du **knowledge management en entreprise** s'est déplacé du choix de l'outil vers la qualité de la couche d'accès : est-ce qu'elle couvre toutes vos sources, est-ce qu'elle respecte vos droits, est-ce qu'elle cite, est-ce qu'elle reste juste dans six mois. Le premier de ces quatre critères est celui qui disqualifie le plus de solutions. Une couche d'accès qui ne lit que votre outil documentaire vous ramène au point de départ : elle ignore le fichier de tarification, les tickets résolus et les tables de l'ERP, c'est-à-dire une grande partie de ce que vos équipes cherchent réellement. ## À partir de quand la gestion des connaissances devient rentable Quelques ordres de grandeur pour décider, à croiser avec votre situation plutôt qu'à prendre au pied de la lettre. Le facteur déclenchant n'est presque jamais le volume documentaire. C'est **la concentration du savoir**. Posez-vous la question autrement : combien de personnes, dans votre entreprise, sont sollicitées plus de cinq fois par jour pour des questions dont la réponse existe quelque part ? Si la réponse est deux ou trois, vous avez déjà un problème coûteux, et il est en train de s'aggraver avec la croissance. Les autres signaux qui comptent : - **Un onboarding supérieur à trois mois** avant qu'un nouvel arrivant devienne autonome sur des questions courantes. - **Un départ à venir** sur un poste clé, avec un savoir concentré sur une seule tête. - **Plus de trois ou quatre sources de vérité** différentes, dont personne ne sait laquelle prime. - **Des erreurs récurrentes** dues à l'utilisation d'une version obsolète d'un document. En dessous de quinze à vingt personnes, la mémoire collective informelle suffit généralement, et le sujet peut attendre. Entre cinquante et trois cents, c'est la zone où le coût devient net sans être encore visible dans un budget, parce qu'il se paie en interruptions et en délais plutôt qu'en factures. ## Un exemple concret : la maintenance informatique Prenons un prestataire de maintenance d'équipements informatiques, un cas que nous connaissons bien. Ses techniciens interviennent chez les clients. Certains sont salariés, d'autres sont des sous-traitants externes mobilisés selon la charge et la couverture géographique. Sur site, un technicien a besoin de trois choses en même temps : la procédure applicable, l'historique du client, et le contexte de l'intervention précédente. Or ce savoir est de deux natures différentes, et c'est ce qui rend le cas intéressant. Il y a d'abord des **documents** : les procédures génériques, mais aussi toutes les particularités propres à un client donné. Cet équipement doit être arrêté selon une séquence précise. Ce site impose une fenêtre d'intervention. Ce client a une configuration réseau qui ne ressemble à aucune autre. Ces spécificités sont écrites, mais dispersées entre des fiches, des annexes contractuelles et des comptes rendus. Il y a ensuite une **base de données** : l'historique des tickets et des interventions. Qui est venu, quand, ce qui a été remplacé, ce qui est retombé en panne trois semaines plus tard. Ce sont des données structurées, avec des dates, des références et des statuts, pas des documents. Aucun référentiel documentaire ne couvre les deux. C'est exactement la cause n° 5 : le prestataire ne manquait pas d'information, il n'avait pas de chemin unique pour y accéder. Résultat, le comportement rationnel du technicien sur site consistait à appeler le support, qui interrogeait l'outil de ticketing pendant que le client attendait. Chaque appel coûtait deux personnes au lieu d'une. Le cas des sous-traitants ajoutait une contrainte que les référentiels classiques traitent mal. Un technicien externe doit accéder aux procédures du client chez qui il intervient ce jour-là, et à rien d'autre. Donner un accès large est inacceptable, ne rien donner du tout revient à en faire un technicien moins efficace que ses collègues internes. À cela s'ajoute un troisième usage, dans les bureaux cette fois. Le support et la direction ont besoin d'interroger ces mêmes bases opérationnelles pour des questions d'analyse : rentabilité par contrat, récurrence des pannes sur un parc, respect des délais d'intervention. C'est le même patrimoine de données, avec une question complètement différente. Nous traitons ce volet spécifique dans [Vos bases de données sont une mine d'or](https://www.askthisguy.com/fr/blog/databases-gold-mine-ai-shovels/). Ce que montre ce cas : dès qu'une entreprise dépasse le stade du wiki, sa connaissance est mixte, documentaire et structurée, et adressée à des populations qui n'ont pas les mêmes droits. Un système de gestion des connaissances qui ne traite qu'une des deux natures laisse le problème entier. ## Comment nous abordons le sujet chez Ask This Guy Notre parti pris découle directement de ce qui précède : **aucune migration**. Ask This Guy se connecte à vos sources existantes, quelles qu'elles soient, et les indexe en continu. Vos équipes ne changent pas leurs habitudes de dépôt, et vous ne payez pas le coût de six mois de reprise documentaire avant d'obtenir le premier résultat utile. Nous traitons les deux natures de savoir dans le même assistant : les **documents**, via le RAG, et les **bases de données** métier, interrogées en langage naturel comme décrit sur notre page [Talk to data](https://www.askthisguy.com/fr/solutions/talk-to-data/). C'est ce qui permet de répondre à « quelle est la procédure sur ce site » et à « combien d'interventions sur ce parc depuis janvier » sans changer d'outil. Trois points sur lesquels nous ne transigeons pas, parce qu'ils déterminent si l'usage tient dans la durée : - **Chaque réponse cite ses sources**, avec leur date. Un utilisateur qui ne peut pas vérifier ne fera pas confiance, et un utilisateur qui ne fait pas confiance revient à sa messagerie et à son collègue. - **Les droits sont hérités des outils d'origine.** L'assistant ne répond jamais au-delà de ce à quoi la personne avait déjà accès. - **L'hébergement est européen**, avec une option on-premise quand la sensibilité des documents l'exige. Enfin, nous ne nous arrêtons pas à la mise en service. Une fois l'assistant en place, vos utilisateurs produisent chaque semaine la matière qui manquait à toutes vos démarches précédentes : les vraies questions. Notre console [Insights](https://www.askthisguy.com/fr/doc/admin-console/insights) suit les volumes, les tags, le ressenti et les réponses jugées insatisfaisantes ; nous vous aidons à en tirer un plan de travail documentaire concret, la liste des sujets à écrire, des contradictions à arbitrer et des pages à reprendre en priorité. **Vous voulez savoir ce que vos utilisateurs cherchent sans le trouver ?** C'est exactement le diagnostic que nous savons faire à partir de vos sources et des questions réelles de vos équipes. [Parlons-en](https://www.askthisguy.com/fr/demo/), ou écrivez-nous à [bonjour@askthisguy.com](mailto:bonjour@askthisguy.com). Le détail de l'approche, des connecteurs disponibles et du modèle de coût est sur la page [RAG entreprise clé en main](https://www.askthisguy.com/fr/solutions/knowledge-rag/), et le fonctionnement technique dans notre [documentation](https://www.askthisguy.com/fr/doc/customizing-atg-to-you/). ## Questions fréquentes sur le knowledge management ### Qu'est-ce que le knowledge management ? Le knowledge management, ou gestion des connaissances, désigne l'ensemble des pratiques par lesquelles une organisation capte, structure, retrouve et réutilise ce qu'elle sait. Il couvre le savoir explicite, celui qui a été écrit, comme le savoir tacite, celui qui vit dans les têtes. La plus faible des quatre opérations décide de la valeur de l'ensemble. ### Quelle différence entre gestion des connaissances et gestion documentaire ? La gestion documentaire organise des fichiers : versions, classement, cycle de vie, archivage. La gestion des connaissances vise l'usage du savoir, y compris quand il n'a pas la forme d'un document. Un fichier de tarification, un historique de tickets ou une table de paramétrage de l'ERP portent du savoir sans être des documents au sens de la GED. C'est pour cette raison qu'un projet purement documentaire ne couvre qu'une fraction du sujet. ### Quelle différence entre savoir tacite et savoir explicite ? Le savoir explicite a été formalisé : procédures, comptes rendus, contrats, spécifications. Le savoir tacite n'a jamais été écrit : pourquoi un fournisseur a été écarté, quelle clause ne doit jamais être acceptée, comment on rattrape une situation quand le processus officiel ne s'applique pas. Les référentiels ne traitent que le premier, et seulement une fois qu'il a été mis par écrit. ### Qu'est-ce qu'un système de gestion des connaissances ? En 2026, il tient en cinq couches. Les sources restent là où elles sont. L'ingestion tourne en continu, au lieu d'une migration faite une fois. La recherche est sémantique et filtrée par les droits de chacun. Les réponses citent leurs sources avec leur date. Et un utilisateur qui tombe sur une réponse fausse peut la signaler et faire corriger le document d'origine. L'outil unique où tout le monde devait ranger n'en fait plus partie. ### Quels sont les outils de gestion des connaissances ? Les outils historiques sont les wikis et intranets (Confluence, SharePoint, Notion, Jalios), auxquels s'ajoutent les bases de connaissances du support et les GED. Le point important est ailleurs : la couche de stockage compte beaucoup moins qu'avant, la couche d'accès beaucoup plus. Un logiciel de gestion des connaissances qui ne lit que son propre contenu laisse dehors le fichier Excel des tarifs, les tickets résolus et les bases métier. C'est pourtant là que se trouve une bonne part des réponses. ### Quels sont les enjeux de la gestion des connaissances en entreprise ? Le volume documentaire compte peu. Ce qui déclenche le sujet, c'est la concentration du savoir sur deux ou trois personnes que tout le monde sollicite. Les autres signaux : un onboarding qui dépasse trois mois, un départ annoncé sur un poste clé, trois ou quatre sources de vérité concurrentes, des erreurs qui reviennent parce que quelqu'un a travaillé sur une version périmée. Le coût se paie en interruptions et en délais, rarement en factures, et reste donc longtemps invisible. ### L'IA remplace-t-elle la gestion des connaissances ? Non. Elle déplace l'endroit où se paie l'effort. Elle améliore nettement les opérations « retrouver » et « réutiliser », et rend exploitable une base imparfaite là où un moteur classique exigeait une base propre. Elle ne fait rien pour « capter » : un savoir qui n'a jamais été écrit reste introuvable. Les droits d'accès, l'arbitrage des contradictions et le choix d'hébergement restent des décisions humaines. ## Conclusion Les démarches de knowledge management des vingt dernières années n'étaient pas absurdes. Elles avaient raison sur l'intention et tort sur la méthode : elles demandaient un effort de rangement en amont, à des gens qui n'en tiraient aucun bénéfice, pour alimenter un système plus coûteux à consulter qu'un message à un collègue. Ce que l'IA change n'est pas la capacité à stocker, qui n'a jamais été le problème. C'est l'endroit où se paie l'effort. **Si vous ne devez retenir qu'une chose.** L'IA ne sauve pas un référentiel vide. Elle rend enfin exploitable un référentiel imparfait, ce qui est le cas de tous les référentiels. La question n'est donc plus « comment convaincre les équipes de mieux ranger », mais « comment rendre l'accès moins cher que la sollicitation d'un collègue ». Si le projet prend la forme d'un assistant interrogeable par vos équipes, notre guide du [chatbot interne en entreprise](https://www.askthisguy.com/fr/blog/internal-company-chatbot/) détaille les cas d'usage rentables, les pièges classiques et les conditions de réussite. Si vous reconnaissez votre entreprise dans la première scène de cet article, le sujet est mûr : **[réservez une démo](https://www.askthisguy.com/fr/demo/)**, nous partirons de vos sources réelles. --- # SLA IA entreprise : un seul fournisseur d'IA pour vos agents ne peut pas suffire URL: https://www.askthisguy.com/fr/blog/enterprise-ai-sla/ Language: fr Section: Blog Ouvrez la [page de statut d'Anthropic](https://status.claude.com/). Vous y trouverez le plus souvent un taux de disponibilité entre 99 et 99,5 %. « Two » nines. Uptime Claude sur 90 jours à date du 30 juillet 2026 On est passé d'une époque où l'on visait les *four nines* (99,99 %) à une époque où **99,3 % d'uptime** ne choque plus (plus assez). Les « vibe codeurs » utilisant Claude s'en contentent, mais est-ce assez pour votre entreprise ? Probablement pas... Anthropic est-il un cas isolé ? Non. Tenir un haut niveau de service sur de l'inférence à grande échelle est difficile pour tout le monde. ## Si vous ne devez retenir qu'une chose Brancher votre production (RAG, assistant interne, agents) sur **un seul** fournisseur d'IA, que ce soit Claude, ChatGPT, Gemini ou Mistral, c'est accepter plusieurs jours d'indisponibilité cumulée par an. Pour un service métier qui compte, ce risque se traite comme n'importe quelle dépendance d'infrastructure. ## Rappel de l'impact des nines Ordres de grandeur d'indisponibilité, toutes causes confondues, sur un an : | Nines | Uptime | Indispo approximative | | --- | --- | --- | | Two nines | 99 % | ~3,6 jours | | Three nines | 99,9 % | ~8,8 heures | | Four nines | 99,99 % | ~52 minutes | Votre projet d'IA peut-il encaisser plusieurs jours d'arrêt par an ? Vos utilisateurs, eux, sont habitués aux « four nines » sur leurs outils du quotidien. Voici la disponibilité réelle de Microsoft 365 : ![Disponibilité mondiale Microsoft 365 par trimestre, autour de 99,9 % et plus (source Microsoft Learn)](https://www.askthisguy.com/blog/enterprise-ai-sla/microsoft-availability.webp) ## Chez les concurrents d'Anthropic ? [OpenAI](https://status.openai.com/) et [Mistral](https://status.mistral.ai/) publient aussi leur disponibilité. Les chiffres ne sont pas directement comparables : chaque page couvre des composants et des périodes différentes. Au 31 juillet 2026, Mistral affichait 99,4 % sur les trois derniers mois. Une page de statut n'est pas un SLA financier. Certaines offres spécifiques publient toutefois un engagement, comme [Gemini Online Inference](https://cloud.google.com/vertex-ai/generative-ai/sla) à 99,5 % ou [OpenAI Scale Tier](https://openai.com/api-scale-tier/) à 99,9 %, en option payante. Les hyperscalers peuvent proposer des engagements plus élevés sur certains services managés d'inférence, par exemple 99,9 % sur [Azure AI](https://azure.microsoft.com/en-us/products/ai-foundry/models/openai). L'engagement porte sur l'endpoint. La latence, la qualité des réponses et le reste de votre chaîne RAG n'entrent pas dedans. On reste loin des garanties habituelles des SaaS de productivité, où les trois « nines » sont un standard sans surcoût. ## Les open weights rendent la bascule possible Un même [modèle ouvert](https://www.askthisguy.com/fr/blog/open-source-vs-open-weights-ai/) tourne chez une dizaine de fournisseurs d'inférence. C'est l'une des sept façons de servir de l'inférence en entreprise, que nous comparons dans notre guide sur l'[inférence IA](https://www.askthisguy.com/fr/blog/enterprise-ai-inference/). Si l'un tombe, vous basculez sur un autre sans changer de modèle, donc sans retoucher vos prompts. D'où la **passerelle multi-fournisseurs**, ou *LLM gateway* : une couche qui sait appeler plusieurs modèles chez plusieurs fournisseurs, et arbitrer entre eux selon qui répond, à quelle vitesse et à quel prix. Aucun de ces fournisseurs n'atteint 99,9 % tout seul. Mis bout à bout derrière une passerelle qui teste leur santé et bascule dès que l'un décroche, on y arrive. Voici ce que nous mesurons en production chez Ask This Guy sur les 30 derniers jours : ![Taux de succès par provider d'inférence : Scaleway 99,87 %, Nebius 99,81 %, Cerebras 99,78 %, DeepInfra 99,76 %, Mistral 99,56 %](https://www.askthisguy.com/blog/enterprise-ai-sla/success-rate-per-provider.webp) Des produits font ça, [OpenRouter](https://openrouter.ai/) par exemple : un point d'accès unique vers plusieurs fournisseurs, et des règles de bascule à configurer. Côté européen, [Eden AI](https://www.edenai.co/), éditeur français, expose plus de 500 modèles derrière une seule API, avec bascule intégrée, endpoint européen et zéro rétention des données. De quoi mutualiser la disponibilité sans sortir votre contexte du périmètre RGPD. Vous pouvez aussi la développer vous-même : brancher les fournisseurs un par un, mesurer ce qu'ils rendent vraiment, coder vos règles de priorité et de bascule. Comptez plus de temps que prévu sur la partie mesure. Certaines plateformes l'intègrent nativement, c'est notre cas chez Ask This Guy. Un **SLA RAG entreprise** ne s'arrête d'ailleurs pas à l'uptime du LLM. L'ingestion des sources, la recherche et les appels d'outils peuvent tomber sans que le modèle bouge d'un pouce. Pour les pièges après le POC, voir [RAG entreprise : 5 erreurs en production](https://www.askthisguy.com/fr/blog/enterprise-rag-production-mistakes/). ## Questions fréquentes sur le SLA IA entreprise ### Qu'est-ce qu'un SLA IA entreprise ? Un SLA IA entreprise fixe le niveau de disponibilité attendu pour un service d'IA, son périmètre de mesure, ses exclusions et les crédits dus si l'engagement n'est pas tenu. Une page de statut sert à observer les incidents, elle n'engage personne. ### Quel SLA pour un RAG entreprise ? Un **SLA RAG entreprise** doit couvrir plus que l'API du modèle : l'ingestion des sources, la recherche, la passerelle et la latence de bout en bout. 99,9 % sert de référence courante, mais le chiffre ne veut rien dire tant que le périmètre et la méthode de mesure ne sont pas écrits noir sur blanc. ### SLA assistant IA : comment améliorer la disponibilité ? Supprimez d'abord le point de défaillance unique : une passerelle multi-provider, plusieurs modèles, des contrôles de santé et une bascule automatique. Ajoutez un monitoring des erreurs et de la latence, et un mode dégradé pour les moments où plus rien ne génère. ## Chez Ask This Guy Notre [passerelle de fournisseurs IA](https://www.askthisguy.com/fr/doc/infrastructure-and-security/ai-providers/) sélectionne en continu les modèles qui répondent, et vite. Objectif côté clients : un niveau de service **supérieur à 99,9 %** sur le périmètre défini, sans dépendre d'un seul modèle de pointe. Politique UE ou monde entier, selon votre contrainte de [souveraineté](https://www.askthisguy.com/fr/doc/infrastructure-and-security/sovereign-ai/). Pas de miracle : une architecture qui part du principe que les LLM cloud tombent. C'est le socle de notre [solution RAG entreprise](https://www.askthisguy.com/fr/solutions/knowledge-rag/), et la même passerelle alimente un [assistant support produit](https://www.askthisguy.com/fr/solutions/product-assistant/) quand les utilisateurs sont vos clients. **SLA IA entreprise utile** = multi-provider + bascule automatique. Si vous industrialisez un RAG ou un assistant interne et que vous voulez voir cette passerelle en conditions réelles : **[réservez une démo](https://www.askthisguy.com/fr/demo/)**. --- # Chatbot dans un SaaS : support produit, data et actions IA URL: https://www.askthisguy.com/fr/blog/chatbot-produit-saas/ Language: fr Section: Blog Un client qui paie son abonnement **n'est pas forcément un client engagé** : un compte peut rester facturé pendant des mois pendant que l'utilisateur, lui, a déjà décroché, ouvre le produit de moins en moins, n'atteint jamais les fonctionnalités qui justifient le prix, et prépare sans le dire son départ. L'enjeu permanent d'un éditeur SaaS n'est donc pas de vendre l'abonnement, c'est de **maximiser en continu la valeur que chaque client en tire réellement**. Sans usage, sans satisfaction, sans montée en compétence sur le produit, la résiliation n'est qu'une question de temps. Ce risque s'aggrave avec un phénomène récent : à peu près n'importe qui peut désormais **vibe coder un outil interne avec une IA**, sans compétence de développement. La barrière qui protégeait un produit moyen, le coût de tout reconstruire soi-même, s'effondre pour une part croissante des cas d'usage. Un client insatisfait n'a plus seulement le choix d'aller voir un concurrent : il peut, de plus en plus souvent, se contenter de recréer la partie du produit qu'il utilise vraiment. Un chatbot bien intégré à un SaaS s'attaque directement à ce problème. Pas comme un gadget posé sur la page d'accueil, mais comme une brique du produit qui augmente la valeur réellement extraite à chaque interaction, et qui rend enfin visible ce qui se jouait jusque-là dans l'angle mort entre deux relevés de facturation. Cet article détaille trois niveaux d'intégration, du plus rapide au plus ambitieux, et la brique qui les relie tous : le pilotage de ce qui se passe réellement dans les conversations, le seul endroit où l'engagement réel devient visible avant qu'il ne soit trop tard. ## Trois niveaux, un seul chatbot « Faire un chatbot produit » est souvent traité comme un projet unique et binaire : on le construit, ou on ne le fait pas. Dans les faits, la valeur s'ajoute par paliers, et chaque palier a un coût et une complexité différents. - **Niveau 1 : répondre aux demandes génériques.** Le chatbot s'appuie sur la documentation produit et le contexte de l'utilisateur. - **Niveau 2 : répondre avec les données propres au client.** Il interroge les données métier de son compte pour fournir une réponse personnalisée. - **Niveau 3 : agir pour le client.** Il déclenche des actions autorisées dans le produit via des API et des workflows. ### Niveau 1 : répondre aux demandes génériques **Personne ne lit plus la documentation produit.** Vos utilisateurs cherchent un menu, veulent comprendre une fonctionnalité ou vérifier leur configuration, et n'ont pas le temps de parcourir vingt pages pour trouver la réponse. Quand ils n'y arrivent pas, ils ouvrent un ticket, même quand la réponse existe déjà. ![Widget d'aide dans la console d'administration Ask This Guy, qui guide un administrateur étape par étape pour configurer le connecteur SharePoint](https://www.askthisguy.com/blog/chatbot-produit-saas/atg-console-aide-sharepoint-fr.webp) La différence avec un simple moteur de recherche intégré au produit, c'est le **contexte**. Un bon assistant support sait quel abonnement l'utilisateur a souscrit, quelle version du produit il utilise, quel rôle il occupe, parfois son historique récent, et jusqu'à la page sur laquelle il se trouve et ce qu'il est en train d'y faire. La réponse à « comment j'exporte mes données » n'est pas la même pour un utilisateur en plan gratuit et pour un administrateur en plan entreprise, et l'assistant devrait le savoir sans qu'on ait à le lui répéter à chaque fois. C'est ce que fait notre propre console d'administration, elle-même un produit SaaS : un administrateur demande « comment je configure SharePoint ? » depuis la page Connaissances, et le widget répond avec une procédure sourcée, sans le renvoyer vers un article de doc séparé à chercher lui-même. C'est aussi, de loin, le niveau le plus rapide à mettre en place. Il ne demande pas de refonte technique : un accès à votre documentation, éventuellement à quelques données de compte en lecture seule, suffit pour démarrer. Sur les déploiements de ce type, **40 à 60 % des tickets concernent du contenu déjà documenté**. C'est le volume que ce premier niveau vient absorber. Détail à ne pas négliger : ce niveau sert **vos deux publics**. Le client obtient une réponse sourcée et contextualisée. Votre équipe support voit remonter ce qui reste vraiment : les bugs, les cas complexes, les signaux produit qui méritent un humain. Chaque friction retirée, c'est un peu plus de valeur réellement extraite du produit, et un peu moins de raisons d'aller chercher une alternative, maison ou concurrente. Voir la fiche solution : [assistant support produit](https://www.askthisguy.com/fr/solutions/product-assistant/). ### Niveau 2 : laisser l'utilisateur interroger ses propres données La présentation des données dans un SaaS est presque toujours un compromis. Vous concevez des tableaux de bord et des menus d'accès à l'information pour l'usage le plus fréquent, et ils ne correspondent jamais exactement au besoin du moment. L'utilisateur qui veut croiser deux filtres que vous n'avez pas prévus retourne voir votre équipe, exporte un fichier, ou abandonne. Un chatbot connecté à vos données change la question posée. Au lieu d'adapter son besoin au dashboard existant, l'utilisateur pose sa question directement, en langage naturel, et obtient une réponse chiffrée, un graphique, parfois un export. Prenons un exemple concret : un SaaS de gestion de flotte automobile. *« Comment ont évolué mes pannes sur la ville de Lyon sur les 12 derniers mois ? »* L'assistant renvoie la tendance, avec un pic visible au mois de juillet. L'utilisateur enchaîne, sans changer d'outil ni reformuler sa demande depuis le début : *« C'est un phénomène saisonnier ? Ça touche toujours les mêmes modèles ? La 308 peut-être ? »* C'est le genre d'enchaînement qu'aucun tableau de bord figé ne permet, parce qu'il faudrait avoir prévu la question à l'avance. Sur ce type de déploiement, on observe généralement **deux fois plus d'utilisateurs qui exploitent réellement la donnée**, précisément parce que le canal ne demande plus de compétence technique ni d'aller-retour avec une équipe data. Ce niveau reste, lui aussi, relativement simple à mettre en œuvre dès lors que le chatbot a accès à vos bases ou à vos API : il n'invente rien, il lit et restitue ce qui existe déjà dans votre système. Il ne remplace pas votre dashboard, il le complète : le tableau de bord suit l'évolution de vos indicateurs dans le temps, la conversation explique pourquoi un chiffre a bougé et explore les facteurs, sans qu'il faille construire un nouveau rapport à chaque question. C'est aussi le niveau où l'écart avec un outil bricolé en interne se creuse. Un tableau croisé sur un export, n'importe qui peut le vibe coder en une heure. Une conversation qui comprend le contexte métier d'un compte et répond avec les vraies données de production, c'est nettement plus difficile à improviser. Voir la fiche solution : [Talk to Data](https://www.askthisguy.com/fr/solutions/talk-to-data/). ### Niveau 3 : déclencher des actions **Un chatbot répond. Un agent agit.** C'est la bascule qui distingue vraiment ce troisième niveau des deux précédents, et c'est aussi celle qui change le calcul de complexité. Deux familles d'actions ont du sens dans un produit SaaS. La première regroupe les **actions du quotidien**, simples mais répétitives : modifier un paramètre de compte, ajouter un utilisateur, changer une configuration, ce que l'utilisateur ferait de toute façon en trois clics, mais qu'il peut désormais demander en une phrase. La seconde est celle où **l'IA apporte une vraie valeur ajoutée** : aller chercher une donnée publique pertinente pour enrichir un dossier, générer un contenu à partir du contexte du compte, analyser l'usage récent d'un client pour recommander un changement de configuration ou de forfait avant même qu'il ne le demande. C'est cette seconde famille qui différencie vraiment un produit, parce qu'elle dépasse la simple réponse à une question posée. Ce niveau change la nature du projet. Il ne suffit plus d'un accès en lecture à de la documentation ou à des données : il faut un **système d'autorisation** qui définisse précisément ce que l'agent peut faire pour quel profil d'utilisateur, des **API adaptées** pour chaque action possible, et souvent des **workflows spécifiques** pour les cas où l'action a des conséquences (facturation, données personnelles, engagement contractuel). C'est un investissement réel, mais concentré sur un petit nombre d'actions à fort effet de levier plutôt que sur l'ensemble du produit, et c'est aussi le niveau le plus difficile à recréer soi-même sans équipe technique, ce qui en fait, une fois posé, l'avantage le plus durable des trois. ## Comprenez enfin vos clients et leurs besoins non exprimés La plupart des projets de chatbot produit s'arrêtent à la réponse : le bot répond bien, tout le monde passe au projet suivant. C'est passer à côté de l'essentiel : **le tableau de bord revenu ne dit rien de l'engagement réel d'un client, mais ses conversations avec le chatbot, si**. Chaque échange est un signal, et la plupart de ces signaux ne remontent nulle part ailleurs. ![Tags et alertes : trois règles configurées, intérêt fonctionnalité premium, intention d'achat et client veut annuler](https://www.askthisguy.com/doc/tags-alerts-01-fr.webp) Concrètement, deux briques transforment ces conversations en pilotage. **Des règles de tag et d'alerte, décrites en langage naturel.** Plutôt qu'une liste figée de mots-clés, vous décrivez une condition comme vous la formuleriez à un collègue : « le client s'interroge sur des fonctionnalités avancées ou des offres supérieures à son forfait actuel », « le client manifeste son intention de mettre fin à un service ». Quand une conversation correspond, elle est étiquetée automatiquement et, si vous l'activez, une alerte part par e-mail vers la bonne équipe. C'est le mécanisme qui transforme une intuition (« on devrait détecter les signaux de désabonnement ») en processus qui tourne seul. **Un tableau de bord de suivi dans le temps.** Volume de conversations, sentiment détecté automatiquement, réactions pouce haut ou bas des utilisateurs, répartition par tag et par agent, comparaison avec la période précédente. De quoi répondre à des questions simples mais rarement mesurées : le sentiment se dégrade-t-il sur telle fonctionnalité depuis la dernière mise à jour ? Quel agent concentre le plus de frustration ? Où porter l'attention cette semaine ? C'est là que l'anti-churn et l'upsell cessent d'être des intentions pour devenir des règles actives. Un client qui manifeste son intention de mettre fin à un service ou qui s'interroge sur des fonctionnalités avancées déclenche une alerte avant que le sujet ne remonte par un autre canal, ou pas du tout. Documentation : [tags et alertes](https://www.askthisguy.com/fr/doc/admin-console/tags-alerts) et [Insights](https://www.askthisguy.com/fr/doc/admin-console/insights). ## Faut-il le construire ou l'acheter ? Dans l'immense majorité des cas, la réponse est d'acheter, et ça vaut pour les trois niveaux, du support au déclenchement d'actions. Construire un chatbot minimal à partir d'un modèle et d'une base vectorielle est faisable en quelques jours pour une démonstration. Mais **ce qui coûte cher, ce n'est jamais la démo, c'est tout ce qu'il y a autour** : la gestion du contexte utilisateur par profil et par plan, une recherche qui trouve vraiment la bonne information dans vos sources, la citation fiable de ces sources, l'évaluation continue de la qualité des réponses, la supervision des coûts d'inférence, l'orchestration et les permissions dès qu'on touche aux actions, et tout le pan pilotage et alerting détaillé plus haut. Cette partie représente **environ 90 % du travail**. Elle est générique, au sens où elle ne dépend pas de votre métier, mais elle est loin d'être simple : c'est elle qui sépare un chatbot qui impressionne en démo d'un chatbot que vos clients utilisent encore six mois plus tard. Un build interne complet se compte en mois-homme, et il faut ensuite le maintenir aussi longtemps qu'il tourne : nous détaillons ces écueils dans notre article sur les [erreurs classiques d'un RAG en production](https://www.askthisguy.com/fr/blog/enterprise-rag-production-mistakes/). C'est la logique du **90/10** que nous appliquons chez Ask This Guy : ces 90 % (le chat, notre [recherche hybride à six niveaux](https://www.askthisguy.com/fr/blog/hybrid-search-retrieval-methods/), la gestion des permissions, le pilotage, l'hébergement) sont une plateforme déjà construite, qui continue d'évoluer sans que vous ayez à le faire. C'est le socle de notre [RAG entreprise clé en main](https://www.askthisguy.com/fr/solutions/knowledge-rag/). Les 10 % restants (vos documents, votre contexte utilisateur, vos API, vos workflows d'action) sont ce qui fait vraiment la différence pour vos clients, et **c'est le seul endroit où un travail sur mesure a du sens**. Deux situations sortent de cette règle. La première, c'est quand l'IA n'est pas une fonctionnalité ajoutée à votre produit mais son cœur même : la maîtrise de la pile technique devient alors votre différenciation, et la construire en interne se justifie. La seconde, c'est quand votre volume d'affaires est très important, un gros produit B2C par exemple : le coût d'un build interne s'amortit sur une base d'utilisateurs assez large pour changer le calcul. | Critère | Build interne complet | Plateforme existante | | --- | --- | --- | | Premier périmètre utile | Plusieurs mois si l'équipe part de zéro | Quelques jours à quelques semaines | | Contexte utilisateur (plan, rôle, historique) | À concevoir et maintenir | Brique standard, à connecter à votre modèle de données | | Pilotage et alerting | Dispositif à construire de A à Z | Déjà disponible, configuration par règles | | Actions et permissions | Système d'autorisation à concevoir | Cadre existant, workflows spécifiques à définir | | Maintenance | À la charge de l'équipe produit | Portée par l'éditeur | | Choix pertinent si… | L'IA est le cœur du produit, ou le volume d'affaires est très important | Dans tous les autres cas | Sur les projets que nous menons, le TCO baisse d'environ **80 %** par rapport à un développement mené intégralement en interne, avec un premier périmètre utile en semaines plutôt qu'en mois. ## L'approche Ask This Guy Nous déployons des assistants produit sur une plateforme qui apporte déjà le chat, le contexte utilisateur, le pilotage et l'alerting. Le travail spécifique porte sur votre documentation, vos API et les actions qui ont vraiment du sens pour votre produit. Notre approche part toujours du niveau 1 : un périmètre étroit, une documentation connectée, un premier cas d'usage mesurable en quelques semaines. Les niveaux suivants, data et actions, s'ajoutent une fois que le premier a fait ses preuves auprès de vos utilisateurs, sans repartir de zéro sur la pile technique. Vous gérez un produit SaaS et vous voulez évaluer ce qu'un chatbot changerait pour vos clients ? [Prenez rendez-vous avec nous](https://www.askthisguy.com/fr/demo/). ## Questions fréquentes sur le chatbot dans un produit SaaS ### Le revenu récurrent ne suffit-il pas à mesurer la santé d'un compte client ? Non. Un client peut rester facturé plusieurs mois après avoir cessé d'extraire une vraie valeur du produit : il ouvre moins souvent l'application, n'explore plus de nouvelles fonctionnalités, et prépare en silence son départ. Le MRR est un indicateur retardé, il confirme un problème après coup plutôt que de l'annoncer. Les signaux d'engagement réel, comme la fréquence d'usage, le sentiment exprimé dans les échanges avec un assistant ou les questions répétées sur une même friction, sont visibles bien plus tôt, à condition de les regarder. ### Un chatbot produit peut-il réellement réduire le churn ? Indirectement, mais de façon mesurable. Le chatbot ne retient pas un client par lui-même : il repère, dans les conversations, les signaux qui précèdent souvent un désabonnement (une question sur la résiliation, une frustration répétée sur une fonctionnalité) et alerte la bonne équipe avant que le client ne parte. C'est la combinaison des réponses contextualisées, qui réduisent la frustration en amont, et des alertes automatiques, qui donnent le temps d'agir en aval, qui fait la différence. ### Combien de temps pour déployer un chatbot dans un produit SaaS ? Pour le premier niveau, un assistant support connecté à votre documentation, quelques jours à quelques semaines suffisent sur une plateforme existante, contre plusieurs mois pour un développement interne complet. Les niveaux suivants, interrogation des données puis déclenchement d'actions, s'ajoutent progressivement et demandent davantage de cadrage, notamment sur les permissions et les workflows métier. ### Faut-il connecter le chatbot à toutes ses données dès le départ ? Non. Le levier le plus rapide est presque toujours la qualité des instructions et des scénarios, pas l'exhaustivité des sources connectées. Un périmètre étroit, sur lequel vous pouvez juger la qualité des réponses, donne de meilleurs résultats qu'un branchement complet mais mal cadré. Vous élargissez ensuite le périmètre une fois le premier cas d'usage validé auprès de vos utilisateurs. ### Comment un chatbot détecte-t-il une opportunité d'upsell ? Par des règles de tag définies en langage naturel plutôt que par des mots-clés figés : par exemple « le client s'interroge sur des fonctionnalités avancées ou des offres supérieures à son forfait actuel ». Quand une conversation correspond à cette condition, elle est étiquetée automatiquement et peut déclencher une alerte e-mail vers l'équipe commerciale ou customer success, en temps réel plutôt qu'après coup dans un export mensuel. ### Un chatbot produit remplace-t-il le support client humain ? Non, il en absorbe la part répétitive et déjà documentée, en général 40 à 60 % du volume de tickets, pour que les équipes support se concentrent sur les cas complexes, les bugs et les sujets qui demandent un vrai jugement humain. L'objectif n'est pas de supprimer le contact humain mais de le réserver aux situations où il apporte le plus de valeur. ## Ce qu'il faut retenir Le revenu récurrent d'un client ne dit rien de son engagement réel, et c'est précisément ce qui rend le désengagement dangereux : il reste silencieux jusqu'à la résiliation. Un chatbot dans un SaaS peut rester un simple assistant de documentation, ou devenir l'instrument qui maximise en continu la valeur extraite par chaque client et qui rend visible ce qui, autrement, ne se verrait qu'au moment du départ, vers un concurrent ou, de plus en plus souvent, vers ce que ce client aura fini par construire lui-même. --- # Outils d'analyse de données : quelle famille pour quel besoin en 2026 ? URL: https://www.askthisguy.com/fr/blog/data-analysis-tools/ Language: fr Section: Blog Il n'y a jamais eu autant d'outils pour analyser ses données. Excel, Power BI, Python, MATLAB, ChatGPT, sans compter la vague d'outils « text-to-SQL » et d'assistants conversationnels arrivés depuis deux ans. **Quelle famille d'outils pour quel type de besoin ?** On vous livre un éclairage ici ! ## 1. Les tableurs : Excel, Google Sheets ![Tableur Excel avec formules, données et graphiques](https://www.askthisguy.com/blog/data-analysis-tools/illustration-excel.webp) **En bref.** Le point de départ universel de l'analyse de données. **Exemples :** Microsoft Excel, Google Sheets. **Pour qui, quand.** N'importe qui, tout le monde sait ouvrir un Excel. Très utilisé par le métier et les DAF, qui s'en servent au quotidien pour modéliser, simuler, faire un calcul ponctuel maîtrisé de bout en bout. Pour le contrôle de gestion, nous avons détaillé cet arbitrage dans notre guide [Excel, tableaux de bord Power BI et IA](https://www.askthisguy.com/fr/blog/financial-analysis-without-excel). **Ce qu'ils font de mieux.** Modéliser. Construire un budget, simuler un scénario, poser des hypothèses et les rendre visibles. Souplesse inégalée, et surtout : tout le monde sait s'en servir. **Leurs limites.** Dès qu'il s'agit d'analyse **récurrente**, les faiblesses apparaissent : pas de connexion automatique aux sources, des formules qui s'empilent et deviennent fragiles, des fichiers difficilement reproductibles et dépendants de la personne qui les maîtrise. De plus, chaque hypothèse que l'on veut valider en manipulant quelques chiffres peut s'avérer chronophage. ## 2. Les plateformes de business intelligence : Power BI, Tableau, Qlik ![Tableau de bord Power BI avec graphiques et indicateurs de suivi](https://www.askthisguy.com/blog/data-analysis-tools/illustration-powerbi.webp) **En bref.** Suivre des indicateurs dans la durée. **Exemples :** Microsoft Power BI, Tableau, Qlik, Looker. **Pour qui, quand.** Généralement configuré par la DSI pour les métiers. Permet d'avoir le reporting financier ou opérationnel récurrent, le suivi d'indicateurs partagés dans le temps. **Ce qu'ils font de mieux.** Le **tableau de bord** et la **visualisation de données** : chiffre d'affaires, marge, trésorerie, encours. Vous suivez l'évolution sur un format visuel stable, partagé, mis à jour automatiquement. C'est l'outil de référence du reporting régulier. **Leurs limites.** Le dashboard est rigide par nature : dès qu'une question sort de la maille prévue par le concepteur du rapport, il faut modifier le dashboard. La réponse attendra. Quant à l'IA conversationnelle intégrée (Copilot avec Power BI par exemple), elle est généralement peu performante et dans le cas de Microsoft, particulièrement chère. ## 3. Les langages et notebooks : Python, R, SQL ![Notebook Jupyter avec code Python et visualisation de données](https://www.askthisguy.com/blog/data-analysis-tools/illustration-jupyter.webp) **En bref.** L'analyse sur-mesure, sans limite de puissance. **Réservé aux profils techniques.** Le notebook permet de saisir du code et de visualiser les résultats directement. **Exemples :** notebooks Jupyter, avec code Python et librairie Pandas (ou en plus moderne/performant Polars) **Pour qui, quand.** Exclusivement des équipes techniques, pour des analyses avancées. Pas un outil en libre-service. **Ce qu'ils font de mieux.** Tout, ou presque. Gros volumes, traitements complexes, analyses statistiques poussées, pipelines reproductibles et versionnés. C'est un outil clé pour les équipes data. **Leurs limites.** Ils supposent de savoir coder et d'avoir une forte logique mathématique. Un utilisateur métier ne peut pas être autonome ici : il dépend d'un data engineer ou d'un développeur pour poser sa question et obtenir une réponse. ## 4. Le calcul scientifique et statistique : MATLAB, SAS, SPSS ![Interface MATLAB pour modélisation numérique et analyse statistique](https://www.askthisguy.com/blog/data-analysis-tools/illustration-matlab.webp) **En bref.** Quand l'analyse devient une discipline scientifique à part entière. **Hors de portée du métier.** **Exemples :** MATLAB, SAS, SPSS, Stata. **Pour qui, quand.** Chercheurs, ingénieurs, biostatisticiens, quants. Cette famille est mentionnée ici pour être complet : pour une question métier courante, ce n'est jamais le bon outil. **Ce qu'ils font de mieux.** Les statistiques avancées, la modélisation numérique, le traitement du signal, la recherche quantitative : des domaines où ces suites spécialisées restent des références. **Leurs limites.** Coûteuses, très spécialisées, avec une longue courbe d'apprentissage. L'autonomie métier y est impossible : ce sont des outils de spécialistes, pas de décideurs ou d'analystes fonctionnels. ## 5. L'IA conversationnelle : parler à ses données **En bref.** La famille la plus récente : **interroger ses données en langage naturel**, comme on poserait la question à un collègue, et obtenir une réponse chiffrée, un graphique, un export. C'est aussi la famille la plus disparate car plus récente. On distingue trois grandes approches. ### Les IA généralistes : Mistral, ChatGPT, Claude **Pour qui, quand.** L'analyse ponctuelle d'un fichier isolé que vous avez déjà sous la main. **Ce qu'elles font de mieux.** Analyser un fichier qu'on leur donne. Vous importez un Excel ou un CSV, vous posez votre question, vous obtenez une analyse en quelques secondes. Zéro mise en place, accessible à tous, encore plus simple qu'Excel. **Leurs limites.** C'est du **one-shot** : vous alimentez l'outil à la main, à chaque fois. Ces assistants commencent à proposer des connecteurs, mais ils ne sont pas conçus pour interroger, de façon **récurrente, gouvernée et permissionnée**, vos sources d'entreprise connectées (ERP, CRM, base SQL) avec votre contexte métier. Par défaut, la donnée quitte votre environnement. Enfin, le risque d'hallucination est élevé. ### Les pure players de la data : Vanna, Wren AI **Pour qui, quand.** Les équipes techniques qui veulent construire leur propre couche conversationnelle sur mesure. **Ce qu'ils font de mieux.** Transformer une question en requête SQL (le « text-to-SQL »). Connectés à votre base, souvent open-source, ils sont puissants sur les données **structurées**. **Leurs limites.** Ils sont focalisés sur le SQL et le structuré, et ignorent vos documents. Surtout, ce sont des **briques à assembler** : il faut les héberger, les entraîner sur votre schéma, gérer les connecteurs, la gouvernance et la maintenance. C'est un projet data, pas un outil clé en main. ### Les plateformes métier : Ask This Guy ![Interface Talk to Data d'Ask This Guy pour interroger ses données en langage naturel](https://www.askthisguy.com/blog/data-analysis-tools/illustration-ask-this-guy.webp) **Ce qu'elles font de mieux.** Réunir les avantages des deux approches précédentes, en managé. **Ask This Guy**, grâce à sa solution Talk to Data, est un pure player de la data **et plus** : il se connecte à vos sources vivantes, croise une requête structurée avec vos documents, applique votre contexte métier et vos permissions, sans que vous ayez rien à construire. Grâce au **RAG**, une même question peut aller chercher une réponse dans votre **base SQL**, dans un **autre SI** (CRM, ERP), dans vos **documents bureautiques** (Excel, Word, PDF, SharePoint) et même sur le **web**, puis combiner le tout dans une seule réponse. Nous y revenons plus bas. ## Tableau récapitulatif | Famille | Exemple | Connexion aux sources | Compétences requises | Idéale pour | | --- | --- | --- | --- | --- | | **Tableurs** | Excel | Import manuel | Faibles | Modéliser, simuler | | **Plateformes BI** | Power BI | Connectée | Faibles à l'usage (config initiale) | Suivre des KPI récurrents | | **Langages / notebooks** | Jupyter | Connectée | Élevées à l'usage | Analyses avancées, industrialisées | | **Calcul scientifique** | MATLAB | Import / connectée | Élevées à l'usage | Statistiques, recherche | | **IA généraliste** | Claude | Import manuel | Faibles | Analyse ponctuelle d'un fichier | | **Pure player data** | Wren AI | Connectée | Faibles à l'usage (config initiale) | Brique text-to-SQL sur-mesure | | **Plateforme métier** | Ask This Guy | Multi-sources | Faibles à l'usage (config initiale) | Interroger et croiser ses données | ## Comment choisir : la bonne famille selon votre besoin Plutôt que de chercher un gagnant, partez de votre besoin : - **Suivre des indicateurs récurrents** (CA, marge, trésorerie) → une plateforme de BI. - **Construire un modèle ou un budget** → un tableur. - **Analyser un fichier isolé, une fois** → une IA généraliste. - **Traiter de gros volumes, industrialiser une analyse** → langages et notebooks. - **Faire des statistiques scientifiques** → une suite spécialisée. - **Interroger vos sources connectées en langage naturel, croiser données et documents, sans coder** → une plateforme conversationnelle métier. Un même service jongle souvent avec plusieurs familles. Pour le cas précis du contrôle de gestion (où Excel, dashboards et IA se complètent), nous avons écrit un [guide de décision dédié](https://www.askthisguy.com/fr/blog/financial-analysis-without-excel). ## Talk to Data : la couche conversationnelle en pratique La plupart des familles ci-dessus ont un angle mort commun : la **question imprévue**, celle qui n'a pas de case dédiée dans un rapport et qui, aujourd'hui, finit dans un Excel ou dans la file d'attente de l'IT. C'est précisément ce que vient combler une plateforme conversationnelle métier. **Talk to Data**, la solution d'Ask This Guy, se connecte à vos sources réelles (**base SQL, ERP et CRM comme Sage ou Salesforce, Excel, SharePoint, documents via RAG, MCP, API**) et répond à vos questions **en langage naturel, avec votre contexte métier**. Concrètement, elle apporte ce que ni un tableur, ni un dashboard, ni un chatbot généraliste ne réunissent : - la **compréhension du contexte métier** (vos termes, vos règles, vos référentiels) ; - le **croisement de sources hétérogènes grâce au RAG** : une même question peut interroger votre **base SQL**, un **autre SI** (ERP, CRM), vos **documents bureautiques** (Excel, Word, PDF, SharePoint) et une **recherche web**, pour combiner le tout dans une seule réponse cohérente, comme nous l'expliquons dans notre article sur [l'accès aux bases de données par l'IA](https://www.askthisguy.com/fr/blog/databases-gold-mine-ai-shovels) ; - la **génération de graphiques** et l'**export Excel/CSV** pour retravailler les résultats ; - le respect des **permissions** et un fonctionnement en **lecture seule**, sous contrôle de l'IT. Là où un pure player open-source vous demande de tout construire et maintenir, une plateforme managée rend l'analyse accessible directement à vos équipes métier. **Si vous ne devez retenir qu'une chose…** Ne choisissez pas un outil par habitude, mais par nature du besoin. - KPI à suivre dans le temps : plateforme de BI. - Modèle à construire : tableur. - Question ouverte sur vos données connectées : conversation en langage naturel. Ces familles se complètent bien plus qu'elles ne se remplacent. ## Questions fréquentes ### Quels sont les outils pour faire une analyse de données ? On distingue cinq grandes familles : les **tableurs** (Excel, Google Sheets) pour modéliser ; les **plateformes de BI** (Power BI, Tableau, Qlik) pour suivre des KPI ; les **langages et notebooks** (Python, R, SQL) pour les analyses avancées ; le **calcul scientifique** (MATLAB, SAS, SPSS) pour la recherche ; et l'**IA conversationnelle** (ChatGPT, Wren AI, Ask This Guy) pour interroger ses données en langage naturel. Chacune répond à un besoin différent, voir le tableau récapitulatif ci-dessus. ### Quel outil pour analyser ses données sans savoir coder ? Un tableur pour un calcul simple, une plateforme de BI pour suivre des indicateurs, et une **plateforme conversationnelle** (comme Ask This Guy) pour poser des questions ouvertes sur vos données connectées. Les langages comme Python ou les suites type MATLAB, eux, supposent de vraies compétences techniques. ### Power BI permet-il d'interroger ses données en langage naturel ? En partie, via Copilot. Mais cette IA conversationnelle reste limitée sur les questions ouvertes, et elle repose sur une **capacité Fabric ou Premium payante** au niveau de l'organisation, particulièrement chère. ### Qu'est-ce que la business intelligence conversationnelle ? C'est une couche qui se pose **au-dessus** de vos données pour permettre de les interroger en langage naturel, plutôt que via un dashboard figé ou une requête SQL. Le dashboard suit vos KPI dans le temps ; la conversation explique les écarts et explore les facteurs. Les deux sont complémentaires. ### Quel outil d'analyse de données pour une PME ou une ETI ? Cela dépend du besoin, mais deux critères pèsent lourd pour une structure sans grande équipe data : la **connexion aux sources réelles** sans projet technique lourd, et le **contrôle des droits**. Une plateforme managée qui interroge vos données existantes en langage naturel offre souvent le meilleur rapport valeur / effort de mise en place. --- Le paysage des outils d'analyse de données n'a jamais été aussi riche, et ce n'est pas près de se simplifier. La bonne stratégie n'est pas de choisir un camp, mais de mettre **chaque famille à sa place**, et de brancher la nouvelle couche conversationnelle là où les autres atteignent leurs limites. **[Réservez une démo](https://www.askthisguy.com/fr/demo/)** pour voir **Ask This Guy** répondre, en direct, à une vraie question sur vos données. --- # Contrôle de gestion : comment concilier Excel, tableaux de bord Power BI et IA ? URL: https://www.askthisguy.com/fr/blog/financial-analysis-without-excel/ Language: fr Section: Blog *« Pourquoi la marge a-t-elle baissé sur la région Ouest ce trimestre ? »* Cette question, un directeur général la pose en trente secondes. Y répondre, avec une bonne analyse et une bonne mise en forme, prend plusieurs heures. Le **contrôle de gestion** connaît bien ce décalage : entre la question et la réponse chiffrée, il y a une connexion à un SI, un export, des RECHERCHEV et des SOMMESI, un fichier à recouper, et un beau slide ou mail pour expliquer les résultats. Face à ce genre de demande, deux réflexes viennent naturellement à l'esprit : - aller fouiller le **tableau de bord** Power BI (ou Tableau ou autre) pour voir si l'on n'a pas déjà la réponse ; - rouvrir un **Excel** d’analyse et reconstruire le calcul. Alors qu'on aimerait juste poser la question dans un chatbot pour avoir les éléments d'entrée permettant l'analyse. C'est ce que permet par exemple la solution **[Talk to Data](https://www.askthisguy.com/fr/solutions/talk-to-data)** d'Ask This Guy. Les trois outils restent toutefois complémentaires. Cet article propose une grille simple pour savoir lequel utiliser, et quand. ## Trois familles d’outils, trois usages Avant de choisir, il faut voir clairement ce que chaque outil fait de mieux, et ses limitations. ### Excel : le couteau suisse de l’analyse Excel reste imbattable pour **modéliser** : construire un budget, simuler un scénario, le présenter avec une transparence maximale sur les hypothèses et inputs. C’est pour ça qu’il est partout dans la finance. Mais dès qu’il sert à **l’analyse de données récurrente**, les limites apparaissent vite : - pas de mécanisme automatisé pour importer des données actualisées ; - chaque question nouvelle demande de nouveaux traitements et formules ; - les formules s’empilent, deviennent fragiles, et une cellule décalée fausse tout ; - le résultat est **difficilement reproductible** : six mois plus tard, plus personne ne sait comment le fichier a été construit (car rarement documenté); - l’analyse dépend de la personne qui maîtrise le classeur. Le jour où elle est absente, l’information l’est aussi (même cause) Excel reste un incontournable et le restera longtemps, et [fait même l'objet d'un e-sport](https://www.youtube.com/watch?v=M0qha4l3Tls). ### Les tableaux de bord (Power BI par ex.) : suivre les KPI dans le temps Un **tableau de bord** est fait pour une chose précise : suivre des indicateurs **dans la durée**. Chiffre d’affaires, marge, trésorerie, encours clients. Vous voyez l’évolution, sur un format visuel stable et partagé. C’est exactement ce qu’il faut pour le **reporting financier** régulier. Son principal avantage par rapport à Excel est qu'il se met à jour automatiquement, et qu'il permet une interface plus intuitive et plus guidée pour ses utilisateurs. Mais dès qu’une question sort de la maille modélisée par le développeur du rapport (« classe-moi les commerciaux par perte de commandes ce quarter vs. Y-1), il faut retourner le voir pour avoir sa réponse (peut-être tout de suite ou peut-être dans une semaine). ### La conversation avec une IA : interroger ses données en langage naturel C’est l'outil le plus récent. L’idée : **interroger ses données en langage naturel**, comme on poserait la question à un collègue, et obtenir directement une réponse chiffrée, un graphique, voire un export. Il ne remplace ni Excel ni les dashboards. Il comble le trou entre les deux : les **questions ponctuelles et imprévues**, celles qui n’ont pas de case dédiée dans un rapport et qui, aujourd’hui, finissent dans un Excel ou dans la file d’attente de l’IT. ## La vraie question : « suivre » ou « comprendre » ? Tout se joue sur une distinction simple. Un tableau de bord répond à la question **« quoi ? »** : *quel* est le CA, *quelle* est la marge, *comment* évolue la trésorerie. Il montre ce qui bouge. La conversation répond à la question **« pourquoi ? »** : *pourquoi* la marge a baissé, *quels* clients ont décroché, *quelle* combinaison de facteurs explique l’écart. Elle aide à comprendre. > Le dashboard suit vos KPI dans le temps ; la conversation explique les écarts et explore les facteurs. Le **reporting financier** récurrent appartient clairement au monde du dashboard. Les questions d’**analyse financière** ponctuelles, elles, sont aujourd’hui traitées dans Excel. Mais dès aujourd'hui, elles peuvent être traitées plus efficacement avec une IA. ## Une grille de décision simple Plutôt que d’opposer les outils, posez-vous une question : **mon besoin est-il récurrent et cadré, ou ponctuel et exploratoire ?** | Votre besoin | Bon outil | Pourquoi | | --- | --- | --- | | Suivre un KPI récurrent (CA, marge, trésorerie) | Tableau de bord | Format visuel stable, partagé, comparable dans le temps | | Construire un modèle ou un budget complexe | Excel | Souplesse de modélisation inégalée | | Réfléchir à un pricing produit | Excel | Souplesse de modélisation inégalée | | Refaire le même calcul chaque mois | Excel ou Tableau de bord | Reproductible une fois le modèle posé | | Répondre à une question ponctuelle et précise | Conversation (IA) | Pas de nouveau rapport à construire | | Croiser plusieurs sources (ERP + CRM + Excel) | Conversation (IA) | Évite les exports manuels et les RECHERCHEV | | Comprendre *pourquoi* un chiffre bouge | Conversation (IA) | Explore les facteurs, pas seulement les totaux | ## La même question, trois chemins Prenons un cas concret. *Atelier Norca*, PME industrielle fictive, voit sa marge reculer sur la région Ouest au T3. Le contrôleur de gestion doit comprendre pourquoi. Voici les trois chemins possibles. **Chemin Excel.** Il exporte les ventes depuis l’ERP, la base clients depuis le CRM, colle le tout dans un classeur, monte un modèle et reconstitue l'impact des différents facteurs. Une trentaine de minutes plus tard, il a une piste (à condition de ne pas s’être trompé d’onglet ou de période). **Chemin tableau de bord.** Il ouvre le dashboard. Il **voit** la baisse, nette, sur la courbe régionale. Mais le rapport est construit par région, pas par client ni par produit. Pour creuser, il faut demander une nouvelle vue au concepteur du rapport. La réponse attendra. **Chemin conversation.** Il pose la question en langage naturel : *« Marge région Ouest au T3 vs T2, explore chaque facteur pouvant expliquer l'écart. »* Il obtient la réponse chiffrée, un graphique, et l’**export Excel/CSV** s’il veut retravailler les données, et un mail de synthèse. En moins d'une minute il identifie les causes clé.