GitHub-KI-Konnektor

Wer kann GitHub mit Notion-KI 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 der GitHub-KI-Konnektor für den Workspace eingerichtet ist, können Mitglieder die Einbindung verwenden, um Antworten abzurufen.

• Öffentliche Repositories: Nach der Ersteinrichtung des Konnektors durch einen Besitzer oder eine Besitzerin ist keine zusätzliche Authentifizierung erforderlich.

• Private Repositories: Jedes Mitglied muss sich bei GitHub anmelden/authentifizieren, um den Zugriff zu verifizieren.

Wie verbinde ich GitHub?

Es gibt zwei Möglichkeiten, GitHub mit Notion-KI zu verbinden. Um die GitHub-Organisation zu verbinden, musst du Workspace-Besitzer/-in und GitHub-Besitzer/-in sein. Um private Repositorys zu verbinden, reicht es Mitglied eines Workspaces sein.

Wenn du Besitzer/-in eines Notion-Workspace und GitHub-Besitzer/-in bist:

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.

Wenn du Mitglied eines Notion-Workspaces bist:

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.

Sobald der KI-Konnektor für den Workspace eingerichtet wurde, kann er Code, PRs, Issues, Dateien und READMEs indizieren.

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.

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.

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?“