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. Quellcode-Verbindungen verwenden die Code Access-Seite (Builder > Code Access), nicht den Managed Connector-Wizard. 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 auf dem Dienst mit Zugriff auf die Repositories oder Projekte, die der Agent lesen sollte.

Für Benachrichtigungsdienste siehe Einen Benachrichtigungsdienst verbinden.

Quellcode-Stecker

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 Sie Repositories, Themen und Pull-Anfragen über Projekte und Organisationen hinweg; Probleme oder Pull Requests mit Genehmigung erstellen
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)	Lese Repositories, Issues und Merge-Anfragen; Erstellen Sie Probleme und Kommentare mit Zustimmung

GitHub und Azure DevOps bieten Authentifizierungsoptionen als Funktasten an. GitLab verwendet einen persönlichen Zugriffstoken.

Schritt 1: Open-Code-Zugriff

1. Wechseln Sie zu sre.azure.com , und wählen Sie Ihren Agenten aus.
2. Öffne in der linken Seitenleiste Builder und wähle dann Code Access 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" öffnet sich mit einem dreistufigen Assistenten: Wähle eine Plattform → Authentifizieren → Repositorien hinzufügen. Klicken Sie nach jedem Schritt auf Weiter. Der letzte Schritt hat eine Speichern-Taste .

GitHub

Benutze Bring your own GitHub App für GitHub Enterprise Cloud oder um den Zugriff nach Organisation oder Installation zu begrenzen.

1. Unter Anmeldemethoden wählen Sie "Bringen Sie Ihre eigene GitHub-App mit.
2. Fülle die vom Wizard angezeigten App-Setup-Felder aus.
3. Wählen Sie Weiteraus.

GitHub Enterprise Cloud (.ghe.com) benötigt eine GitHub-App-Verbindung. Für github.com werden auch Ihr Konto (OAuth, wenn für Ihre Umgebung konfiguriert) oder ein Personal Access Token unterstützt, wobei die GitHub-App-Option für Produktionsszenarien bevorzugt wird, um detailliertere Berechtigungen und Audit-Transparenz zu ermöglichen.

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

Azure DevOps

Nutze Managed Identity für die Produktionsnutzung, wodurch langjährige Zugangsdaten vermieden werden.

1. Unter Anmeldemethoden wählen Sie Managed Identity.
2. 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.
3. Wählen Sie Weiteraus.

Dein Konto (OAuth) und die Authentifizierung des persönlichen Zugangstokens 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. Hier kommt ein GitLab-Personal Access Token (PAT) ins Spiel.
2. Wählen Sie Weiteraus.

Gewähre dem PAT nur die Scopes, die der Agent für Repository-, Ausgabe- und Merge-Anfragen 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. Probleme, Kommentare und Pull-Request-Aktivitäten, die der Agent erstellt, erscheinen unter diesem Konto.

Schritt 3: Repositorien hinzufügen

Der Schritt "Repositories hinzufügen" zeigt eine Tabelle, in der man angibt, welche Repositories der Agent indexiert. Jede Zeile ist ein Repository.

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. In der Spalte Repository-URL wählen Sie ein Repository aus dem Dropdown-Menü aus oder geben Sie direkt eine URL ein. Für GitHub und GitLab listet das Dropdown-Menü die Repositories auf, auf die deine Zugangsdaten zugreifen können. Für Azure DevOps listet es Repositories im ausgewählten Projekt auf.

3. In der Spalte Anzeigename geben Sie einen kurzen Namen ein, den der Agent verwendet, um auf das Repository zu verweisen.

4. Füllen Sie optional die Spalte Beschreibung , um dem Agenten mehr Kontext darüber zu geben, was das Repository enthält.

5. Wenn Ihr Service Azure DevOps ist und das Repository sehr groß ist, aktivieren Sie das Fernkontrollkästchen. Der Agent verwendet KI-gestützte Suche auf der entfernten Kopie, anstatt sie lokal zu klonen. Repositories werden mit einem Festplattenlimit von 100 GB geklont; Das Aktivieren von Remote umgeht diese Beschränkung.

6. Um ein weiteres Repository hinzuzufügen, wählen Sie Hinzufügen und füllen Sie die nächste Zeile aus.

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

Schritt 4: Validiere mit einem Szenario

1. Eröffnen Sie einen Chat mit Ihrem Agenten.

2. Stellen Sie eine gelesene Frage, wie 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.
Create schlägt mit einem Berechtigungsfehler fehl	Der Token oder das Konto hat keinen Schreibbereich	Gewähren Sie dem Token oder Konto den erforderlichen Umfang 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 als Authentifizierungsmethode "Bring your own GitHub App".

Verwandte Inhalte

• Verbinden Sie einen Benachrichtigungsdienst
• Verbinden Sie eine Telemetriequelle
• Einen verwalteten Connector einrichten