> For the complete documentation index, see [llms.txt](https://gitbook.com/docs/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://gitbook.com/docs/documentation/fr/lia-pour-vos-lecteurs/connections.md). # Connexions Les connexions vous permettent d'importer du contenu externe dans votre site de documentation. Le contenu connecté peut apparaître dans [Recherche IA](/docs/documentation/fr/lia-pour-vos-lecteurs/ai-search.md) et [Assistant GitBook](/docs/documentation/fr/lia-pour-vos-lecteurs/gitbook-ai-assistant.md). Certaines connexions peuvent également aider GitBook à générer des demandes de modification. Pour ajouter une connexion, ouvrez la page de votre site consacrée aux **Paramètres** du tableau de bord de votre site, puis 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 ### Comment fonctionnent les connexions {% stepper %} {% step %} #### Connecter une source Sélectionnez un type de source. Puis autorisez-la, ou saisissez l'URL que vous souhaitez importer dans GitBook. {% hint style="info" %} Si vous connectez YouTube, saisissez l'identifiant de la chaîne — pas le nom de la chaîne. Un nom de chaîne ne fonctionne pas pour cette source. Dans YouTube Studio, ouvrez **Paramètres** → **Chaîne** → **Paramètres avancés**. Copiez l’ **Identifiant de la chaîne**. Si l'URL de votre chaîne contient `/channel/`, copiez la partie qui suit `/channel/`. {% endhint %} Chaque connexion crée un flux d'enregistrements provenant de cette source, tels que des tickets, des discussions, des conversations, des pages ou des vidéos. {% endstep %} {% step %} #### GitBook synchronise les enregistrements Après avoir enregistré la connexion, 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 l'heure de la dernière synchronisation. Les URL connectées se rafraîchissent par défaut une fois par jour. Vous pouvez également lancer un rafraîchissement manuellement depuis la page de votre site consacrée aux **Paramètres** → **Connexions**. {% endstep %} {% step %} #### 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 également ajuster le classement de recherche de la connexion afin de donner plus ou moins de priorité à ses enregistrements. {% endstep %} {% endstepper %} ### Paramètres de la connexion Lorsque vous modifiez une connexion, vous pouvez configurer ces options : #### Libellé Utilisez **Libellé** pour donner à la connexion un nom explicite. Cela facilite l'identification de la source dans la liste des connexions, en particulier si vous connectez plusieurs dépôts, sites web ou chaînes. #### Générer automatiquement des demandes de modification {% hint style="warning" %} La génération automatique de demandes de modification est actuellement en accès anticipé. Voir [Améliorations automatiques de la documentation](/docs/documentation/fr/gitbook-agent/automatic-docs-improvements.md) pour savoir comment demander l'accès {% endhint %} Activez **Générer automatiquement 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 que votre équipe pourra examiner. #### Exposer dans la recherche / l’assistant Activez **Exposer dans la recherche / l’assistant** pour rendre les enregistrements de cette connexion consultables par les visiteurs et disponibles pour répondre aux questions. Cela permet au contenu connecté d'apparaître dans l'expérience de recherche assistée par IA de votre site et dans les réponses de GitBook Assistant. {% hint style="warning" %} L'activation de **Exposer dans la recherche / l’assistant** met les enregistrements de cette connexion à la disposition de toute personne ayant accès au site — y compris les visiteurs externes si le site est partagé à l'extérieur. {% endhint %} #### Amélioration du classement dans la recherche Utilisez **Amélioration du classement dans la recherche** pour prioriser ou déprioriser les enregistrements d'une connexion dans la recherche. Augmentez la valeur si cette source doit apparaître plus souvent. Diminuez-la si cette source doit avoir moins de poids que vos documents principaux. ### Détails du connecteur Tous les connecteurs de cette section peuvent fournir du contexte à [Assistant GitBook](/docs/documentation/fr/lia-pour-vos-lecteurs/gitbook-ai-assistant.md). GitBook Agent peut utiliser les enregistrements résolus pour identifier [les lacunes de contenu](/docs/documentation/fr/gitbook-agent/automatic-docs-improvements.md) et suggérer des mises à jour de la documentation. #### Intercom GitBook indexe les conversations résolues ayant au moins une réponse d'un agent de support 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 ayant au moins une réponse d'un agent de support 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 ayant au moins une réponse d'un agent de support 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 stocke uniquement la conversation, la discussion ou l'issue. Nous ne stockons ni métadonnées ni 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 basées sur le contenu. Chaque élément que nous indexons à partir d'une connexion est appelé un **enregistrement.** Des exemples d'enregistrements sont les tickets Intercom, les tickets Freshdesk, les 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 utilisant 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é à l'aide de ces enregistrements comme contexte, et nous ne retirons pas non plus le contenu des enregistrements de tout journal de conversation IA stocké. Par exemple, vous pouvez connecter Intercom et GitBook suggère une modification de la documentation à partir d'un ticket de support Intercom fermé. Si vous supprimez ensuite la connexion Intercom, toutes nos données stockées spécifiques à Intercom sont supprimées, mais les demandes de modification resteront. #### FAQ
Quelle est votre politique concernant les données personnelles identifiables ? 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 soumettons à des processus de masquage des données personnelles. Le premier est un masquage en mémoire des adresses e-mail, numéros de téléphone, adresses postales et autres informations personnelles. Nous faisons ensuite passer l'enregistrement par une deuxième étape de traitement des données personnelles à l'aide d'un LLM tiers. Il s'agit d'une requête conforme au ZDR, sans stockage, qui n'est pas conservée sur les serveurs de notre tiers et n'est utilisée dans aucun entraînement. Les données personnelles peuvent exister sur nos serveurs pendant quelques minutes pendant que nous effectuons ce prétraitement, mais nous ne stockons que l'enregistrement après traitement.
Envoyez-vous des données à des tiers ? Nous faisons appel à un tiers pour masquer les données personnelles après la première phase interne de masquage. Nous utilisons également le contenu de l'enregistrement masqué chez des prestataires tiers lors de la création de demandes de modification et pour répondre 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 l'entraînement de modèles, 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 fournisseurs tiers qu'ils ne le font pas non plus.
Puis-je limiter les enregistrements que GitBook récupère ? Les exigences spécifiques aux connecteurs et les enregistrements indexés sont listés dans [Détails du connecteur](#connector-details).
--- # Agent Instructions This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com. ## Querying This Documentation If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question. Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter: ``` GET https://gitbook.com/docs/documentation/fr/lia-pour-vos-lecteurs/connections.md?ask=&goal= ``` `ask` is the immediate question: it should be specific, self-contained, and written in natural language. `goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal. The response will contain a direct answer to the question and relevant excerpts and sources from the documentation. Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.