Verbinde dein GitHub-Konto mit Goodweek, um Repositorys, Issues, Pull Requests und Workflows direkt aus deinem KI-Arbeitsbereich zu verwalten.
ℹ️ Hinweis zur Governance
Goodweek überschreitet niemals die Zugriffsebenen, die dem Benutzer innerhalb von GitHub gewährt wurden, und gewährleistet so die Einhaltung der Governance-Richtlinien deiner Organisation. Die Ergebnisse und verfügbaren Funktionen können je nach den spezifischen Berechtigungen und dem authentifizierten Zugriff der einzelnen Benutzer variieren.
📋 Voraussetzungen
Bevor Benutzer die GitHub-Integration sehen und verbinden können, muss dein Organisationsadministrator sie zunächst im Goodweek Admin-Panel im Tab Integrationen aktivieren.
Admin-Einrichtung
Die GitHub-Integration nutzt OAuth 2.0 und erfordert für persönliche Repositorys keine Genehmigung auf Administratorebene. Der Zugriff auf GitHub-Organisationsressourcen kann jedoch zusätzliche Schritte erfordern.
⚠️ OAuth-App-Einschränkungen für GitHub-Organisationen
GitHub-Organisationen können einschränken, welche Drittanbieter-OAuth-Apps Zugriff auf Organisationsdaten haben. Wenn deine Organisation OAuth-App-Zugriffsbeschränkungen aktiviert hat, muss ein GitHub-Organisationsinhaber Composio genehmigen, bevor Benutzer auf Organisations-Repositorys und -Ressourcen zugreifen können:
Gehe zu deiner GitHub-Organisation → Einstellungen → Zugriff durch Dritte → OAuth-App-Richtlinie.
Suche die Composio-App und klicke auf Genehmigen, um den Organisationszugriff zu gewähren.
Diese Einschränkung ist bei neuen GitHub-Organisationen standardmäßig aktiviert. Ohne Genehmigung können Benutzer ihr persönliches GitHub-Konto verbinden, jedoch nicht auf Repositorys zugreifen, die der Organisation gehören.
Benutzerverbindung
Gehe in Goodweek zu Integrationen.
Suche GitHub und klicke auf Verbinden.
Du wirst zu GitHub weitergeleitet, wo du aufgefordert wirst, dich anzumelden und den Zugriff zu autorisieren.
Klicke auf Autorisieren, um den Zugriff zu gewähren und zu Goodweek zurückzukehren.
Wichtige Hinweise
Jeder Benutzer muss sein eigenes Konto individuell verbinden.
Goodweek kann nur auf Repositorys und Ressourcen zugreifen, die dein individuelles GitHub-Konto sehen darf.
Der Zugriff auf Repositorys, die der Organisation gehören, erfordert, dass der Organisationsinhaber Composio wie oben beschrieben genehmigt.
Du kannst den Zugriff von Goodweek jederzeit über GitHub → Einstellungen → Anwendungen → Autorisierte OAuth-Apps → Composio → Widerrufen entziehen.
Verfügbare Tools
Tool | Beschreibung | Typ |
Get a Repository | Ruft detaillierte Informationen zu einem bestimmten GitHub-Repository ab. | Lesen |
List Repositories for User | Listet Repositorys für einen angegebenen Benutzer oder den authentifizierten Benutzer auf. | Lesen |
List Organization Repositories | Listet Repositorys für eine angegebene GitHub-Organisation auf. | Lesen |
Search Repositories | Durchsucht GitHub-Repositorys mithilfe der GitHub-Suchsyntax. | Lesen |
Create a Repository | Erstellt ein neues GitHub-Repository für den authentifizierten Benutzer oder die Organisation. | Schreiben |
Get Repository Content | Ruft den Inhalt einer Datei oder eines Verzeichnisses in einem Repository ab. | Lesen |
Create or Update File Contents | Erstellt eine neue Datei oder aktualisiert den Inhalt einer vorhandenen Datei in einem Repository. | Schreiben |
Get an Issue | Ruft ein bestimmtes GitHub-Issue anhand von Repository und Issue-Nummer ab. | Lesen |
List Repository Issues | Listet Issues in einem Repository mit optionaler Filterung nach Status, Labels und Zuweisung auf. | Lesen |
Create an Issue | Erstellt ein neues Issue in einem angegebenen Repository. | Schreiben |
Update an Issue | Aktualisiert Titel, Inhalt, Status, Labels oder Zuweisungen eines vorhandenen Issues. | Schreiben |
Add Labels to an Issue | Fügt einem GitHub-Issue ein oder mehrere Labels hinzu. | Schreiben |
Add Assignees to an Issue | Weist einem GitHub-Issue einen oder mehrere Benutzer zu. | Schreiben |
Create Issue Comment | Fügt einem vorhandenen GitHub-Issue einen Kommentar hinzu. | Schreiben |
List Issue Comments | Listet alle Kommentare zu einem bestimmten GitHub-Issue auf. | Lesen |
Get a Pull Request | Ruft Details zu einem bestimmten Pull Request ab. | Lesen |
List Pull Requests | Listet Pull Requests in einem Repository mit optionaler Filterung nach Status und Branch auf. | Lesen |
Create a Pull Request | Erstellt einen neuen Pull Request von einem Head-Branch zu einem Base-Branch. | Schreiben |
Update a Pull Request | Aktualisiert Titel, Inhalt, Status oder Base-Branch eines Pull Requests. | Schreiben |
Create a Review Comment on a Pull Request | Fügt einer bestimmten Zeile in einem Pull Request einen Review-Kommentar hinzu. | Schreiben |
Merge a Pull Request | Führt einen Pull Request in seinen Base-Branch zusammen. | Schreiben |
List Repository Commits | Listet Commits in einem Repository mit optionaler Filterung nach Autor, Pfad oder Datumsbereich auf. | Lesen |
Get a Commit | Ruft Details zu einem bestimmten Commit anhand seines SHA-Werts ab. | Lesen |
List Repository Branches | Listet Branches in einem angegebenen Repository auf. | Lesen |
Create a Branch | Erstellt einen neuen Branch in einem Repository ausgehend von einem angegebenen SHA-Wert oder Branch. | Schreiben |
Get a Workflow Run | Ruft Details zu einem bestimmten GitHub Actions-Workflow-Lauf ab. | Lesen |
List Workflow Runs for a Workflow | Listet Workflow-Läufe für einen angegebenen Workflow mit optionalem Statusfilter auf. | Lesen |
Re-run a Workflow | Führt alle Jobs eines angegebenen Workflow-Laufs erneut aus. | Schreiben |
Search Code | Durchsucht GitHub-Repositorys nach Code mithilfe der GitHub-Code-Suchsyntax. | Lesen |
Search Issues and Pull Requests | Durchsucht GitHub-Issues und Pull Requests mithilfe der GitHub-Suchsyntax. | Lesen |
Get a User | Ruft öffentliche Informationen zu einem angegebenen GitHub-Benutzer ab. | Lesen |
Get the Authenticated User | Ruft das Profil des authentifizierten GitHub-Benutzers ab. | Lesen |
List Organization Members | Listet Mitglieder einer GitHub-Organisation auf. | Lesen |
Close an Issue | Schließt ein angegebenes GitHub-Issue. | ⚠️ Destruktiv |
Close a Pull Request | Schließt einen angegebenen Pull Request, ohne ihn zusammenzuführen. | ⚠️ Destruktiv |
Delete a File | Löscht eine Datei aus einem Repository. Diese Aktion ist ohne Versionskontrollverlauf unwiderruflich. | ⚠️ Destruktiv |
Anwendungsfälle
Issues direkt aus Unterhaltungen erstellen und verwalten. Erfasse neue GitHub-Issues mit Titel, Beschreibung, Labels und Zuweisungen direkt aus einer Goodweek-Unterhaltung – praktisch, um Bugs oder Feature-Anfragen festzuhalten, ohne zu GitHub zu wechseln.
Pull Requests und Commit-Verlauf überprüfen. Rufe PR-Details ab, liste aktuelle Commits auf oder überprüfe den Status eines Workflow-Laufs aus Goodweek heraus, um über die Repository-Aktivität auf dem Laufenden zu bleiben.
Code und Issues repositoryübergreifend durchsuchen. Nutze die GitHub-Suchsyntax direkt in Goodweek, um bestimmten Code, Issues oder PRs in deinen Repositorys zu finden, ohne die GitHub-Oberfläche zu öffnen.
Dateien in Repositorys erstellen und aktualisieren. Lies Dateiinhalte oder übertrage kleine Dateiaktualisierungen direkt aus Goodweek heraus – praktisch, um Dokumentation, Konfigurationsdateien oder README-Inhalte zu aktualisieren.
Fehlerbehebung
Verbindung erfolgreich, aber Organisations-Repositorys fehlen
Deine GitHub-Organisation hat OAuth-App-Zugriffsbeschränkungen aktiviert. Ein GitHub-Organisationsinhaber muss Composio über die Organisationseinstellungen → Zugriff durch Dritte → OAuth-App-Richtlinie genehmigen.
Integration in Goodweek nicht sichtbar
Stelle sicher, dass dein Organisationsadministrator die GitHub-Integration im Goodweek Admin-Panel im Tab Integrationen aktiviert hat.