Použití GitHub Copilot s Azure Boards

Služby Azure DevOps

Pomocí Azure Boards a GitHub Copilotu můžete rychleji přejít z pracovní položky k návrhu žádosti o přijetí změn. Spusťte Copilot z pracovní položky, vytvořte větev, vygenerujte změny kódu a otevřete návrh žádosti o přijetí změn, zatímco Azure DevOps sleduje postup práce na pracovní položce.

Tuto integraci použijte k:

  • Začněte s automatizovaným psaním kódu z pracovních položek.
  • Sledujte průběh GitHub Copilot přímo v Azure DevOps.
  • Propojte vytvořené větve a pull requesty s pracovními položkami.
  • Sledujte, kdy jsou koncepty pull requestů připraveny k revizi.

Důležité

Tato integrace vyžaduje GitHub úložiště a ověřování aplikací GitHub. Pro integraci GitHub Copilot se nepodporují úložiště Azure Repos (úložiště Git služby Azure DevOps).

Požadavky

Kategorie Požadavky
Licencování Aktivní předplatné GitHub Copilot. Informace o cenách najdete v GitHub Copilot plánech.
Repository GitHub úložiště (ne Azure Repos) s příslušnými oprávněními
Autentizace GitHub ověřování aplikací nakonfigurované mezi Azure DevOps a GitHub (nepodporují se osobní přístupové tokeny)
Povolení Contribute přístup v Azure DevOps k pracovním položkám a možnost propojit artefakty
připojení Azure Boards Připojení Azure Boards k GitHub

Pro správce týmu

K nastavení této integrace pro týmy použijte následující kontrolní seznam:

  • Nakonfigurujte integraci aplikace GitHub na úrovni organizace. Postup nastavení najdete v tématu Připojení Azure Boards k GitHub.
  • Ujistěte se, že každý člen týmu má požadovaný přístup v obou systémech:
    • Oprávnění Azure DevOps k aktualizaci pracovních položek a propojování artefaktů.
    • Přístup v GitHubu k cílovým repozitářům a větvím.

Podporované typy pracovních položek

Integrace GitHub Copilot podporuje typy pracovních položek v kategoriích Požadavky a úkoly, včetně:

  • Standardní typy pracovních položek, jako je uživatelský scénář, položka backlogu produktu, požadavek, úkol, chyba a problém.
  • Vlastní typy pracovních položek, které definujete v šabloně procesu.

Vlastní typy se podporují, když je proces mapuje na kategorie Požadavky nebo Úkoly.

V projektu Azure DevOps můžete použít GitHub Copilot s pracovními položkami z Agilních, Scrum, CMMI a vlastních šablon procesů.

Spustit GitHub Copilot z pracovních úkolů

  1. Otevřete pracovní položku, kterou chcete implementovat, pomocí GitHub Copilot.

  2. Ve formuláři pracovní položky vyberte ikonu GitHub.

    Pokud je k dispozici více možností, zobrazí se ikona jako rozevírací nabídka.

    Snímek obrazovky zobrazující zvýrazněnou ikonu GitHub Copilot v pracovním položce.

  3. Vyberte Vytvořit návrh změn pomocí GitHub Copilot.

    Snímek obrazovky zobrazující vybranou rozbalovací nabídku GitHub a možnost Zahájit pull request na GitHubu.

  4. Vyberte cílový repozitář na GitHubu a cílovou větev pro žádost o přijetí změn.

    Poznámka:

    V seznamu úložišť se zobrazují jenom GitHub úložiště připojená prostřednictvím ověřování GitHub aplikace. Služba Azure Repos není podporována.

  5. (Volitelné) Přidejte speciální pokyny pro usměrnění implementace.

    Ukázkové pokyny:

    • Vytvořte soubor README s pokyny k nastavení.
    • Pro nový asynchronní kód použijte vzory async/await.
    • Přidejte jednotkové testy pro novou logiku
    • Dodržujte stávající styl kódu a konvence pojmenování v repozitáři.

  6. Vyberte Vytvořit.

    Screenshot zobrazuje rozevírací nabídky pro úložiště a větev k vytvoření konceptu pull requestu pomocí Copilot.

Co se stane, když spustíte službu Copilot

Když spustíte Copilot z pracovní položky, Azure DevOps provede následující akce:

  • Sdílejte kontext pracovní položky s GitHub Copilot: název, velká textová pole (například popis a kritéria přijetí), komentáře a odkaz na pracovní položku.
  • Ve vybraném úložišti GitHubu vytvořte větev a koncept pull requestu a poté je propojte s pracovní položkou.
  • Aktualizujte stav pracovní položky , abyste mohli sledovat probíhající, připravené ke kontrole a chybové stavy.

Monitorování průběhu GitHub Copilot

Indikátory stavu

Azure DevOps zobrazí stav Copilot přímo na pracovní položce se třemi možnými stavy:

  • Probíhá: Copilot generuje změny kódu.
  • Připraveno ke kontrole: Koncept požadavku na přijetí změn je připraven ke kontrole.
  • Chyba: Proces kódování selhal. Najeďte myší na stav a zobrazíte podrobnosti.

Poznámka:

V závislosti na složitosti pracovní položky očekáváte, že dokončení operace Copilot trvá 5 až 15 minut.

Indikátory karty panelu

Pracovní položky na panelu zobrazují GitHub Copilot stav přímo na kartě pracovní položky. Na kartě se zobrazí ikona GitHub Copilot a značí, že Copilot pro danou položku pracuje nebo dokončila práci.

Snímek obrazovky zobrazující kartu úkolu na tabuli s ikonou stavu GitHub Copilot označující pokrok.

Tento indikátor vám pomůže identifikovat pracovní položky s aktivními nebo dokončenými operacemi Copilot bez otevření jednotlivých položek.

Aktualizace vývojové části

V části Vývoj pracovní položky se automaticky zobrazí:

  • Větev vytvořená Copilotem.
  • Koncept požadavku na začlenění se stavem v reálném čase
  • Přímý odkaz na kontrolu vygenerovaného kódu v GitHub

Kontrola a sloučení pull requestu

  1. Výběrem odkazu na žádost o přijetí změn zkontrolujte implementaci Copilot v GitHub.

  2. Pokud jste se změnami spokojeni, převeďte koncept pull requestu na běžný pull request.

    Diskuze o pracovní položce se automaticky aktualizuje, protože se změní stav žádosti o přijetí změn.

  3. Pomocí rozhraní GitHub můžete zkontrolovat, okomentovat a schválit vygenerovaný kód.

  4. Až budete připraveni, sloučte pull request na GitHubu.

    • Potvrzení sloučení automaticky odkazuje na vaši pracovní položku.
    • Odkazy na větev budou odstraněny, pokud větev odstraníte.
    • Copilot indikátory stavu jsou po úspěšném sloučení skryté.

  5. Po sloučení pull requestu:

    1. Aktualizujte stav pracovní položky tak, aby odrážel dokončení.
    2. Ověřte, že se potvrzení sloučení zobrazí v části Vývoj.
    3. Zavřete pracovní položku, pokud implementace plně řeší požadavky.

Další informace najdete v tématu Co je GitHub Copilot?

Řešení potíží

  • Kontrola podrobností o chybě: Pokud chcete zobrazit podrobnosti, najeďte myší na ikonu chyby.

  • Znovu spustit Copilot: Vyberte Znovu spustit Copilot a zkuste to znovu se stejnými nebo aktualizovanými pokyny.

    Screenshot zobrazuje vybranou ikonu Další akce a poté možnost Znovu spustit výběr Copilot v oblasti vývoje.

  • Ruční zásah: V případě potřeby proveďte ruční změny v generované branchi a pull requestu.

Problémy s licencí

  • Problém: Ověření licence nezdaří se.
  • Řešení: Potvrďte, že máte aktivní GitHub Copilot předplatné, a po zobrazení výzvy vyberte Získat licenci.

Přístup k úložišti

  • Problém: Očekávaná úložiště se nezobrazují.
  • Řešení:
    • Ověřte připojení aplikace GitHub mezi Azure DevOps a GitHub.
    • Ověřte, že máte přístup k cílovým úložištím GitHub.
    • Zkontrolujte oprávnění úložiště a ověřování aplikací GitHub.
    • Ověřte, že je úložiště připojené přes správnou integraci aplikace GitHub.

chyby Copilot

  • Problém: U Copilotu dochází k chybám.
  • Řešení: Projděte si podrobnosti o chybě, objasněte si pokyny a spusťte Copilot znovu.

Opakované chyby po opětovném spuštění

  • Problém: Copilot po opětovném spuštění selhává.
  • Řešení:
    • Zkontrolujte propojenou větev a pull request na GitHubu pro zjištění aktuálního stavu operace.
    • Ověřte, že oprávnění k repozitáři a větvím stále umožňují Copilotu vytvářet větve a žádosti o přijetí změn.
    • Pokud potíže potrvají, obraťte se na správce projektu nebo organizace s odkazem na pracovní položku a žádostí o přijetí změn.

Zrušení probíhající operace

Poznámka:

Po spuštění operace GitHub Copilot z pracovní položky ji nemůžete zrušit. Programovací agent Copilot běží až do dokončení. Pokud chcete řešit nežádoucí výsledky, spravujte nebo zahoďte vygenerovanou žádost o přijetí změn v GitHub.

Stav se neaktualizuje

  • Problém: Stav průběhu zůstává zablokovaný.
  • Řešení: Skutečný průběh zkontrolujte na GitHubu, protože aktualizace stavu závisí na údajích z GitHubu.

Osvědčené postupy

  • Podrobné popisy pracovních položek: Zadejte podrobná kritéria přijetí a kontext pro lepší Copilot výsledky.
  • Udržujte změny jednoduché a stručné: Čím moc složitý a rozsáhlý je popis vašeho pracovního zadání, tím má Copilot větší potíže porozumět. Zaměřte se na jasné konkrétní požadavky.
  • Specifická instrukce: Přidání pokynů k implementaci při spuštění Copilot
  • Pravidelné monitorování: Pravidelně kontrolujte průběh, zejména u složitých pracovních položek.
  • Rychlá kontrola: Rychle zkontrolujte a poskytněte zpětnou vazbu k návrhům žádostí o přetažení, abyste zachovali dynamiku.
  • Správná hygiena pracovních položek: V průběhu procesu aktualizujte stavy pracovních položek odpovídajícím způsobem.

Omezení

Při používání GitHub Copilot s Azure Boards zkontrolujte následující omezení:

  • Závislosti: Copilot nezpracovává závislosti mezi pracovními položkami. Uchovávejte jednotlivé pracovní položky samostatně.
  • Sdílení dat: GitHub Copilot obdrží jenom název pracovní položky, velká textová pole, komentáře a odkaz na pracovní položku.
  • Složitost: Příliš složité nebo podrobné popisy pracovních položek mohou snížit efektivitu Copilot.

Související obsah

  • Last updated on