Connecteur IA de Notion pour GitHub

Pour connecter GitHub à l’IA de Notion :

• Vous devez être propriétaire d’une organisation GitHub et d’un espace de travail Notion.

• Votre espace de travail doit être au forfait Business ou Enterprise et compter plus d’un membre.

Une fois la connexion établie, les membres de votre espace de travail Notion doivent se connecter pour consulter les dépôts auxquels ils ont accès.

Pour connecter GitHub à votre espace de travail Notion :

1. Allez dans Paramètres → IA de Notion.

2. Sélectionnez + à côté de GitHub.

   

3. Vous serez redirigé·e vers GitHub. Assurez-vous que vous êtes connecté·e avec le bon compte GitHub. Ne fermez pas Notion lors du processus de configuration !

   

4. Dans la page qui s’ouvre, connectez-vous à GitHub et sélectionnez l’organisation à synchroniser. Notez que si vous souhaitez connecter un dépôt GitHub personnel, vous devez d’abord créer une organisation, puis déplacer le dépôt dans l’organisation.

5. Sélectionnez Tous les dépôts (recommandé) ou Sélectionner les dépôts, puis cliquez sur Installer.

6. Retournez dans Notion.

Une fois l’intégration configurée, cette dernière pourra indexer les Pull Requests et les Issues jusqu’à un an avant la date de configuration. Vous aurez également accès à tous les fichiers de code, y compris les fichiers Markdown et les fichiers README, sans aucune restriction de temps.

La connexion peut prendre jusqu’à 72 heures. Ensuite, chaque utilisateur de votre espace de travail Notion doit s’authentifier individuellement auprès de GitHub pour utiliser l’intégration, et ses autorisations seront mappées en conséquence.

Si vous n’êtes pas propriétaire de votre espace de travail Notion ou de votre organisation GitHub, vous aurez besoin d’un propriétaire pour connecter Notion à GitHub avant de pouvoir utiliser l’intégration. Une fois l’intégration configurée par un propriétaire, vous devrez vous connecter pour relier vos dépôts privés. Pour ce faire :

1. Dans Notion, ouvrez l’IA de Notion en bas de votre écran et cliquez sur ••• → Connecter GitHub.

2. Sélectionnez Se connecter et connectez votre compte GitHub.

Chaque utilisateur ne pourra utiliser l’IA de Notion que pour voir et rechercher le contenu auquel il a accès dans GitHub. L’IA de Notion peut récupérer les informations des pull requests jusqu’à un an en arrière.

Le connecteur IA de GitHub est particulièrement utile pour :

• Poser des questions sur les modifications récentes et les mises à jour de projet

• Trouver des applications de code

• Rechercher des issues et leur statut

• Déboguer des issues (par exemple, vous pouvez obtenir des informations contextuelles lorsque des fonctionnalités sont défectueuses ou génèrent des erreurs en consultant les dernières pull requests)

• Rechercher des tendances en matière de sécurité

Vous pouvez essayer de donner les instructions suivantes à l’IA de Notion :

• « Quelles sont les dernières nouvelles concernant {project name} ? »

• « Sur quelles pull requests avons-nous travaillé la semaine dernière ? »

• « Quels sont les changements récents apportés à notre système d’authentification ? »

• « Montrez-moi des exemples de la façon dont nous mettons en œuvre la gestion des erreurs dans notre base de code. »

• « Quelles sont les principales dépendances utilisées dans nos composants front-end ? »

• « Trouvez des mises en œuvre des fonctions de migration de base de données. »

• « Quels modèles de sécurité utilisons-nous pour les points de terminaison d’API ? »

Vous pouvez effectuer des recherches dans GitHub via les connecteurs IA de Notion aux emplacements suivants :

• Dans le chat de l’IA de Notion en bas à droite de Notion

• Dans le widget IA de Notion en haut de la page d’accueil

• Via la recherche de la barre latérale

Vous pouvez restreindre votre recherche à GitHub en cliquant sur le bouton Toutes les sources dans le chat et la page d’accueil, puis en sélectionnant GitHub. Vous pouvez également filtrer les résultats de recherche de l’IA de Notion pour afficher uniquement les informations de GitHub.

Qui peut connecter GitHub à l’IA de Notion ?

Lorsque vous connectez GitHub à l’IA de Notion pour la première fois, vous devez être propriétaire d’un espace de travail Notion et propriétaire d’une organisation GitHub. Une fois la connexion établie, les membres de votre espace de travail Notion doivent se connecter pour consulter les dépôts auxquels ils ont accès.

Qui peut utiliser cette intégration ?

Une fois le connecteur IA de GitHub configuré pour l’espace de travail, les membres peuvent utiliser l’intégration pour obtenir des réponses :

• Dépôts publics : aucune authentification supplémentaire n’est requise après la configuration initiale du connecteur par un propriétaire.

• Dépôts privés : chaque membre doit se connecter/s’authentifier auprès de GitHub pour vérifier l’accès.

J’ai connecté le mauvais espace de travail de Notion. Comment puis-je déconnecter mon dépôt GitHub ?

Les propriétaires d’espace de travail peuvent déconnecter ou modifier des canaux une fois l’intégration initiale terminée en allant dans Paramètres → IA de Notion. Sélectionnez ⚙️ à côté de GitHub → Paramètres → Déconnecter.

Combien de temps dure le processus d’intégration ?

La configuration de l’intégration peut prendre jusqu’à 72 heures en fonction de la taille du dépôt et du type de forfait GitHub.

Combien de temps faut-il pour que le nouveau contenu de GitHub soit reflété dans l’IA de Notion ?

Après la configuration initiale, nous indexerons les nouvelles données toutes les 30 minutes.

Est-ce que toutes les personnes de mon espace de travail Notion peuvent accéder aux informations de GitHub ?

Les membres d’un espace de travail doivent s’authentifier et se connecter de manière individuelle pour récupérer les informations des dépôts privés auxquels ils ont déjà accès dans GitHub.

Jusqu’à quand peuvent remonter mes questions dans GitHub ?

Vous pouvez récupérer des Pull Requests et des Issues dans leurs dépôts jusqu’à un an en arrière. Tous les fichiers README seront disponibles sans aucune restriction de temps.

À quoi l’IA de Notion a-t-elle accès ?

Au cours du processus d’intégration, après avoir sélectionné l’organisation GitHub que vous souhaitez connecter, vous pouvez choisir si l’IA de Notion a accès à :

• Tous les dépôts : cela s’applique à tous les dépôts actuels et futurs appartenant au propriétaire de la ressource. Comprend également les dépôts publics (en lecture seule).

• Sélectionnez uniquement les propriétés : sélectionnez au moins un dépôt. Comprend également les dépôts publics (en lecture seule).

Quels contenus de GitHub sont pris en charge par le connecteur IA ?

Une fois le connecteur IA configuré pour l’espace de travail, il peut indexer le code, les Pull Requests, les Issues, les fichiers et les README.

Les connecteurs IA de Notion respectent-ils les autorisations existantes de l’IA de Notion ?

Tout à fait. L’IA de Notion respectera les autorisations existantes conformément aux pratiques existantes de l’IA de Notion en matière de sécurité. Les utilisateurs ne seront pas en mesure de générer du contenu ou de recevoir des réponses de l’IA de Notion qui prendraient en compte des ressources de tiers auxquelles ils n’ont pas accès.

En ce qui concerne le contenu tiers, l’IA de Notion gère les contenus publics et privés dans un souci de sécurité et ingère le contenu conformément aux correspondances d’autorisations établies entre les utilisateurs de GitHub et de Notion.

Comment l’IA de Notion gère-t-elle le mappage des autorisations ?

Les utilisateurs ne verront que le contenu GitHub (par exemple, le code, les Pull Requests, les Issues) dans l’IA de Notion auquel ils ont l’autorisation personnelle d’accéder dans GitHub. Si quelqu’un essaie d’interroger un dépôt auquel il n’a pas accès dans GitHub, l’IA de Notion ne renverra pas les résultats de ce dépôt.

• L’utilisateur doit être à la fois membre de GitHub et de Notion pour s’authentifier à cette application à un niveau utilisateur.

  • Les utilisateurs n’ont pas besoin d’utiliser la même adresse e-mail dans Notion et GitHub.

  • Les autorisations sont mappées en fonction de l’authentification réussie de chaque utilisateur avec son compte GitHub, et non en comparant les adresses e-mail. L’IA de Notion s’appuie sur la connexion OAuth pour confirmer l’identité et la portée des autorisations, et non sur la correspondance des e-mails.

• Nous synchronisons les autorisations de GitHub toutes les heures et mettons à jour les autorisations dans Notion en conséquence.

Comment Notion stocke-t-il ou référence-t-il mes données GitHub dans ses systèmes ?

Comme pour notre produit principal (l’IA de Notion), nous créons et stockons des intégrations dans une base de données vectorielle hébergée par Turbopuffer, ce qui nous permet de fournir des réponses aux questions en utilisant du contenu tiers (par exemple GitHub). Notre équipe de sécurité a approuvé ce service, qui bénéficie par ailleurs d’une certification SOC2 Type II obtenue après audit externe. En savoir plus sur la sécurité de Turbopuffer ici →