Poznámka:
Přístup k této stránce vyžaduje autorizaci. Můžete se zkusit přihlásit nebo změnit adresáře.
Přístup k této stránce vyžaduje autorizaci. Můžete zkusit změnit adresáře.
Připojte wikiweby Azure DevOps, aby mohl váš agent během vyšetřování odkazoval na runbooky a postupy vašeho týmu. Obsah wikiwebu je indexovaný a prohledávatelný a váš agent najde správnou stránku automaticky. Konektor podporuje ověřování pomocí spravované identity i osobního přístupového tokenu (PAT).
Problém: Během incidentů se znalosti nevyužívají
Váš tým investuje stovky hodin psaní runbooků, průvodců odstraňováním potíží a provozních postupů na wikiwebech Azure DevOps. Ale když k incidentu dojde ve 3:00 ráno, nikdo nehledá na wiki. On-call inženýr otevře tucet karet, zkontroluje Azure Monitor a buď to zjistí z paměti, nebo eskaluje. Dokumentace napsaná přesně pro tuto situaci zůstane nepoužitá.
Znalost existuje. Problém je přístup – ne k wiki, ale ke správné stránce ve správný čas v kontextu daného problému.
Jak agent SRE řeší tento problém
Připojte wikiweb Azure DevOps jednou a agent ho během každého šetření automaticky prohledá:
- Indexuje stránky wikiwebu – procházení a indexování všech stránek z wikiwebu Azure DevOps.
- Prohledává kontextově – když položíte otázku nebo je spuštěn incident, váš agent prohledá vaši wiki společně s dalšími zdroji znalostí.
- Odkazy na konkrétní stránky – Odpovědi zahrnují citace odkazující zpět na původní stránku wikiwebu.
- Přebírá aktualizace – Znovu se připojte nebo aktualizujte konektor a znovu indexujte aktualizovaný obsah wikiwebu.
Před a po
| Scénář | před | Po |
|---|---|---|
| Reakce na incidenty | Osoba v pohotovostním režimu nehledá během incidentů na wiki. | Váš agent vyhledá wikiweb automaticky pro každý dotaz. |
| Přístup ke znalostem | Znalosti na wiki jsou nevyužité ve 03:00 | Runbooky se objeví přesně, když je to potřeba. |
| Onboarding | Noví členové týmu neví, která stránka wikiwebu se má zkontrolovat | Váš agent najde příslušnou stránku bez ohledu na prostředí. |
| Kvalita vyhledávání | Hledání na wikiwebu vyžaduje znalost správných klíčových slov. | Váš agent rozumí kontextu a najde související obsah. |
Co to dělá jinak
Na rozdíl od nahrávání statických souborů zůstane wiki naživu. Když váš tým aktualizuje runbook v Azure DevOps, váš agent převezme změny. Nemusíte znovu nahrávat soubory.
Na rozdíl od fulltextového vyhledávání wikiwebu agent rozumí kontextu. Neodpovídá klíčovým slovům. Místo toho koreluje vaši otázku s relevantním obsahem wikiwebu, kombinuje ji s živou telemetrií ze služby Azure Monitor, protokoly z Kusto a dalšími připojenými zdroji.
Na rozdíl od externího přístupu k wiki na bázi MCP vestavěný konektor dokumentace nevyžaduje žádné nastavení externího serveru. Poskytnete adresu URL a ověřovací údaje pro wiki, a váš agent se postará o zbytek.
Jak to funguje
Konektor dokumentace (Azure DevOps typ služby) prochází stránky wikiwebu a indexuje je pro vyhledávání. Když váš agent obdrží dotaz, prohledá indexovaný obsah spolu s dalšími zdroji znalostí, jako jsou nahrané soubory, webové stránky a připojené úložiště.
Konektor podporuje dva typy obsahu Azure DevOps:
| Typ obsahu | Vzor adresy URL | Co se indexuje |
|---|---|---|
| Wiki | https://dev.azure.com/{org}/{project}/_wiki/wikis/{wiki-name} |
Všechny stránky wikiwebu (Markdown) |
| Wiki (vymezený obor) | .../_wiki/wikis/{wiki-name}/{pageId}/Page-Name |
Konkrétní stránka a její podstránky |
| Úložiště Git | https://dev.azure.com/{org}/{project}/_git/{repo} |
Textové soubory (Markdown, docs, kód) |
| Starší wiki | https://{org}.visualstudio.com/{project}/_wiki/wikis/{wiki-name} |
Stejné jako výše (starší formát adresy URL) |
Poznámka:
Pokud do adresy URL wikiwebu zahrnete ID stránky, konektor indexuje pouze tuto stránku a její podstránky. Tento přístup je užitečný pro cílení na konkrétní oddíly, jako je /Operations nebo /Runbooks, aniž by bylo nutné indexovat celé wiki.
Jak funguje synchronizace dokumentace
Po připojení váš agent udržuje index dokumentace automaticky aktuální. Nemusíte znovu ručně nahrávat žádné soubory ani data.
| Aspekt | Podrobnosti |
|---|---|
| Frekvence synchronizace | Automatické procházení každých 24 hodin |
| Podporované formáty |
.md, .txt, .rst, .adoc, .asciidoc, .wiki, .textile, .org, .htm, .html, .json, .yaml, .yml, .xml, .csv (15 formátů souborů) |
| Proces indexování | Dokumenty jsou rozdělené, vložené a indexované pro sémantické vyhledávání. |
| Aktualizace | Změny v úložišti jsou zaznamenány v příštím cyklu synchronizace bez nutnosti ručního zásahu. |
Váš agent zpracovává každý dokument rozdělením do sémanticky smysluplných bloků dat, generováním vektorových vkládání a jejich uložením do vyhledávacího indexu. Když dorazí dotaz, váš agent provede sémantické vyhledávání ve všech indexovaných blocích a načte nejrelevavantnější pasáže bez ohledu na přesnou shodu klíčových slov.
Váš tým může aktualizovat runbooky, přidat nové postupy nebo změnit uspořádání wiki stránek a váš agent tyto změny odráží do 24 hodin.
Předpoklady
| Požadavek | Podrobnosti |
|---|---|
| Wiki Azure DevOps | Wikiweb v projektu Azure DevOps s obsahem |
| Autentizace | Spravovaná identita (doporučeno) nebo osobní přístupový token (PAT) |
| Povolení | Přístup pro čtení na wiki |
Možnosti ověřování
Následující tabulka popisuje dostupné metody ověřování pro konektor wikiwebu Azure DevOps.
| Metoda | Nejvhodnější pro | Jak to funguje |
|---|---|---|
| Spravovaná identita | Produkční prostředí | Používá spravovanou identitu přiřazenou systémem nebo přiřazenou uživatelem vašeho agenta. Vyžaduje přidání identity jako uživatele ve vaší organizaci Azure DevOps. |
| Osobní přístupový token (PAT) | Rychlé nastavení, testování | Vygenerujte PAT v Azure DevOps s rozsahem Code (Read). |
Příklad: Použití runbooku během incidentu
Po připojení vašeho provozního wikiwebu se zeptejte agenta:
Our payment service is returning 503 errors. What does our runbook say to do?
Váš agent vyhledá váš wikiweb, najde stránku Řešení potíží s platební službou a odpoví zdokumentovaným postupem. Odpověď obsahuje citaci odkazující zpět na původní stránku wikiwebu v Azure DevOps.