Azure DevOps-Connector im Azure SRE-Agent

Verbinden Sie Azure DevOps, damit Ihr Agent Ihren Code durchsuchen, Arbeitsaufgaben erstellen und Ihr Wiki als Wissensquelle indizieren kann.

Tipp

Schnelle Übersicht

  • Zwei Connectortypen: Azure DevOps OAuth für Livecode und Arbeitsaufgaben, Dokumentationsconnector für Wiki-Wissen.
  • OAuth unterstützt Benutzerkonten (Microsoft Entra ID) und verwaltete Identitätsauthentifizierung .
  • Ein einzelner Connector deckt Ihre gesamte Azure DevOps-Organisation ab, einschließlich aller Projekte und Repositorys.
  • Wiki-Inhalte werden für die semantische Suche indiziert und alle 24 Stunden automatisch synchronisiert.

Zwei Verbindertypen

Azure DevOps verfügt über zwei Connectortypen, da sie unterschiedlichen Zwecken dienen.

Konnektor Was es tut Authentifizierungsoptionen
Azure DevOps OAuth Live-Quellcodezugriff, Arbeitsaufgaben, Pipelines, Semantikcodesuche Benutzerkonto (OAuth) oder verwaltete Identität
Dokumentationskonnektor Indiziert Wiki-Seiten und Dokumente in einer durchsuchbaren Wissensbasis Verwaltete Identität oder PAT

Sie können beides zusammen verwenden. Verwenden Sie den OAuth-Connector für Live-Codeuntersuchungen und den Dokumentationsconnector für wiki-basierte Kenntnisse.

Azure DevOps OAuth-Konnektor

Der OAuth-Connector bietet Ihrem Agent live Zugriff auf Quellcode, Arbeitsaufgaben und Pipelines in Ihrer gesamten Azure DevOps-Organisation.

Authentifizierungstypen

Wählen Sie die Authentifizierungsmethode aus, die den Anforderungen Ihres Teams entspricht.

Methode So funktioniert es Am besten geeignet für:
Benutzerkonto Melden Sie sich mit Ihrem Microsoft Entra ID-Konto an. Der Agent greift über Ihre Berechtigungen auf Azure DevOps zu. Die Tokens werden automatisch aktualisiert. Das interaktive Setup wird für die meisten Benutzer empfohlen.
Verwaltete Identität Verwenden Sie die verwaltete Identität des Agents, um sich zu authentifizieren. Unterstützt Verbundidentitätsanmeldeinformationen (Federated Identity Credentials, FIC) für den mandantenübergreifenden Zugriff. Automatisierte Einrichtung, Dienstkonten, mandantenübergreifender Zugriff

Tipp

OAuth-Token werden automatisch aktualisiert

Azure DevOps OAuth-Token laufen nach ungefähr einer Stunde ab, aber Ihr Agent aktualisiert sie automatisch vor ablaufen mithilfe eines 5-Minuten-Puffers. Jede Aktualisierung generiert ein neues Aktualisierungstoken, wodurch eine selbsterhaltende Erneuerungskette erstellt wird. Ihr Konnektor bleibt auch nach mehrstündigen Untersuchungen verbunden, ohne dass eine manuelle Neuauthentifizierung erforderlich ist.

Wenn Sie erneut authentifizieren müssen: Wenn das Aktualisierungstoken abläuft (die Lebensdauer variiert je nach Microsoft Entra-ID-Richtlinie), wenn ein Administrator die App-Autorisierung widerruft oder Wenn Sie Ihren Connector vor Version 26.2.247.0 einrichten (eine erneute Authentifizierung aktiviert autorefresh in Zukunft).

Was der Agent tun kann

Der OAuth-Connector bietet Ihrem Agent die folgenden Funktionen.

Quellcodeanalyse:

  • Durchsuchen Sie Code für alle Repositorys in Ihrer Organisation mithilfe der Azure DevOps Search-API.
  • Dateiinhalte nach Pfad und Verzweigung lesen.
  • Korrelieren von Azure-Ressourcenfehlern mit Quellcode-Standorten (mit Konfidenzpunktzahl).
  • Führen Sie semantische Codesuchen durch, um Code im Zusammenhang mit einem Vorfall mithilfe natürlicher Sprache zu finden.

Verwaltung von Arbeitsaufgaben:

  • Erstellen Sie Arbeitsaufgaben (Task, Bug, Epic, Feature) mit Bereichspfad, Iteration, Priorität und Schweregrad.
  • Verknüpfen Sie Arbeitsaufgaben mit Azure-Ressourcen, um die Rückverfolgbarkeit zu verbessern.

Repositoryzuordnung:

  • Suchen und Verknüpfen von Azure Repos mit Azure-Ressourcen.
  • Identifizieren von Infrastructure-as-Code-Dateien (Bicep, Terraform, ARM-Vorlagen) in verknüpften Repositories.

Dokumentations-Connector (Wiki-Wissen)

Indizieren Sie Ihre Azure DevOps-Wiki-Seiten, damit Ihr Agent sie während untersuchungen durchsuchen kann. Wenn Ihr Agent auf ein Problem stößt, durchsucht er Ihr indiziertes Wiki nach relevanten Anleitungen zur Fehlerbehebung, Architekturdokumenten und Runbooks.

So funktioniert es

Der Dokumentationsconnector verarbeitet Ihre Wiki-Inhalte mithilfe der folgenden Schritte:

  1. Durchforstet alle Seiten aus Ihrer angegebenen Azure DevOps-Wiki-URL (oder einem bestimmten Unterabschnitt).
  2. Teilt und bettet Dokumentinhalte in einen Vektorsuchindex ein.
  3. Semantische Suche - während Untersuchungen findet Ihr Agent relevante Passagen und zitiert die ursprüngliche Wiki-Seite.
  4. Synchronisiert alle 24 Stunden automatisch, um Wiki-Updates aufzunehmen.

Unterstützte Inhalte

Der Dokumentationsconnector unterstützt die folgenden Inhaltstypen:

  • Wiki-Seiten (Azure DevOps Wiki-Format)
  • Git-Repositorydateien einschließlich 15 unterstützter Formate: .md, .txt, .rst, .adoc, .asciidoc, .wiki, .textile, .org, .htm, .html, .json, .yaml, .yml, .xml, .csv
  • Bereichsindizierung, die auf eine Unterseite verweist, um nur einen bestimmten Abschnitt Ihres Wikis zu indizieren

Erste Schritte

Verwenden Sie die folgenden Ressourcen, um Ihren Azure DevOps-Connector einzurichten.

Ressource Was Sie lernen
Quellcode verbinden Schrittweise Anleitung zum Verbinden von GitHub- und Azure DevOps-Repositorys
Einrichten eines Azure DevOps-Connectors Detailliertes Lernprogramm für Azure DevOps-Connector

Nächster Schritt

Einrichten eines Azure DevOps-Connectors

Verwandte Inhalte

  • Last updated on