Integracje / GitHub / GitLab

Komunikacja, projekty i biuro

Integracja AI: GitHub / GitLab

Podłączamy repozytoria przez token API read-only i czytamy issues, merge requesty, pipeline CI/CD oraz logi deploymentów. Asystent przekłada wiadomości commitów na język polski i wysyła cotygodniowy raport do właściciela bez otwierania repozytorium.

Po prezentacji do 2 tygodni testów, z dostępem tego samego dnia. Płacicie dopiero po decyzji.

Narzędzie „Zgłoszenia GitHub: orbito/panel” w portalu redAi, ekran z danymi z programu GitHub / GitLab
Narzędzie „Zgłoszenia GitHub: orbito/panel” w Waszym portalu. Dane przykładowe.

W skrócie

Jak asystent AI łączy się z systemem GitHub / GitLab?

Łączymy się przez REST API i GraphQL API obu platform. W GitHubie generujemy Personal Access Token lub Fine-grained Token z zakresami repo i read:org.

Na start potrzebujemy
Token API read-only: GitHub (zakresy repo, read:org) lub GitLab (zakres read_api)
Czego asystent nie robi
Asystent nie tworzy, nie zamyka ani nie edytuje issues i merge requestów w repozytorium.
Gdzie są dane
Na Waszym serwerze. Zaczynamy od odczytu, zapis włączacie sami.

Dane z GitHub / GitLab w czacie i we własnym module

Pracujecie na dwa sposoby. W czacie pytacie o cokolwiek z programu i dostajecie odpowiedź na Waszych danych. Do rzeczy, które wracają co dzień, budujemy w portalu osobne narzędzie: Zgłoszenia GitHub: orbito/panel. Moduł pobiera otwarte issues z repozytorium GitHub i wyświetla je według priorytetu i etykiety. Zespół widzi od razu, które zgłoszenia są krytyczne, brakuje im przypisanej osoby lub przekroczyły próg oczekiwania. Kliknięcie wiersza otwiera kartę zgłoszenia z historią komentarzy i linkiem bezpośrednio do GitHub.

  • Wyświetla otwarte issues posortowane według etykiety critical i czasu oczekiwania
  • Oznacza zgłoszenia krytyczne bez assignee czekające ponad 24 godziny
  • Pokazuje liczbę MR czekających na przegląd powyżej progu trzech dni
  • Wykrywa wdrożenia bez powiązanego pipeline z wynikiem passed i wyróżnia je na liście
  • Generuje alert dla team leada jednym kliknięciem z karty zgłoszenia
Rozmowa z asystentem AI w portalu redAi o danych z programu GitHub / GitLab: Zmiany w produkcie Orbito Panel w tym tygodniu

Pytanie w czacie

Asystent czyta wiadomości commitów i merge requestów z GitHub i układa je w jedno zdanie po polsku: właściciel wie, co zmieniło się w produkcie, bez otwierania repozytorium.

Przygotuj tygodniowe podsumowanie dla właściciela: co weszło na produkcję w tym tygodniu z repozytorium orbito/panel? Bez technicznego żargonu, po polsku.
Karta Zgłoszenie #247 w narzędziu Zgłoszenia GitHub: orbito/panel w portalu redAi

Karta w narzędziu

Karta zgłoszenia zestawia dane z GitHub z oceną asystenta: team lead widzi od razu, dlaczego sprawa jest pilna, bez przechodzenia przez cały tracker.

Moduł zbiera issues z GitHub i pokazuje je według priorytetu: team lead widzi na jednym ekranie, co blokuje pracę i gdzie brakuje przypisanej osoby.

Ekrany na danych przykładowych. Narzędzie dla Waszej firmy układamy pod Wasz sposób pracy: inne kolumny, inne progi, inne powiadomienia.

Co podłączamy

Zaczynamy od odczytu danych. Zapis i akcje w systemie GitHub / GitLab włączamy dopiero wtedy, gdy sami tego chcecie.

Issues i zgłoszenia

Czytamytytuł, opis, etykiety, przypisana osoba, data otwarcia, status open/closed i komentarze do zgłoszenia

Asystentwykrywa zgłoszenia krytyczne bez reakcji ponad 24 godziny i zaległe bez assignee, wysyła alert do managera zanim zadzwoni klient

Merge requesty i pull requesty

Czytamyautor, lista recenzentów, status recenzji (approved, changes requested, pending) i lista zmienionych plików

Asystentflaguje przeglądy kodu czekające na zatwierdzenie ponad 3 dni, które blokują wejście zmiany na serwer produkcyjny

Commits i historia zmian

Czytamywiadomość commita, autor, data i lista zmienionych ścieżek plików w danej zmianie kodu

Asystentprzekształca techniczne opisy commitów na zrozumiały dla właściciela opis zmian w produkcie, pisany po polsku bez żargonu

Pipelines CI/CD

Czytamyetapy build/test/deploy, wyniki testów z podziałem na przejścia i niepowodzenia, status i czas trwania pipeline'u

Asystentwykrywa wdrożenia na produkcję bez powiązanego pipeline'u lub z wynikiem failed i generuje natychmiastowy alert do managera

Environments i Deployments

Czytamyśrodowisko docelowe (staging, production), kto uruchomił, kiedy, do której wersji kodu i czy poprzedzał go pipeline

Asystentporównuje każde wdrożenie z wynikiem pipeline'u i alarmuje, gdy deploy ominął testy lub poszedł z gałęzi bez code review

Releases i tagi wersji

Czytamynumer wersji, data publikacji, opis wydania, commity od poprzedniego tagu i powiązane issues z milestone'u

Asystentgeneruje gotową notatkę wydania po polsku z opisem zmian widocznych dla użytkownika, z pominięciem refaktoryzacji i zmian wewnętrznych

O co pytają w praktyce

Po polsku, jak koledze z pracy. Asystent odpowiada na danych z Waszego programu, a nie z ogólnej wiedzy.

  • „Co nowego weszło do produktu w ostatnich 7 dniach?”
  • „Które zgłoszenia od klientów czekają bez przypisanej osoby ponad 5 dni?”
  • „Czy ostatnie wdrożenie na produkcję przeszło wszystkie etapy testów?”
  • „Jakie błędy naprawiono od czasu poprzedniego wydania?”

Co się zmienia

Właściciel dostaje w piątek czytelny raport o stanie projektu bez jednego pytania do programistów, a zaległe zgłoszenia przestają się gubić.

Asystent działa na Waszym serwerze, na Waszych uprawnieniach. Każdy odczyt i każda akcja zostawiają ślad w logu. Program zostaje tam, gdzie jest, razem z historią danych i nawykami zespołu.

O programie

GitHub i GitLab to platformy, na których zespoły programistyczne trzymają kod źródłowy, zgłaszają błędy, planują zmiany i wdrażają oprogramowanie na serwery. Korzystają z nich firmy rozwijające własne produkty cyfrowe, software house'y i działy IT prowadzące wewnętrzne systemy. Codzienna praca odbywa się przez zgłoszenia (issues), przeglądy kodu (code review) i automatyczne pipeline'y uruchamiane przy każdej zmianie.

Oba systemy udostępniają REST API i GraphQL API. Dane leżą na serwerach GitHub lub GitLab, ale GitLab można też zainstalować na własnym serwerze firmy. Repozytorium i historia pozostają na serwerze firmy, a do modelu trafia tylko to, co potrzebne do odpowiedzi, bez trenowania cudzych modeli na danych klienta. W repozytorium gromadzą się miesiące albo lata danych o zgłoszeniach, commitach i wdrożeniach. Większość firm nigdy nie zebrała ich w całość dla zarządu.

Gdzie to działa najlepiej

Właściciel firmy

Co piątek właściciel firmy rozwijającej własną platformę chce wiedzieć, co zmieniło się w produkcie. Dotychczas dowiadywał się o tym z rozmów przy kawie albo ze sprint review, na których nie rozumiał połowy slajdów.

Z asystentem: Dostaje na e-mail jedno zwięzłe podsumowanie po polsku: co naprawiono, co weszło jako nowa funkcja, które wdrożenie trafiło na produkcję. Nie musi nic pytać ani otwierać repozytorium.

Manager lub team lead

Krytyczne zgłoszenie od klienta leży w issue trackerze od ponad doby bez komentarza i bez przypisanego programisty. Manager nie wie, bo nikt mu nie powiedział, a programiści skupiają się na nowych zadaniach.

Z asystentem: Asystent wysyła alert z listą zaległych zgłoszeń krytycznych. Manager widzi problem i może reagować, zanim klient zadzwoni z pretensjami o brak odpowiedzi.

Dyrektor techniczny lub właściciel

Programista ręcznie uruchamia deployment na środowisko produkcyjne w piątek po 16:00, pomijając standardowy pipeline CI/CD z testami. Nikt nie zauważa, że etap testów nie przeszedł i że kod wchodzi na produkcję bez weryfikacji.

Z asystentem: Asystent wykrywa brak powiązanego pipeline'u z wynikiem passed i wysyła alert do managera. Firma ma szansę zareagować przed zgłoszeniem awarii przez użytkowników w poniedziałek.

Jak się łączymy

Łączymy się przez REST API i GraphQL API obu platform. W GitHubie generujemy Personal Access Token lub Fine-grained Token z zakresami repo i read:org. W GitLabie używamy Project Access Token albo Group Access Token z zakresem read_api. Token ma wyłącznie uprawnienia do odczytu, więc asystent pobiera dane i nie wprowadza żadnych zmian w repozytorium.

Przy GitLabie zainstalowanym na własnym serwerze firmy token wskazuje na wewnętrzny adres. Repozytorium i historia pozostają na serwerze firmy, a do modelu trafia tylko to, co potrzebne do odpowiedzi. Oprócz cyklicznego odpytywania API obsługujemy webhooki: GitHub i GitLab mogą wysłać powiadomienie natychmiast po każdym zdarzeniu, co przyspiesza alerty o wdrożeniach na produkcję czy krytycznych zgłoszeniach bez czekania na zaplanowany cykl.

Czego potrzebujemy od Was

  • Token API read-only: GitHub (zakresy repo, read:org) lub GitLab (zakres read_api)
  • Lista repozytoriów lub grup projektów do monitorowania wraz z wybranym harmonogramem sprawdzania
  • Wybór kanału powiadomień: e-mail, Slack, Microsoft Teams lub wewnętrzny panel redAi
  • Osoba po stronie firmy, która potwierdzi zakres monitorowania i odbierze pierwsze raporty
  • Przy GitLabie self-hosted: adres wewnętrznego serwera dostępny z naszej infrastruktury

Czego asystent nie robi

  • Asystent nie tworzy, nie zamyka ani nie edytuje issues i merge requestów w repozytorium.
  • Asystent nie blokuje deploymentów ani nie naprawia kodu: widzi wzorzec i zgłasza go człowiekowi do decyzji.
  • Asystent nie przypisuje zadań programistom ani nie wysyła do nich wiadomości bezpośrednio.
  • Asystent nie zastępuje code review: nie ocenia jakości kodu ani nie zatwierdza zmian w repozytorium.

Częste pytania

Jak szybko po podłączeniu pojawią się pierwsze użyteczne raporty?

Pierwsze sensowne wyniki pojawiają się po kilku dniach, gdy asystent zebrał historię z kilku cykli i może porównywać tygodnie. Na starcie warto zadać jednorazowe pytanie: podsumuj ostatnie 30 dni w repozytorium X. To od razu pokazuje, czy dane nadają się do automatycznych podsumowań.

Czy monitorowanie działa, gdy mamy kilkanaście repozytoriów w różnych projektach?

Tak. Określasz, które repozytoria lub grupy projektów mają być monitorowane. Można wybrać wszystkie naraz albo ograniczyć się do konkretnych. Przy GitLabie możesz wskazać całą grupę projektów jednym tokenem na poziomie grupy, bez konfigurowania każdego repozytorium osobno.

Czy mogę dostać alert od razu, gdy coś pójdzie nie tak, a nie czekać do piątkowego raportu?

Tak. Oprócz cyklicznych raportów obsługujemy webhooki: GitHub i GitLab wysyłają powiadomienie natychmiast po zdarzeniu, takim jak nowe wdrożenie na produkcję czy otwarcie zgłoszenia z etykietą critical. Alert trafia do managera w minutach, bez czekania na koniec tygodnia.

Czy raport można dostosować do tego, co mnie interesuje jako właściciela?

Tak. Możesz określić, które obszary chcesz widzieć w raporcie i z jaką częstotliwością. Na przykład właściciel może dostawać piątkowe podsumowanie z naciskiem na wdrożenia i nowe funkcje, a team lead codzienne alerty o zaległych zgłoszeniach i blokadach code review.

Pełny opis integracji w bazie wiedzy →

Jak zaczynamy

  1. Bezpłatna prezentacja. Mówicie, na czym pracujecie i co Was korkuje. Mówimy wprost, czy da się to spiąć, a jeśli nie ma czego automatyzować, też to powiemy.
  2. Do 2 tygodni testów. Dostęp do portalu tego samego dnia, podłączenie w trybie odczytu, sprawdzacie na własnych danych.
  3. Rozszerzanie. Kolejne moduły i akcje dokładamy, gdy zespół ufa temu, co dostaje. W abonamencie jest wdrożenie, integracja, szkolenie i opieka.
Wybierzcie termin → Wolicie napisać?
Wolicie napisać

Pokażemy to na Waszych danych z GitHub / GitLab

Jedno zdanie wystarczy: czego szukacie w GitHub / GitLab albo co ma się dziać samo. Odpiszemy, co podłączymy i od czego zacząć.

GitHub / GitLab jest znakiem towarowym swojego właściciela. Nie jesteśmy z nim powiązani ani przez niego autoryzowani. Nazwy używamy wyłącznie po to, żeby wskazać, z jakim programem integrujemy asystenta.