Verbinden Sie einen Quellcode-Dienst

Geben Sie Ihrem Agenten Zugriff auf Repository-, Issue- und Pull-Request-Kontext für Untersuchungen. Es kann aktuelle Änderungen lesen, verwandte Probleme finden und ein Problem oder eine Pull Request im richtigen Repository oder Projekt öffnen, wenn die von dir angegebene Zugangsberechtigung es erlaubt.

Dieses Tutorial behandelt GitHub, Azure DevOps und GitLab. Quellcodeverbindungen verwenden die Seite Codezugriff (Erstellen und einrichten > Kontext > Codezugriff), nicht den Assistenten für verwaltete Konnektoren. Dieser Artikel konzentriert sich auf Details zum Quellcode: wie sich jeder Dienst authentifiziert und wie die Verbindung validiert wird.

Voraussetzungen

• Ein laufender SRE-Agent und Zugang zu sre.azure.com.
• Berechtigung zur Konfiguration des Agenten.
• Ein Konto für den Dienst mit Zugriff auf die Repositorys oder Projekte, die der Agent lesen soll.

Für Benachrichtigungsdienste siehe Einen Benachrichtigungsdienst verbinden.

Quellcode-Konnektoren

Konnektor	Dienst	Authentication	Typische Nutzung
GitHub	GitHub und GitHub Enterprise Cloud	Bring-your-own-GitHub App (OAuth und PAT werden für github.com ebenfalls unterstützt)	Lesen von Repositorys, Issues und Pull Requests über Projekte und Organisationen hinweg; Erstellen von Issues oder Pull Requests mit Genehmigung
Azure DevOps	Azure DevOps	Verwaltete Identität (OAuth und PAT ebenfalls unterstützt)	Lesen Sie Repositories und Pull-Anfragen über Projekte hinweg; Erstellen Sie Pull Requests oder Arbeitselemente mit Genehmigung
GitLab	GitLab	Persönliches Zugriffstoken (Personal Access Token, PAT)	Lesen von Repositorys, Issues und Merge Requests; Erstellen von Issues und Kommentaren mit Genehmigung

GitHub und Azure DevOps bieten Authentifizierungsoptionen als Optionsfelder an. GitLab verwendet ein persönliches Zugriffstoken.

Schritt 1: Codezugriff öffnen

1. Wechseln Sie zu sre.azure.com , und wählen Sie Ihren Agenten aus.
2. Wählen Sie in der linken Seitenleiste Build + setupKontext>> aus.
3. Wählen Sie den Tab für Ihren Service (GitHub, Azure DevOps oder GitLab).
4. Wählen Sie "Repository hinzufügen" aus.

Schritt 2: Authentifizieren

Der Dialog „Repositories hinzufügen“ besteht aus zwei Schritten: Verbindung und Repositories hinzufügen. Bei Connection wählen Sie die Plattform aus und geben Sie deren Repository-URL oder Organisation ein, bevor Sie die Authentifizierung konfigurieren. Wählen Sie nach der Verbindung Weiter und dann im letzten Schritt Speichern.

GitHub

Wählen Sie Ihre GitHub-App verwenden für GitHub Enterprise Cloud oder zum Begrenzen des Zugriffs nach Organisation oder Installation.

1. Geben Sie eine vollständige Repository-URL ein, wie z. B. https://github.com/owner/repo.
2. Wenn passende Anmeldedaten vorhanden sind, wählen Sie Bestehende Verbindung zur Wiederverwendung oder Neue Verbindung zur Konfiguration einer weiteren Verbindung.
3. Wählen Sie unter Verbindungsmethode die Option Ihre GitHub-App verwenden aus.
4. Fülle die vom Wizard angezeigten App-Setup-Felder aus.
5. Wählen Sie Verbinden und bestätigen Sie, dass die Verbindung erfolgreich hergestellt wurde.
6. Wählen Sie Weiteraus.

GitHub Enterprise Cloud (.ghe.com) benötigt eine GitHub-App-Verbindung. Für github.com werden auch OAuth und Personal Access Token (PAT) unterstützt. Die GitHub-App-Authentifizierung erfordert eine RSA Key Vault-Schlüssel-URI (/keys/), keine Secret-URI. Siehe GitHub BYO App einrichten.

Nach der Verbindung kann der Agent Repositories, Issues und Pull Requests in Projekten und Organisationen durchsuchen, auf die Ihre App oder Ihr Konto Zugriff hat.

Azure DevOps

Nutze Managed Identity für die Produktionsnutzung, wodurch langlebige Zugangsdaten vermieden werden.

1. Geben Sie den Namen der Azure DevOps Organisation ein.
2. Unter Anmeldemethoden wählen Sie Managed Identity.
3. Füllen Sie die vom Wizard angezeigten Felder aus und stellen Sie sicher, dass die verwaltete Identität des Agenten Zugriff auf die Azure DevOps-Projekte und -Repositories hat, die der Agent benötigt.
4. Wählen Sie Verbinden und vergewissern Sie sich, dass die Verbindung erfolgreich hergestellt wurde.
5. Wählen Sie Weiteraus.

Dein Konto (OAuth) und PAT-Authentifizierung werden ebenfalls unterstützt, sind aber am besten für Entwicklung, Tests oder Szenarien geeignet, in denen die verwaltete Identität nicht verwendet werden kann. Verwenden Sie die engste Identität oder das Token, das die Projekte und Repositories lesen kann, die der Agent benötigt.

Nach der Verbindung kann der Agent Repositories durchsuchen, Pull Requests lesen und Arbeitsobjekte in deinen Projekten inspizieren.

GitLab

1. Geben Sie ein GitLab Personal Access Token (PAT) ein.
2. Wählen Sie Weiteraus.

Gewähre dem PAT nur die Scopes, die der Agent für Repository-, Issue- und Merge-Request-Zugriff benötigt.

Nach der Verbindung kann der Agent Repositories, Issues und Merge-Anfragen innerhalb von Projekten, auf die das Token Zugriff hat, lesen.

Der Dienst sieht die Identität, die die Verbindung autorisiert hat. Issues, Kommentare und Pull-Request-Aktivitäten, die der Agent erstellt, erscheinen unter diesem Konto.

Schritt 3: Repositorien hinzufügen

Überprüfen Sie die hinzuzufügenden Repositories. Für GitHub erweitern Sie jedes Repository, um dessen Anzeigenamen und Beschreibung zu bearbeiten. Für Azure DevOps und GitLab bearbeiten Sie diese Felder direkt in der Tabelle.

1. Wenn Ihr Service Azure DevOps ist, wählen Sie zuerst ein project aus dem Azure DevOps Project Dropdown-Menü aus. Die Spalte Repository-URL wird mit Repositories in diesem Projekt gefüllt.

2. Überprüfen Sie die ursprüngliche URL des Repositorys. Für weitere Einträge wählen Sie ein Repository aus dem Dropdown-Menü aus oder geben Sie direkt eine URL ein. Für Azure DevOps wählen Sie zuerst das Projekt aus.

3. Geben Sie einen kurzen Anzeigenamen ein, den der Agent verwendet, um auf das Repository zu verweisen. Für GitHub erweitern Sie den Eintrag, um dieses Feld zu finden.

4. Geben Sie optional eine Beschreibung ein, um dem Agenten mehr Kontext zum Repository zu geben. Für GitHub wählen Sie zuerst Beschreibung hinzufügen.

5. Wenn Ihre Azure DevOps-Umgebung eine Remote-Option anbietet, können Sie sie für KI-gestützte Suche nutzen, ohne das vollständige Repository klonen zu müssen. Diese Option ist nicht in jeder Umgebung verfügbar.

6. Um ein weiteres Repository hinzuzufügen, wählen Sie Repository hinzufügen für GitHub oder Hinzufügen im Azure DevOps- oder GitLab-Raster aus. Zusätzliche GitHub-Repositories in dieser Verbindung verwenden denselben Host und dieselbe Zugangsberechtigung.

7. Wenn die Tabelle fertig ist, wählen Sie Speichern.

Schritt 4: Validiere mit einem Szenario

1. Öffnen Sie einen Chat mit Ihrem Agent.

2. Stellen Sie eine Frage zum Lesen, zum Beispiel:

   List the open issues in the payments repository from the last week.
   

3. Überprüfen Sie die Toolcard, um zu sehen, wie der Agent den Dienst durchsucht und Ergebnisse zurückgibt, die auf Ihren Daten basieren.

Wenn Ergebnisse erscheinen, die auf Ihr Repository verweisen, funktioniert die Verbindung von Anfang bis Ende.

Troubleshooting

Problem	Ursache	Beheben
Suche gibt keine Ergebnisse zurück.	Das Konto hat keinen Zugriff auf das Projekt oder das Repository	Bestätigen Sie, dass das Verbindungskonto das Projekt oder Repository sehen kann, und versuchen Sie es dann erneut.
Erstellen schlägt mit einem Berechtigungsfehler fehl	Der Token oder das Konto hat keine Schreibberechtigung	Gewähren Sie dem Token oder Konto den erforderlichen Scope oder verwenden Sie Zugangsdaten mit Schreibzugriff.
GitHub Enterprise Cloud lehnt die Verbindung ab	GitHub Enterprise Cloud erfordert eine GitHub-App-Verbindung	Auf der Code-Access-Seite trennen Sie die GitHub-Verbindung, wählen Sie Repository hinzufügen, wählen Sie GitHub, geben Sie Ihren .ghe.com Host ein und wählen Sie Bring your own GitHub App als Authentifizierungsmethode.

Verwandte Inhalte

• Benachrichtigungsdienst verbinden
• Telemetriequelle verbinden
• Einen verwalteten Connector einrichten