Adopcja AI

Sekcja Konfiguracji odpowiadająca za dane o wykorzystaniu narzędzi AI: wzorce rozpoznawania commitów, przełącznik widoczności i mapowanie kont z telemetrii. Same wykresy i sposób ich czytania opisuje Adopcja AI w dziale funkcji.

Celem modułu jest zastąpienie deklaracji i liczby wykupionych licencji danymi mierzalnymi: ile pracy powstało z udziałem AI, ile osób faktycznie z niej korzysta, ile to kosztuje i czy zmiany wprowadzone z pomocą AI zostają w kodzie.

Dwa źródła danych, dwa różne wymagania

Od wyboru źródła zależy, ile pracy wymaga wdrożenie.

Źródło	Co daje	Co wymaga
Rozpoznawanie commitów	podział Kalorii i commitów na powstałe z udziałem AI i bez	nic, działa na danych już zbieranych przez Q247
Telemetria narzędzi AI	czas pracy, liczba tokenów, koszt, liczba wygenerowanych linii	eksport telemetrii w narzędziu AI oraz Enterprise Plugin

Pierwsze źródło polega na rozpoznawaniu w wiadomościach commitów adnotacji wskazujących na udział narzędzia AI, na przykład Co-Authored-By: Claude. Nie wymaga żadnej integracji ani zmian w repozytoriach. Jeśli zależy Ci tylko na proporcji pracy z AI, wystarczy włączyć widoczność i na tym poprzestać.

Drugie źródło to telemetria w standardzie OpenTelemetry, raportowana przez narzędzie AI. Ona odpowiada za koszty i zużycie tokenów, a jej wdrożenie, warianty i wymagania wstępne opisują Logi narzędzi AI w Integracjach.

Oba źródła łączone są na poziomie użytkownika, po adresie e-mail. Dlatego mapowanie kont jest osobnym krokiem wdrożenia i bez niego telemetria nie ma do kogo się przypisać.

Wiadomości commitów jako źródło danych

To źródło działa na danych, które Q247 zbiera i tak, więc decyduje o nim wyłącznie treść wiadomości commita.

Dopasowanie wzorca

Q247 przeszukuje wiadomość commita (jej tytuł i treść, wraz ze stopką) w poszukiwaniu tekstu z listy wzorców. Zasady dopasowania:

• Fragment tekstu: wzorzec pasuje, gdy występuje w wiadomości w dowolnym miejscu. Nie musi zaczynać ani kończyć linii.
• Bez rozróżniania wielkości liter: Co-Authored-By: Claude i co-authored-by: claude dopasowują się tak samo.
• Pierwsze trafienie decyduje: wzorce sprawdzane są w kolejności z listy, a commit dostaje etykietę narzędzia z pierwszego dopasowanego wzorca. Commit oznaczony przez dwa narzędzia naraz zostanie więc przypisany do jednego z nich.
• Dowolny tekst po wzorcu nie przeszkadza: wzorzec Co-authored-by: Copilot dopasuje również linię Co-Authored-By: Copilot GPT 4.5, więc dopisywanie nazwy i wersji modelu nie psuje rozpoznawania.

Wzorzec może być również wyrażeniem regularnym, jeśli sam fragment tekstu nie wystarcza.

Adnotacje rozpoznawane domyślnie

Narzędzie	Wzorzec
Claude Code	Co-Authored-By: Claude
Claude Code	Generated with Claude Code
GitHub Copilot	Co-authored-by: Copilot
Cursor	Co-authored-by: Cursor Agent
Aider	Co-authored-by: aider
Devin	Co-authored-by: Devin AI
OpenAI Codex	Co-authored-by: Codex

Większość z nich to standardowe trailery Gita, czyli linie w stopce wiadomości commita, dopisywane przez narzędzie automatycznie.

Wymuszenie trailera w instrukcjach dla narzędzia AI

Narzędzia AI dopisują trailer nie zawsze i nie wszystkie. Commit bez adnotacji jest dla Q247 zwykłym commitem człowieka, więc każdy taki przypadek zaniża udział pracy z AI. Najpewniejszym rozwiązaniem jest wpisanie tego wymogu do głównego promptu (pliku z instrukcjami dla narzędzia, na przykład CLAUDE.md albo copilot-instructions.md), tak żeby obowiązywał w każdym repozytorium:

## Git workflow
Every commit message MUST end with a blank line followed by the `Co-Authored-By` trailer. Append the model type and version after `Copilot` (e.g. `GPT 4.5`):

Co-Authored-By: Copilot GPT 4.5

No exceptions. This applies to version bumps, hotfixes, and one-line commits.

Dopisanie nazwy i wersji modelu za nazwą narzędzia jest przy tym korzystne: wzorzec nadal się dopasowuje, a w samej historii repozytorium zostaje informacja, który model wykonał zmianę.

Rozpoznawanie działa wstecz

Wzorce stosowane są również do commitów już zebranych, więc podział na pracę z AI i bez pojawia się od razu po włączeniu funkcji, bez czekania na nowe commity. Dopisanie wzorca później przelicza historię ponownie.

Ustawienia w Q247

Przełącznik widoczności

Przełącznik "Pokaż adopcję AI" steruje widocznością widżetu na dashboardach. Zbieranie danych działa niezależnie od niego: przy wyłączonym przełączniku dane nadal spływają i są przetwarzane, a widżet pozostaje ukryty. Włączenie go później pokazuje więc również historię.

Tabela wzorców

Tabela wzorców to edytowalna lista adnotacji opisanych wyżej. Kolumny to narzędzie, wzorzec tekstowy i przełącznik aktywności, a wpisy domyślne można wyłączyć albo zmienić.

Listę warto rozszerzyć, jeśli zespół korzysta z narzędzia poza domyślną siódemką wzorców albo stosuje własną konwencję oznaczania. Nie wymaga to żadnych zmian po stronie repozytoriów.

Ograniczenie	Wartość
Maksymalna liczba wzorców	100
Kolejność	ma znaczenie, wygrywa pierwsze dopasowanie

Mapowanie kont z telemetrii

Narzędzie AI identyfikuje użytkownika po adresie e-mail skonfigurowanym lokalnie, na jego komputerze. Ten adres nie zawsze jest tym samym, który konto danej osoby ma w Q247, a bez dopasowania telemetria nie ma do kogo się przypisać.

Zgodne adresy dopasowują się automatycznie i nie wymagają żadnej czynności. Sekcja "Nieprzypisani użytkownicy narzędzi AI" pokazuje przypadki wymagające uwagi, w dwóch kategoriach:

Kategoria	Co oznacza	Co zrobić
Adres niedopasowany	telemetria przyszła, ale nie udało się jej powiązać z żadnym kontem Q247	wskazać powiązanie ręcznie
Adres bez danych	powiązanie istnieje, ale z tego adresu nie odnotowano telemetrii	sprawdzić, czy adres nie zawiera błędu

Skrót "Przejdź do Users and Teams" prowadzi wprost do mapowania kont, opisanego w Użytkownikach i Zespołach.

Odczekaj dzień lub dwa, zanim zaczniesz mapować

Zaraz po uruchomieniu lista niedopasowanych adresów jest niepełna, bo telemetria dopiero zaczyna spływać. Przegląd po jednym lub dwóch dniach roboczych oszczędza powtarzania tej samej pracy.

Weryfikacja

1. Wzorce commitów: podział na pracę z AI i bez powinien pojawić się od razu, bo działa na danych historycznych.
2. Telemetria: terminy pierwszych danych zależą od wariantu i opisują je Logi narzędzi AI.
3. Lista niedopasowanych adresów: przejrzeć po jednym lub dwóch dniach roboczych i uzupełnić powiązania.
4. Adresy bez danych: obecność wpisu w tej kategorii po kilku dniach wskazuje na błąd w adresie, a nie na brak aktywności.

Zobacz też

• Logi narzędzi AI: wdrożenie telemetrii, warianty i wymagania wstępne
• Adopcja AI: widżet i interpretacja danych
• Użytkownicy i Zespoły: mapowanie adresów z telemetrii na konta
• Model językowy: integracja obsługująca Asystenta AI
• Wykluczanie commitów: co nie wchodzi do wyliczeń