Kurz: Připojení wikiwebu Azure DevOps k agentovi Azure SRE

V tomto kurzu připojíte wikiweb Azure DevOps jako zdroj znalostí pro svého agenta Azure SRE. Po dokončení těchto kroků může váš agent prohledávat týmové wiki pro runbooky a postupy, když odpovídá na otázky během vyšetřování.

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

  • Připojení wikiwebu Azure DevOps pomocí konektoru dokumentace
  • Vyberte mezi ověřováním spravované identity a osobního přístupového tokenu (PAT)
  • Ověřte připojení tím, že položíte agentovi otázku, která používá obsah wiki.

Odhadovaný čas: 10 minut

Předpoklady

Než začnete, ujistěte se, že máte následující prostředky a přístup:

  • Agent Azure SRE (už vytvořený).
  • Projekt Azure DevOps s wikiwebem, který obsahuje obsah
  • Jedna z těchto možností ověřování:
    • Spravovaná identita: Přidejte spravovanou identitu agenta jako uživatele v organizaci Azure DevOps (Nastavení organizace>Uživatelé>Přidat uživatele> zadejte ID klienta identity).
    • Osobní přístupový token (PAT): Vygenerujte v Azure DevOps s rozsahem Code (Read).

Získání adresy URL wikiwebu

K připojení wikiwebu potřebujete nejprve adresu URL z Azure DevOps.

  1. Přejděte do projektu Azure DevOps.
  2. Na levém bočním panelu vyberte wikiweb .
  3. Zkopírujte adresu URL z adresního řádku prohlížeče.

Vaše adresa URL vypadá jako v tomto příkladu:

https://dev.azure.com/{your-org}/{your-project}/_wiki/wikis/{wiki-name}

Podporují se také starší adresy URL:

https://{your-org}.visualstudio.com/{your-project}/_wiki/wikis/{wiki-name}

Návod

Pokud chcete indexovat jenom konkrétní část wikiwebu, přejděte nejprve do tohoto oddílu v Azure DevOps a zkopírujte adresu URL. ID stránky v adrese URL říká agentovi, aby procházal jenom tuto stránku a její podstránky. Tento přístup je užitečný pro velké wiki, kde je relevantní jenom oddíl /Operations nebo /Runbooks.

Otevřete stránku Konektory

Na portálu agenta Azure SRE přejděte ke konfiguraci konektorů.

  1. Přejděte na sre.azure.com.
  2. Vyberte agenta.
  3. Na levém bočním panelu rozevřete Builder.
  4. Vyberte Konektory.

Zobrazí se seznam existujících konektorů s jejich názvy, typy služeb a stavem připojení.

Spustit průvodce pro přidání konektoru

Výběrem možnosti Přidat spojnici na panelu nástrojů otevřete průvodce třemi kroky:

  1. Zvolte spojnici: Vyberte typ spojnice.
  2. Nastavení konektoru: Konfigurace názvu, adresy URL a ověřování
  3. Zkontrolovat a přidat: Potvrdit a vytvořit

Vyberte konektor pro dokumentaci

V nástroji pro výběr konektoru vyhledejte a vyberte Konektor dokumentace s podnadpisem Azure DevOps. Popis konektoru popisuje, že agent odkazuje na dokumentaci a soubory, abyste porozuměli vašim projektům a procesům.

Chcete-li pokračovat ve formuláři nastavení, vyberte Další .

Konfigurace konektoru

Název formuláře zobrazuje nastavení konektoru Azure DevOps. Vyplňte následující pole:

Pole Co zadat
název Popisný název (například ops-wiki nebo team-runbooks)
Azure DevOps URL URL wiki z předchozího kroku

Volba metody ověřování

Vyberte jednu z následujících možností ověřování.

  1. Vyberte spravovanou identitu (ve výchozím nastavení je vybraná).
  2. V rozevíracím seznamu Spravované identity zvolte svou spravovanou identitu (výchozí nastavení: systémem přiřazené).
  3. Volitelně vyberte Použít spravovanou identitu jako přihlašovací údaje federované identity.

Možnost B: Osobní přístupový token (PAT)

  1. Vyberte token PAT (Personal Access Token).
  2. Vložte svůj Azure DevOps PAT do pole Osobní přístupový token.

Výběrem možnosti Další přejděte ke kroku revize.

Kontrola a vytvoření konektoru

Zkontrolujte podrobnosti o konektoru na souhrnné obrazovce a pak výběrem tlačítka Odeslat vytvořte konektor.

Nový konektor se zobrazí v seznamu konektorů se stavem Připojeno (zelené zaškrtnutí).

Poznámka:

Počáteční indexování může trvat několik minut v závislosti na velikosti wikiwebu. Po dokončení indexování může váš agent používat obsah wikiwebu.

Ověření připojení

Otestujte nové připojení wikiwebu tak, že položíte agenta otázku, na kterou může váš obsah wikiwebu odpovědět.

  1. Na bočním panelu vyberte nové vlákno chatu .
  2. Položte otázku, na kterou může váš obsah wikiwebu odpovědět.

Například:

What are our standard procedures for handling a database failover?

Váš agent prohledá wikiweb společně s dalšími zdroji znalostí a obsahuje citace odkazující na původní stránku wikiwebu v odpovědi. Odpověď obsahuje odkaz na citaci zpět na zdrojovou stránku wikiwebu v Azure DevOps.

Troubleshooting

Použijte následující tabulku k řešení běžných problémů s konektorem Azure DevOps wiki.

Problém Řešení
Konektor zobrazuje odpojeno Ověřte formát URL wiki a autentizační přihlašovací údaje.
Obsah wikiwebu se nezobrazuje v odpovědích Počkejte několik minut, než se počáteční indexování dokončí, a zkuste to znovu.
Chyba ověření adresy URL Ujistěte se, že adresa URL odpovídá https://dev.azure.com/{org}/{project}/_wiki/wikis/{wiki-name} nebo https://dev.azure.com/{org}/{project}/_git/{repo}. Akceptují se také starší visualstudio.com adresy URL.
Selhání ověřování PAT Zkontrolujte, jestli má váš PAT rozsah Kód (čtení) a nevypršela.
Selhání spravované identity Ověřte, že spravovaná identita agenta je přidána jako uživatel ve vaší organizaci Azure DevOps (Nastavení organizace>Uživatelé).

Další krok

Další informace o znalostech wikiwebu ADO

Související obsah

  • Last updated on