Nahrát dokumentaci znalostí do Azure SRE agenta

Každý incident, který váš tým vyřeší, vygeneruje cenné znalosti: co se nepovedlo, jaké příkazy ho opravili a co se má zkontrolovat při příštím spuštění. Tato znalost ale žije v chatovacích vláknech, v paměti inženýrů a postmortem, které nikdo nečte v 3:00.

Váš tým má runbooky, ale postupem času zastarávají. Oprava zjištěná během incidentu včera v noci? Je to v hlavě někoho, nebo je pohřben v konverzaci, která se posune mimo zobrazení příští týden. Při příštím výskytu stejného problému začne jiný technik úplně od začátku.

Jak váš agent tento problém vyřeší

Váš agent může během konverzací nahrát dokumenty do nastavení znalostí pomocí nástroje Nahrát dokument znalostí . Když váš agent zjistí opravu, vytvoří průvodce odstraňováním potíží nebo syntetizuje zjištění vyšetřování, uloží tyto znalosti přímo. Tento přístup umožňuje vyhledávat informace pro každou budoucí konverzaci.

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

Váš agent vygeneruje strukturovaný runbook a nahraje ho za několik sekund. Dokument se indexuje automaticky a bude prohledávatelný pro budoucí šetření.

Před a po

	před	Po
Zachycení znalostí	Po incidentu: inženýr píše runbook (možná)	Váš agent zachytí opravu, když k ní dojde.
Čas na dokument	30 až 60 minut pro zápis runbooku	Sekundy. Agent generuje a nahrává během zpracování.
Aktuálnost znalostí	Runbooky zastarají během několika týdnů	Znalosti rostou s každým vyřešením.
Přístupnost	Znalosti zaseknuté v hlavě inženýra nebo v chatovacím vlákně.	Prohledávatelný agentem ve všech budoucích konverzacích
Konzistence formátu	Liší se podle autora	Strukturovaná, konzistentní dokumentace pokaždé

Co to dělá jinak

Na rozdíl od ručních nahrávání váš agent proaktivně vytváří znalosti. Nemusíte si pamatovat dokumentování toho, co jste se naučili, protože to váš agent dělá jako součást konverzace.

Na rozdíl od historie chatu se nahrané dokumenty indexují pro sémantické vyhledávání. Když dojde k podobnému problému později, váš agent najde příslušný runbook automaticky s využitím inteligentního načítání, nikoli posouváním archivovaných vláken.

Na rozdíl od konektorů wikiwebu nahrané dokumenty nevyžadují externí služby. Znalosti se nacházejí přímo v nastavení znalostí vašeho agenta, které jsou dostupné okamžitě bez zpoždění synchronizace.

Jak to funguje

Nástroj Nahrát dokument znalostí přijímá tři parametry:

Parametr	Povinné	Description
Název souboru	Ano	Název s příponou .md nebo .txt (například database-pool-runbook.md)
Content	Ano	Celý text dokumentu ve formátu Markdownu nebo ve formátu prostého textu
Aktivace indexování	Volitelné (výchozí: true)	Zda se má dokument okamžitě prohledávat

Když váš agent nahraje dokument:

1. Ověří název souboru a obsah (až 16 MB na soubor).
2. Uloží dokument do nastavení znalostí vašeho agenta.
3. Indexuje obsah pro sémantické vyhledávání.
4. Potvrdí nahrávání zprávou o úspěchu.

Poznámka:

Pokud už dokument se stejným názvem souboru existuje, nahradí ho nový obsah. Tento proces usnadňuje aktualizaci znalostí agentem. Pokud chcete aktualizovat obsah, nahrajte dokument stejným názvem.

Podporované formáty souborů

Váš agent zpracovává soubory třemi metodami, z nichž každá podporuje různé formáty.

Přílohy chatu

Přetáhněte soubory do libovolného chatu a poskytněte agentovi okamžitý kontext pro analýzu – skripty pro řešení potíží, konfigurační soubory, trasování sítě a další.

Kategorie	Extensions
Images	.png, .jpg, .jpeg, .gif, , .webp.svg
Documents	.txt, .md, .pdf, .docx, , .pptx.xlsx
Data a konfigurace	.json, .csv, .log, .yaml, .yml, .xml, .ini, .conf, .env
Web a síť	.html, .har
Kód a skripty	.ts, .js, .py, .sh, , .sql.kql
Infrastruktura	.bicep, .tf

Omezení: 10 MB na soubor · Celkem 50 MB na zprávu · 5 souborů na zprávu

Nahrání konfigurací znalostí

Pokud chcete zachovat dokumenty, na které bude váš agent odkazovat v budoucích konverzacích, nahrajte soubory prostřednictvím Builderu → nastavení znalostí → Přidat soubor. Systém indexuje nahrané soubory pro sémantické vyhledávání.

Kategorie	Extensions
Images	.png, .jpg, .jpeg, , .gif.webp, .bmp, , .tiff.tif
Documents	.txt, .md, .pdf, .docx, .pptx, .xlsx, .doc, .ppt, .xls
Data a konfigurace	.json, .csv, .log, .yaml, .yml, .xml, .ini, .conf, .cfg, .config, .properties

Omezení: 16 MB na soubor · 100 MB na nahrání

Nahrávání složek

Pokud chcete nahrát všechny podporované soubory najednou, přetáhněte celou složku do zóny pro nahrání. Tento proces zahrnuje soubory ve vnořených podsložkách. Portál automaticky extrahuje každý soubor z hierarchie složek a vyfiltruje nepodporované typy souborů.

Jak funguje nahrávání složek:

1. Systém extrahuje všechny soubory z vnořených podsložek do plochého seznamu.
2. Systém obsahuje pouze soubory s podporovanými příponami a bezobslužné filtrování nepodporovaných typů.
3. Systém deduplikuje soubory s duplicitními názvy z různých podsložek a uchovává pouze první soubor.
4. Systém nahraje a indexuje každý soubor jednotlivě pro vyhledávání.

Poznámka:

Nahrané soubory se ve zdrojích znalostí zobrazují jako jednotlivé dokumenty. Původní hierarchie složek není zachována. Soubor na runbooks/networking/dns-troubleshooting.md se zobrazí jako dns-troubleshooting.md.

Nastavení znalostí pro nahrávání přijímají starší formáty Office (.doc, .ppt, .xls) a další formáty obrázků (.bmp, .tiff, .tif), které přílohy chatu nepodporují. Přílohy chatu podporují kód, skripty, infrastrukturu a webové formáty, které nastavení znalostí nepodporuje.

Dokumenty generované agentem

Když váš agent během konverzací vytvoří dokumenty (pomocí nástroje Nahrát dokument znalostí), vygeneruje .md nebo .txt soubory a uloží je přímo do nastavení znalostní báze. K tomuto procesu dochází, když požádáte svého agenta, aby ho uložil jako runbook.

Příklad: Dokumentace znalostí o incidentu

Během vyšetřování incidentu se zeptejte svého 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.

Váš agent vygeneruje průvodce strukturovaným řešením potíží:

• Kroky vymezení: Jak identifikovat problém.
• Rychlé zmírnění rizik: Okamžité akce, které snižují dopad.
• Analýza původní příčiny: Co je potřeba prozkoumat.
• Postup řešení: Oprava, která fungovala.
• Prevence: Jak se vyhnout opakování.

Při dalším výskytu podobného problému s procesorem váš programový agent během vyšetřování automaticky odkazuje na tento dokument a proměňuje zkušenosti jednoho inženýra ve sdílené týmové znalosti.

Co potřebujete

Požadavek	Podrobnosti
Verze agenta	26.1.57.0 nebo novější
Nastavení znalostí	Povoleno u agenta
Oprávnění k zápisu	Váš agent potřebuje oprávnění k zápisu do nastavení Znalostí.
Režim spuštění	Kontrola nebo autonomní. Akce zápisu vyžadují schválení v režimu revize.

Omezení

Typ	Přílohy chatu	Nahrání konfigurací znalostí	Nástroj agenta
Maximální velikost souboru	10 MB	16 MB	16 MB
Maximální součet	50 MB na zprávu	100 MB na nahrání	Není relevantní
Maximální počet souborů	5 na zprávu	Bez limitu (celková velikost je omezena na 100 MB)	1 na akci
Nahrání složky	Nepodporováno	• Přetažením složek nahrajete všechny soubory najednou.	Nepodporováno
Podporovaná rozšíření	31	28	2 (.md, .txt)
Znaky názvu souboru	Není relevantní	Písmena, číslice, pomlčky, podtržítka, tečky	Stejné
Maximální délka názvu souboru	Není relevantní	1 024 znaků	Stejné

Kdy použít něco jiného

Scénář	Lepší přístup
Připojení živého obsahu wikiwebu, který zůstane synchronizovaný	Znalostní báze wikiwebu ADO
Nahrávání binárních souborů (PDF, Word, obrázky)	Nahrání prostřednictvím Tvůrce → nastavení znalostí → Přidání souboru
Hromadný import mnoha dokumentů najednou	Nahrání více souborů prostřednictvím Tvůrce → nastavení znalostí → Přidání souboru
Automatické udržování úložišť kódu v aktualizovaném stavu	Připojení konektoru GitHub nebo ADO

Související možnosti

Schopnost	Co přidává
Znalost wikiwebu ADO	Připojení živého obsahu wikiwebu, který se aktualizuje automaticky
Analýza hlavní příčiny	Prozkoumání problémů a zachycení zjištění