Kurz: Nahrání dokumentů znalostí do agenta Azure SRE

V tomto kurzu nahrajete do svého Azure agenta SRE dokumenty znalostí, aby na ně bylo možné odkazovat během budoucích šetření. Naučíte se ukládat výsledky šetření přímo do nastavení znalostí prostřednictvím chatu a jak nahrát existující soubory prostřednictvím uživatelského rozhraní portálu.

V tomto návodu se naučíte, jak:

• Přeměňte vyšetřování na opakovaně použitelný runbook a uložte ho do nastavení znalostní báze
• Ověřte, že je nahraný obsah indexovaný a prohledávatelný.
• Nahrání jednotlivých souborů nebo složek prostřednictvím portálu
• Otestujte, že váš agent může načíst nahraný obsah v nové konverzaci.

Odhadovaný čas: 10 minut

Předpoklady

• Agent Azure SRE ve běžícím stavu
• Oprávnění k zápisu na agenta
• Režim spuštění agenta nastavený na Kontrolu nebo autonomní režim

Krok 1: Zahájení šetření

Nejlepší dokumenty znalostí pocházejí z skutečných šetření. Místo vytváření obsahu úplně od začátku zachyťte, co už se váš agent naučil.

1. Přejděte na sre.azure.com a vyberte svého agenta.
2. Na levém bočním panelu v části Chaty najděte předchozí vlákno šetření – jakoukoli konverzaci, ve které agent diagnostikoval nebo vyřešil nějaký problém – a vyberte ho.

Pokud ještě nemáte vlákno šetření, spusťte nový chat a požádejte svého agenta, aby něco prošetřil:

Investigate high memory usage on our container apps

Počkejte na dokončení šetření a pokračujte krokem 2.

Krok 2: Požádejte svého agenta, aby vytvořil runbook

Ve stejném vlákně vyšetřování požádejte svého agenta, aby své závěry převedl do runbooku a uložil do nastavení znalostí. Buďte specifická pro název souboru.

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

Váš agent:

1. Syntetizuje kontext šetření do strukturovaného runbooku.
2. Generuje oddíly, jako je analýza základní příčiny, diagnostické kroky, opatření a spouštěče eskalace.
3. Uloží dokument do nastavení znalostní báze a potvrdí odeslání.

Agent potvrdí, že dokument byl uložen, a poskytne odkaz ke stažení. Runbook je nyní uložen v Nastavení znalostní báze a je indeksován pro vyhledávání.

Checkpoint

• Agent vygeneroval strukturovaný runbook z šetření.
• Agent potvrdil, že byl dokument uložen.

Krok 3: Ověření v nastavení znalostí

1. Na levém bočním panelu vyberte Stavitel a rozbalte část.
2. Vyberte nastavení znalostí.

Na stránce Nastavení znalostí se zobrazují dokumenty v tabulce se sloupci pro název souboru, stav, typ a poslední úpravy. Ve sloupci Stav se zobrazí indexováno, když je dokument indexovaný a připravený k hledání.

Pokud se zobrazí stav Čeká na vyřízení, vyberte Aktualizovat. Indexování se obvykle dokončí během několika sekund.

Checkpoint

• Přechod na Tvůrce → Nastavení znalostí
• Dokument se zobrazí se stavem ✓ Indexován

Krok 4: Nahrání souborů prostřednictvím portálu

Jednotlivé soubory nebo celé složky můžete nahrát přímo. Tato metoda je užitečná pro existující runbooky, dokumentaci nebo referenční materiály, které už váš tým má.

Nahrání jednotlivých souborů

1. Na stránce Zdroje znalostí vyberte Přidat soubor.
2. Přetáhněte soubor do zóny přetažení nebo vyberte procházet soubory.
3. Vyberte Přidat soubor , který chcete nahrát.

Nahrání složky

Do zóny přetažení můžete také přetáhnout celou složku , včetně vnořených podsložek.

1. Na stránce Zdroje znalostí vyberte Přidat soubor.
2. Přetáhněte složku ze správce souborů do vymezené oblasti.
3. Portál extrahuje všechny podporované soubory ze složky a jejích podsložek a pak je zobrazí v dialogovém okně.
4. Zkontrolujte seznam souborů – odeberte všechny soubory, které nechcete, výběrem ikony odstranění vedle každého souboru.
5. Vyberte Přidat soubor a nahrajte všechny uvedené soubory.

Portál automaticky vyfiltruje soubory s nepodporovanými rozšířeními. Úplný seznam podporovaných rozšíření a omezení velikosti najdete na stránce funkce Nahrát dokumenty znalostí.

Maximální velikost souboru je 16 MB, přičemž jednotlivý upload může mít až 100 MB.

Poznámka:

Když nahrajete složku, portál nezachová strukturu složek – soubory z podsložek se zobrazují jako jednotlivé dokumenty. Pokud soubory v různých podsložkách sdílejí stejný název, nahraje se jenom první soubor.

Checkpoint

• Vybráno Přidat soubor a zobrazilo se dialogové okno pro nahrání.
• Nahrál(a) soubor nebo přetáhl složku úspěšně.
• Soubory se zobrazují ve zdrojích znalostí se stavem Indexované .

Krok 5: Otestujte načítání v nové konverzaci

Spusťte nové vlákno chatu a položte otázku, na kterou by nahrané dokumenty měly odpovědět:

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

Váš agent prohledá nastavení znalostí, najde nahraný runbook a v odpovědi na něj odkazuje. Tento proces potvrzuje indexování a načítání znalostí.

Checkpoint

• Spustilo se nové vlákno chatu.
• Položil(a) otázku související s nahraným obsahem
• Agent odkazoval na nahraný dokument v odpovědi.

Odstranění znalostního dokumentu

1. Přejděte do Builderu → nastavení znalostí.
2. V seznamu dokumentů pomocí zaškrtávacích políček vyberte jeden nebo více dokumentů.
3. Na panelu nástrojů vyberte Odstranit .
4. Potvrzovací dialogové okno obsahuje seznam dokumentů, které chcete odebrat. Výběrem možnosti Odstranit potvrdíte akci.

Když odstraníte dokumenty, odeberete je z nastavení znalostí agenta a ve výsledcích hledání se už nezobrazí.

Poznámka:

Nemůžete upravovat znalostní dokumenty na místě. Pokud chcete dokument aktualizovat, nahrajte novou verzi se stejným názvem souboru. Nová verze nahrazuje předchozí verzi.

Co jste se naučili

• Váš agent může přeměnit skutečná vyšetřování na strukturované runbooky a uložit je do znalostní databáze.
• Soubory můžete nahrát ručně pomocí uživatelského rozhraní portálu v Tvůrci → nastavení znalostí. Podporuje mnoho formátů, včetně PDF, dokumentů Office a obrázků.
• Systémové indexy nahrály dokumenty pro sémantické vyhledávání a jsou k dispozici ve všech budoucích konverzacích.
• Pokud chcete aktualizovat dokumenty, nahrajte je pomocí stejného názvu souboru.

Troubleshooting

Error	Příčina	Oprava
Paměť agenta je deaktivována. Dokumenty nelze nahrát."	Nastavení znalostí není ve vašem agentovi povolené.	Pokud chcete povolit nastavení znalostí, obraťte se na správce.
Nemám oprávnění k zápisu do vašeho nastavení znalostí.	Agent nemohl najít nástroj pro nahrávání	Přeformulujte požadavek: "Uložit do Nastavení znalostí jako soubor filename.md"
"Neplatná přípona souboru. Jsou povoleny pouze soubory .md a .txt."	Název souboru nemá koncovku .md nebo .txt (nahrání chatu)	Použijte rozšíření .md nebo .txt při žádosti agenta o uložení.
"Obsah dokumentu překračuje maximální velikost 16 MB"	Obsah je příliš velký pro jeden dokument.	Rozdělení na několik menších dokumentů
Název souboru nemůže být prázdný.	Nebyl poskytnut žádný název souboru.	Do výzvy zadejte název souboru (např. runbook.md)

Related

zdroj	Co se naučíte
Nahrání znalostních dokumentů	Jak to funguje a proč je to důležité
Vytvoření dovednosti	Vytváření procedurálních dovedností, které doplňují dokumenty znalostí
Dovednosti	Spolupráce dovedností a znalostí
Wiki znalosti ADO	Připojení živého obsahu wikiwebu jako zdroje znalostí