Aller au contenu
  1. Documentation/
  2. RagWeb — Documentation/

FAQ et dépannage

736 mots
Sommaire
Documentation RagWeb - Série de pages
Service 6: Ce service

Questions fréquentes
#

Combien de temps prend l’indexation ?
#

La première indexation prend entre 1 et 10 minutes selon la taille de votre site. Les re-indexations suivantes sont plus rapides (incrémentales — seules les pages modifiées ou nouvelles sont traitées).

Est-ce que mes visiteurs sont trackés ?
#

Non. Le widget ne pose aucun cookie et ne collecte aucune donnée personnelle des visiteurs. Seul le contenu de la question est envoyé à l’API pour générer une réponse.

Où sont hébergées mes données ?
#

En Union Européenne (AWS Dublin, Irlande). Aucune donnée ne transite par des serveurs hors UE.

Le widget ralentit-il mon site ?
#

Non. Le script pèse moins de 5 KB gzipped, se charge de manière asynchrone, et utilise un Shadow DOM fermé qui n’interfère pas avec le CSS de votre site.

Que se passe-t-il si je dépasse mon quota quotidien ?
#

Les requêtes retournent un code HTTP 429 (Too Many Requests). Le widget affiche un message à l’utilisateur. Le compteur est réinitialisé à minuit UTC.

Puis-je utiliser RagWeb sur plusieurs sites ?
#

Un abonnement correspond à un domaine vérifié. Pour plusieurs sites, vous aurez besoin de plusieurs comptes ou d’un arrangement personnalisé (contactez contact@yannick.services).

Le widget fonctionne-t-il en anglais ?
#

Oui. Ajoutez data-lang="en" au snippet. L’IA répond dans la langue de la question — si un visiteur pose une question en anglais, la réponse sera en anglais, quelle que soit la langue de l’interface.

Les pages protégées par un login sont-elles indexées ?
#

Non. Le crawler AWS accède uniquement au contenu public. Les pages derrière une authentification ne sont pas crawlées.

Puis-je uploader des documents manuellement ?
#

Oui (plans Starter+). L’onglet Configuration permet d’activer l’indexation des documents attachés détectés pendant le crawl. Vous pouvez aussi uploader des PDF et DOCX directement depuis le dashboard.

Que se passe-t-il si je résilie mon abonnement ?
#

Vous disposez d’un délai de grâce de 30 jours. Après cette période, la data source est supprimée et le widget cesse de fonctionner. Vous pouvez vous réabonner à tout moment pour relancer l’indexation.

L’IA peut-elle inventer des réponses ?
#

L’IA ne répond qu’à partir du contenu indexé de votre site. Si aucune information pertinente n’est trouvée, elle l’indique explicitement. Le prompt personnalisable permet de cadrer davantage les réponses.

Dépannage
#

Le widget n’apparaît pas
#

VérificationSolution
La clé API est-elle correcte ?Vérifiez dans l’onglet Clés API du dashboard
Le script est-il bien avant </body> ?Certains builders (Webflow, Wix) nécessitent un placement spécifique
data-include-paths est-il défini ?S’il est défini, le widget n’apparaît que sur les pages listées
Un ad-blocker est-il actif ?Certains bloqueurs peuvent interférer — testez en navigation privée
Le domaine est-il vérifié et indexé ?Le widget a besoin d’une data source active

Le widget affiche “Service temporairement indisponible”
#

Cause probable : erreur serveur temporaire ou quota atteint.

  • Vérifiez votre consommation quotidienne dans le dashboard (graphique 14 jours)
  • Si le quota n’est pas atteint, réessayez dans quelques minutes
  • Si le problème persiste, contactez contact@yannick.services

Les réponses ne sont pas pertinentes
#

CauseSolution
Site pas encore indexé complètementAttendez la fin de l’indexation ou lancez une re-indexation
Pages importantes exclues par un filtreVérifiez vos filtres d’exclusion dans l’onglet Configuration
Prompt trop restrictifAjustez les instructions dans l’onglet Assistant
Contenu du site peu structuréAméliorez les titres et la hiérarchie de vos pages

L’indexation échoue
#

MessageCauseSolution
“robots.txt bloque le crawl”Votre robots.txt interdit le crawler AWSAutorisez le user-agent AWS dans votre robots.txt
Indexation FAILEDLe site est inaccessible ou retourne des erreursVérifiez que votre site est en ligne et accessible publiquement

Configuration robots.txt recommandée :

User-agent: *
Allow: /

# Si vous voulez bloquer uniquement certains chemins :
Disallow: /admin/
Disallow: /private/

La vérification de domaine ne fonctionne pas
#

Voir le guide détaillé : Vérification de domaine — Dépannage

Le streaming ne fonctionne pas (texte d’un bloc)
#

Le streaming SSE nécessite que votre infrastructure (proxy, CDN) ne bufferise pas les réponses. Vérifiez :

  • Cloudflare : désactivez le buffering sur la route du widget (ou utilisez le mode “streaming”)
  • Nginx : ajoutez proxy_buffering off; pour les requêtes vers l’API
  • Le widget gère automatiquement le fallback vers une réponse non-streamée si le SSE échoue

Support
#

Pour toute question non couverte ici :

  • Email : contact@yannick.services
  • Forfait intégration (49 € HT) : accompagnement personnalisé pour la mise en place
Documentation RagWeb - Série de pages
Service 6: Ce service

Pages connexes

API et intégrations

728 mots
RagWeb expose une API REST pour l’intégration programmatique du moteur de recherche IA dans vos applications, bots ou workflows. Clés API # Créer une clé # Connectez-vous au tableau de bord RagWeb Allez dans l’onglet Clés API Entrez un nom descriptif (ex : “Mon site”, “Bot Discord”) Cliquez Créer Copiez immédiatement la clé — elle ne sera plus affichée ensuite Format de la clé # rw_xxxxxxxxxxxxxxxxxxxxxxxxxxxx Les clés commencent par rw_ et sont composées de caractères alphanumériques.

Configuration

659 mots
L’onglet Configuration permet de contrôler précisément ce que RagWeb indexe et comment l’IA répond. Il se déverrouille une fois votre domaine vérifié. Seed URLs # Les seed URLs sont les pages de départ depuis lesquelles le crawler commence sa découverte. Le crawler suit ensuite les liens internes pour indexer le reste du site.

Démarrage rapide

322 mots
De l’inscription à votre premier résultat de recherche IA en 5 minutes. Prérequis # Un site web public accessible (pas de pages derrière un login) Un email professionnel (@votredomaine.fr) — recommandé pour la vérification par email Accès à votre zone DNS — si vous préférez la vérification DNS Étape 1 — Créer un compte # Rendez-vous sur yannick.services/apps/ragweb/ Cliquez sur Commencer gratuitement Entrez votre email et validez le code OTP reçu Vous êtes redirigé vers le tableau de bord RagWeb Le plan Free est activé automatiquement. Pas de carte bancaire requise.