Podłącz usługę repozytorium kodu źródłowego

Daj agentowi dostęp do kontekstu repozytorium, problemu i pull requestów do analiz. Może odczytać ostatnie zmiany, znaleźć powiązane problemy i otworzyć problem lub pull request w odpowiednim repozytorium lub projekcie, gdy podane poświadczenia na to pozwalają.

Ten samouczek obejmuje GitHub, Azure DevOps i GitLab. Połączenia kodu źródłowego korzystają ze strony Dostęp do kodu (Build + setup > Kontekst > Dostęp do kodu), a nie kreatora zarządzanego łącznika. Ten artykuł skupia się na szczegółach kodu źródłowego: jak każda usługa uwierzytelnia się i jak weryfikować połączenie.

Wymagania wstępne

  • Działający agent SRE i dostęp do sre.azure.com.
  • Uprawnienie do konfiguracji agenta.
  • Konto w usłudze z dostępem do repozytoriów lub projektów, do których agent powinien mieć dostęp do odczytu.

W przypadku usług powiadomień zobacz Łączenie usługi powiadomień.

Złącza kodu źródłowego

Złącze Usługa Authentication Typowe użycie
GitHub GitHub i GitHub Enterprise Cloud Własna aplikacja GitHub (OAuth i PAT również wspierane dla github.com) Czytaj repozytoria, zgłoszenia i pull requesty w różnych projektach i organizacjach; twórz zgłoszenia lub pull requesty z zatwierdzeniem
Azure DevOps Azure DevOps Zarządzana tożsamość (obsługiwane także OAuth i PAT) Odczytywanie repozytoriów i pull requestów między projektami; tworzenie pull requestów lub zadań z zatwierdzeniem
GitLab GitLab Osobisty token dostępu (PAT) Czytaj repozytoria, zgłoszenia i żądania scalenia; twórz zgłoszenia i komentarze po zatwierdzeniu

GitHub i Azure DevOps prezentują opcje uwierzytelniania jako przyciski radiowe. GitLab używa osobistego tokena dostępu.

Krok 1: Otwórz dostęp do kodu

  1. Przejdź do sre.azure.com i wybierz agenta.
  2. W lewym pasku bocznym wybierz Build + setup>Context>.
  3. Wybierz zakładkę dla swojej usługi (GitHub, Azure DevOps lub GitLab).
  4. Wybierz pozycję Dodaj repozytorium.

Krok 2: Uwierzytelnij się

Okno Dodaj repozytoria składa się z dwóch etapów: Połączenie i Dodaj repozytoria. W Connection wybierz platformę i wprowadź adres URL repozytorium lub organizację przed konfiguracją uwierzytelniania. Wybierz Następny po połączeniu, a potem Zapisz na ostatnim kroku.

Wybierz Użyj aplikacji GitHub dla GitHub Enterprise Cloud lub aby ograniczyć dostęp według organizacji lub instalacji.

  1. Wpisz pełny adres URL repozytorium, na przykład https://github.com/owner/repo.
  2. Jeśli istnieje pasujące poświadczenie, wybierz Istniejące połączenie , aby je ponownie użyć, lub Nowe połączenie , aby skonfigurować inne.
  3. W sekcji Metoda połączenia wybierz Użyj aplikacji GitHub.
  4. Wypełnij pola ustawień aplikacji wyświetlane przez kreatora.
  5. Wybierz Połącz i potwierdź, że połączenie zostało nawiązane.
  6. Wybierz Dalej.

GitHub Enterprise Cloud (.ghe.com) wymaga połączenia z aplikacją GitHub. Dla github.com obsługiwane są również OAuth oraz osobisty token dostępu (PAT). Uwierzytelnianie aplikacji GitHub wymaga identyfikatora URI klucza RSA usługi Key Vault (/keys/), a nie identyfikatora URI wpisu tajnego. Zobacz Skonfiguruj aplikację GitHub BYO.

Po połączeniu agent może przeszukiwać repozytoria, zgłoszenia i pull requesty w różnych projektach i organizacjach, do których Twoja aplikacja lub konto ma dostęp.

Usługa widzi tożsamość, która autoryzowała połączenie. Problemy, komentarze i działania pull requestów tworzone przez agenta pojawiają się na tym koncie.

Krok 3: Dodaj repozytoria

Przejrzyj repozytoria do dodania. Dla GitHub rozwiń każde repozytorium, aby edytować jego wyświetlaną nazwę i opis. Dla Azure DevOps i GitLab edytuj te pola bezpośrednio w tabeli.

  1. Jeśli twoja usługa jest Azure DevOps, najpierw wybierz projekt z rozwijanego menu Azure DevOps Project. Kolumna URL repozytoria zawiera repozytoria w tym projekcie.

  2. Sprawdź początkowy adres URL repozytorium. Aby uzyskać więcej elementów, wybierz repozytorium z rozwijanego menu lub wpisz bezpośrednio adres URL. Dla Azure DevOps wybierz najpierw projekt.

  3. Wprowadź krótką nazwę wyświetlaną , której agent używa do odniesienia do repozytorium. Dla GitHub rozwiń wpis, aby znaleźć to pole.

  4. Opcjonalnie wprowadź Opis, aby przekazać agentowi więcej kontekstu na temat repozytorium. Dla GitHub najpierw wybierz Dodaj opis.

  5. Jeśli Twoje środowisko Azure DevOps oferuje opcję Remote, możesz go używać do wyszukiwania opartego na sztucznej inteligencji bez klonowania całego repozytorium. Ta opcja nie jest dostępna we wszystkich środowiskach.

  6. Aby dodać kolejne repozytorium, wybierz Dodaj repozytorium dla GitHub lub Dodaj w siatce Azure DevOps lub GitLab. Dodatkowe repozytoria GitHub w tym powiązaniu korzystają z tego samego hosta i danych uwierzytelniających.

  7. Gdy tabela jest kompletna, wybierz Zapisz.

Krok 4: Zweryfikuj scenariusz

  1. Otwórz czat ze swoim agentem.

  2. Zadaj pytanie do odczytania, na przykład:

    List the open issues in the payments repository from the last week.

  3. Sprawdź kartę narzędzi, aby zobaczyć, jak agent przeszukuje usługę i zwraca wyniki oparte na Twoich danych.

Gdy pojawiają się wyniki odnoszące się do twojego repozytorium, połączenie działa od początku do końca.

Troubleshooting

Problem Cause Napraw.
Wyszukiwanie nie zwraca żadnych wyników Konto nie ma dostępu do projektu ani repozytorium Potwierdź, że konto połączenia widzi projekt lub repozytorium, a potem spróbuj ponownie.
Tworzenie kończy się błędem uprawnień Token lub konto nie ma uprawnień do zapisu Nadaj wymagany zakres tokenowi lub kontu albo użyj poświadczeń mających dostęp do zapisu.
GitHub Enterprise Cloud odrzuca połączenie GitHub Enterprise Cloud wymaga połączenia z aplikacją GitHub Na stronie dostępu do kodu rozłącz połączenie GitHub, wybierz Dodaj repozytorium, wybierz GitHub, wpisz swój .ghe.com host i wybierz Bring your own GitHub App jako metodę uwierzytelniania.

Treści powiązane

  • Ostatnia aktualizacja o