GitHub Copilot gebruiken met Azure Boards

Azure DevOps Services

Gebruik Azure Boards met GitHub Copilot om sneller over te stappen van werkitem naar concept pull-aanvraag. Start Copilot vanuit een werkitem om een branch te maken, codewijzigingen te genereren en een concept-pullrequest te openen, terwijl Azure DevOps de voortgang op het werkitem bijhoudt.

Gebruik deze integratie voor:

• Begin met geautomatiseerd coderen vanuit werkitems.
• Volg GitHub Copilot voortgang rechtstreeks in Azure DevOps.
• Gegenereerde vertakkingen en pull-aanvragen koppelen aan werkitems.
• Controleren wanneer concept-pull-aanvragen gereed zijn voor controle.

Vereiste voorwaarden

Voor teambeheerders

Gebruik de volgende controlelijst om deze integratie voor teams in te stellen:

• Configureer GitHub App-integratie op organisatieniveau. Zie Azure Boards verbinden met GitHub voor installatiestappen.
• Zorg ervoor dat elk teamlid de vereiste toegang heeft in beide systemen:
  • Azure DevOps machtigingen voor het bijwerken van werkitems en het koppelen van artefacten.
  • GitHub toegang tot de doelopslagplaatsen en vertakkingen.

Ondersteunde typen werkitems

De GitHub Copilot-integratie ondersteunt werkitemtypen in de categorieën Vereisten en Taken, waaronder:

• Standaardwerkitemtypen, zoals Gebruikersverhaal, Productachterstanditem, Vereiste, Taak, Bug en Probleem.
• Aangepaste werkitemtypen die u in uw processjabloon definieert.

Aangepaste typen worden ondersteund wanneer uw proces deze toe wijst aan de categorieën Vereisten of Taken.

U kunt GitHub Copilot gebruiken met werkitems uit Agile-, Scrum-, CMMI- en aangepaste processjablonen in uw Azure DevOps project.

GitHub Copilot starten vanuit werkitems

1. Open het werkitem dat u wilt implementeren met behulp van GitHub Copilot.

2. Selecteer in het werkitemformulier het pictogram GitHub.

   Als er meerdere opties beschikbaar zijn, wordt het pictogram weergegeven als een vervolgkeuzemenu.

   

3. Selecteer Maak een pull-aanvraag met GitHub Copilot.

   

4. Selecteer de doel-GitHub-opslagplaats en branch voor de pull request.

   Opmerking

   In de lijst met opslagplaatsen worden alleen GitHub opslagplaatsen weergegeven die zijn verbonden via GitHub App-verificatie. Azure-opslagplaatsen worden niet ondersteund.

5. (Optioneel) Voeg speciale instructies toe om de implementatie te begeleiden.

   Voorbeeldinstructies:

   • Maak een README met installatie-instructies.
   • Gebruik async/await-patronen voor nieuwe asynchrone code.
   • Eenheidstests voor nieuwe logica toevoegen.
   • Volg de bestaande codestijl en naamconventies van de opslagplaats.

6. Klik op Creëren.

   

Wat gebeurt er wanneer u Copilot start

Wanneer u Copilot vanaf een werkitem start, voert Azure DevOps de volgende acties uit:

• Werkitemcontext delen met GitHub Copilot: titel, grote tekstvelden (zoals beschrijving en acceptatiecriteria), opmerkingen en een koppeling naar het werkitem.
• Maak een branch en een concept-pullrequest in de geselecteerde GitHub-repository en koppel beide vervolgens aan het werkitem.
• Werkitemstatus bijwerken, zodat u de statussen in uitvoering, gereed voor controle en foutstatussen kunt bijhouden.

Voortgang van GitHub Copilot bewaken

Statusindicatoren

Azure DevOps geeft Copilot status rechtstreeks op uw werkitem weer met drie mogelijke statussen:

• Wordt uitgevoerd: Copilot codewijzigingen genereert.
• Gereed voor beoordeling: Het concept van de pull request is gereed voor beoordeling.
• Fout: het coderingsproces is mislukt. Beweeg de aanwijzer over de status voor details.

Bordkaartindicatoren

Werkitems op het bord geven GitHub Copilot status rechtstreeks op de kaart met werkitems weer. Er verschijnt een GitHub Copilot-pictogram op de kaart, dat aangeeft dat Copilot bezig is met werken aan of het werk heeft voltooid voor dat item.

Met deze indicator kunt u werkitems identificeren met actieve of voltooide bewerkingen Copilot zonder elk item te openen.

Updates voor ontwikkelingssecties

In de sectie Ontwikkeling van uw werkitem wordt automatisch het volgende weergegeven:

• Branch aangemaakt door Copilot.
• Concept van pull-aanvraag met realtimestatus.
• Directe koppeling om gegenereerde code in GitHub te controleren.

De pull-aanvraag controleren en samenvoegen

1. Selecteer de koppeling naar de pull-aanvraag om de implementatie van Copilot in GitHub te bekijken.

2. Als u tevreden bent met de wijzigingen, zet u de concept-pullrequest om in een gewone pullrequest.

   De discussie over werkitems wordt automatisch bijgewerkt wanneer de status van de pull-aanvraag wordt gewijzigd.

3. Gebruik de interface van GitHub om de gegenereerde code te controleren, te commentaaren en goed te keuren.

4. Voeg de pull-aanvraag samen in GitHub wanneer u klaar bent.

   • De merge-commit wordt automatisch gekoppeld aan uw werkitem.
   • Koppelingen naar vertakkingen worden verwijderd als u de vertakking verwijdert.
   • Copilot statusindicatoren worden verborgen na geslaagde samenvoeging.

5. Nadat de pull-aanvraag is samengevoegd:

   1. Werk de status van uw werkitem bij om de voltooiing weer te geven.
   2. Controleer of de samenvoegdoorvoering wordt weergegeven in de sectie Ontwikkeling.
   3. Sluit het werkitem als de implementatie volledig aan de vereisten voldoet.

Zie Wat is GitHub Copilot? voor meer informatie.

Problemen oplossen

• Controleer de foutdetails: beweeg de muisaanwijzer over het foutpictogram om details weer te geven.

• Voer Copilot opnieuw uit: selecteer Copilot opnieuw uitvoeren om het opnieuw te proberen met dezelfde of bijgewerkte instructies.

  

• Handmatige interventie: breng indien nodig handmatige wijzigingen aan in de gegenereerde vertakking en pull-aanvraag.

Licentieproblemen

• Probleem: licentievalidatie mislukt.
• Oplossing: Bevestig dat u een actief GitHub Copilot-abonnement hebt en selecteer vervolgens Een licentie ophalen als hierom wordt gevraagd.

Toegang tot repository

• Probleem: Kan verwachte opslagplaatsen niet zien.
• Oplossing:
  • Controleer de GitHub app-verbinding tussen Azure DevOps en GitHub.
  • Controleer of u toegang hebt tot de doelopslagplaatsen GitHub.
  • Controleer de machtigingen van de repository en de GitHub App-authenticatie.
  • Controleer of de opslagplaats is verbonden via de juiste GitHub App-integratie.

Copilot-fouten

• Probleem: Copilot fouten ondervindt.
• Oplossing: Bekijk de foutdetails, verduidelijkt uw instructies en voer Copilot opnieuw uit.

Herhaalde fouten na opnieuw uitvoeren

• Probleem: Copilot blijft mislukken na het opnieuw uitvoeren.
• Oplossing:
  • Controleer de gekoppelde vertakking en pull-aanvraag in GitHub op de meest recente bewerkingsstatus.
  • Controleer of de repository- en branchmachtigingen Copilot nog steeds toestaan branches en pull requests te maken.
  • Als het probleem zich blijft voordoen, neem dan contact op met uw project- of organisatiebeheerder en vermeld de koppeling naar het werkitem en de koppeling naar de pullaanvraag.

Een actieve bewerking annuleren

Status wordt niet bijgewerkt

• Probleem: de voortgangsstatus blijft hangen.
• Oplossing: Controleer GitHub op werkelijke voortgang, omdat statusupdates afhankelijk zijn van GitHub rapportage.

Beste praktijken

• Duidelijke beschrijvingen van werkitems: geef gedetailleerde acceptatiecriteria en context op voor betere resultaten met Copilot.
• Wijzigingen eenvoudig en beknopt houden: Hoe complexer en uitgebreider de beschrijving van uw werkitem, hoe moeilijker het is voor Copilot om te begrijpen. Focus op duidelijke, specifieke vereisten.
• Specifieke instructies: implementatierichtlijnen toevoegen bij het starten van Copilot.
• Regelmatige controle: Controleer regelmatig de voortgang, met name voor complexe werkitems.
• Promptbeoordeling: Beoordeel en geef snel feedback op concept pull requests om momentum te behouden.
• Juiste hygiëne van werkitems: Werkitemstatussen op de juiste wijze bijwerken tijdens het proces.

Beperkingen

Bekijk de volgende beperkingen wanneer u GitHub Copilot gebruikt met Azure Boards:

• Afhankelijkheden: Copilot verwerkt geen afhankelijkheden tussen werkitems. Houd elk werkitem zelfstandig.
• Gegevens delen: GitHub Copilot alleen de titel van het werkitem, grote tekstvelden, opmerkingen en de koppeling naar het werkitem ontvangt.
• Complexiteit: te complexe of uitgebreide beschrijvingen van werkitems kunnen Copilot effectiviteit verminderen.

Verwante inhoud

• Werkitems koppelen aan ontwikkelingsartefacten
• Integratie van GitHub configureren
• Werk met pull-aanvragen in Azure-opslagplaatsen
• Werk bijhouden met verbindingen en bijlagen