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 Azure DevOps in modo che l'agente possa cercare il codice, creare elementi di lavoro e indicizzare il wiki come origine delle conoscenze.
Suggerimento
Panoramica rapida
- Due tipi di connettore: Azure DevOps OAuth per codice live ed elementi di lavoro, connettore di documentazione per la conoscenza wiki.
- OAuth supporta l'account utente (ID Microsoft Entra) e l'autenticazione dell'identità gestita .
- Un singolo connettore copre l'intera organizzazione di Azure DevOps, inclusi tutti i progetti e i repository.
- Il contenuto wiki viene indicizzato per la ricerca semantica e le sincronizzazioni automatica ogni 24 ore.
Due tipi di connettore
Azure DevOps ha due tipi di connettore perché servono scopi diversi.
| Connettore | Funzionamento | Opzioni di autenticazione |
|---|---|---|
| Azure DevOps OAuth | Accesso al codice sorgente live, elementi di lavoro, pipeline, ricerca di codice semantico | Account utente (OAuth) o identità gestita |
| Connettore di documentazione | Indicizza pagine wiki e documenti in una knowledge base ricercabile | Identità gestita o "PAT" |
È possibile usare entrambi insieme. Usare il connettore OAuth per le indagini sul codice live e il connettore di documentazione per informazioni basate su wiki.
Connettore OAuth di Azure DevOps
Il connettore OAuth consente all'agente l'accesso in tempo reale al codice sorgente, agli elementi di lavoro e alle pipeline nell'intera organizzazione di Azure DevOps.
Tipi di autenticazione
Scegliere il metodo di autenticazione più adatto alle esigenze del team.
| metodo | Come funziona | Ideale per |
|---|---|---|
| Account utente | Accedere con l'account Microsoft Entra ID. L'agente accede ad Azure DevOps tramite le autorizzazioni. I token vengono aggiornati automaticamente. | La configurazione interattiva è consigliata per la maggior parte degli utenti |
| Identità gestita | Usare l'identità gestita dell'agente per l'autenticazione. Supporta le credenziali di identità federate (FIC) per l'accesso tra tenant. | Configurazione automatizzata, account di servizio, accesso tra tenant |
Suggerimento
I token OAuth vengono aggiornati automaticamente
I token OAuth di Azure DevOps scadono dopo circa un'ora, ma l'agente li aggiorna automaticamente prima della scadenza usando un buffer di 5 minuti. Ogni aggiornamento genera un nuovo token di aggiornamento, creando una catena di rinnovo a supporto automatico. Il connettore rimane connesso durante indagini di più ore senza richiedere la riautenticazione manuale.
Quando è necessario eseguire di nuovo l'autenticazione: se il token di aggiornamento scade (la durata varia in base ai criteri microsoft Entra ID), se un amministratore revoca l'autorizzazione dell'app o se si configura il connettore prima della versione 26.2.247.0 (una nuova autenticazione abilita l'aggiornamento automatico in futuro).
Operazioni che l'agente può eseguire
Il connettore OAuth offre all'agente le funzionalità seguenti.
Analisi del codice sorgente:
- Eseguire ricerche nel codice in tutti i repository dell'organizzazione usando l'API Ricerca devOps di Azure.
- Leggere il contenuto del file in base al percorso e al ramo.
- Correlare gli errori delle risorse di Azure con i percorsi del codice sorgente (con punteggio di attendibilità).
- Eseguire ricerche di codice semantico per trovare il codice correlato a un evento imprevisto usando il linguaggio naturale.
Gestione degli elementi di lavoro:
- Creare elementi di lavoro (attività, bug, Epic, funzionalità) con percorso di area, iterazione, priorità e gravità.
- Collegare elementi di lavoro alle risorse di Azure per la tracciabilità.
Mappatura del repository:
- Trovare e collegare Azure Repos alle risorse di Azure.
- Identificare i file di infrastruttura come codice (Bicep, Terraform, modelli ARM) nei repository collegati.
Connettore della documentazione (conoscenza wiki)
Indicizzare le pagine wiki di Azure DevOps in modo che l'agente possa cercarle durante le indagini. Quando l'agente rileva un problema, cerca nel wiki indicizzato le guide alla risoluzione dei problemi pertinenti, la documentazione dell'architettura e i runbook.
Come funziona
Il connettore della documentazione elabora il contenuto wiki seguendo questa procedura:
- Esegue una ricerca per indicizzazione di tutte le pagine dall'URL wiki di Azure DevOps specificato (o da una sottosezione specifica).
- Suddivide e incorpora il contenuto del documento in un indice di ricerca vettoriale.
- Ricerca semantica : durante le indagini, l'agente trova passaggi pertinenti e cita la pagina wiki originale.
- La sincronizzazione automatica viene eseguita ogni 24 ore per raccogliere gli aggiornamenti wiki.
Contenuto supportato
Il connettore della documentazione supporta i tipi di contenuto seguenti:
- Pagine wiki (formato wiki di Azure DevOps)
- File del repository Git con 15 formati supportati:
.md,.txt,.rst,.adoc,.asciidoc,.wiki,.textile,.org,.htm,.html,.json,.yaml,.yml,.xml,.csv - Indicizzazione con ambito che punta a una sottopagina per indicizzare solo una sezione specifica del wiki
Inizia subito
Usare le risorse seguenti per configurare il connettore Azure DevOps.
| risorsa | Cosa imparerai |
|---|---|
| Connettere il codice sorgente | Guida dettagliata per la connessione di Repository GitHub e Azure DevOps |
| Configurare un connettore Azure DevOps | Esercitazione dettagliata sul connettore Azure DevOps |
Passo successivo
Contenuti correlati
- Analisi della causa radice: come il contesto del codice sorgente migliora l'accuratezza dell'indagine.
- Memoria e conoscenze: modalità di integrazione delle conoscenze indicizzate con la memoria persistente dell'agente.
- Caricare documenti di conoscenza: Carica i documenti direttamente invece di connetterti a un wiki.
- Connettori: panoramica di tutti i tipi di connettore.