Prześlij dokumenty z wiedzą w Azure SRE agent

Każdy incydent, który zespół rozwiązuje, generuje cenną wiedzę: co poszło nie tak, jakie polecenia to naprawiły i co należy sprawdzić najpierw następnym razem. Ale ta wiedza żyje w wątkach czatu, pamięci inżyniera i analizach poawaryjnych, których nikt nie czyta o 3:00.

Twój zespół ma runbooki, ale są przestarzałe. Poprawka odkryta podczas wczorajszego nocnego incydentu? Jest w głowie kogoś lub ukryty w rozmowie, która zniknie z widoku w przyszłym tygodniu. Przy następnym wystąpieniu tego samego problemu inny inżynier zaczyna się od podstaw.

Jak agent rozwiązuje ten problem

Agent może przekazać dokumenty do ustawień wiedzy podczas konwersacji przy użyciu narzędzia Przekaż dokument wiedzy . Gdy agent odnajduje poprawkę, tworzy przewodnik rozwiązywania problemów lub syntetyzuje wyniki badania, przechowuje ją bezpośrednio. Takie podejście sprawia, że informacje można wyszukiwać dla 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 Knowledge settings.

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.

Przed i po

przed po
Przechwytywanie wiedzy Po incydencie: inżynier pisze runbook (być może) Agent przechwytuje poprawkę w miarę jej wprowadzania
Czas na dokumentowanie 30 do 60 minut na napisanie runbooka Sekund. Agent generuje i przekazuje wbudowane dane.
Świeżość wiedzy Elementy Runbook są nieaktualne w ciągu kilku tygodni Ustawienia zarządzania wiedzą rozwijają się przy każdym rozwiązaniu
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 ręcznego wgrywania agent aktywnie tworzy wiedzę. Nie musisz pamiętać, aby udokumentować zdobytą wiedzę, ponieważ agent wykonuje ją w ramach 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 ustawieniach wiedzy agenta, które są dostępne 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. Weryfikuje nazwę pliku i zawartość (do 16 MB na plik).
  2. Przechowuje dokument w ustawieniach wiedzy agenta.
  3. Indeksuje zawartość wyszukiwania semantycznego.
  4. Potwierdza przesyłanie z komunikatem o powodzeniu.

Uwaga / Notatka

Jeśli dokument o tej samej nazwie pliku już istnieje, nowa zawartość go zastępuje. Ten proces ułatwia agentowi aktualizowanie wiedzy. Prześlij dokument, używając tej samej nazwy, aby odświeżyć zawartość.

Obsługiwane formaty plików

Agent obsługuje pliki za pomocą trzech metod, z których każdy obsługuje różne formaty.

Załączniki czatu

Przeciągnij pliki do dowolnego czatu, aby dać agentowi bezpośredni kontekst do analizy — rozwiązywanie problemów ze skryptami, plikami konfiguracji, śladami sieci i nie tylko.

Kategoria Rozszerzenia
Images .png, , .jpg, .jpeg, .gif, , .webp.svg
Documents .txt, , .md, .pdf, .docx, , .pptx.xlsx
Dane i konfiguracja .json, .csv, , .log, .yaml.yml, .xml, , .ini.conf.env
Web i sieć .html, .har
Kod i skrypty .ts, , .js, .py, .sh, , .sql.kql
Infrastruktura .bicep, .tf

Limity: 10 MB na plik · Suma 50 MB na komunikat · 5 plików na wiadomość

Przesyłanie ustawień wiedzy

Aby utrwalać dokumenty, aby agent mógł się do nich odwoływać w przyszłych rozmowach, prześlij pliki przez narzędzia Builder → Ustawienia wiedzy → Dodaj plik. System indeksuje przesłane pliki do wyszukiwania semantycznego.

Kategoria Rozszerzenia
Images .png, .jpg, , .jpeg, .gif.webp, , .bmp, , .tiff.tif
Documents .txt, .md, , .pdf, .docx.pptx, .xlsx, , .doc.ppt.xls
Dane i konfiguracja .json, .csv, .log.yaml.yml.xml.ini.conf.cfg.config.properties

Limity: 16 MB na plik · 100 MB na przekazanie

Przekazywanie folderów

Aby załadować wszystkie obsługiwane pliki jednocześnie, przeciągnij cały folder do obszaru przekazywania plików. Ten proces obejmuje pliki w zagnieżdżonych podfolderach. Portal automatycznie wyodrębnia każdy plik z hierarchii folderów i filtruje nieobsługiwane typy plików.

Jak działa przesyłanie folderów:

  1. System wyodrębnia wszystkie pliki z zagnieżdżonych podfolderów do płaskiej listy.
  2. System zawiera tylko pliki z obsługiwanymi rozszerzeniami i dyskretnie filtruje nieobsługiwane typy.
  3. System deduplikuje pliki o zduplikowanych nazwach z różnych podfolderów i przechowuje tylko pierwszy plik.
  4. System przekazuje i indeksuje każdy plik indywidualnie do wyszukiwania.

Uwaga / Notatka

Przekazane pliki są wyświetlane jako pojedyncze dokumenty w źródłach wiedzy. Oryginalna hierarchia folderów nie jest zachowywana. Plik w pliku runbooks/networking/dns-troubleshooting.md jest wyświetlany jako dns-troubleshooting.md.

Przesyłanie ustawień wiedzy akceptuje starsze formaty pakietu Office (.doc, .ppt, .xls) i dodatkowe formaty obrazów (.bmp, .tiff, .tif), których nie obsługują załączniki do czatu. Załączniki czatów obsługują kod, skrypty, infrastrukturę i formaty internetowe, których ustawienia wiedzy nie obsługują.

Dokumenty generowane przez agenta

Gdy agent tworzy dokumenty podczas konwersacji (przy użyciu narzędzia Przekaż dokument wiedzy ), generuje .md lub .txt pliki i zapisuje je bezpośrednio w ustawieniach wiedzy. Ten proces występuje, gdy poprosisz agenta o "zapisanie tego jako runbook".

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 Knowledge settings.

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

  • Kroki ustalania zakresu: Jak zidentyfikować problem.
  • Szybkie środki zaradcze: natychmiastowe działania w celu zmniejszenia wpływu.
  • Analiza głównej przyczyny: co należy zbadać.
  • Kroki rozwiązywania problemu: poprawka, która zadziałała.
  • Zapobieganie: Jak uniknąć cyklu.

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

Czego potrzebujesz

Wymaganie Szczegóły
Wersja agenta 26.1.57.0 lub nowsza
Ustawienia wiedzy Włączone na agencie
Uprawnienia do zapisu Agent musi mieć dostęp do zapisu w ustawieniach Wiedzy
Tryb działania Przegląd lub autonomiczny. Operacje zapisu wymagają zatwierdzenia w trybie recenzji

Limity

Typ Załączniki czatu Przesyłanie ustawień wiedzy Narzędzie agenta
Maksymalny rozmiar pliku 10 MB 16 MB 16 MB
Maksymalna suma 50 MB na komunikat 100 MB na przesyłanie Nie dotyczy
Maksymalna liczba plików 5 na wiadomość Brak limitu (całkowity rozmiar ograniczony do 100 MB) 1 na akcję
Przekazywanie folderu Niewspierane √ Przeciągnij foldery, aby przekazać wszystkie pliki jednocześnie Niewspierane
Obsługiwane rozszerzenia 31 28 2 (.md, .txt)
Znaki nazwy pliku Nie dotyczy Litery, cyfry, łączniki, podkreślenia, kropki To samo
Maksymalna długość nazwy pliku Nie dotyczy 1024 znaki To samo

Kiedy należy użyć czegoś innego

Scenario Lepsze podejście
Łączenie treści wiki na żywo, która pozostaje zsynchronizowana ADO Wiki Knowledge
Przekazywanie plików binarnych (PDF, Word, images) Przekazywanie za pomocą programu Builder → ustawień wiedzy → Dodawanie pliku
Zbiorcze importowanie wielu dokumentów jednocześnie Prześlij wiele plików przez Builder → Ustawienia wiedzy → Dodaj plik
Automatyczne aktualizowanie repozytoriów kodu Łączenie łącznika GitHub lub ADO
Zdolność Co dodaje
Wiedza na temat witryny typu wiki ADO Podłącz zawartość wiki na żywo, która aktualizuje się automatycznie
Analiza głównej przyczyny Badanie problemów i przechwytywanie wyników