Aan de slag met Copilot codebeoordeling voor pull-aanvragen

Azure DevOps Services

Gebruik GitHub Copilot om pull-aanvragen in Azure-opslagplaatsen te controleren. Copilot fungeert als een geautomatiseerde revisor die opmerkingen en suggesties voor gewijzigde code plaatst, zodat u feedback krijgt voordat een menselijke revisor zich afmeldt.

Als u de functie wilt gebruiken, schakelt een Project Collection Administrator deze in voor de organisatie, beheert een projectbeheerder de standaardinstellingen op projectniveau en uitzonderingen voor opslagplaatsen, configureren repositorybeheerders afzonderlijke opslagplaatsen wanneer uitzonderingen zijn toegestaan, en melden afzonderlijke gebruikers zich aan via Preview-functies (tenzij de beheerder de preview voor iedereen inschakelt).

Prerequisites

Copilot codebeoordeling inschakelen

Op organisatieniveau

Een Project Collection Administrator moet Copilot-codereview inschakelen voor de organisatie voordat projecteigenaren dit kunnen inschakelen voor afzonderlijke projecten en repositories.

Als u de optie Alles op organisatieniveau inschakelen selecteert, wordt Copilot codebeoordeling ingeschakeld voor elk project in de organisatie en elke opslagplaats in deze projecten. U hoeft elk project of elke opslagplaats niet afzonderlijk in te schakelen.

1. Meld u aan bij uw Azure DevOps-organisatie (https://dev.azure.com/{yourorganization}).

2. Selecteer Organisatie-instellingen>Repo's>Opslagplaatsen.

3. Zet onder GitHub Copilot-codebeoordeling de optie Repository’s in deze organisatie toestaan Copilot-codebeoordeling te gebruiken op Aan.

   

Op projectniveau

Nadat toegang op organisatieniveau is ingeschakeld, kan een Project Beheerder de functie op project niveau inschakelen. Deze optie biedt gedetailleerde controle over welke projecten in de organisatie Copilot codebeoordeling kunnen gebruiken.

Als u de optie Alles op projectniveau inschakelen selecteert, wordt Copilot codebeoordeling ingeschakeld voor elke opslagplaats in dat project. U hoeft elke opslagplaats niet afzonderlijk in te schakelen.

1. Selecteer Projectinstellingen>Repos>Opslagplaatsen.

2. Schakel onder GitHub Copilot codebeoordelingCopilot codebeoordeling inschakelen voor dit project in op Aan.

   

   Deze instelling is van toepassing op alle opslagplaatsen in het project, tenzij deze worden overschreven op het niveau van de opslagplaats. U kunt de functie voor afzonderlijke opslagplaatsen indien nodig nog steeds in- of uitschakelen.

Op opslagplaatsniveau

Nadat u toegang op organisatieniveau (en optioneel toegang op projectniveau) hebt ingeschakeld, schakelt een eigenaar van de opslagplaats Copilot codebeoordeling in voor elke opslagplaats die deze moet gebruiken.

1. Selecteer Projectinstellingen>Repos>Opslagplaatsen.

2. Selecteer de opslagplaats die u wilt inschakelen.

3. Schakel op het tabblad Settings de optie Copilot-codebeoordeling voor pull requests in deze opslagplaats inschakelen in op On.

   

Als u wilt controleren of de functie is ingeschakeld, opent u een pull-aanvraag in de opslagplaats. GitHub Copilot moet nu worden weergegeven als een beschikbare revisor in de lijst Reviewers.

Copilot codebeoordeling configureren

Nadat u de functie op alle drie de niveaus hebt ingeschakeld, kunt u instellen hoe Copilot pull requests beoordeelt in uw repositories.

De standaardbeoordelingsinspanning configureren

De beoordelingsinspanning bepaalt hoe grondig Copilot een pull-aanvraag analyseert. Een projectbeheerder stelt de standaardinspanning in voor alle opslagplaatsen in een project en bepaalt of beheerders van opslagplaatsen deze kunnen overschrijven. Gebruikers kunnen een ander inspanningsniveau selecteren voor een afzonderlijke beoordeling zonder de standaardinstelling van het project of de opslagplaats te wijzigen.

Hogere inspanningsniveaus verbruiken over het algemeen meer tokens en kunnen de kosten van een beoordeling verhogen. Zie Facturering voor meer informatie.

De standaardinstelling voor het project instellen

1. Selecteer Projectinstellingen>Repos>Opslagplaatsen.

2. Selecteer onder GitHub Copilot codereview een optie uit Standaardinspanningsniveau.

3. Als u wilt dat opslagplaatsbeheerders een andere standaardinstelling instellen, selecteert u Afzonderlijke opslagplaatsen toestaan om hun eigen standaardniveau voor inspanning in te stellen. Schakel deze optie uit om te vereisen dat alle opslagplaatsen de standaardwaarde van het project gebruiken.

   

Standaardinstelling voor een opslagplaats instellen

Als het project repository-overschrijvingen toestaat, kan een repositorybeheerder een andere standaardwaarde instellen:

1. Selecteer Projectinstellingen>Repos>Opslagplaatsen.
2. Selecteer de opslagplaats en selecteer vervolgens het tabblad Instellingen .
3. Selecteer onder GitHub Copilot codereview een optie uit Standaardinspanningsniveau.

Als het project geen repository-overschrijvingen toestaat, is Standaard inspanningsniveau alleen-lezen en wordt de geërfde projectinstelling weergegeven.

Beleid voor automatische controle instellen

Copilot kan nieuwe pullverzoeken automatisch beoordelen zonder dat dit handmatig hoeft te worden aangevraagd. U kunt dit beleid configureren voor alle opslagplaatsen in een project of voor afzonderlijke opslagplaatsen.

Functie-inschakeling en automatische controle zijn afzonderlijke instellingen. Als u Copilot-codebeoordeling inschakelt, wordt deze beschikbaar gemaakt voor een repository. Een beleid voor automatische controle vraagt een Copilot beoordeling aan wanneer er een nieuwe pull-aanvraag wordt gemaakt.

Automatische controle configureren voor alle opslagplaatsen in een project

Gebruik het beleid op projectniveau om automatisch Copilot beoordelingen aan te vragen voor elke opslagplaats in het project. U hoeft het beleid niet afzonderlijk te configureren voor elke opslagplaats.

1. Selecteer Projectinstellingen>Repos>Opslagplaatsen.

2. Schakel onder GitHub Copilot codebeoordelingAutomatisch Copilot-codebeoordeling aanvragen voor nieuwe pull requests voor alle repository's in dit project in op Aan.

   Deze instelling is van toepassing op alle opslagplaatsen in het project, tenzij een beleid op opslagplaatsniveau dit overschrijft.

Automatische controle voor één opslagplaats configureren

Gebruik beleid op opslagplaatsniveau wanneer u specifiek gedrag van de opslagplaats nodig hebt.

1. Selecteer Projectinstellingen>Repos>Opslagplaatsen.

2. Selecteer de opslagplaats die u wilt configureren.

3. Zet op het tabblad Instellingen, onder GitHub Copilot-codebeoordeling, de optie Automatisch Copilot-codebeoordeling aanvragen voor nieuwe pull requests op Aan.

4. (Optioneel) Beoordelingsbereik configureren:

   • Van toepassing op alle pull-aanvragen: Copilot controleert elke nieuwe pull-aanvraag in de opslagplaats.
   • Van toepassing op specifiek branchbeleid: Copilot controleert alleen pull requests die gericht zijn op opgegeven branches (bijvoorbeeld main of develop).

   Beleidsprioriteit voor automatische beoordelingen:

   • Het beleid voor automatische controle op projectniveau is van toepassing op alle opslagplaatsen in het project.
   • Instellingen voor automatische controle op opslagplaatsniveau overschrijven de standaardwaarde op projectniveau voor die opslagplaats.

Wanneer u automatische controle inschakelt, begint Copilot met het controleren van nieuwe pull-aanvragen onmiddellijk na het maken. U kunt nog steeds handmatig aanvullende beoordelingen aanvragen door Aanvraag naast GitHub Copilot in de pull-aanvraag te selecteren.

Een agentgroep selecteren

Copilot-codebeoordeling voert beoordelingstaken uit door gebruik te maken van een Azure-pipelines-agentpool. Standaard wordt de standaardgroep Azure-pipelines in uw organisatie gebruikt.

Sommige organisaties schakelen de standaardgroep Azure-pipelines uit. In die configuratie kan Copilot-codereview pas worden uitgevoerd nadat u een ondersteunde alternatieve pool hebt geselecteerd.

Als uw organisatie een beheerde DevOps-pool heeft geconfigureerd, kunt u deze selecteren om Copilot codebeoordeling uit te voeren in plaats van de standaardpool.

Wanneer u een installatiekopie voor Managed DevOps Pool selecteert, zorg er dan voor dat u de meest recente Ubuntu Server selecteert.

Windows afbeeldingen worden niet ondersteund voor Copilot codebeoordelingen. Meng uw pool niet met zowel Ubuntu- als Windows-agents.

1. Selecteer Organisatie-instellingen>Repo's>Opslagplaatsen.

2. Selecteer onder GitHub Copilot codebeoordelingde optie Compute-pool in de vervolgkeuzelijst.

   De configuratie van de rekengroep van uw organisatie bepaalt de beschikbare pools. Als er geen pools beschikbaar zijn, neemt u contact op met de beheerder van uw organisatie.

3. Kies Opslaan.

De geselecteerde pool verwerkt alle Copilot codebeoordelingen voor opslagplaatsen in uw organisatie. U kunt deze instelling op elk gewenst moment wijzigen. Als u verschillende pools wilt gebruiken voor verschillende projecten of opslagplaatsen, configureert u pooltoewijzingen via beheerde DevOps-pools.

Het beoordelingsgedrag van Copilot aanpassen

Raadpleeg Instructies voor Copilot-codebeoordeling configureren voor richtlijnen over het gebruik van aangepaste instructies en agentvaardigheden om de feedback van Copilot bij codebeoordelingen aan te passen.

Copilot gebruiken voor code review

Wanneer de functie op alle drie de niveaus is ingeschakeld, kunt u Copilot vragen een pull request te beoordelen. In de volgende secties wordt beschreven wat u kunt verwachten.

Een beoordeling aanvragen

Standaard controleert GitHub Copilot alleen een pull-aanvraag wanneer u om een pull-aanvraag vraagt:

1. Open een pull-aanvraag.

2. Gebruik in de sectie Revisoren een van de volgende opties naast GitHub Copilot:

   • Als u het standaardniveau voor inspanning van de opslagplaats wilt gebruiken, selecteert u Aanvraag.
   • Als u een ander inspanningsniveau voor deze beoordeling wilt gebruiken, opent u de vervolgkeuzelijst naast Aanvraag en selecteert u een inspanningsniveau.

3. Wacht totdat de beoordeling is voltooid. De beoordeling kan even duren, afhankelijk van de grootte van de opslagplaats en het aantal wijzigingen in de pull-aanvraag. Wanneer de beoordeling is afgerond, verandert de status in Beoordeling voltooid.

   

Als Copilot potentiële problemen identificeert, worden opmerkingen en suggesties rechtstreeks aan de pull-aanvraag toegevoegd, zodat u deze kunt onderzoeken en oplossen.

Het geselecteerde inspanningsniveau is alleen van toepassing op die beoordeling. Azure DevOps legt de aanvrager en het inspanningsniveau vast in de activiteit van de pull request.

Opmerkingen van Copilot lezen

• Copilot plaatst zijn feedback als een gewone reviewer met de naam GitHub Copilot bij de pull request.
• Elke opmerking wordt weergegeven op de coderegel waarop deze van toepassing is en, indien mogelijk, bevat een voorgestelde wijziging die u met één klik kunt toepassen.
• Copilot laat altijd een Comment beoordeling achter. Het keurt de pullrequest nooit goed en vraagt ook nooit om wijzigingen, dus de beoordeling voldoet niet aan het beleid voor verplichte reviewers en blokkeert het samenvoegen niet.
• de opmerkingen van Copilot gedragen zich als opmerkingen van een menselijke revisor. U kunt ze beantwoorden, erop reageren, ze oplossen of verbergen. Copilot leest reacties niet en geeft geen vervolg.

Opnieuw beoordelen na nieuwe commits

Copilot beoordeelt een pull request niet automatisch opnieuw wanneer u nieuwe commits pusht. Als u een nieuwe beoordeling wilt krijgen na een doorvoering, selecteert u Request opnieuw naast GitHub Copilot in de lijst Reviewers.

Een beoordeling die wordt uitgevoerd annuleren

Als een codebeoordeling langer duurt dan verwacht of als u deze moet stoppen, kunt u de beoordelingsuitvoering annuleren.

1. Open de pull request die Copilot momenteel beoordeelt.
2. Selecteer in de sectie Revisoren, naast GitHub Copilot, de knop Annuleren (of selecteer Meer opties>Controle annuleren).
3. Bevestig de annulering wanneer hierom wordt gevraagd.

De beoordelingsuitvoering stopt onmiddellijk en er worden geen extra opmerkingen toegevoegd. De gedeeltelijke beoordelingsresultaten, inclusief opmerkingen die vóór annulering zijn toegevoegd, blijven op de pull-aanvraag staan. U kunt op elk gewenst moment een nieuwe beoordeling aanvragen.

Vereisten en beperkingen

De volgende vereisten en limieten zijn van toepassing tijdens de preview en kunnen worden gewijzigd.

Copilot een pull-aanvraag alleen controleert wanneer deze voldoet aan deze vereisten:

Deze gelijktijdigheids- en frequentielimieten zijn ook van toepassing:

Billing

Elke voltooide codebeoordeling verbruikt tokens, inclusief invoertokens die u naar het model verzendt, uitvoertokens die door het model worden gegenereerd en in de cache opgeslagen tokens die bestaande context hergebruiken. Tokens die voor elke beoordeling worden gebruikt, worden omgezet in een standaardfactureringseenheid, een GitHub AI-tegoed, waarbij 1 tegoed gelijk is aan $ 0,01 USD.

De geselecteerde beoordelingsinspanning is van invloed op het verbruik. Hogere inspanningsniveaus analyseren over het algemeen meer context en verbruiken meer tokens dan lagere inspanningsniveaus. De grootte van pull-aanvragen, aangepaste instructies voor opslagplaatsen en modelwijzigingen kunnen ook van invloed zijn op het verbruik. Zie Geschatte verbruik voor huidige referentiebereiken en opmerkingen.

Voor antwoorden op veelgestelde vragen over de facturering en kosten van Copilot-codebeoordeling, zie Problemen met Copilot-codebeoordeling oplossen.

Kosten gaan naar het Azure-abonnement dat is gekoppeld aan uw Azure DevOps organisatie en worden weergegeven als een afzonderlijke meter in Azure Cost Management. Als u de verwachte kosten in uw omgeving wilt schatten, schakelt u de functie in voor een of twee opslagplaatsen, vergelijkt u de inspanningsniveaus en controleert u het dagelijkse gebruik.

Copilot kosten voor codebeoordeling in Azure Cost Management bevatten nu Azure DevOps projecttags, waardoor kostenrapportage per project mogelijk is. U kunt de kostenanalyse filteren of groeperen op deze projecttags om gebruik en uitgaven toe te wijzen aan afzonderlijke Azure DevOps-projecten.

Uw dagelijkse kosten controleren:

1. Ga in de Azure-portal naar uw abonnement.

2. Selecteer Kostenbeheer>Kostenanalyse.

3. Filter op product om de dagelijkse kosten van de organisatie weer te geven. Als u de kosten voor een specifiek project wilt weergeven, voegt u een filter of groep toe op de Azure DevOps projecttag.

   

Een budgetwaarschuwing instellen

Maak een Azure budget waarmee u wordt op de hoogte gesteld wanneer de uitgaven een drempelwaarde bereiken die u hebt ingesteld. Budgetten waarschuwen u alleen. Ze stoppen geen beoordelingen of wijzigen van resources. U hebt eigenaars-, inzender- of Cost Management-inzendertoegang nodig voor het abonnement dat is gekoppeld aan uw Azure DevOps organisatie.

1. Open in de Azure-portal het abonnement dat is gekoppeld aan uw Azure DevOps organisatie.

2. Selecteer Kostenbeheer>Budgetten en selecteer vervolgens Toevoegen.

3. Voeg onder Filters een filter toe voor Product en selecteer GitHub Copilot voor AzDO.

   

4. Als het abonnement is gekoppeld aan meerdere Azure DevOps organisaties, voegt u een filter toe voor Tag en selecteert u de organisatienaamtags waarop u de waarschuwing wilt toepassen. Als er projecttags aanwezig zijn, kunt u ook filteren of groeperen op projecttag om budgetwaarschuwingen op projectniveau te maken.

5. Voer een budgetnaam in, kies een periode voor opnieuw instellen en vervaldatum, stel het budgetbedrag in en selecteer vervolgens Volgende.

6. Voeg een of meer waarschuwingsdrempels toe als een percentage van het budget (bijvoorbeeld 75% en 90%), stel Type in op Werkelijk of Voorspeld en voer de e-mailadressen in die u wilt melden.

7. Klik op Creëren.

   

Wanneer uitgaven een drempelwaarde bereiken, stuurt Azure binnen een uur na de volgende evaluatie een e-mail. Als u geactiveerde waarschuwingen wilt bekijken, selecteert u Cost Management>Kostenwaarschuwingen. Om te voorkomen dat waarschuwingsmails in uw map Ongewenste e-mail terechtkomen, voegt u azure-noreply@microsoft.com toe aan uw lijst met goedgekeurde afzenders. Zie Budgetten maken en beheren voor meer informatie.

Copilot-codebeoordeling uitschakelen

Als u Copilot codebeoordeling niet meer wilt gebruiken, stelt u de wisselknop in op Off in het bereik dat u wilt uitschakelen:

• Voor één gebruiker: Schakel in je gebruikersinstellingen de schakelaar Preview-functies uit.
• Voor één opslagplaats: Schakel de wisselknop voor de opslagplaats uit in Project-instellingen>Repos>Repositories.
• Voor de hele organisatie: schakel de wisselknop van de organisatie uit in Organization settings>Repos>Repositories. Met deze actie wordt de functie voor alle opslagplaatsen uitgeschakeld.

Feedback delen

Als u problemen wilt melden of feedback over deze preview wilt delen, gaat u naar de Azure DevOps Developer Community.

Problemen met Copilot-codereview oplossen

Zie Problemen met aangepaste instructies oplossen Copilot code controleren voor antwoorden op veelgestelde vragen over facturering, gegevensverwerking, naleving en het oplossen van problemen met aangepaste instructies.

Volgende stap

Verwante inhoud

• Problemen met Copilot-codereview oplossen
• Instructies voor Copilot-codebeoordeling configureren
• Over GitHub Copilot codebeoordeling
• Over pull-aanvragen
• Instellingen en beleidsregels voor opslagplaatsen