Notion-KI-Connect für GitHub

Um GitHub mit der Notion-KI zu verbinden:

• Musst du Besitzer/-in der GitHub-Organisation und des Notion-Workspace sein.

• Dein Workspace muss im Business oder Enterprise Plan sein und mehr als ein Mitglied haben.

Sobald die Verbindung hergestellt ist, müssen sich die Mitglieder deines Notion-Workspaces anmelden, um auf die Repositories zugreifen zu können, auf die ihnen Zugriff gewährt wurde.

So verbindest du GitHub mit deinem Notion-Workspace:

1. Gehe zu Einstellungen → Notion-KI.

2. Wähle + neben Github aus.

   

3. Du wirst zu GitHub weitergeleitet. Stelle sicher, dass du mit dem richtigen GitHub-Konto angemeldet bist. Du darfst Notion während der Einrichtung nicht schließen!

   

4. Stelle auf der sich nun öffnenden Seite eine Verbindung zu GitHub her und wähle die Organisation aus, die du synchronisieren möchtest. Beachte, dass du, wenn du ein persönliches GitHub-Repository verknüpfen möchtest, zuerst eine Organisation erstellen und das Repository dann in die Organisation verschieben musst.

5. Wähle Alle Repositories (empfohlen) oder Repositories auswählen aus und klicke dann auf Installieren.

6. Zu Notion zurückkehren.

Sobald die Einbindung eingerichtet ist, können PRs und Issues, die bis zu ein Jahr zurückliegen, indiziert werden. Du hast außerdem ohne zeitliche Begrenzung Zugriff auf alle Codedateien, einschließlich Markdown-Dateien und READMes.

Es kann bis zu 72 Stunden dauern, bis die Verbindung abgeschlossen ist. Danach müssen sich alle Benutzer/-innen in deinem Notion-Workspace einzeln bei GitHub authentifizieren, um die Einbindungen verwenden zu können. Die jeweiligen Berechtigungen werden entsprechend zugeordnet.

Notion muss zuerst von den Besitzer/-innen mit GitHub verbunden werden, bevor Mitglieder die Einbindung nutzen können. Sobald die Einbindung von den Besitzer/-innen eingerichtet wurde, musst du dich anmelden, um deine privaten Repositories zu verbinden. Das funktioniert so:

1. Öffne in Notion die Notion-KI unten auf deinem Bildschirm und klicke auf ••• → Mit GitHub verbinden.

2. Wähle Anmelden aus und verbinde dein GitHub-Konto.

Nutzer/-innen können die Notion-KI nur verwenden, um Inhalte anzuzeigen und zu durchsuchen, auf die sie in GitHub Zugriff haben. Die Notion-KI kann die Informationen des letzten Jahres aus PRs abrufen.

Der GitHub-KI-Konnektor ist besonders hilfreich für:

• Fragen zu den jüngsten Änderungen und Projektaktualisierungen.

• Suche nach Code-Implementierungen.

• Suche nach Problemen und deren Status.

• Fehlerbehebung. Du kannst beispielsweise den Kontext erhalten, wenn Funktionen defekt sind oder Fehler auslösen, indem du die letzten PRs liest.

• Sicherheitsmuster finden.

Du könntest versuchen, der Notion-KI den folgenden Prompt vorzugeben:

• „Was ist der letzte Stand bei {project name}?“

• „An welchen Pull-Requests haben wir in der letzten Woche gearbeitet?“

• „Was sind die jüngsten Änderungen an unserem Authentifizierungssystem?“

• „Zeige mir Beispiele, wie wir die Fehlerbehandlung in unserer Codebasis implementieren.“

• „Was sind die wichtigsten Abhängigkeiten, die in unseren Frontend-Komponenten verwendet werden?“

• „Finde Implementierungen der Funktionen zur Datenbankmigration.“

• „Welche Sicherheitsmuster verwenden wir für API-Endpunkte?“

Du kannst GitHub über Notion-KI-Konnektoren an folgenden Stellen durchsuchen:

• Im Notion-KI-Chat unten rechts in Notion.

• Im Notion-KI-Widget oben in Home.

• Über die Suche in der Seitenleiste.

Du kannst deine Suche auf GitHub beschränken, indem du den Schalter Alle Quellen im Chat und in Home öffnest und GitHub auswählst. Du kannst die Suchergebnisse der Notion-KI filtern, um nur Informationen aus GitHub anzuzeigen.

Wer kann GitHub mit der Notion-KI verbinden?

Wenn du GitHub zum ersten Mal mit der Notion-KI verbindest, musst du Notion-Workspace-Besitzer/-in und Besitzer/-in der GitHub-Organisation sein. Sobald die Verbindung hergestellt ist, müssen sich die Mitglieder deines Notion-Workspaces anmelden, um auf die Repositories zugreifen zu können, auf die ihnen Zugriff gewährt wurde.

Ich habe den falschen Notion-Workspace verbunden. Wie kann ich mein Github-Repository trennen?

Workspace-Besitzer/-innen können die Verbindung trennen oder Kanäle bearbeiten, nachdem die erste Einbindung abgeschlossen ist, indem sie zu Einstellungen → Notion-KI gehen. Wähle ⚙️ neben GitHub → Einstellungen → Trennen aus.

Wie lange dauert es, bis die Einbindung abgeschlossen ist?

Die Einrichtung der Einbindung kann je nach Größe des Repositorys und des GitHub Plans bis zu 72 Stunden dauern.

Wie lange dauert es, bis neue Inhalte in der Notion-KI angezeigt werden?

Nach der Ersteinrichtung indizieren wir alle 30 Minuten neue Daten.

Können alle in meinem Notion-Workspace auf Informationen in GitHub zugreifen?

Mitglieder eines Workspaces müssen sich einzeln authentifizieren und anmelden, um Informationen aus privaten Repositories abzurufen, auf die sie in GitHub bereits Zugriff haben.

Wie weit in die Vergangenheit kann ich in GitHub Fragen stellen?

Du kannst PRs und Issues aus dem letzten Jahr in ihrem Repository abrufen. Alle READMes sind ohne zeitliche Beschränkung verfügbar.

Respektieren Notion-KI-Connectors bestehende Notion-KI-Berechtigungen?

Absolut! Notion-KI respektiert bestehende Berechtigungen gemäß unseren bestehenden Notion-KI-Sicherheitsverfahren. Nutzer/-innen können keine Inhalte generieren oder Antworten von der Notion-KI erhalten, die auf Ressourcen von Drittanbietern basieren, auf die sie keinen Zugriff haben.

Wie geht die Notion-KI mit der Berechtigungszuordnung um?

„Notion-KI für GitHub“ ordnet GitHub-Mitglieder Notion-Mitgliedern zu. Der oder die Benutzer/-in muss sowohl GitHub- als auch Notion-Mitglied sein, um diese App auf Benutzerebene zu authentifizieren. Wir synchronisieren die Berechtigungen von GitHub stündlich und aktualisieren die Berechtigungen in Notion entsprechend.

Wie speichert oder referenziert Notion meine GitHub-Daten in seinen Systemen?

Ähnlich wie bei unserem Hauptprodukt, Notion-KI, erstellen und speichern wir Einbettungen in einer von Turbopuffer gehosteten Vektordatenbank. Diese bietet die Möglichkeit, Antworten auf Fragen zu geben, die Inhalte von Drittanbietern (z. B. in GitHub) einbeziehen. Turbopuffer wurde von unserem Sicherheitsteam sowie von einem externen Auditor genau überprüft, um eine SOC2-Typ-II-Zertifizierung zu erhalten. Erfahre hier mehr über die Sicherheit von Turbopuffer →