Delen via

Zelfstudie: Een Azure DevOps-wiki verbinden met Azure SRE-agent

In deze zelfstudie verbindt u een Azure DevOps-wiki als kennisbron voor uw Azure SRE-agent. Nadat u deze stappen hebt voltooid, kan uw agent de wiki van uw team doorzoeken op runbooks en procedures wanneer er tijdens het onderzoek vragen worden beantwoord.

In deze handleiding leer je hoe je:

  • Een Azure DevOps-wiki verbinden met behulp van de documentatieconnector
  • Kiezen tussen verificatie van beheerde identiteit en persoonlijk toegangstoken (PAT)
  • Controleer de verbinding door uw agent een vraag te stellen die gebruikmaakt van wiki-inhoud

Geschatte tijd: 10 minuten

Vereiste voorwaarden

Voordat u begint, moet u ervoor zorgen dat u over de volgende resources en toegang beschikt:

  • Een Azure SRE-agent (al gemaakt).
  • Een Azure DevOps-project met een wiki die inhoud bevat.
  • Een van deze verificatieopties:
    • Beheerde identiteit: voeg de beheerde identiteit van uw agent toe als een gebruiker in uw Azure DevOps-organisatie (Organisatie-instellingen>gebruikers>gebruikers toevoegen gebruikers> invoeren de client-id van de identiteit).
    • Persoonlijk toegangstoken (PAT):Genereer in Azure DevOps met codebereik (leesbereik).

Uw wiki-URL ophalen

Als u verbinding wilt maken met uw wiki, hebt u eerst de URL van Azure DevOps nodig.

  1. Ga naar uw Azure DevOps-project.
  2. Selecteer Wiki in de linkerzijbalk.
  3. Kopieer de URL uit de adresbalk van uw browser.

Uw URL ziet er als volgt uit:

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

Verouderde URL's worden ook ondersteund:

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

Aanbeveling

Als u alleen een specifieke sectie van uw wiki wilt indexeren, gaat u eerst naar die sectie in Azure DevOps en kopieert u de URL. De pagina-id in de URL laat uw agent alleen die pagina en de bijbehorende subpagina's verkennen. Deze benadering is handig voor grote wiki's waarbij alleen een sectie zoals /Operations of /Runbooks relevant is.

De pagina Connectors openen

Ga naar de configuratie van connectors in de Azure SRE Agent-portal.

  1. Ga naar sre.azure.com.
  2. Selecteer uw agent.
  3. Vouw Builder uit in de zijbalk aan de linkerkant.
  4. Selecteer Connectors.

Er wordt een lijst met bestaande connectors weergegeven, waarin de namen, servicetypen en verbindingsstatus worden weergegeven.

De wizard Connector toevoegen starten

Selecteer Connector toevoegen op de werkbalk om een wizard met drie stappen te openen:

  1. Kies een connector: selecteer het connectortype.
  2. Connector instellen: Naam, URL en verificatie configureren.
  3. Beoordelen en toevoegen: Bevestigen en maken.

Selecteer de connector voor documentatie

Zoek en selecteer in de Connectorkiezer Documentatieconnector met de ondertitel Azure DevOps. De beschrijving van de connector leest: 'De agent verwijst naar documentatie en bestanden om inzicht te krijgen in uw projecten en processen'.

Selecteer Volgende om door te gaan naar het installatieformulier.

De connector configureren

In de formuliertitel ziet u De Azure DevOps-connector instellen. Vul de volgende velden in:

Veld Wat moet ik invoeren?
Naam Een beschrijvende naam (bijvoorbeeld ops-wiki of team-runbooks)
Azure DevOps-URL Uw wiki-URL uit de vorige stap

Uw verificatiemethode kiezen

Selecteer een van de volgende verificatieopties.

  1. Selecteer Beheerde identiteit (standaard geselecteerd).
  2. Kies uw beheerde identiteit in de vervolgkeuzelijst Beheerde identiteit (standaard ingesteld op Door het systeem toegewezen).
  3. Selecteer desgewenst Beheerde identiteit gebruiken als federatieve identiteitsreferentie.

Optie B: Persoonlijk toegangstoken (PAT)

  1. Selecteer Persoonlijk toegangstoken (PAT).
  2. Plak uw Azure DevOps PAT in het veld Persoonlijk toegangstoken .

Selecteer Volgende om door te gaan met de beoordelingsstap.

De connector beoordelen en vervolgens maken

Controleer de details van de connector op het overzichtsscherm en selecteer vervolgens de knop Verzenden om de connector te maken.

De nieuwe connector wordt weergegeven in de lijst met connectors met de status Verbonden (groen vinkje).

Opmerking

Het initiële indexeren kan enkele minuten duren, afhankelijk van de grootte van uw wiki. Uw agent kan de wiki-inhoud gebruiken nadat de indexering is voltooid.

De verbinding controleren

Test de nieuwe wikiverbinding door de agent een vraag te stellen die uw wiki-inhoud kan beantwoorden.

  1. Selecteer Nieuwe chat-thread in de zijbalk.
  2. Stel een vraag die uw wiki-inhoud kan beantwoorden.

Voorbeeld:

What are our standard procedures for handling a database failover?

Uw agent doorzoekt uw wiki naast andere kennisbronnen en bevat bronvermeldingen die zijn gekoppeld aan de oorspronkelijke wikipagina in het antwoord. Het antwoord bevat een bronvermeldingskoppeling terug naar de bronwikipagina in Azure DevOps.

Troubleshooting

Gebruik de volgende tabel om veelvoorkomende problemen met de Azure DevOps-wikiconnector op te lossen.

Issue Solution
Connector toont Verbinding verbroken Controleer uw wiki-URL-indeling en verificatiereferenties.
Wiki-inhoud wordt niet weergegeven in antwoorden Wacht enkele minuten totdat de eerste indexering is voltooid en probeer het opnieuw.
URL-validatiefout Zorg ervoor dat de URL overeenkomt met https://dev.azure.com/{org}/{project}/_wiki/wikis/{wiki-name} of https://dev.azure.com/{org}/{project}/_git/{repo}. Verouderde visualstudio.com URL's worden ook geaccepteerd.
PAT-verificatie mislukt Controleer of uw PAT het codebereik (lees) heeft en niet is verlopen.
Beheerde identiteit mislukt Controleer of de beheerde identiteit van de agent wordt toegevoegd als een gebruiker in uw Azure DevOps-organisatie (gebruikers van organisatie-instellingen>).

Volgende stap

Meer informatie over ADO Wiki-kennis

Verwante inhoud

  • Last updated on