Collega un servizio di codice sorgente

Dai al tuo agente accesso al contesto repository, issue e pull request per le indagini. Può leggere le modifiche recenti, trovare problemi correlati e aprire un issue o pull request nel repository o progetto giusto quando la credenziale che fornisci lo consente.

Questo tutorial copre GitHub, Azure DevOps e GitLab. Le connessioni codice sorgente utilizzano la pagina di accesso al codice (Builder > Code Access), non il connettore manager gestito. Questo articolo si concentra sui dettagli del codice sorgente: come ogni servizio si autentica e come validare la connessione.

Prerequisiti

  • Un agente SRE in esecuzione e accesso a sre.azure.com.
  • Permesso di configurare l'agente.
  • Un account sul servizio con accesso ai repository o ai progetti che l'agente dovrebbe leggere.

Per i servizi di notifica, vedi Collega un servizio di notifica.

Connettori del codice sorgente

Connettore Servizio Authentication Uso tipico
GitHub GitHub e GitHub Enterprise Cloud Porta la tua GitHub App (OAuth e PAT supportati anch'essi per github.com) Leggere repository, issue e pull request tra progetti e organizzazioni; Create issue o pull request con approvazione
Azure DevOps Azure DevOps Identità gestita (supportate anche OAuth e PAT) Leggere repository e pull request tra i progetti; Crea pull request o elementi di lavoro con approvazione
GitLab GitLab Token di accesso personale Leggere repository, numeri e richieste di fusione; crea problemi e commenti con approvazione

GitHub e Azure DevOps presentano le scelte di autenticazione come pulsanti radio. GitLab utilizza un token di accesso personale.

Passaggio 1: Accesso al codice aperto

  1. Passare a sre.azure.com e selezionare l'agente.
  2. Nella barra laterale sinistra, espandi Builder e poi seleziona Code Access.
  3. Seleziona la scheda per il tuo servizio (GitHub, Azure DevOps o GitLab).
  4. Selezionare Aggiungi repository.

Passo 2: Autenticazione

La finestra di dialogo Aggiungi repository si apre con un assistente in tre passaggi: scegli una piattaforma → Autentica → Aggiungi repository. Selezionare Avanti dopo ogni passaggio. L'ultimo passaggio ha un pulsante Salva .

Usa Bring your GitHub App per GitHub Enterprise Cloud o per determinare l'accesso tramite organizzazione o installazione.

  1. Sotto Metodi di Accesso, scegli Porta la tua app GitHub.
  2. Completa i campi di configurazione dell'app mostrati dal wizard.
  3. Seleziona Avanti.

GitHub Enterprise Cloud (.ghe.com) richiede una connessione GitHub App. Per github.com, sono supportati anche il tuo account (OAuth, se configurato per il tuo ambiente) o un token di accesso personale, anche se l'opzione GitHub App è preferita per scenari di produzione per consentire permessi più dettagliati e visibilità di audit.

Dopo la connessione, l'agente può cercare depositi, issue e pull request tra progetti e organizzazioni a cui la tua app o account ha accesso.

Il servizio vede l'identità che ha autorizzato la connessione. Problemi, commenti e attività pull request create dall'agente compaiono sotto quell'account.

Passo 3: Aggiungi repository

Il passaggio Aggiungi repository mostra una tabella in cui specifichi quali repository indicizzano gli agenti. Ogni riga è un repository.

  1. Se il tuo servizio è Azure DevOps, prima seleziona un project dal menu a tendina Azure DevOps Project. La colonna URL del repository si popola con i repository in quel progetto.

  2. Nella colonna URL del repository , seleziona un repository dal menu a tendina o digita direttamente un URL. Per GitHub e GitLab, il menu a tendina elenca i repository a cui le tue credenziali possono accedere. Per Azure DevOps, elenca i repository nel progetto selezionato.

  3. Nella colonna Nome visualizzato , inserisci un nome breve che l'agente usa per riferirsi al repository.

  4. Opzionalmente, compila la colonna Descrizione per dare all'agente più contesto su ciò che contiene il repository.

  5. Se il tuo servizio è Azure DevOps e il repository è molto grande, attiva la casella di spunta Remoto. L'agente utilizza la ricerca basata sull'IA sulla copia remota invece di clonarla localmente. I repository sono clonati con un limite di 100 GB su disco; abilitare Remote evita questo vincolo.

  6. Per aggiungere un altro repository, seleziona Aggiungi e riempi la riga successiva.

  7. Quando la tabella è completa, seleziona Salva.

Passo 4: Valida con uno scenario

  1. Apri una chat con il tuo agente.

  2. Fai una domanda letta, ad esempio:

    List the open issues in the payments repository from the last week.

  3. Controlla la scheda degli strumenti per vedere l'agente, cercare il servizio e restituire risultati basati sui tuoi dati.

Quando compaiono risultati che fanno riferimento al tuo repository, la connessione funziona end-to-end.

Troubleshooting

Problema Cause Correzione
La ricerca non restituisce risultati L'account non ha accesso al progetto o al repository Conferma che l'account di connessione può vedere il progetto o il repository, poi riprova.
La creazione fallisce con un errore di permesso Il token o account non ha ambito di scrittura Concedere l'ambito richiesto al token o all'account, oppure utilizzare credenziali che abbiano accesso in scrittura.
GitHub Enterprise Cloud rifiuta la connessione GitHub Enterprise Cloud richiede una connessione GitHub App Nella pagina Code Access, disconnetti la connessione GitHub, seleziona Aggiungi repository, scegli GitHub, inserisci il tuo .ghe.com host e seleziona Porta la tua app GitHub come metodo di autenticazione.

Contenuti correlati

  • Last updated on