Samouczek: przesyłanie dokumentów wiedzy do agenta SRE w Azure

W tym samouczku przekażesz dokumenty wiedzy do agenta usługi SRE Azure, aby można było do nich odwoływać się podczas przyszłych badań. Dowiesz się, jak zapisywać wyniki badania bezpośrednio w ustawieniach wiedzy za pośrednictwem czatu i jak przekazywać istniejące pliki za pośrednictwem interfejsu użytkownika portalu.

W tym poradniku nauczysz się, jak:

• Przekształć badanie w Runbook wielokrotnego użytku i zapisz go w ustawieniach Knowledge.
• Sprawdź, czy przekazana zawartość jest indeksowana i można wyszukiwać
• Przekazywanie pojedynczych plików lub folderów za pośrednictwem portalu
• Przetestuj, czy agent może pobrać przekazaną zawartość w nowej konwersacji

Szacowany czas: 10 minut

Wymagania wstępne

• Agent Azure SRE w stanie Uruchomiony
• Uprawnienia do zapisu na agencie
• Tryb uruchamiania agenta ustawiony na Przegląd lub Autonomiczny

Krok 1. Rozpoczęcie od badania

Najlepsze dokumenty wiedzy pochodzą z rzeczywistych dochodzeń. Zamiast tworzyć zawartość od podstaw, przechwyć zdobytą wiedzę agenta.

1. Przejdź do sre.azure.com i wybierz agenta.
2. Na pasku bocznym po lewej stronie w obszarze Czaty znajdź poprzedni wątek badania — dowolną konwersację, w której agent zdiagnozował lub rozwiązał problem — i wybierz go.

Jeśli nie masz jeszcze wątku badania, rozpocznij nowy czat i poproś agenta o zbadanie czegoś:

Investigate high memory usage on our container apps

Poczekaj na zakończenie badania, a następnie przejdź do kroku 2.

Krok 2: Poproś agenta o utworzenie Runbooka

W tej samej sesji analizy poproś agenta o przekształcenie wyników w runbook i zapisanie go w ustawieniach bazy wiedzy. Proszę być precyzyjnym w kwestii nazwy pliku.

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

Twój agent:

1. Syntetyzuje kontekst badania do ustrukturyzowanego przewodnika operacyjnego.
2. Generuje sekcje, takie jak analiza głównej przyczyny, kroki diagnostyczne, środki zaradcze i wyzwalacze eskalacji.
3. Zapisuje dokument w ustawieniach zarządzania wiedzą i potwierdza przesłanie.

Agent potwierdza zapisanie dokumentu i udostępnia link pobierania. Runbook jest teraz przechowywany w ustawieniach Knowledge i jest indeksowany pod kątem wyszukiwania.

Checkpoint

• Agent wygenerował ustrukturyzowany Runbook z badania.
• Agent potwierdził, że dokument został zapisany.

Krok 3. Weryfikowanie w ustawieniach wiedzy

1. Na lewym pasku bocznym wybierz pozycję Konstruktor , aby rozwinąć sekcję.
2. Wybierz Ustawienia Wiedzy.

Na stronie Ustawienia wiedzy są wyświetlane dokumenty w tabeli z kolumnami Nazwa pliku, Stan, Typ i Ostatnia modyfikacja. W kolumnie Stan jest wyświetlana wartość √ Indeksowana , gdy dokument jest indeksowany i gotowy do wyszukiwania.

Jeśli stan to Oczekujące, wybierz pozycję Odśwież. Indeksowanie zwykle kończy się w ciągu kilku sekund.

Checkpoint

• Przeniesiono do Konstruktor → Ustawienia wiedzy
• Dokument ma status ✓ indeksowany

Krok 4. Przekazywanie plików za pośrednictwem portalu

Pojedyncze pliki lub całe foldery można przekazać bezpośrednio. Metoda ta jest przydatna dla istniejących runbooków, dokumentacji lub materiałów referencyjnych, które twój zespół już posiada.

Przekazywanie pojedynczych plików

1. Na stronie Źródła wiedzy wybierz pozycję Dodaj plik.
2. Przeciągnij plik do obszaru upuszczania lub wybierz przeglądaj pliki, aby wybrać plik.
3. Wybierz Dodaj plik, aby przesłać.

Przekazywanie folderu

Możesz również przeciągnąć cały folder — w tym zagnieżdżone podfoldery — na strefę upuszczania.

1. Na stronie Źródła wiedzy wybierz pozycję Dodaj plik.
2. Przeciągnij folder z menedżera plików bezpośrednio do strefy upuszczenia.
3. Portal wyodrębnia wszystkie obsługiwane pliki z folderu i jego podfolderów, a następnie wyświetla je w oknie dialogowym.
4. Przejrzyj listę plików — usuń wszystkie pliki, których nie chcesz, wybierając ikonę usuwania obok każdego pliku.
5. Wybierz pozycję Dodaj plik , aby przekazać wszystkie wymienione pliki.

Portal automatycznie filtruje pliki z nieobsługiwanymi rozszerzeniami. Pełną listę obsługiwanych rozszerzeń i limitów rozmiaru można znaleźć na stronie Możliwości przekazywania dokumentów wiedzy.

Maksymalny rozmiar pliku to 16 MB na plik, z maksymalnie 100 MB na przesyłanie.

Uwaga / Notatka

Podczas przekazywania folderu portal nie zachowuje struktury folderów — pliki z podfolderów są wyświetlane jako poszczególne dokumenty. Jeśli pliki w różnych podfolderach mają taką samą nazwę, zostanie przekazany tylko pierwszy plik.

Checkpoint

• Wybrano pozycję Dodaj plik i pojawiło się okno dialogowe przesyłania.
• Pomyślnie przesłano plik lub przeciągnięto folder.
• Pliki są wyświetlane w źródłach wiedzy z oznaczeniem ✓ Indeksowane.

Krok 5. Testowanie pobierania w nowej konwersacji

Rozpocznij nowy wątek czatu i zadaj pytanie, na które powinny odpowiedzieć przekazane dokumenty:

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

Agent przeszukuje ustawienia wiedzy, znajduje przesłany Runbook i odnosi się do niego w odpowiedzi. Ten proces potwierdza indeksowanie i pobieranie wiedzy.

Checkpoint

• Rozpoczęto nowy wątek czatu
• Zadano pytanie dotyczące przekazanej zawartości
• Agent odniósł się do przekazanego dokumentu w odpowiedzi

Usuwanie dokumentu merytorycznego

1. Przejdź do obszaru Konstruktor → ustawienia wiedzy.
2. Na liście dokumentów zaznacz co najmniej jeden dokument przy użyciu pól wyboru.
3. Wybierz pozycję Usuń na pasku narzędzi.
4. Zostanie wyświetlone okno dialogowe potwierdzenia z listą dokumentów do usunięcia. Wybierz Usuń, aby potwierdzić.

Po usunięciu dokumentów usuniesz je z ustawień wiedzy agenta i nie będą one już wyświetlane w wynikach wyszukiwania.

Uwaga / Notatka

Nie można edytować dokumentów wiedzy bezpośrednio. Aby zaktualizować dokument, przekaż nową wersję z tą samą nazwą pliku. Nowa wersja zastępuje poprzednią wersję.

Czego się nauczyłeś

• Agent może przekształcić rzeczywiste badania w ustrukturyzowane elementy Runbook i zapisać je w ustawieniach wiedzy.
• Pliki można przekazywać ręcznie za pomocą interfejsu użytkownika portalu w narzędziu Builder → Ustawienia wiedzy. Obsługuje wiele formatów, w tym pdf, dokumentów pakietu Office i obrazów.
• System indeksuje przesłane dokumenty dla wyszukiwania semantycznego, i są dostępne podczas przyszłych rozmów.
• Aby zaktualizować dokumenty, przekaż je pod tą samą nazwą pliku.

Troubleshooting

Błąd	Przyczyna	Napraw.
"Pamięć agenta jest wyłączona. Nie można przekazać dokumentów".	Funkcje wiedzy nie są włączone w systemie agenta	Skontaktuj się z administratorem, aby aktywować ustawienia wiedzy
Nie mam uprawnień do zapisu w ustawieniach Knowledge	Agent nie może zlokalizować narzędzia do przesyłania	Przekształć swoje żądanie: "Zapisz je w ustawieniach Knowledge jako filename.md"
"Nieprawidłowe rozszerzenie pliku. Dozwolone są tylko pliki md i .txt.	Nazwa pliku nie kończy się .md lub .txt (przesyłanie czatu)	Użyj rozszerzenia .md lub .txt podczas proszenia agenta o zapisanie
"Zawartość dokumentu przekracza maksymalny rozmiar 16 MB"	Zawartość za duża dla pojedynczego dokumentu	Podziel na wiele mniejszych dokumentów
"Nazwa pliku nie może być pusta"	Brak podanej nazwy pliku	Dołącz nazwę pliku w wierszu polecenia (np. runbook.md)

Related

Resource	Czego się uczysz
Załaduj dokumenty wiedzy	Jak to działa i dlaczego ma znaczenie
Tworzenie umiejętności	Tworzenie umiejętności proceduralnych, które uzupełniają dokumenty merytoryczne
Umiejętności	Jak współpracują ze sobą umiejętności i wiedza
Wiedza na temat witryny typu wiki ADO	Łączenie zawartości typu wiki na żywo jako źródła wiedzy