Notitie
Voor toegang tot deze pagina is autorisatie vereist. U kunt proberen u aan te melden of de directory te wijzigen.
Voor toegang tot deze pagina is autorisatie vereist. U kunt proberen de mappen te wijzigen.
Verbind uw Azure DevOps-wiki's zodat uw agent verwijst naar de runbooks en procedures van uw team tijdens onderzoeken. Wiki-inhoud wordt geïndexeerd en doorzoekbaar en uw agent vindt automatisch de juiste pagina. De connector ondersteunt zowel verificatie van beheerde identiteiten als persoonlijke toegangstokens (PAT).
Het probleem: kennis wordt niet gebruikt tijdens incidenten
Uw team investeert honderden uren aan het schrijven van runbooks, handleidingen voor probleemoplossing en operationele procedures in Azure DevOps-wiki's. Maar wanneer een incident om 3:00 uur brandt, doorzoekt niemand de wiki. De dienstdoende ingenieur opent een dozijn tabbladen, controleert Azure Monitor en lost het probleem uit het hoofd op of escaleert het. De documentatie die voor deze situatie is geschreven, gaat ongewijzigd.
De kennis bestaat. Het probleem is toegang - niet naar de wiki, maar naar de juiste pagina op het juiste moment, in de context van het werkelijke probleem.
Hoe SRE-agent dit probleem oplost
Verbind uw Azure DevOps-wiki eenmaal en uw agent doorzoekt deze automatisch tijdens elk onderzoek:
- Indexeert uw wikipagina's : verkent en indexeert alle pagina's uit uw Azure DevOps-wiki.
- Zoekt contextueel: Wanneer u een vraag stelt of een incident plaatsvindt, doorzoekt uw agent uw wiki en andere kennisbronnen.
- Verwijzingen naar specifieke pagina's : antwoorden bevatten bronvermeldingen die zijn gekoppeld aan de oorspronkelijke wikipagina.
- Hiermee worden updates opgehaald : de connector opnieuw verbinden of vernieuwen om bijgewerkte wiki-inhoud opnieuw te indexeren.
Voor en na
| Scenario | Voordat | Na |
|---|---|---|
| Reactie op incidenten | De dienstdoende persoon kijkt niet in de wiki tijdens incidenten. | Uw agent zoekt automatisch naar wiki voor elke query |
| Kennistoegang | Kennis in wiki wordt niet gebruikt om 3:00 uur | Runbooks worden exact op het juiste moment beschikbaar wanneer dat nodig is |
| onboarding | Nieuwe teamleden weten niet welke wikipagina moet worden gecontroleerd | Uw agent vindt de relevante pagina, ongeacht de ervaring |
| Zoekkwaliteit | Zoeken in wiki's vereist dat u de juiste trefwoorden kent | Uw agent begrijpt de context en vindt verwante inhoud |
Wat maakt dit anders
In tegenstelling tot statische bestandsuploads blijft uw wiki actief. Wanneer uw team een runbook bijwerken in Azure DevOps, worden de wijzigingen door uw agent opgehaald. U hoeft geen bestanden opnieuw te uploaden.
In tegenstelling tot zoeken in wiki's in volledige tekst begrijpt uw agent context. Het komt niet overeen met trefwoorden. In plaats daarvan correleert het uw vraag met relevante wiki-inhoud, waarbij deze wordt gecombineerd met livetelemetrie van Azure Monitor, logboeken van Kusto en andere verbonden bronnen.
In tegenstelling tot externe wikitoegang op basis van MCP is voor de ingebouwde documentatieconnector geen externe serverinstallatie vereist. U geeft de wiki-URL en verificatie op en uw agent verwerkt de rest.
Hoe werkt het?
De documentatieconnector (Azure DevOps servicetype) verkent uw wikipagina's en indexeert ze voor zoekopdrachten. Wanneer uw agent een query ontvangt, wordt de geïndexeerde inhoud naast andere kennisbronnen doorzocht, zoals geüploade bestanden, webpagina's en verbonden opslagplaatsen.
De connector ondersteunt twee typen Azure DevOps-inhoud:
| Inhoudstype | URL-patroon | Wat wordt geïndexeerd |
|---|---|---|
| Wiki | https://dev.azure.com/{org}/{project}/_wiki/wikis/{wiki-name} |
Alle wikipagina's (Markdown) |
| Wiki (afgebakend) | .../_wiki/wikis/{wiki-name}/{pageId}/Page-Name |
Specifieke pagina's en de bijbehorende subpagina's |
| Git-opslagplaats | https://dev.azure.com/{org}/{project}/_git/{repo} |
Tekstbestanden (Markdown, documenten, code) |
| Verouderde wiki | https://{org}.visualstudio.com/{project}/_wiki/wikis/{wiki-name} |
Hetzelfde als hierboven (verouderde URL-indeling) |
Opmerking
Wanneer u een pagina-id opneemt in de wiki-URL, indexeert de connector alleen die pagina en de bijbehorende subpagina's. Deze methode is handig voor specifieke secties, zoals /Operations of /Runbooks zonder de hele wiki te indexeren.
Hoe documentatie synchroniseren werkt
Zodra de agent is verbonden, blijft uw documentatie-index automatisch up-to-date. U hoeft niets handmatig opnieuw te uploaden.
| Aspect | Details |
|---|---|
| Synchronisatiefrequentie | Automatisch crawlen om de 24 uur |
| Ondersteunde indelingen |
.md, .txt, .rst, .adoc, .asciidoc, .wiki, .textile, .org, .htm, .html, .json, .yaml, .yml, .xml, .csv (15 bestandsindelingen) |
| Indexeringsproces | Documenten zijn gesegmenteerd, ingesloten en geïndexeerd voor semantische zoekopdrachten |
| Updates | Wijzigingen in uw opslagplaats worden tijdens de volgende synchronisatiecyclus opgenomen zonder dat er handmatige actie nodig is. |
Uw agent verwerkt elk document door het op te splitsen in semantisch zinvolle segmenten, vector insluitingen te genereren en op te slaan in een zoekindex. Wanneer een query binnenkomt, voert uw agent een semantische zoekopdracht uit op alle geïndexeerde segmenten en haalt u de meest relevante passages op, ongeacht exacte trefwoordovereenkomsten.
Uw team kan runbooks bijwerken, nieuwe procedures toevoegen of wikipagina's opnieuw ordenen en uw agent weerspiegelt deze wijzigingen binnen 24 uur.
Vereiste voorwaarden
| Requirement | Details |
|---|---|
| Azure DevOps-wiki | Een wiki in uw Azure DevOps-project met inhoud |
| Authentication | Beheerde identiteit (aanbevolen) of persoonlijk toegangstoken (PAT) |
| toestemmingen | Leestoegang tot de wiki |
Verificatieopties
In de volgende tabel worden de beschikbare verificatiemethoden voor de Azure DevOps-wikiconnector beschreven.
| Methode | Het beste voor | Hoe werkt het? |
|---|---|---|
| beheerde identiteit | Productieomgevingen | Maakt gebruik van de door het systeem toegewezen of door de gebruiker toegewezen beheerde identiteit van uw agent. Hiervoor moet u de identiteit toevoegen als een gebruiker in uw Azure DevOps-organisatie. |
| Persoonlijk toegangstoken (PAT) | Snelle installatie, testen | Genereer een PAT in Azure DevOps met Code (Lezen) scope. |
Voorbeeld: een runbook gebruiken tijdens een incident
Nadat u verbinding hebt gemaakt met uw bewerkingswiki, vraagt u uw agent:
Our payment service is returning 503 errors. What does our runbook say to do?
Uw agent doorzoekt uw wiki, zoekt de pagina Probleemoplossing van de betalingsservice en reageert met de gedocumenteerde procedure. Het antwoord bevat een bronvermelding die is gekoppeld aan de oorspronkelijke wikipagina in Azure DevOps.