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

Servizi di Azure DevOps

Importante

Questa funzionalità è in anteprima pubblica limitata e richiede l'iscrizione. Per richiedere l'accesso per l'organizzazione, iscriversi all'anteprima pubblica.

La funzionalità potrebbe cambiare o essere rimossa senza preavviso. Le funzionalità di anteprima non hanno un contratto di servizio e un supporto limitato.

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

Categoria Requirements
Organizzazione Una organizzazione in Azure DevOps.
Repository Un repository Git in Azure Repos. TFVC non è supportato.
Autorizzazioni dell'organizzazione Amministratore della raccolta progetti per abilitare la funzionalità a livello dell'organizzazione.
Autorizzazioni repository Il proprietario del repository o un amministratore deve abilitare la funzionalità per il repository.
fatturazione Una sottoscrizione Azure collegata all'organizzazione Azure DevOps. L'utilizzo della revisione del codice di Copilot viene fatturato tramite Gestione costi di Azure. Per informazioni dettagliate, vedere Fatturazione.

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.

    Pagina delle impostazioni dell'organizzazione con l'interruttore Consenti ai repository di usare la revisione del codice di Copilot impostato su Attivato.

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.

    Pagina delle impostazioni del repository con l'opzione Abilita la revisione del codice di Copilot per le pull request impostata su Attivata.

Abilitare la revisione del codice con Copilot per i singoli utenti

Dopo aver abilitato la funzionalità a livello di organizzazione e repository, i singoli utenti possono acconsentire esplicitamente tramite le funzionalità di anteprima.

  1. Selezionare l'avatar dell'utente in alto a destra e quindi selezionare Funzionalità di anteprima.

  2. Imposta l'ambito per me.

  3. Individua Revisione del codice di Copilot per le richieste pull e impostalo su Attivato.

    Pannello delle funzionalità di anteprima con Copilot Code Review per le pull request impostato su Attivato.

Tip

Un amministratore della raccolta Project può impostare l'ambito su per questa organizzazione per abilitare l'anteprima per tutti gli utenti contemporaneamente.

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.

Inviare commenti e suggerimenti su una recensione

Ogni commento Copilot include i controlli thumbs-up e thumbs-down. Usarli per indicare al team Copilot se un commento specifico è stato utile. Se si seleziona thumbs-down, è possibile scegliere facoltativamente un motivo e aggiungere i dettagli prima di inviare.

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:

Requisito Value
Stato della richiesta di pull Attivo
Stato del merge della pull request Nessun conflitto di merge (merge riuscito)
Dimensioni del repository 10 GB o meno
File modificati della richiesta pull 100 file o meno

Si applicano anche questi limiti di concorrenza e velocità:

Limit Value
Verifica duplicata nella stessa versione della richiesta pull 1 revisione completata per commit di merge
Verifiche simultanee per richiesta pull 1
Revisioni simultanee per organizzazione 5
Revisioni concorrenti per utente 2

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.

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.

    Schermata dell'analisi dei costi di Gestione costi di Azure filtrata per prodotto per mostrare gli addebiti per la revisione del codice di Copilot.

Domande frequenti

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

Vedi Modelli e prezzi nella documentazione di GitHub Copilot.

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

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

I crediti acquistati con gli abbonamenti 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?

No, l'utilizzo in Azure DevOps non consuma i crediti AI dei piani GitHub Copilot.

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