# GitHub-Agent ### Was können Sie tun? Sobald verbunden, können Sie mit dem GitHub Agenten: * **Repositories durchsuchen**: Ihre persönlichen und Organisations-Repositories auflisten und erkunden, Dateien und Branches anzeigen * **Pull Requests verwalten**: Pull Requests auflisten, prüfen und erstellen – einschließlich Anzeigen von Kommentaren, Reviews und Commit-Verlauf * **Issues bearbeiten**: Issue-Assignees und Labels in Ihren Projekten verwalten * **Workflows überwachen**: GitHub Actions CI/CD-Workflows auflisten, auslösen und verfolgen * **Code durchsuchen**: Bestimmten Code in Ihren Repositories und Organisationen finden ### Schnelle Einrichtung #### Schritt 1: GitHub Agent auswählen Klicken Sie in einem beliebigen Blockbrain-Chat auf das Dropdown zur Auswahl von KI-Modellen. Klicken Sie auf **Detaillierte Liste der KI-Modelle anzeigen**. Suchen und klicken Sie auf **GitHub Agent**. Suchen Sie nach **Konfigurieren** in der Spalte Status. #### Schritt 2: Mit GitHub verbinden Klicken Sie auf **Konfigurieren**. Klicken Sie auf die **Verbinden** Schaltfläche. Melden Sie sich bei Aufforderung mit Ihrem GitHub-Konto an. Überprüfen Sie die von Blockbrain angeforderten Berechtigungen und klicken Sie auf **Autorisieren** um den Zugriff zu gewähren. #### Schritt 3: GitHub verwenden Sie sind bereit! Jetzt können Sie Blockbrain bitten, bei Ihren Repositories, Pull Requests, Issues und Workflows zu helfen. ### Was Sie fragen können #### Repositories durchsuchen ``` „Liste alle meine GitHub-Repositories auf“ „Zeige mir die Repositories in unserer Organisation“ „Welche Branches gibt es im Hauptprojekt-Repo?“ „Zeige mir den Inhalt der README-Datei im docs-Repo“ ``` #### Pull-Request-Verwaltung ``` „Liste alle offenen Pull Requests im backend-Repo auf“ „Zeige mir die Review-Kommentare zu PR #42“ „Wie sieht die Commit-Historie für PR #15 aus?“ „Erstelle einen Pull Request von feature-branch nach main“ ``` #### Issue-Assignees und Labels ``` „Wer kann in den frontend-Repo-Issues zugewiesen werden?“ „Weise das Login-Bug-Issue Maria zu“ „Füge dem Issue #7 das Label 'urgent' hinzu“ „Entferne das Label 'wontfix' von Issue #12“ ``` #### Workflow-Überwachung ``` „Welche CI/CD-Workflows sind im backend-Repo eingerichtet?“ „Zeige mir die letzten Workflow-Läufe für die Deploy-Pipeline“ „Wie ist der Status des neuesten Builds?“ „Starte den Staging-Deployment-Workflow“ ``` #### Code-Suche ``` „Suche nach 'authentication' in all unseren Repositories“ „Finde, wo die API-Schlüsselvalidierung implementiert ist“ „Suche im backend-Repo nach Dateien mit 'database migration'“ ``` ### So funktioniert es **Ihr Konto = der Zugriff von Blockbrain** * Blockbrain verwendet Ihre GitHub-Berechtigungen – Sie können nur auf Repositories und Daten zugreifen, auf die Sie normalerweise Zugriff haben * Aktionen wie das Erstellen von Pull Requests oder das Auslösen von Workflows werden unter Ihrer GitHub-Identität ausgeführt **Intelligente Unterstützung** * Die KI hilft dabei, komplexe Repositories zu navigieren und relevante Informationen schnell zu finden * Versucht es automatisch erneut, wenn eine Anfrage fehlschlägt, und passt bei Bedarf Parameter an * Bestätigt Aktionen vor der Ausführung von Schreibvorgängen wie dem Erstellen von PRs oder dem Auslösen von Workflows ### Tipps für bessere Ergebnisse #### Repository-Tipps * Seien Sie konkret, welches Repository gemeint ist: *„Liste PRs im **backend** Repo auf“* statt einfach *„Liste PRs auf“* * Geben Sie bei Bedarf den Organisationsnamen an: *„Zeige Repos in der **acme-corp** Organisation“* * Geben Sie Branches an, wenn relevant: *„Zeige mir den Inhalt von config.yaml auf dem **develop** Branch“* #### Pull-Request-Tipps * Geben Sie die PR-Nummer an, wenn Sie nach einem bestimmten PR fragen: *„Zeige Kommentare zu **PR #42**"* * Nennen Sie das Repository: *„Erstelle einen PR im **frontend-Repo** von feature-login nach main“* * Geben Sie an, was Sie sehen möchten: *„Zeige mir die **Reviews** für PR #15“* vs. *„Zeige mir die **Commits** für PR #15“* #### Workflow-Tipps * Nennen Sie den Workflow: *„Löse den **deploy-staging** Workflow aus“* * Fragen Sie mit Kontext nach dem Status: *„Wie ist der Status der **letzten 5 Läufe** der CI-Pipeline?“* * Der Agent prüft die Workflow-Eingaben vor dem Auslösen und bittet um Ihre Bestätigung ### Fehlerbehebung #### „Meine Repositories werden nicht angezeigt“ * Prüfen Sie, ob Sie direkt auf GitHub auf das Repository zugreifen können * Überprüfen Sie, ob Ihre GitHub-Verbindung in den Agent-Einstellungen aktiv ist * Versuchen Sie, die Verbindung erneut herzustellen, indem Sie auf **Konfigurieren** erneut #### „Zugriff verweigert“-Fehler * Ihre GitHub-Berechtigungen umfassen möglicherweise die angeforderte Aktion nicht * Einige Organisationen erfordern eine Admin-Freigabe für OAuth-Apps — wenden Sie sich an den GitHub-Organisationsadministrator * Stellen Sie sicher, dass Sie mit dem richtigen GitHub-Konto verbunden sind #### „Workflow-Auslösung fehlgeschlagen“ * Stellen Sie sicher, dass der Workflow manuelles Auslösen unterstützt (`workflow_dispatch` -Trigger) * Prüfen Sie, ob Sie die Berechtigung haben, Workflows im Repository auszulösen * Stellen Sie sicher, dass die erforderlichen Eingaben für den Workflow korrekt angegeben sind #### „Code oder Dateien nicht gefunden“ * Versuchen Sie es mit spezifischeren Suchbegriffen * Überprüfen Sie, ob das Repository existiert und ob Sie Zugriff darauf haben * Prüfen Sie, ob der Dateipfad oder der Branch-Name korrekt ist ### Datenschutz und Sicherheit #### Was Blockbrain tun kann * Ihre Repositories, Branches und den Dateiinhalt lesen * Pull Requests in Ihrem Namen auflisten und erstellen * Issue-Assignees und Labels anzeigen und verwalten * GitHub Actions-Workflows auflisten und auslösen * Code in Ihren zugänglichen Repositories durchsuchen #### Was Blockbrain nicht tun kann * Auf private Repositories zugreifen, für die Sie keine Berechtigung zum Anzeigen haben * Repositories, Branches oder Dateien löschen * Repository-Einstellungen, Webhooks oder GitHub-Apps ändern * Auf private Daten oder Repositories anderer Benutzer zugreifen * Organisationsweite Zugriffsbeschränkungen umgehen #### Sicherheitsfunktionen * Pull Requests und Aktionen werden unter Ihrer GitHub-Identität ausgeführt * Workflow-Auslösungen erfordern Ihre ausdrückliche Bestätigung * Sie können den Zugriff jederzeit in den GitHub-Agent-Einstellungen widerrufen ### Häufige Anwendungsfälle #### Entwicklungs-Workflow * **PR-Reviews**: Prüfen Sie schnell den Status und das Feedback zu Ihren Pull Requests * **Code-Erkundung**: Finden Sie Implementierungen oder Muster in mehreren Repositories * **Branch-Verwaltung**: Branches anzeigen und Referenzen für neue Features erstellen #### Projektüberblick * **Repositories durchsuchen**: Navigieren Sie durch Organisations-Repos und verstehen Sie die Projektstruktur * **Issue-Verwaltung**: Weisen Sie Teammitglieder Issues zu und organisieren Sie die Arbeit mit Labels * **CI/CD-Überwachung**: Verfolgen Sie Build- und Bereitstellungsstatus über Workflows hinweg #### Teamzusammenarbeit * **Pull-Request-Erstellung**: Erstellen Sie PRs mit den richtigen Basis- und Head-Branches * **Review-Nachverfolgung**: Sehen Sie, wer was geprüft hat und welches Feedback gegeben wurde * **Workflow-Automatisierung**: Lösen Sie Bereitstellungen oder Testläufe direkt aus dem Chat aus ### Beispieldialog **Sie:** „Zeige mir alle offenen Pull Requests im backend-Repository“ **Blockbrain:** „Hier sind die offenen Pull Requests im backend-Repository: | # | Titel | Autor | Status | | ------ | ------------------------------------------------- | ----- | --------------------------------- | | PR #42 | Benutzer-Authentifizierungs-Middleware hinzufügen | sarah | 2 Reviews, Änderungen angefordert | | PR #38 | Datenbank-Migrationsskripte aktualisieren | tom | 1 Review, genehmigt | | PR #35 | Rate Limiting für API-Endpunkte beheben | maria | Wartet auf Review | Möchten Sie Details, Reviews oder Kommentare zu einem davon sehen?“ **Sie:** „Zeige mir die Reviews für PR #42“ **Blockbrain:** „PR #42 hat 2 Reviews: 1. **John** (Änderungen angefordert): 'Die Middleware sieht insgesamt gut aus, aber die Token-Validierung sollte abgelaufene Tokens elegant behandeln. Siehe meine Inline-Kommentare in auth.ts.' 2. **Lisa** (Kommentiert): 'Toller Ansatz! Ein Vorschlag — könnten wir auch Rate Limiting für den Auth-Endpunkt hinzufügen?' Möchten Sie, dass ich den Commit-Verlauf oder die Inline-Kommentare zeige?“ ### Nächste Schritte Möchten Sie weitere Dienste verbinden? Probieren Sie die [Salesforce-Agent](/de/fur-nutzer/agenten/salesforce-agent.md) um Ihre Leads, Kontakte und Konten direkt über Blockbrain zu verwalten. --- # Agent Instructions: 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: ``` GET https://docs.en.theblockbrain.ai/de/fur-nutzer/agenten/github-agent.md?ask= ``` The question should be specific, self-contained, and written in natural language. 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.