Condividi tramite

Esercitazione: Connettere un wiki di Azure DevOps all'agente SRE di Azure

In questa esercitazione si connette un wiki di Azure DevOps come origine delle conoscenze per l'agente SRE di Azure. Dopo aver completato questi passaggi, l'agente può cercare i manuali operativi e le procedure del team nel wiki quando risponde alle domande, durante le indagini.

In questa esercitazione apprenderai a:

  • Connettere un wiki di Azure DevOps usando il connettore della documentazione
  • Scegliere tra l'identità gestita e l'autenticazione del token di accesso personale
  • Verificare la connessione chiedendo all'agente una domanda che usa il contenuto wiki

Tempo stimato: 10 minuti

Prerequisiti

Prima di iniziare, assicurarsi di avere le risorse e l'accesso seguenti:

  • Un agente SRE di Azure (già creato).
  • Un progetto Azure DevOps con un wiki che contiene contenuto.
  • Una di queste opzioni di autenticazione:
    • Identità gestita: aggiungere l'identità gestita dell'agente come utente nell'organizzazione di Azure DevOps (Impostazioni> organizzazioneUtenti>Aggiungi utenti> immettere l'ID client dell'identità).
    • Token di accesso personale (PAT): generare in Azure DevOps con ambito Codice (Lettura).

Ottieni l'URL del wiki

Per connettere il wiki, è necessario prima di tutto l'URL di Azure DevOps.

  1. Passare al progetto Azure DevOps.
  2. Selezionare Wiki nella barra laterale sinistra.
  3. Copiare l'URL dalla barra degli indirizzi del browser.

L'URL è simile all'esempio seguente:

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

Sono supportati anche gli URL legacy:

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

Suggerimento

Per indicizzare solo una sezione specifica del wiki, passare prima a tale sezione in Azure DevOps e quindi copiare l'URL. L'ID di pagina nell'URL indica all'agente di effettuare la scansione solo di quella pagina e delle sue sottopagine. Questo approccio è utile per wiki di grandi dimensioni in cui è rilevante solo una sezione come /Operations o /Runbooks .

Aprire la pagina Connettori

Passare alla configurazione dei connettori nel portale dell'agente SRE di Azure.

  1. Passare a sre.azure.com.
  2. Seleziona il tuo agente.
  3. Nella barra laterale sinistra espandere Generatore.
  4. Seleziona Connettori.

Viene visualizzato un elenco dei connettori esistenti, che mostra i nomi, i tipi di servizio e lo stato della connessione.

Avviare la procedura guidata Aggiungi connettore

Selezionare Aggiungi connettore sulla barra degli strumenti per aprire una procedura guidata in tre passaggi:

  1. Scegliere un connettore: selezionare il tipo di connettore.
  2. Configurare il connettore: configurare nome, URL e autenticazione.
  3. Rivedi e aggiungi: conferma e crea.

Selezionare il connettore per la documentazione

Nella selezione connettore trovare e selezionare Connettore di documentazione con il sottotitolo Azure DevOps. La descrizione del connettore legge: "L'agente fa riferimento alla documentazione e ai file per comprendere i progetti e i processi".

Selezionare Avanti per passare al modulo di installazione.

Configurare il connettore

Il titolo del modulo mostra Configurare il connettore Azure DevOps. Compilare i campi seguenti:

Campo Cosa immettere
Nome Nome descrittivo (ad esempio, ops-wiki o team-runbooks)
Azure DevOps URL L'URL del tuo wiki dal passaggio precedente

Scegliere il metodo di autenticazione

Selezionare una delle opzioni di autenticazione seguenti.

  1. Selezionare Identità gestita (selezionata per impostazione predefinita).
  2. Scegliere l'identità gestita dall'elenco a discesa Identità gestita (impostazione predefinita assegnata dal sistema).
  3. Facoltativamente, selezionare Usa identità gestita come credenziale di identità federata.

Opzione B: Token di accesso personale (PAT)

  1. Selezionare Token di accesso personale (PAT).
  2. Incolla il PAT di Azure DevOps nel campo Token di accesso personale.

Selezionare Avanti per passare al passaggio di revisione.

Esaminare e creare il connettore

Esaminare i dettagli del connettore nella schermata di riepilogo e quindi selezionare il pulsante invia per creare il connettore.

Il nuovo connettore viene visualizzato nell'elenco dei connettori con stato Connesso (segno di spunta verde).

Annotazioni

L'indicizzazione iniziale potrebbe richiedere alcuni minuti a seconda delle dimensioni del wiki. L'agente può usare il contenuto wiki al termine dell'indicizzazione.

Verificare la connessione

Testare la nuova connessione wiki chiedendo all'agente una domanda che il contenuto wiki possa rispondere.

  1. Selezionare Nuovo thread di chat nella barra laterale.
  2. Porre una domanda a cui il contenuto wiki può rispondere.

Per esempio:

What are our standard procedures for handling a database failover?

L'agente cerca il wiki insieme ad altre fonti di informazioni e include citazioni che collegano alla pagina wiki originale nella risposta. La risposta include un collegamento di citazione alla pagina wiki di origine in Azure DevOps.

Risoluzione dei problemi

Usare la tabella seguente per risolvere i problemi comuni relativi al connettore wiki di Azure DevOps.

Issue Soluzione
Il connettore mostra Disconnesso Verificare il formato dell'URL wiki e le credenziali di autenticazione.
Il contenuto wiki non viene visualizzato nelle risposte Attendere alcuni minuti per il completamento dell'indicizzazione iniziale, quindi riprovare.
Errore di convalida url Verificare che l'URL corrisponda a https://dev.azure.com/{org}/{project}/_wiki/wikis/{wiki-name} o https://dev.azure.com/{org}/{project}/_git/{repo}. Vengono accettati anche GLI URL legacy visualstudio.com .
L'autenticazione PAT ha esito negativo Verificare che il PAT abbia il scope Codice (lettura) e che non è scaduto.
L'identità gestita è fallita Verificare che l'identità gestita dell'agente sia aggiunta come utente nell'organizzazione di Azure DevOps (Impostazioni dell'organizzazione>Utenti).

Passo successivo

Informazioni sulla conoscenza wiki di ADO

Contenuti correlati

  • Last updated on