Connexions

Connectez des sources externes à l’Assistant GitBook et à l’Agent GitBook

Les connexions vous permettent d’intégrer du contenu externe dans votre site de documentation.

Le contenu connecté peut apparaître dans Assistant IA. Certaines connexions peuvent aussi aider GitBook à générer des demandes de modification.

Pour ajouter une connexion, ouvrez le Paramètres tableau de bord de votre site et cliquez sur Connexions.

Connexions disponibles

Vous pouvez connecter des plateformes de support, des communautés de développeurs et d’autres sources de contenu :

• Intercom, Zendesk, Freshdesk, Front, HubSpot, Zoho Desk et Pylon
• GitHub Discussions et GitHub Issues
• YouTube, un site web ou un serveur MCP

Fonctionnement des connexions

1

Connecter une source

Sélectionnez un type de source. Ensuite, autorisez-la ou saisissez l’URL que vous souhaitez importer dans GitBook.

Si vous connectez YouTube, saisissez l’ID de la chaîne — pas le nom de la chaîne.

Un nom de chaîne ne fonctionnera pas pour cette source.

Dans YouTube Studio, ouvrez Paramètres → Chaîne → Paramètres avancés.

Copiez l’ ID de la chaîne.

Si l’URL de votre chaîne contient /channel/, copiez la partie qui suit /channel/.

Chaque connexion crée un flux d’enregistrements à partir de cette source, comme des tickets, des discussions, des problèmes, des conversations, des pages ou des vidéos.

2

GitBook synchronise les enregistrements

Une fois la connexion enregistrée, GitBook commence à synchroniser les enregistrements de cette source.

Dans la liste des connexions, vous pouvez consulter l’état de synchronisation, le nombre d’enregistrements et la date de la dernière synchronisation.

Par défaut, les URL connectées sont actualisées une fois par jour. Vous pouvez également lancer une actualisation manuellement depuis le Paramètres → Connexions.

3

Choisissez comment les enregistrements sont utilisés

Pour chaque connexion, vous pouvez choisir si ses enregistrements apparaissent dans la recherche et dans GitBook Assistant, et s’ils aident GitBook à générer des demandes de modification.

Vous pouvez aussi ajuster le classement de recherche de la connexion pour prioriser ou reléguer ses enregistrements.

Paramètres de connexion

Lorsque vous modifiez une connexion, vous pouvez configurer ces options :

Libellé

Utilisez Libellé pour donner un nom clair à la connexion.

Cela facilite l’identification de la source dans la liste des connexions, surtout si vous connectez plusieurs dépôts, sites web ou chaînes.

Génération automatique des demandes de modification

La génération automatique des demandes de modification est actuellement en accès anticipé.

Voir Améliorations automatiques de la documentation pour savoir comment demander l’accès

Activer Génération automatique des demandes de modification pour permettre à GitBook d’apprendre à partir des enregistrements de la connexion et de suggérer des mises à jour de la documentation.

GitBook peut utiliser ces enregistrements pour créer des demandes de modification avec des changements suggérés à examiner par votre équipe.

Exposer dans la recherche / l’assistant

Activer Exposer dans la recherche / l’assistant pour rendre les enregistrements de cette connexion recherchables par les visiteurs et disponibles pour répondre aux questions.

Cela permet au contenu connecté d’apparaître dans l’expérience de recherche alimentée par l’IA de votre site et dans les réponses de GitBook Assistant.

L’activation de Exposer dans la recherche / l’assistant rend les enregistrements de cette connexion disponibles pour toute personne pouvant accéder au site — y compris les visiteurs externes si le site est partagé en externe.

Boost du classement dans la recherche

Utilisez Boost du classement dans la recherche pour prioriser ou reléguer les enregistrements d’une connexion dans la recherche.

Augmentez la valeur si cette source doit apparaître plus souvent. Baissez-la si cette source doit avoir moins de poids que votre documentation principale.

Détails du connecteur

Tous les connecteurs de cette section peuvent fournir du contexte à Assistant IA. GitBook Agent peut utiliser les enregistrements résolus pour identifier les lacunes de contenu et suggérer des mises à jour de la documentation.

Intercom

GitBook indexe les conversations résolues comportant au moins une réponse d’un agent d’assistance humain ou IA. Il n’indexe pas les conversations ouvertes, non résolues ou indésirables.

Pour connecter Intercom, utilisez une clé API avec un accès en lecture aux conversations. Vous contrôlez sa portée et son expiration.

Zendesk

GitBook indexe les conversations résolues comportant au moins une réponse d’un agent d’assistance humain ou IA. Il n’indexe pas les conversations ouvertes, non résolues ou indésirables.

Pour connecter Zendesk, saisissez votre sous-domaine Zendesk, par exemple gitbook.zendesk.com. Vous avez également besoin d’une clé API avec un accès en lecture aux conversations. Vous contrôlez sa portée et son expiration.

Pylon

GitBook indexe les conversations résolues comportant au moins une réponse d’un agent d’assistance humain ou IA. Il n’indexe pas les conversations ouvertes, non résolues ou indésirables.

Pour connecter Pylon, utilisez des identifiants avec un accès en lecture aux conversations.

GitHub Discussions

GitBook indexe les discussions résolues comportant au moins une réponse. Il n’indexe pas les discussions non résolues ou indésirables.

Pour connecter GitHub Discussions, utilisez des identifiants avec un accès en lecture aux discussions.

GitHub Issues

GitBook indexe les issues résolues. Il n’indexe pas les conversations ouvertes, non résolues ou indésirables.

Pour connecter GitHub Issues, utilisez des identifiants avec un accès en lecture aux issues.

Données stockées pour ces connecteurs

GitBook ne stocke que la conversation, la discussion ou l’issue. Nous ne stockons pas les métadonnées ni les informations personnelles.

GitBook masque les informations sensibles avant le stockage. Nous ne stockons pas d’informations sensibles dans l’enregistrement indexé.

Conservation des données et confidentialité

Qu’est-ce que GitBook indexe ?

GitBook indexe le contenu de vos connexions et l’utilise dans la recherche, les demandes de modification et d’autres fonctionnalités axées sur le contenu. Chaque élément que nous indexons à partir d’une connexion est appelé un enregistrement. Des exemples d’enregistrements incluent des tickets Intercom, des tickets Freshdesk, des pages web, et bien plus encore.

Nous utilisons les enregistrements pour suggérer des modifications de contenu et fournir un contexte supplémentaire aux agents utilisés dans GitBook.

Nous conservons les enregistrements tant que la source reste connectée. Si vous supprimez la connexion, nous supprimons tous les enregistrements stockés. Nous ne supprimons aucun contenu généré à partir de ces enregistrements comme contexte, ni ne retirons le contenu des enregistrements de journaux de conversation IA stockés.

Par exemple, vous pourriez connecter Intercom et GitBook suggère une modification de la documentation à partir d’un ticket d’assistance Intercom fermé. Si vous supprimez ensuite la connexion Intercom, toutes nos données stockées spécifiques à Intercom seront supprimées, mais les demandes de modification resteront.

FAQ

Quelle est votre politique concernant les données personnelles identifiables (PII) ?

En général, GitBook ne demande que les champs source qu’il peut utiliser comme contexte (voir les pages des connecteurs pour plus de détails sur chaque source).

Lorsque nous ingérons un enregistrement, nous le faisons passer par des processus de masquage des PII. Le premier est un masquage en mémoire de tous les e-mails, numéros de téléphone, adresses et autres informations personnelles.

Nous faisons ensuite passer l’enregistrement par une deuxième étape de masquage des PII à l’aide d’un LLM tiers. Il s’agit d’une requête conforme au ZDR, sans stockage, qui n’est pas enregistrée sur les serveurs de notre tiers et n’est utilisée dans aucun entraînement.

Des PII peuvent exister sur nos serveurs pendant quelques minutes pendant ce prétraitement, mais nous ne stockons que l’enregistrement après traitement.

Envoyez-vous des données à des tiers ?

Nous utilisons un tiers pour masquer les PII après la fin de notre premier masquage interne des PII.

Nous utilisons également le contenu de l’enregistrement masqué chez des prestataires tiers lors de la création de demandes de modification et de la réponse aux questions des utilisateurs.

Par exemple, lors de la rédaction de contenu avec GitBook Agent, l’agent peut inclure du contenu provenant d’un enregistrement externe comme contexte supplémentaire.

GitBook utilise-t-il des données pour un entraînement de modèle, que ce soit lui-même ou via des tiers

Non, nous n’utilisons pas les données des enregistrements pour l’entraînement et nous vérifions auprès de nos prestataires tiers qu’ils ne le font pas non plus.

Puis-je limiter les enregistrements que GitBook récupère ?

Les exigences spécifiques à chaque connecteur et les enregistrements indexés sont listés dans Détails du connecteur.