Dela via

Självstudie: Ansluta en Azure DevOps-wiki till Azure SRE Agent

I den här självstudien ansluter du en Azure DevOps-wiki som kunskapskälla för din Azure SRE-agent. När du har slutfört de här stegen kan din agent söka i teamets wiki efter körböcker och processer när den besvarar frågor under utredningar.

I den här tutorialen lär du dig följande:

  • Ansluta en Azure DevOps-wiki med hjälp av dokumentationsanslutningsappen
  • Välj mellan autentisering med hanterad identitet och personlig åtkomsttoken (PAT)
  • Verifiera anslutningen genom att ställa en fråga till agenten som använder wiki-innehåll

Uppskattad tid: 10 minuter

Förutsättningar

Kontrollera att du har följande resurser och åtkomst innan du börjar:

  • En Azure SRE-agent (redan skapad).
  • Ett Azure DevOps-projekt med en wiki som innehåller innehåll.
  • Ett av följande autentiseringsalternativ:
    • Hanterad identitet: Lägg till agentens hanterade identitet som användare i din Azure DevOps-organisation (Organisationsinställningar>Användare>Lägg till användare> anger identitetens klient-ID).
    • Personlig åtkomsttoken (PAT): Generera i Azure DevOps med kodomfång (Läs ).

Hämta din wiki-URL

För att ansluta din wiki behöver du först URL:en från Azure DevOps.

  1. Gå till ditt Azure DevOps-projekt.
  2. Välj Wiki i det vänstra sidofältet.
  3. Kopiera URL:en från webbläsarens adressfält.

Url:en ser ut så här:

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

Äldre URL:er stöds också:

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

Tips/Råd

Om du bara vill indexera ett visst avsnitt i wikin går du först till det avsnittet i Azure DevOps och kopierar sedan URL:en. Sid-ID:t i URL:en uppmanar din agent att endast crawla sidan och dess undersidor. Den här metoden är användbar för stora wikis där endast ett avsnitt som /Operations eller /Runbooks är relevant.

Öppna sidan Anslutningsappar

Gå till konfigurationen för anslutningar i Azure SRE-agentportalen.

  1. Gå till sre.azure.com.
  2. Välj din handläggare.
  3. Expandera Builder i det vänstra sidofältet.
  4. Välj Anslutningar.

En lista över dina befintliga kopplare visas och visar deras namn, tjänstetyper och anslutningsstatus.

Starta guiden Lägg till anslutningsguide

Välj Lägg till anslutning i verktygsfältet för att öppna en trestegsguide:

  1. Välj en kontakt: Välj kontakttyp.
  2. Konfigurera anslutningsapp: Konfigurera namn, URL och autentisering.
  3. Granska + lägg till: Bekräfta och skapa.

Välj dokumentationsanslutningsappen

I anslutningsväljaren letar du upp och väljer Dokumentationsanslutning med underrubriken Azure DevOps. Beskrivningen av anslutningsappen lyder: "Agenten refererar till dokumentation och filer för att förstå dina projekt och processer."

Välj Nästa för att fortsätta till installationsformuläret.

Konfigurera anslutaren

Formulärrubriken visar Konfigurera Azure DevOps-anslutningsprogram. Fyll i följande fält:

Fält Vad du ska ange
Namn Ett beskrivande namn (till exempel ops-wiki eller team-runbooks)
Azure DevOps URL Wiki-URL:en från föregående steg

Välj din autentiseringsmetod

Välj något av följande autentiseringsalternativ.

  1. Välj Hanterad identitet (markerad som standard).
  2. Välj din hanterade identitet i listrutan Hanterad identitet (standardinställningen systemtilldelad).
  3. Du kan också välja Använd hanterad identitet som federerad identitetsautentiseringsuppgift.

Alternativ B: Personlig åtkomsttoken (PAT)

  1. Välj Personlig åtkomsttoken (PAT).
  2. Klistra in din Azure DevOps PAT i fältet Personlig åtkomsttoken .

Välj Nästa för att gå vidare till granskningssteget.

Granska och skapa anslutningen

Granska anslutningsinformationen på sammanfattningsskärmen och välj sedan knappen Skicka för att skapa anslutningsappen.

Den nya anslutningsappen visas i listan över anslutningsappar med statusen Ansluten (grön bock).

Anmärkning

Den första indexeringen kan ta några minuter beroende på wikins storlek. Din agent kan använda wiki-innehållet när indexeringen har slutförts.

Verifiera anslutningen

Testa den nya wiki-anslutningen genom att ställa en fråga till agenten som ditt wiki-innehåll kan besvara.

  1. Välj Ny chatttråd i sidopanelen.
  2. Ställ en fråga som ditt wiki-innehåll kan besvara.

Som exempel:

What are our standard procedures for handling a database failover?

Din agent söker i din wiki tillsammans med andra kunskapskällor och innehåller citat som länkar till den ursprungliga wiki-sidan i svaret. Svaret innehåller en källlänk tillbaka till wiki-källsidan i Azure DevOps.

Felsökning

Använd följande tabell för att lösa vanliga problem med Wiki-anslutningsappen för Azure DevOps.

Problematik Lösning
Anslutningsappen visar frånkopplad Verifiera wiki-URL-formatet och autentiseringsuppgifterna.
Wiki-innehåll visas inte i svar Vänta några minuter tills den första indexeringen har slutförts och försök sedan igen.
URL-valideringsfel Kontrollera att URL:en matchar https://dev.azure.com/{org}/{project}/_wiki/wikis/{wiki-name} eller https://dev.azure.com/{org}/{project}/_git/{repo}. Äldre visualstudio.com URL:er accepteras också.
PAT-autentisering misslyckas Kontrollera att din PAT har Code (Läs) omfång och inte har löpt ut.
Hanterad identitet misslyckas Kontrollera att agentens hanterade identitet har lagts till som en användare i din Azure DevOps-organisation (Organisationsinställningar>Användare).

Nästa steg

Lär dig mer om ADO Wiki-kunskap

Relaterat innehåll

  • Last updated on