Hinweis
Für den Zugriff auf diese Seite ist eine Autorisierung erforderlich. Sie können versuchen, sich anzumelden oder das Verzeichnis zu wechseln.
Für den Zugriff auf diese Seite ist eine Autorisierung erforderlich. Sie können versuchen, das Verzeichnis zu wechseln.
Verbinden Sie Ihre Azure DevOps-Wikis, damit Ihr Agent während der Untersuchungen auf die Runbooks und Verfahren Ihres Teams verweist. Wiki-Inhalte sind indiziert und durchsuchbar, und Ihr Agent findet automatisch die richtige Seite. Der Connector unterstützt sowohl die verwaltete Identitäts- als auch die PAT-Authentifizierung .The connector supports both managed identity and personal access token (PAT) authentication.
Das Problem: Wissen wird bei Vorfällen nicht verwendet
Ihr Team investiert Hunderte von Stunden zum Schreiben von Runbooks, Anleitungen zur Problembehandlung und betriebstechnischen Verfahren in Azure DevOps-Wikis. Aber wenn ein Vorfall um 3 Uhr morgens auftritt, sucht niemand im Wiki nach Informationen. Der Bereitschaftstechniker öffnet ein Dutzend Registerkarten, überprüft Azure Monitor und findet entweder aus dem Gedächtnis heraus eine Lösung oder eskaliert. Die Dokumentation, die genau für diese Situation geschrieben wurde, bleibt unberührt.
Das Wissen ist vorhanden. Das Problem ist der Zugriff - nicht auf das Wiki, sondern auf die richtige Seite zur richtigen Zeit, im Kontext des tatsächlichen Problems.
Wie der SRE-Agent dieses Problem löst
Verbinden Sie Ihr Azure DevOps-Wiki einmal, und Ihr Agent durchsucht es während jeder Untersuchung automatisch:
- Indiziert Ihre Wiki-Seiten – Durchforstet und indiziert alle Seiten aus Ihrem Azure DevOps-Wiki.
- Sucht kontextbezogen – Wenn Sie eine Frage stellen oder ein Vorfall ausgelöst wird, durchsucht Ihr Agent Ihr Wiki zusammen mit anderen Wissensquellen.
- Verweise auf bestimmte Seiten – Antworten enthalten Zitate, die mit der ursprünglichen Wiki-Seite verknüpft sind.
- Erfasst Aktualisierungen — Verbinden Sie den Connector erneut oder erneuern Sie ihn, um neue Wiki-Inhalte erneut zu indizieren.
Vor und nachher
| Szenario | Vorher | Nach |
|---|---|---|
| Reaktion auf Vorfälle | Anrufperson durchsucht kein Wiki während Vorfällen | Ihr Agent durchsucht automatisch wiki für jede Abfrage |
| Wissenszugang | Wissen im Wiki wird um 3:00 Uhr nicht verwendet | Runbooks werden genau dann bereitgestellt, wenn sie benötigt werden. |
| Einarbeitung | Neue Teammitglieder wissen nicht, welche Wiki-Seite überprüft werden soll | Ihr Agent findet die relevante Seite unabhängig von der Erfahrung |
| Suchqualität | Für die Wiki-Suche ist es erforderlich, die richtigen Schlüsselwörter zu kennen | Ihr Agent versteht kontextbezogene Inhalte und findet verwandte Inhalte |
Was macht dies anders
Im Gegensatz zu statischen Dateiuploads bleibt Ihr Wiki lebendig. Wenn Ihr Team ein Runbook in Azure DevOps aktualisiert, nimmt Ihr Agent die Änderungen auf. Dateien müssen nicht erneut hochgeladen werden.
Im Gegensatz zur Volltext-Wiki-Suche versteht Ihr Agent den Kontext. Es stimmt nicht mit Schlüsselwörtern überein. Stattdessen korreliert sie Ihre Frage mit relevanten Wiki-Inhalten, kombiniert sie mit Live-Telemetrie aus Azure Monitor, Protokollen aus Kusto und anderen verbundenen Quellen.
Im Gegensatz zum externen MCP-basierten Wiki-Zugriff erfordert der integrierte Dokumentationsconnector keine externe Servereinrichtung. Sie stellen die Wiki-URL und Authentifizierung bereit, und Ihr Agent verarbeitet den Rest.
So funktioniert es
Der Dokumentationsconnector (Azure DevOps Diensttyp) durchforstet Ihre Wiki-Seiten und indiziert sie für die Suche. Wenn Ihr Agent eine Abfrage empfängt, durchsucht er den indizierten Inhalt zusammen mit anderen Wissensquellen, z. B. hochgeladene Dateien, Webseiten und verbundene Repositorys.
Der Connector unterstützt zwei Arten von Azure DevOps-Inhalten:
| Inhaltstyp | URL-Muster | Was indiziert wird |
|---|---|---|
| Wiki | https://dev.azure.com/{org}/{project}/_wiki/wikis/{wiki-name} |
Alle Wiki-Seiten (Markdown) |
| Wiki (bereichsspezifisch) | .../_wiki/wikis/{wiki-name}/{pageId}/Page-Name |
Bestimmte Seite und deren Unterseiten |
| Git-Repository | https://dev.azure.com/{org}/{project}/_git/{repo} |
Textdateien (Markdown, Dokumente, Code) |
| Legacywiki | https://{org}.visualstudio.com/{project}/_wiki/wikis/{wiki-name} |
Identisch mit oben (Legacy-URL-Format) |
Hinweis
Wenn Sie eine Seiten-ID in die Wiki-URL einschließen, indiziert der Connector nur diese Seite und seine Unterseiten. Dieser Ansatz eignet sich für bestimmte Abschnitte wie /Operations oder /Runbooks ohne Indizierung des gesamten Wikis.
Funktionsweise der Synchronisierung von Dokumentationen
Sobald die Verbindung hergestellt wurde, hält Ihr Agent Ihren Dokumentationsindex automatisch auf dem neuesten Stand. Sie müssen nichts manuell erneut hochladen.
| Aspekt | Einzelheiten |
|---|---|
| Synchronisierungshäufigkeit | Automatisches Crawling alle 24 Stunden |
| Unterstützte Formate |
.md, .txt, , .rst, .adoc, .asciidoc, .wiki.textile, .org, , .htm, , .html, .json.yaml.yml.xml( .csv 15 Dateiformate) |
| Indizierungsprozess | Dokumente werden für die semantische Suche unterteilt, eingebettet und indiziert. |
| Updates | Änderungen in Ihrem Repository werden im nächsten Synchronisierungszyklus aufgenommen, ohne dass eine manuelle Aktion erforderlich ist. |
Ihr Agent verarbeitet jedes Dokument, indem es in semantisch sinnvolle Blöcke aufgeteilt, Vektoreinbettungen generiert und in einem Suchindex gespeichert wird. Wenn eine Abfrage eintrifft, führt Ihr Agent eine semantische Suche über alle indizierten Abschnitte aus und ruft die relevantesten Passagen ab, unabhängig von genauen Schlüsselwortüberstimmungen.
Ihr Team kann Runbooks aktualisieren, neue Prozeduren hinzufügen oder Wiki-Seiten neu organisieren, und Ihr Agent spiegelt diese Änderungen innerhalb von 24 Stunden wider.
Voraussetzungen
| Anforderung | Einzelheiten |
|---|---|
| Azure DevOps-Wiki | Ein Wiki in Ihrem Azure DevOps-Projekt mit Inhalt |
| Authentifizierung | Verwaltete Identität (empfohlen) oder persönliche Zugriffstoken (PAT) |
| Erlaubnisse | Lesezugriff auf das Wiki |
Authentifizierungsoptionen
In der folgenden Tabelle werden die verfügbaren Authentifizierungsmethoden für den Azure DevOps-Wiki-Connector beschrieben.
| Methode | Am besten geeignet für: | So funktioniert es |
|---|---|---|
| Verwaltete Identität | Produktionsumgebungen | Verwendet die vom System zugewiesene oder vom Benutzer zugewiesene verwaltete Identität Ihres Agents. Erfordert das Hinzufügen der Identität als Benutzer in Ihrer Azure DevOps-Organisation. |
| Persönliches Zugriffstoken (PAT) | Schnelleinrichtung, Tests | Generieren Sie einen PAT in Azure DevOps mit Codebereich (Lesebereich). |
Beispiel: Verwenden eines Runbook während eines Vorfalls
Nachdem Sie Ihr Operationswiki verbunden haben, fragen Sie Ihren Agenten:
Our payment service is returning 503 errors. What does our runbook say to do?
Ihr Agent durchsucht Ihr Wiki, findet die Seite "Problembehandlung beim Zahlungsdienst" und antwortet mit dem dokumentierten Verfahren. Die Antwort enthält eine Zitatverknüpfung zurück zur ursprünglichen Wiki-Seite in Azure DevOps.