Udostępnij za pośrednictwem

Przekazywanie dokumentów wiedzy do agenta usługi Azure SRE

Agent przechwytuje wiedzę instytucjonalną podczas konwersacji, przesyłając runbooki, przewodniki rozwiązywania problemów i dokumentację bezpośrednio do bazy wiedzy. Gdy agent wykryje poprawkę lub rozwiąże zdarzenie, generuje dokumenty ustrukturyzowane i indeksuje je do wyszukiwania semantycznego, więc każde przyszłe badanie przynosi korzyści z poprzednich rozwiązań.

Wskazówka

Agent tworzy i przesyła runbooki podczas rozmów, eliminując potrzebę ręcznego zarządzania plikami. System indeksuje dokumenty dotyczące wyszukiwania semantycznego, udostępniając je wszystkim przyszłym badaniom. Rozwiązania incydentów stają się automatycznie wiedzą instytucjonalną.

Jak agent przechwytuje wiedzę

Agent może przekazać dokumenty do bazy wiedzy podczas konwersacji przy użyciu narzędzia Przekaż dokument wiedzy . Gdy agent odnajdzie poprawkę, utworzy przewodnik rozwiązywania problemów lub zsyntetyzuje wyniki badania, przechowuje ją bezpośrednio i ułatwia wyszukiwanie każdej przyszłej konwersacji.

Create a runbook from the steps we just followed to fix this database
connection pool exhaustion issue and save it to the knowledge base.

Agent generuje ustrukturyzowany runbook i przesyła go w ciągu sekund. Dokument jest indeksowany automatycznie i staje się możliwy do wyszukiwania w przyszłych badaniach.

Agent generujący i przekazujący przewodnik rozwiązywania problemów podczas konwersacji

Przed i po

W poniższej tabeli porównaliśmy przepływy pracy przechwytywania wiedzy przed i po użyciu narzędzia Przekaż dokument wiedzy .

Obszar przed po
Przechwytywanie wiedzy Po incydencie: inżynier pisze runbook (być może) Agent przechwytuje poprawkę w miarę jej wprowadzania
Czas na dokumentowanie 30–60 minut na napisanie runbooka Sekundy: agent generuje i ładuje dane inline
Świeżość wiedzy Elementy Runbook są nieaktualne w ciągu kilku tygodni Baza wiedzy rozwija się wraz z każdym rozwiązaniem
Dostępność Wiedza utknęła w głowie inżyniera lub w wątku czatu Możliwość przeszukiwania przez twojego agenta we wszystkich przyszłych konwersacjach.
Spójność formatu Różni się od autora Strukturalna, spójna dokumentacja za każdym razem

Co sprawia, że różni się to

W przeciwieństwie do przesyłania ręcznego, Twój agent aktywnie tworzy wiedzę. Nie musisz pamiętać, aby udokumentować zdobytą wiedzę. Agent wykonuje to jako część konwersacji.

W przeciwieństwie do historii czatów przekazane dokumenty są indeksowane pod kątem wyszukiwania semantycznego. Gdy podobny problem występuje kilka miesięcy później, agent automatycznie znajdzie odpowiedni runbook za pośrednictwem inteligentnego wyszukiwania, a nie przewijając stare wątki.

W przeciwieństwie do łączników typu wiki przekazane dokumenty nie wymagają usług zewnętrznych. Wiedza znajduje się bezpośrednio w bazie wiedzy agenta, która jest dostępna natychmiast bez opóźnień synchronizacji.

Jak to działa

Narzędzie Przekaż dokument wiedzy akceptuje trzy parametry.

Parametr Wymagania Opis
Nazwa pliku Yes Nazwa z rozszerzeniem .md lub .txt (na przykład database-pool-runbook.md)
Content Yes Pełny tekst dokumentu w formacie Markdown lub zwykłego tekstu
Wyzwalanie indeksowania Opcjonalne (ustawienie domyślne: true) Czy można natychmiast wyszukiwać dokument

Gdy agent przekaże dokument:

  1. Agent weryfikuje nazwę pliku i zawartość (maksymalnie 16 MB na plik).
  2. Agent przechowuje dokument w bazie wiedzy twojego agenta.
  3. Agent indeksuje zawartość wyszukiwania semantycznego.
  4. Agent potwierdza przekazanie poprzez komunikat potwierdzający sukces.

Uwaga / Notatka

Jeśli dokument o tej samej nazwie pliku już istnieje, nowa zawartość go zastępuje. Prześlij plik o tej samej nazwie, aby odświeżyć zawartość.

Obsługiwane formaty plików

Narzędzie do przesyłania dokumentów wiedzy obsługuje formaty tekstowe generowane przez agenta w tekście liniowym.

Format Rozszerzenie Najlepsze dla
Markdown .md Runbooki, przewodniki dotyczące rozwiązywania problemów z formatowaniem i nagłówkami
Zwykły tekst .txt Proste notatki, dzienniki, nieprzetworzona dokumentacja

Uwaga / Notatka

Podczas przekazywania plików za pośrednictwem interfejsu API lub interfejsu wiersza polecenia można użyć większej liczby formatów tekstowych, w tym plików CSV, JSON, YAML i plików dziennika. Interfejs API przekazywania obsługuje formaty binarne (PDF, Word, Excel, PowerPoint) i obrazy. Narzędzie agenta koncentruje się na formatach .md i .txt, ponieważ agent generuje zawartość tekstową podczas konwersacji.

Okno dialogowe Dodawanie pliku w bazie wiedzy z obsługiwanymi formatami i przeciąganie i upuszczanie przekazywania

Przykład: przechwytywanie wiedzy o zdarzeniach

Podczas badania incydentu zapytaj agenta:

We just resolved the high CPU issue on web-app-prod. It was caused by a
memory leak in the connection pool. Create a troubleshooting guide from
what we learned and upload it to the knowledge base.

Twój agent tworzy ustrukturyzowany przewodnik rozwiązywania problemów z:

  • Kroki w zakresie określania: Jak zidentyfikować problem
  • Szybkie środki zaradcze: natychmiastowe działania w celu zmniejszenia wpływu
  • Analiza głównej przyczyny: co zbadać
  • Kroki rozwiązywania problemów: poprawka, która działała
  • Zapobieganie: Jak uniknąć cyklu

Następnym razem, gdy wystąpi podobny problem z procesorem, agent automatycznie odwołuje się do tego dokumentu podczas badania, przekształcając doświadczenie jednego inżyniera we wspólną wiedzę zespołu.

Wymagania wstępne

Przed użyciem narzędzia Przekaż dokument merytoryczny upewnij się, że spełniasz następujące wymagania.

Wymaganie Szczegóły
Wersja agenta 26.1.57.0 lub nowsza
Baza wiedzy Włączone na agencie
Uprawnienia do zapisu Agent musi mieć uprawnienia do zapisu w bazie wiedzy
Tryb działania Przegląd lub autonomiczny (akcje zapisu wymagają zatwierdzenia w trybie przeglądu)

Limity

Następujące limity dotyczą przesłanych dokumentów wiedzy.

Limit Wartość
Maksymalny rozmiar pliku 16 MB na dokument
Obsługiwane rozszerzenia .md i .txt
Znaki nazwy pliku Litery, cyfry, łączniki, podkreślenia, kropki (bez /, \, , ?#)
Maksymalna długość nazwy pliku 1024 znaki

Kiedy należy użyć czegoś innego

W poniższej tabeli opisano scenariusze, w których bardziej odpowiednie jest inne podejście.

Scenario Lepsze podejście
Łączenie treści wiki na żywo, która pozostaje zsynchronizowana Wiedza na temat witryny typu wiki usługi Azure DevOps
Przekazywanie plików binarnych (PDF, Word, images) Prześlij ręcznie przez Builder > Bazę wiedzy > Dodaj plik
Zbiorcze importowanie wielu dokumentów jednocześnie Użyj polecenia srectl doc upload --file <path> wiersza poleceń

Następne kroki

Samouczek: przesyłanie dokumentu wiedzy

Treści powiązane

  • Last updated on