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 Project lo attiva per l'organizzazione, un proprietario del repository lo attiva per ogni repository e i singoli utenti acconsentono esplicitamente alle funzionalità di anteprima (a meno che l'amministratore non abiliti l'anteprima per tutti).

Prerequisiti

Abilita la revisione del codice con Copilot a livello dell'organizzazione

Un amministratore di Project Collection deve abilitare la revisione del codice di Copilot per l'organizzazione prima che i proprietari del repository possano attivarla per i singoli 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.

   

Abilitare la revisione del codice di Copilot a livello del repository

Dopo l'abilitazione dell'accesso a livello di organizzazione, 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.

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 Reviewers selezionare Request accanto a GitHub Copilot.
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.

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.

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 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 GitHub credito di intelligenza artificiale, dove 1 credito equivale a $0,01 USD.

Gli addebiti passano alla sottoscrizione Azure collegata all'organizzazione Azure DevOps e vengono visualizzati come contatori separati in Gestione costi di Azure. Il costo di ogni revisione varia in base a fattori come le dimensioni della richiesta pull e il numero di righe modificate. Per stimare i costi previsti nell'ambiente, abilitare la funzionalità per uno o due repository prima 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.

Passo successivo

Domande frequenti

D: Dove è possibile trovare i prezzi di listino addebitati per i token?

R: Vedere Modelli e prezzi nella documentazione di GitHub Copilot.

D: Quali fattori influenzano il numero di token utilizzati da una revisione del codice?

R: L'utilizzo dei token dipende da fattori quali le dimensioni del repository, le dimensioni della modifica e la complessità del codice da esaminare.

D: I crediti acquistati con gli abbonamenti a Copilot vengono conteggiati ai fini dell'utilizzo della revisione del codice in Azure DevOps? È possibile usare i crediti di intelligenza artificiale da un piano di GitHub Copilot?

R: No, l'utilizzo in Azure DevOps non usa i crediti di intelligenza artificiale dai piani GitHub Copilot.

Q: Il codice dei clienti o il contenuto delle revisioni delle pull request vengono utilizzati per addestrare o migliorare i modelli fondamentali?

R: No. I dati di interazione utilizzati per la revisione del codice in Copilot, inclusi i diff delle pull request, i prompt, le risposte, i suggerimenti e il relativo contesto di revisione, non vengono usati per addestrare o migliorare i modelli di base.

D: Quali dati dei clienti vengono conservati durante o dopo una revisione del codice?

A: La gestione e la conservazione dei dati seguono la documentazione delle policy di GitHub Copilot. Azure Repos non pubblica criteri di conservazione separati per la revisione del codice di Copilot.

D: I diff delle pull request, i prompt, i suggerimenti generati o i dati di telemetria vengono conservati oltre il tempo necessario per l'elaborazione della richiesta? Se conservati, quali sono i periodi di conservazione?

R: Per i dettagli di archiviazione e conservazione correnti, inclusi gli aggiornamenti dei criteri correlati alla conservazione, vedere GitHub Copilot documentazione sull'attendibilità e sulla privacy. Azure Repos al momento non pubblica una tabella separata con il periodo di conservazione specifico della funzionalità per la revisione del codice con Copilot.

D: Dove viene elaborato e archiviato il contenuto dei clienti per la revisione del codice con Copilot?

A: La revisione del codice di Copilot in Azure Repos è basata su GitHub Copilot. La residenza dei dati per GitHub Copilot non è allineata ai limiti di residenza dei dati dell'organizzazione Azure DevOps per questa funzionalità di anteprima. Ad esempio, se la tua organizzazione Azure DevOps è ospitata nell'UE, l'elaborazione della revisione del codice di Copilot potrebbe comunque avvenire in un'altra area geografica, ad esempio negli Stati Uniti.

D: La residenza dei dati di GitHub Copilot si applica alla revisione del codice Copilot per Azure Repos?

A: Per questa funzionalità in anteprima, non dare per scontato che l'area geografica dell'organizzazione di Azure DevOps determini l'area geografica di elaborazione della revisione del codice di Copilot. Consultare la documentazione su attendibilità e privacy di GitHub Copilot per informazioni aggiornate sull'ambito e i limiti della residenza dei dati.

D: La revisione del codice di Copilot per Azure Repos segue gli stessi impegni di gestione dei dati di GitHub Copilot Business e GitHub Copilot Enterprise?

A: Sì, la revisione del codice di Copilot in Azure Repos segue i criteri di gestione dei dati di GitHub Copilot. Per gli impegni attuali, consulta la documentazione su affidabilità e privacy di GitHub Copilot.

D: Quale documentazione sulla conformità rivolta ai clienti è possibile condividere con i team di sicurezza e conformità?

R: Usare questi riferimenti ufficiali:

• Domande frequenti sul Centro protezione GitHub Copilot
• GitHub informativa sulla privacy generale
• Informazioni sulla revisione del codice GitHub Copilot

D: Esistono limitazioni o eccezioni specifiche dell'anteprima di cui tenere conto?

R: Sì. La revisione del codice con Copilot per Azure Repos è disponibile in anteprima pubblica limitata:

• Le funzionalità di anteprima possono cambiare o essere rimosse senza preavviso.
• Le funzionalità di anteprima non hanno un contratto di servizio e un supporto limitato.
• La residenza dei dati per questa funzionalità non è allineata ai limiti di residenza dei dati dell'organizzazione Azure DevOps.

Contenuti correlati

• Informazioni sulla revisione del codice GitHub Copilot
• Informazioni su pull request
• Impostazioni e criteri del repository