Přeskočit na hlavní obsah

Azure DevOps

Připojení Azure DevOps poskytuje agentům kontrolovaný přístup k projektům, repozitářům, větvím, souborům, rozdílům a pull requestům v Azure DevOps. Použijte ho, když by agent měl prozkoumat kód, připravit dokumentaci nebo uvolnit změny, otevřít větev pro navrhovanou aktualizaci nebo pomoci s pracovním postupem pull requestu uvnitř Azure DevOps.

Kdy to použít​

Použijte Azure DevOps, když agent potřebuje:

  • vyhledávat kód v rámci projektu nebo repozitáře,
  • vypsat projekty, repozitáře, větve nebo pull requesty,
  • číst soubory repozitáře nebo segmenty souborů,
  • porovnat dvě větve před dokumentováním nebo přezkoumáním změny,
  • vytvořit větev, potvrdit změnu souboru nebo otevřít pull request.

Nastavení​

  1. V Connections klikněte na Add Integration.
  2. Vyberte Azure DevOps.
  3. Vytvořte nebo použijte Personal Access Token (PAT) v Azure DevOps s minimálně přístupem pro čtení repozitáře.
  4. Zadejte URL organizace Azure DevOps, například https://dev.azure.com/your-org.
  5. Uložte připojení a přiřaďte ho pouze agentům nebo pracovním postupům, které by měly mít přístup k obsahu repozitáře.

Pokud agent musí zapisovat do repozitářů, použijte PAT s minimálním rozsahem zápisu Git požadovaným pro cílový projekt.

Co nástroj může dělat​

Operace pro čtení a inspekci:

  • vyhledávat kód pomocí syntaxe pro vyhledávání kódu Azure DevOps,
  • vypsat projekty a repozitáře,
  • vypsat větve repozitáře,
  • vypsat pull requesty podle repozitáře nebo podle projektu,
  • prozkoumat detaily pull requestu, potvrzení a recenzenty,
  • číst soubor nebo segment řádku z větve,
  • vypsat soubory a složky v cestě repozitáře,
  • porovnat rozdíly větví.

Operace schopné zápisu:

  • vytvořit větev,
  • vytvářet, aktualizovat nebo mazat soubory repozitáře na nechráněné větvi,
  • potvrdit více změn souborů v jednom potvrzení,
  • vytvořit nebo aktualizovat pull request.

Vyhledávání a čtení souborů​

Operace vyhledávání kódu podporuje normální vyhledávací text spolu se filtry ve stylu Azure DevOps, jako jsou:

  • proj:
  • repo:
  • path:
  • file:
  • ext:
  • class:
  • def:
  • comment:

Použijte čtení souborů, když by agent měl citovat nebo shrnout přesný zdrojový soubor. Použijte čtení segmentu souboru, když je soubor velký a agent potřebuje pouze omezenou část kolem odpovídajícího ukotvovacího řádku.

Použijte výpis cesty repozitáře před čtením, když si agent není jistý přesným názvem složky nebo souboru. Použijte inspekci rozdílů před dokumentační prací, aby poznámky k vydání nebo shrnutí změn byly založeny na skutečném rozdílu větve, nikoli na odhadovaném rozsahu potvrzení.

Pracovní postup větve a pull requestu​

Nejbezpečnější vzor zápisu je:

  1. Vypsat repozitáře a větve.
  2. Vytvořit nebo zajistit dedikovanou pracovní větev.
  3. Nejprve přečíst cílový soubor nebo rozdíl.
  4. Upsertovat jeden soubor nebo potvrdit několik souvisejících změn souborů dohromady.
  5. Vytvořit pull request zpět na main, master nebo integrační větev týmu.

To udržuje změny vytvořené agentem přehledné a vyhýbá se přímým úpravám chráněných větví.

Chráněné větve a potvrzení​

Uvolněná uživatelská rozhraní nástroje blokují přímé potvrzení do chráněných názvů větví, jako jsou:

  • main
  • master
  • release/*

I když může PAT zapisovat, udržujte Povolené s potvrzením u funkcí Azure DevOps schopných zápisu:

  • vytvořit větev,
  • upsertovat soubor,
  • smazat soubor,
  • potvrdit více souborů,
  • vytvořit nebo aktualizovat pull request.

Požádejte agenta, aby ukázal zamýšlený rozdíl, obsah souboru nebo popis pull requestu před potvrzením zápisu. Operace čtení a inspekce mohou obvykle zůstat povoleny bez potvrzení, pokud je publikum repozitáře již schváleno pro tento kód.

Příklad použití​

Porovnejte main a feature/release-notes, shrňte změněné soubory a poté navrhněte popis pull requestu.

Přečtěte /docs/api.md z větve dev a zobrazte pouze sekci kolem Authentication.

Technické poznámky​

  • Implementace: připojení vystavuje operace repozitáře, souboru, větve, rozdílu a pull requestu Azure DevOps.
  • Autentizace/rozsahy: používá přístup založený na PAT Azure DevOps vůči nakonfigurované URL organizace. Oprávnění k projektům a repozitářům určují, co může agent číst nebo měnit.
  • Funkce: vyhledávání kódu, výpis projektů/republikací, výpis větví, inspekce pull requestů, čtení souborů, výpis souborů, vytváření větví, změny souborů, vícenásobné potvrzení souborů, vytváření/aktualizace pull requestů a rozdíl větví.
  • Chování zápisu: zápisy do repozitářů jsou skutečné operace Git. Výchozí je potvrzení, preferujte krátkodobé pracovní větve a považujte pull requesty za normální cestu sloučení.
Naposledy aktualizováno