Introduzione all’uso di Copilot per la revisione del codice nelle pull request

Servizi di Azure DevOps

Usare GitHub Copilot per esaminare le richieste pull in Azure Repos. Copilot funge da revisore automatico che pubblica commenti e suggerimenti sul codice modificato, in modo da ricevere feedback prima che un revisore umano si disconnette.

Per usare la funzionalità, un amministratore della raccolta di progetti la attiva per l'organizzazione, un amministratore del progetto gestisce le impostazioni predefinite a livello di progetto e gli override del repository, gli amministratori del repository configurano i singoli repository quando gli override sono consentiti e i singoli utenti possono attivarla tramite le funzionalità di anteprima, a meno che l'amministratore non abiliti l'anteprima per tutti.

Prerequisiti

Abilita la revisione del codice con Copilot

A livello di organizzazione

Un amministratore della raccolta di progetti deve abilitare la revisione del codice di Copilot per l'organizzazione prima che i proprietari del progetto possano attivarla per i singoli progetti e repository.

Se si seleziona l'opzione Abilita tutto a livello di organizzazione, la revisione del codice di Copilot viene abilitata per ogni progetto dell'organizzazione e per ogni repository in tali progetti. Non è necessario abilitare singolarmente ogni progetto o repository.

1. Accedere all'organizzazione di Azure DevOps (https://dev.azure.com/{yourorganization}).

2. Selezionare Organization settings>Repos>Repositories.

3. In revisione del codice di GitHub Copilot, imposta Consenti ai repository di questa organizzazione di usare la revisione del codice di Copilot su On.

   

A livello di progetto

Dopo aver abilitato l'accesso a livello di organizzazione, un Amministratore di progetto può, facoltativamente, abilitare la funzionalità a livello di progetto. Questa opzione offre un controllo dettagliato su quali progetti dell'organizzazione possono usare la revisione del codice di Copilot.

Se si seleziona l'opzione Abilita tutto a livello di progetto, la revisione del codice di Copilot viene abilitata per ogni repository in quel progetto. Non è necessario abilitare ogni repository singolarmente.

1. Selezionare Project settings>Repos>Repositories.

2. In Revisione del codice di GitHub Copilot, imposta Abilita la revisione del codice di Copilot per questo progetto su Attivato.

   

   Questa impostazione si applica a tutti i repository nel progetto, a meno che non venga sottoposto a override a livello di repository. È comunque possibile abilitare o disabilitare la funzionalità per singoli repository in base alle esigenze.

A livello di repository

Dopo aver abilitato l'accesso a livello di organizzazione (e facoltativamente l'accesso a livello di progetto), un proprietario del repository attiva Copilot verifica del codice per ogni repository che deve usarlo.

1. Selezionare Project settings>Repos>Repositories.

2. Selezionare il repository da abilitare.

3. Nella scheda Settings, imposta Enable Copilot code review for pull requests in this repository su Attivato.

   

Per verificare che la funzionalità sia abilitata, aprire qualsiasi richiesta pull nel repository. GitHub Copilot dovrebbe essere visualizzato come revisore disponibile nell'elenco Reviewers.

Configura la revisione del codice di Copilot

Dopo aver abilitato la funzionalità in tutti e tre gli ambiti, è possibile configurare il modo in cui Copilot esamina le richieste pull nei repository.

Configura l'impegno di revisione predefinito

Lo sforzo di revisione controlla il modo in cui Copilot analizza accuratamente una richiesta pull. Un amministratore del progetto imposta il lavoro predefinito per tutti i repository in un progetto e decide se gli amministratori del repository possono eseguirne l'override. Gli utenti possono selezionare un livello di lavoro diverso per una singola revisione senza modificare il progetto o il repository predefinito.

I livelli di lavoro più elevati in genere usano più token e possono aumentare il costo di una revisione. Per altre informazioni, vedereFatturazione.

Impostare il valore predefinito del progetto

1. Selezionare Project settings>Repos>Repositories.

2. In Revisione del codice di GitHub Copilot, seleziona un'opzione da livello di impegno predefinito.

3. Per consentire agli amministratori del repository di impostare un valore predefinito diverso, selezionare Consenti ai singoli repository di impostare il proprio livello di lavoro predefinito. Deselezionare questa opzione per richiedere a tutti i repository di usare l'impostazione predefinita del progetto.

   

Impostare un repository predefinito

Se il progetto consente le sostituzioni del repository, un amministratore del repository può impostare un valore predefinito diverso:

1. Selezionare Project settings>Repos>Repositories.
2. Selezionare il repository e quindi selezionare la scheda Impostazioni .
3. In Revisione del codice di GitHub Copilot, seleziona un'opzione da livello di impegno predefinito.

Se il progetto non consente le sostituzioni del repository, il livello di lavoro predefinito è di sola lettura e visualizza l'impostazione del progetto ereditata.

Configurare i criteri di revisione automatica

Copilot può esaminare automaticamente le nuove richieste pull senza richiedere richieste manuali. È possibile configurare questo criterio per tutti i repository in un progetto o per singoli repository.

L'abilitazione delle funzionalità e la revisione automatica sono impostazioni separate. L'abilitazione della revisione del codice di Copilot la rende disponibile per un repository. Un criterio di revisione automatica richiede una revisione di Copilot quando viene creata una nuova pull request.

Configurare la verifica automatica per tutti i repository in un progetto

Usa il criterio a livello di progetto per richiedere automaticamente revisioni di Copilot in tutti i repository del progetto. Non è necessario configurare i criteri per ogni repository singolarmente.

1. Selezionare Project settings>Repos>Repositories.

2. In revisione del codice di GitHub Copilot, imposta Richiedi automaticamente la revisione del codice di Copilot per le nuove pull request per tutti i repository in questo progetto su Attivato.

   Questa impostazione si applica a tutti i repository nel progetto, a meno che un criterio a livello di repository non ne esegua l'override.

Configurare la revisione automatica per un repository

Usare i criteri a livello di repository quando è necessario un comportamento specifico del repository.

1. Selezionare Project settings>Repos>Repositories.

2. Selezionare il repository da configurare.

3. Nella scheda Impostazioni, in Revisione del codice di GitHub Copilot, imposta Richiedi automaticamente la revisione del codice di Copilot per le nuove pull request su Attivato.

4. (Facoltativo) Configurare l'ambito di revisione:

   • Applica a tutte le pull request: Copilot esamina ogni nuova pull request nel repository.
   • Si applica a criteri specifici dei rami: Copilot esamina solo le pull request rivolte ai rami specificati, ad esempio main o develop.

   Ordine di precedenza dei criteri per le revisioni automatiche:

   • I criteri di revisione automatica a livello di progetto si applicano a tutti i repository nel progetto.
   • Le impostazioni di revisione automatica a livello di repository sostituiscono l'impostazione predefinita a livello di progetto per tale repository.

Quando si abilita la revisione automatica, Copilot inizia a esaminare le nuove richieste pull immediatamente dopo la creazione. È comunque possibile richiedere revisioni aggiuntive manualmente selezionando Richiesta accanto a GitHub Copilot nella richiesta pull.

Selezionare un pool di agenti

La revisione del codice di Copilot esegue processi di revisione tramite un pool di agenti di Azure Pipelines. Per impostazione predefinita, usa il pool di Azure Pipelines predefinito nell'organizzazione.

Alcune organizzazioni disabilitano il pool di Azure Pipelines predefinito. In questa configurazione, la revisione del codice di Copilot non può essere effettuata finché non si seleziona un pool alternativo supportato.

Se l'organizzazione ha configurato un pool DevOps gestito, è possibile selezionarlo per eseguire Copilot revisione del codice anziché il pool predefinito.

Quando si seleziona un'immagine per il pool DevOps gestito, assicurarsi di selezionare la versione più recente Ubuntu Server.

Le immagini Windows non sono supportate per Copilot Code Reviews. Non usare nello stesso pool agenti Ubuntu e Windows.

1. Selezionare Organization settings>Repos>Repositories.

2. In revisione del codice di GitHub Copilot, seleziona pool di calcolo dal menu a discesa.

   La configurazione del pool di calcolo dell'organizzazione determina i pool disponibili. Se non sono disponibili pool, contattare l'amministratore dell'organizzazione.

3. Seleziona Salva.

Il pool selezionato elabora tutte le revisioni del codice Copilot per i repository nell'organizzazione. È possibile cambiare questa impostazione in qualsiasi momento. Per usare pool diversi per progetti o repository differenti, configurare le assegnazioni dei pool tramite Managed DevOps Pools.

Personalizzare il comportamento di revisione di Copilot

Per indicazioni sull'uso di istruzioni personalizzate e competenze dell'agente per personalizzare il feedback sulla revisione del codice di Copilot, vedere Configurare Copilot istruzioni per la revisione del codice.

Usa la revisione del codice di Copilot

Con la funzionalità abilitata in tutti e tre gli ambiti, è possibile chiedere Copilot di esaminare una richiesta pull. Le sezioni seguenti descrivono cosa aspettarsi.

Richiedere una revisione

Per impostazione predefinita, GitHub Copilot esamina una richiesta pull solo quando ne viene richiesta una:

1. Apri una pull request.

2. Nella sezione Revisori usare una delle opzioni seguenti accanto a GitHub Copilot:

   • Per usare il livello di lavoro predefinito del repository, selezionare Richiedi.
   • Per usare un livello di lavoro diverso per questa revisione, aprire il menu a discesa accanto a Richiedi e selezionare un livello di sforzo.

3. Attendere il completamento della revisione. La revisione potrebbe richiedere alcuni istanti, a seconda delle dimensioni del repository e del numero di modifiche nella richiesta pull. Al termine della revisione, lo stato cambia in Revisione completata.

   

Se Copilot identifica i potenziali problemi, aggiunge commenti e suggerimenti direttamente alla richiesta pull da esaminare e risolvere.

Il livello di lavoro selezionato si applica solo a tale revisione. Azure DevOps registra il richiedente e il livello di impegno nell'attività della pull request.

Leggere i commenti di Copilot

• Copilot pubblica il proprio feedback come revisore regolare denominato GitHub Copilot nella richiesta pull.
• Ogni commento viene visualizzato nella riga di codice a cui si applica e, se possibile, include una modifica suggerita che è possibile applicare con un solo clic.
• Copilot lascia sempre una revisione Comment. Non approva mai la pull request né richiede modifiche, quindi la sua revisione non soddisfa i criteri dei revisori obbligatori e non blocca il merge.
• I commenti di Copilot si comportano come commenti di un revisore umano. È possibile rispondere a loro, reagire a loro, risolverli o nasconderli. Copilot non legge le risposte e non dà seguito.

Ripetere la revisione dopo i nuovi commit

Copilot non riesamina automaticamente una pull request quando invii nuovi commit. Per ottenere una nuova revisione dopo un commit, selezionare di nuovo Request accanto a GitHub Copilot nell'elenco Reviewers.

Annullare una revisione in corso

Se una verifica del codice richiede più tempo del previsto o se è necessario arrestarla, è possibile annullare l'esecuzione della revisione.

1. Apri la pull request su cui Copilot sta attualmente effettuando la revisione.
2. Nella sezione Revisori, accanto a GitHub Copilot, selezionare il pulsante Annulla oppure selezionare Altre opzioni>Annulla revisione.
3. Confermare l'annullamento quando richiesto.

L'esecuzione della revisione si arresta immediatamente e non vengono aggiunti commenti aggiuntivi. I risultati della revisione parziale, inclusi i commenti aggiunti prima dell'annullamento, rimangono nella richiesta pull. È possibile richiedere una nuova revisione in qualsiasi momento.

Requisiti e limiti

I requisiti e i limiti seguenti si applicano durante l'anteprima e possono cambiare.

Copilot esamina una richiesta pull solo quando soddisfa questi requisiti:

Si applicano anche questi limiti di concorrenza e velocità:

Billing

Ogni revisione del codice completata utilizza i token, inclusi i token di input inviati al modello, i token di output generati dal modello e i token memorizzati nella cache che riutilizzano il contesto esistente. I token usati per ogni recensione vengono convertiti in un'unità di fatturazione standard denominata credito di intelligenza artificiale GitHub, dove 1 credito è uguale a $0,01 USD.

Lo sforzo di revisione selezionato influisce sul consumo. I livelli di lavoro più elevati in genere analizzano più contesto e utilizzano più token rispetto ai livelli di lavoro inferiori. Le dimensioni delle richieste pull, le istruzioni personalizzate del repository e le modifiche del modello possono influire anche sull'utilizzo. Per gli intervalli di riferimento e le avvertenze correnti, vedere Consumo stimato.

Per trovare risposte alle domande frequenti sulla fatturazione e sui costi della revisione del codice di Copilot, consulta Risolvere i problemi relativi alla revisione del codice Copilot.

Gli addebiti passano alla sottoscrizione Azure collegata all'organizzazione Azure DevOps e vengono visualizzati come contatori separati in Gestione costi di Azure. Per stimare i costi previsti nell'ambiente, abilitare la funzionalità per uno o due repository, confrontare i livelli di lavoro di revisione e monitorare l'utilizzo giornaliero.

I costi di Copilot Code Review in Gestione costi di Azure ora includono i tag di progetto Azure DevOps, consentendo la creazione di report dei costi per progetto. È possibile filtrare o raggruppare l'analisi dei costi in base a questi tag di progetto per l'utilizzo e la spesa per singoli progetti Azure DevOps.

Per monitorare gli addebiti giornalieri:

1. Nel portale Azure passare alla sottoscrizione.

2. Selezionare Gestione dei costi>Analisi dei costi.

3. Filtra per prodotto per visualizzare i costi giornalieri dell'organizzazione. Per visualizzare i costi per un progetto specifico, aggiungere un filtro o un gruppo in base al tag di progetto Azure DevOps.

   

Impostare un avviso di budget

Creare un budget Azure che notifica quando la spesa raggiunge una soglia impostata. I budget si limitano a inviarti notifiche. Non interrompono le revisioni o modificano le risorse. È necessario l'accesso proprietario, collaboratore o collaboratore gestione costi nella sottoscrizione collegata all'organizzazione Azure DevOps.

1. Nel portale di Azure aprire la sottoscrizione collegata all'organizzazione Azure DevOps.

2. Selezionare Gestione costi>Budget e quindi selezionare Aggiungi.

3. In Filtri aggiungere un filtro per Product e selezionare GitHub Copilot per AzDO.

   

4. Se la sottoscrizione è collegata a più organizzazioni Azure DevOps, aggiungere un filtro per Tag e selezionare i tag dei nomi dell'organizzazione a cui si vuole impostare l'avviso come destinazione. Se sono presenti tag di progetto, è anche possibile filtrare o raggruppare in base al tag di progetto per creare avvisi di budget a livello di progetto.

5. Immettere un nome di budget, scegliere un periodo di reimpostazione e una data di scadenza, impostare l'importo del budget e quindi selezionare Avanti.

6. Aggiungere una o più soglie di avviso come percentuale del budget (ad esempio, 75% e 90%), impostare Tipo su Effettivo o Previsto e immettere gli indirizzi di posta elettronica per la notifica.

7. Selezionare Crea.

   

Quando la spesa raggiunge una soglia, Azure invia un messaggio di posta elettronica entro un'ora dalla valutazione successiva. Per esaminare gli avvisi attivati, selezionare Gestione costi>Avvisi sui costi. Per mantenere i messaggi di posta elettronica di avviso fuori dalla cartella indesiderata, aggiungere azure-noreply@microsoft.com ai mittenti approvati. Per altre informazioni, vedere Creare e gestire i budget.

Disattiva la revisione del codice di Copilot

Per smettere di usare la revisione del codice di Copilot, imposta l'interruttore su Off nell'ambito che vuoi disabilitare:

• Per un utente: disattivare l'interruttore Delle funzionalità di anteprima nelle impostazioni utente.
• For one repository: Disattivare l'interruttore del repository in Project settings>Repos>Repositories.
• Per l'intera organizzazione: Disattivare l'interruttore dell'organizzazione in Organization settings>Repos>Repositories. Questa azione disabilita la funzionalità per tutti i repository.

Condividi commenti

Per segnalare problemi o condividere commenti e suggerimenti su questa anteprima, visitare il Azure DevOps Developer Community.

Risolvere i problemi relativi alla revisione del codice Copilot

Per trovare risposte alle domande comuni sulla fatturazione, la gestione dei dati, la conformità e la risoluzione dei problemi relativi alle istruzioni personalizzate, vedi Risolvere i problemi di revisione del codice di Copilot.

Passo successivo

Contenuti correlati

• Risolvere i problemi relativi alla revisione del codice Copilot
• Configurare le istruzioni di revisione del codice di Copilot
• Informazioni sulla revisione del codice GitHub Copilot
• Informazioni su pull request
• Impostazioni e criteri del repository