Lernprogramm: Hochladen von Wissensdokumenten in Azure SRE-Agent

In diesem Lernprogramm laden Sie Wissensdokumente in Ihren Azure SRE-Agent hoch, damit sie während zukünftiger Untersuchungen darauf verweisen können. Sie erfahren, wie Sie Untersuchungsergebnisse direkt im Chat in Wissenseinstellungen speichern und vorhandene Dateien über die Portal-UI hochladen.

In diesem Tutorial erfahren Sie, wie:

  • Verwandeln einer Untersuchung in ein wiederverwendbares Runbook und speichern in den Wissenseinstellungen
  • Überprüfen, ob hochgeladene Inhalte indiziert und durchsuchbar sind
  • Hochladen einzelner Dateien oder Ordner über das Portal
  • Testen, dass Ihr Agent den hochgeladenen Inhalt in einer neuen Unterhaltung abrufen kann

Geschätzte Zeit: 10 Minuten

Voraussetzungen

  • Ein Azure SRE-Agent im Runningstatus
  • Schreibberechtigungen auf dem Agent
  • Agent-Ausführungsmodus auf "Überprüfen" oder "Autonom" festgelegt

Schritt 1: Starten von einer Untersuchung

Die besten Wissensdokumente stammen aus echten Untersuchungen. Anstatt Inhalte von Grund auf neu zu erstellen, erfassen Sie, was Ihr Agent bereits gelernt hat.

  1. Wechseln Sie zu sre.azure.com , und wählen Sie Ihren Agenten aus.
  2. Suchen Sie in der linken Randleiste unter "Chats" einen vorherigen Untersuchungsthread – jede Unterhaltung, in der Ihr Agent ein Problem diagnostiziert oder gelöst hat – und wählen Sie ihn aus.

Wenn Sie noch keinen Untersuchungsthread haben, starten Sie einen neuen Chat, und bitten Sie Ihren Agenten, etwas zu untersuchen:

Investigate high memory usage on our container apps

Warten Sie, bis die Untersuchung abgeschlossen ist, und fahren Sie dann mit Schritt 2 fort.

Schritt 2: Bitten Sie Ihren Agent, ein Runbook zu erstellen

Bitten Sie Ihren Agenten im gleichen Untersuchungsstrang, seine Ergebnisse in ein Runbook zu verwandeln und in den Wissenseinstellungen zu speichern. Geben Sie den Dateinamen präzise an.

Create a runbook from the investigation we just did. Include the root cause
analysis, the diagnostic steps, mitigations, and escalation triggers.
Save it to Knowledge settings as high-memory-runbook.md

Ihr Agent:

  1. Fasst den Untersuchungskontext in einem strukturierten Runbook zusammen.
  2. Generiert Abschnitte wie Ursachenanalyse, Diagnoseschritte, Maßnahmen zur Risikominderung und Eskalationsauslöser.
  3. Speichert das Dokument in den Wissenseinstellungen und bestätigt den Upload.

Der Agent bestätigt, dass das Dokument gespeichert wurde und einen Downloadlink bereitstellt. Ihr Runbook wird jetzt in den Wissenseinstellungen gespeichert und für die Suche indiziert.

Kontrollpunkt

  • Agent hat ein strukturiertes Runbook aus der Untersuchung generiert.
  • Der Agent hat bestätigt, dass das Dokument gespeichert wurde.

Schritt 3: Überprüfen in den Wissenseinstellungen

  1. Wählen Sie in der linken Randleiste den Generator aus, um den Abschnitt zu erweitern.
  2. Wählen Sie "Wissenseinstellungen" aus.

Auf der Seite "Wissenseinstellungen " werden Ihre Dokumente in einer Tabelle mit Spalten für Dateiname, Status, Typ und Zuletzt geändert angezeigt. In der Spalte Status wird ✓ Indiziert angezeigt, wenn das Dokument indiziert und für die Suche bereit ist.

Wenn der Status "Ausstehend" angezeigt wird, wählen Sie "Aktualisieren" aus. Die Indizierung wird in der Regel innerhalb weniger Sekunden abgeschlossen.

Kontrollpunkt

  • Navigiert zu Builder → Wissenseinstellungen
  • Dokument erscheint mit ✓ indiziert-Status.

Schritt 4: Hochladen von Dateien über das Portal

Sie können einzelne Dateien oder ganze Ordner direkt hochladen. Diese Methode ist nützlich für vorhandene Runbooks, Dokumentationen oder Referenzmaterialien, die Ihr Team bereits hat.

Hochladen einzelner Dateien

  1. Wählen Sie auf der Seite "Wissensquellen " die Option "Datei hinzufügen" aus.
  2. Ziehen Sie eine Datei in die Dropdownzone, oder suchen Sie nach Dateien , um eine datei auszuwählen.
  3. Wählen Sie "Datei zum Hochladen hinzufügen" aus.

Hochladen eines Ordners

Sie können auch einen ganzen Ordner – einschließlich geschachtelter Unterordner – auf die Dropzone ziehen.

  1. Wählen Sie auf der Seite "Wissensquellen " die Option "Datei hinzufügen" aus.
  2. Ziehen Sie einen Ordner aus Dem Datei-Manager direkt in die Dropzone.
  3. Das Portal extrahiert alle unterstützten Dateien aus dem Ordner und seinen Unterordnern und listet sie dann im Dialogfeld auf.
  4. Überprüfen Sie die Dateiliste– Entfernen Sie alle Dateien, die Sie nicht benötigen, indem Sie das Symbol "Löschen" neben jeder Datei auswählen.
  5. Wählen Sie "Datei hinzufügen" aus, um alle aufgelisteten Dateien hochzuladen.

Das Portal filtert Dateien automatisch mit nicht unterstützten Erweiterungen aus. Die vollständige Liste der unterstützten Erweiterungen und Größenbeschränkungen finden Sie auf der Seite "Wissensdokumente hochladen".

Die maximale Dateigröße beträgt 16 MB pro Datei mit bis zu 100 MB pro Upload.

Hinweis

Wenn Sie einen Ordner hochladen, behält das Portal die Ordnerstruktur nicht bei – Dateien aus Unterordnern werden als einzelne Dokumente angezeigt. Wenn Dateien in verschiedenen Unterordnern denselben Namen gemeinsam verwenden, wird nur die erste Datei hochgeladen.

Kontrollpunkt

  • Die Option "Datei hinzufügen" ausgewählt und sah das Dialogfeld "Hochladen".
  • Eine Datei wurde hochgeladen oder ein Ordner erfolgreich gezogen.
  • Dateien werden in Wissensquellen mit dem Status "Indiziert" angezeigt.

Schritt 5: Abruf in einer neuen Unterhaltung testen

Starten Sie einen neuen Chatthread, und stellen Sie eine Frage, die Ihre hochgeladenen Dokumente beantworten sollten:

What are the steps for troubleshooting high memory usage on container apps?

Ihr Agent durchsucht die Wissenseinstellungen, findet Ihr hochgeladenes Runbook und verweist in der Antwort darauf. Dieser Prozess bestätigt, dass das Wissen indiziert und abrufbar ist.

Kontrollpunkt

  • Einen neuen Chatthread gestartet
  • Eine Frage im Zusammenhang mit dem hochgeladenen Inhalt gestellt
  • Der Agent hat in seiner Antwort auf das hochgeladene Dokument verwiesen.

Löschen eines Wissensdokuments

  1. Gehen Sie zu Builder → Wissenseinstellungen.
  2. Wählen Sie in der Liste "Dokumente" ein oder mehrere Dokumente mithilfe der Kontrollkästchen aus.
  3. Wählen Sie auf der Symbolleiste "Löschen" aus.
  4. Ein Bestätigungsdialogfeld listet die zu entfernenden Dokumente auf. Wählen Sie zur Bestätigung Löschen aus.

Wenn Sie Dokumente löschen, entfernen Sie sie aus den Wissenseinstellungen des Agents und werden nicht mehr in Suchergebnissen angezeigt.

Hinweis

Sie können Wissensdokumente nicht In-Place bearbeiten. Um ein Dokument zu aktualisieren, laden Sie eine neue Version mit demselben Dateinamen hoch. Die neue Version ersetzt die vorherige Version.

Was Sie gelernt haben

  • Ihr Agent kann echte Untersuchungen in strukturierte Ablaufbeschreibungen umwandeln und sie in Wissenseinstellungen speichern.
  • Sie können Dateien manuell über die Portal-Benutzeroberfläche im Generator → Wissenseinstellungen hochladen. Es unterstützt viele Formate, einschließlich PDF, Office-Dokumente und Bilder.
  • Das System indiziert hochgeladene Dokumente für die semantische Suche und ist in allen zukünftigen Unterhaltungen verfügbar.
  • Um Dokumente zu aktualisieren, laden Sie sie mit demselben Dateinamen hoch.

Problembehandlung

Fehler Ursache Reparatur
"Der Agentspeicher ist deaktiviert. Dokumente können nicht hochgeladen werden." Wissenseinstellungen sind für Ihren Agent nicht aktiviert. Wenden Sie sich an Ihren Administrator, um Wissenseinstellungen zu aktivieren.
"Ich habe keinen Schreibzugriff auf Ihre Wissenseinstellungen" Der Agent konnte das Uploadtool nicht finden. Formulieren Sie Ihre Anfrage neu: „Speichere es in den Wissenseinstellungen als Dateiname.md“
"Ungültige Dateierweiterung. Es sind nur MD- und .txt-Dateien zulässig." Dateiname endet nicht in .md oder .txt (Chatupload) Verwenden sie eine .md Oder .txt Erweiterung, wenn Sie den Agent zum Speichern auffordern
"Dokumentinhalt überschreitet die maximale Größe von 16 MB" Inhalt zu groß für ein einzelnes Dokument Aufteilen in mehrere kleinere Dokumente
"Dateiname darf nicht leer sein" Kein Dateiname angegeben Fügen Sie einen Dateinamen in Ihre Eingabeaufforderung ein (z. B. runbook.md)
Ressource Was Sie lernen
Hochladen von Wissensdokumenten Wie das funktioniert und warum es wichtig ist
Erstellen einer Fähigkeit Erstellen von Verfahrensfähigkeiten, die Wissensdokumente ergänzen
Fähigkeiten Wie Fähigkeiten und Wissen zusammenarbeiten
ADO-Wikiwissen Verbinden von Live-Wiki-Inhalten als Wissensquelle
  • Last updated on