Nota
L'accesso a questa pagina richiede l'autorizzazione. È possibile provare ad accedere o modificare le directory.
L'accesso a questa pagina richiede l'autorizzazione. È possibile provare a modificare le directory.
Connettere i wiki di Azure DevOps in modo che l'agente faccia riferimento ai runbook e alle procedure del team durante le indagini. Il contenuto wiki è indicizzato e ricercabile e l'agente trova automaticamente la pagina corretta. Il connettore supporta sia l'autenticazione dell'identità gestita che l'autenticazione del token di accesso personale .
Problema: le informazioni non vengono usate durante gli eventi imprevisti
Il team investe centinaia di ore per scrivere runbook, guide alla risoluzione dei problemi e procedure operative nei wiki di Azure DevOps. Ma quando un incidente si verifica alle 3:00, nessuno consulta il wiki. Il tecnico su chiamata apre una dozzina di schede, controlla Azure Monitor e lo risolve a memoria o fa l'escalation. La documentazione scritta per questa situazione non viene consultata.
La conoscenza esiste. Il problema è l'accesso - non al wiki, ma alla pagina giusta al momento giusto, nel contesto del problema effettivo.
Come l'agente SRE risolve questo problema
Connettere il wiki di Azure DevOps una sola volta e l'agente lo cerca automaticamente durante ogni indagine:
- Indicizza le pagine wiki — indicizza tutte le pagine del wiki di Azure DevOps.
- Ricerche contestuali : quando si pone una domanda o si verifica un evento imprevisto, l'agente cerca il wiki insieme ad altre fonti di informazioni.
- Riferimenti a pagine specifiche: le risposte includono citazioni che si collegano nuovamente alla pagina wiki originale.
- Rileva gli aggiornamenti : riconnettere o aggiornare il connettore per reindicizzare il contenuto wiki aggiornato.
Prima e dopo
| Scenario | Prima | Dopo |
|---|---|---|
| Risposta agli eventi imprevisti | La persona su chiamata non esegue ricerche nel wiki durante gli eventi imprevisti | L'agente cerca automaticamente ogni query nel wiki |
| Accesso alle informazioni | Le informazioni nel wiki non vengono usate alle 3:00 | I runbook vengono visualizzati esattamente quando necessario |
| Inserimento | I nuovi membri del team non conoscono la pagina wiki da controllare | L'agente trova la pagina pertinente indipendentemente dall'esperienza |
| Qualità della ricerca | La ricerca wiki richiede la conoscenza delle parole chiave corrette | L'agente comprende il contesto e trova il contenuto correlato |
Cosa rende questo diverso
A differenza dei caricamenti di file statici, il wiki rimane attivo. Quando il team aggiorna un runbook in Azure DevOps, l'agente rileva le modifiche. Non è necessario ricaricare i file.
A differenza della ricerca wiki full-text, l'agente riconosce il contesto. Non corrisponde alle parole chiave. Correla invece la domanda al contenuto wiki pertinente, combinandola con i dati di telemetria in tempo reale di Monitoraggio di Azure, i log da Kusto e altre origini connesse.
A differenza dell'accesso wiki basato su MCP esterno, il connettore di documentazione predefinito non richiede alcuna configurazione del server esterno. Specificare l'URL wiki e l'autenticazione e l'agente gestisce il resto.
Come funziona
Il connettore per la documentazione (Azure DevOps tipo di servizio) scansiona le tue pagine wiki e le indicizza per la ricerca. Quando l'agente riceve una query, cerca il contenuto indicizzato insieme ad altre origini informazioni, ad esempio file caricati, pagine Web e repository connessi.
Il connettore supporta due tipi di contenuto di Azure DevOps:
| Tipo di contenuto | Modello URL | Cosa viene indicizzato |
|---|---|---|
| Wiki | https://dev.azure.com/{org}/{project}/_wiki/wikis/{wiki-name} |
Tutte le pagine wiki (Markdown) |
| Wiki (limitato) | .../_wiki/wikis/{wiki-name}/{pageId}/Page-Name |
Pagina specifica e pagine secondarie |
| Repository Git | https://dev.azure.com/{org}/{project}/_git/{repo} |
File di testo (Markdown, docs, codice) |
| Wiki storico | https://{org}.visualstudio.com/{project}/_wiki/wikis/{wiki-name} |
Uguale a quanto sopra (formato URL legacy) |
Annotazioni
Quando si include un ID pagina nell'URL wiki, il connettore indicizza solo tale pagina e le relative pagine secondarie. Questo approccio è utile per definire come destinazione sezioni specifiche come /Operations o /Runbooks senza indicizzare l'intero wiki.
Funzionamento della sincronizzazione della documentazione
Dopo la connessione, l'agente mantiene aggiornato automaticamente l'indice della documentazione. Non è necessario ricaricare manualmente alcun elemento.
| Aspetto | dettagli |
|---|---|
| Frequenza di sincronizzazione | Scansione automatica ogni 24 ore |
| Formati supportati |
.md, .txt, .rst, .adoc, .asciidoc, .wiki, .textile, .org, .htm, .html, .json, .yaml, .yml, (.xml 15 formati di file) .csv |
| Processo di indicizzazione | I documenti sono in blocchi, incorporati e indicizzati per la ricerca semantica |
| Updates | Le modifiche nel repository vengono prelevate nel ciclo di sincronizzazione successivo senza alcuna azione manuale necessaria |
L'agente elabora ogni documento suddividendolo in blocchi semanticamente significativi, generando incorporamenti vettoriali e archiviandoli in un indice di ricerca. Quando arriva una query, l'agente esegue una ricerca semantica in tutti i blocchi indicizzati e recupera i passaggi più rilevanti, indipendentemente dalle corrispondenze esatte delle parole chiave.
Il team può aggiornare i runbook, aggiungere nuove procedure o riorganizzare le pagine wiki e l'agente riflette tali modifiche entro 24 ore.
Prerequisiti
| Requisito | dettagli |
|---|---|
| Wiki di Azure DevOps | Wiki nel progetto Azure DevOps con contenuto |
| Autenticazione | Identità gestita (scelta consigliata) o token di accesso personale (PAT) |
| Autorizzazioni | Accesso di sola lettura al wiki |
Opzioni di autenticazione
La tabella seguente descrive i metodi di autenticazione disponibili per il connettore wiki di Azure DevOps.
| metodo | Ideale per | Come funziona |
|---|---|---|
| Identità gestita | Ambienti di produzione | Usa l'identità gestita dell'agente assegnata dal sistema o dall'utente. Richiede l'aggiunta dell'identità come utente nell'organizzazione di Azure DevOps. |
| Token di accesso personale | Configurazione rapida, test | Generare un PAT (Personal Access Token) in Azure DevOps con ambito Codice (lettura). |
Esempio: utilizzare un runbook durante un incidente
Dopo aver connesso il wiki delle operazioni, chiedere all'agente:
Our payment service is returning 503 errors. What does our runbook say to do?
L'agente cerca nel wiki, trova la pagina "Risoluzione dei problemi del servizio di pagamento" e risponde con la procedura documentata. La risposta include un riferimento alla pagina wiki originale in Azure DevOps.