Integracje / Linear

Komunikacja, projekty i biuro

Integracja AI: Linear

Podłączamy GraphQL API Linear i czytamy zgłoszenia (Issues), cykle (Cycles), projekty z kamieniami milowymi i powiązania z pull requestami. Asystent codziennie przegląda bieżący sprint, wyłapuje zablokowane i przeterminowane zgłoszenia oraz zakłada nowe Issues z maili klientów.

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

Rozmowa z asystentem AI w portalu redAi o danych z programu firmowego
Tak wygląda praca w portalu. Przykład na danych przykładowych.

W skrócie

Jak asystent AI łączy się z systemem Linear?

Łączymy się przez GraphQL API Linear. Jedno zapytanie zwraca naraz Issues z bieżącego cyklu ze wszystkimi polami, bez kilku wywołań po kolei.

Na start potrzebujemy
Konto Linear z dostępem do workspace'u (plan Free wystarczy do odczytu przez API)
Czego asystent nie robi
Nie zmienia statusów, priorytetów ani przypisań w Linear bez potwierdzenia przez człowieka.
Gdzie są dane
Na Waszym serwerze. Zaczynamy od odczytu, zapis włączacie sami.

Co podłączamy

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

Issues bieżącego cyklu

CzytamyStatus, priorytet, due date, etykiety, relacje (blocked by, blocks), assignee i estimate każdego zgłoszenia w cyklu

AsystentWyłapuje zgłoszenia z przeterminowaną due date, zablokowane relacją lub etykietą blocked i informuje o brakujących estimate przed standupem.

Cycles: postęp sprintu

CzytamyLiczba Issues w cyklu, liczba Done i otwartych, zgłoszenia bez przypisanego cyklu w workspace'ie

AsystentLiczy stosunek Done do wszystkich Issues i informuje, ile zostało do zamknięcia przed końcem sprintu.

Projects i Milestones

CzytamyStatus projektu, daty kamieni milowych, Issues w projekcie nieprzypisane do żadnego cyklu

AsystentSprawdza, które Milestones mają otwarte Issues po terminie, i podaje liczbę zgłoszeń czekających poza cyklem na roadmapie.

Triage nieprzypisanych zgłoszeń

CzytamyZgłoszenia bez przypisanego cyklu z priorytetem Urgent lub High, bez assignee

AsystentWyciąga listę pilnych zgłoszeń pominiętych przy planowaniu sprintu i proponuje ich przejrzenie przed następnym cyklem.

GitHub, stan PR

CzytamyStan pull requestów (open, merged, closed) powiązanych z Issues przez integrację GitHub w Linear

AsystentWykrywa Issues w statusie In Review z PR-em bez aktywności od kilku dni i powiadamia przypisaną osobę, zanim opóźnienie wyjdzie na planowaniu.

Etykieta customer-bug

CzytamyIssues oznaczone etykietą customer-bug, posortowane według priorytetu: Urgent, High, Medium, Low

AsystentZestawia otwarte błędy klientów według priorytetu przed planowaniem cyklu, żeby zespół widział skalę zaległych zgłoszeń przed wciąganiem nowych funkcji.

Komentarze i Identifier

CzytamyHistoria komentarzy do zgłoszenia, unikalny Identifier (np. ENG-42), data ostatniej aktywności

AsystentDopisuje komentarz z treścią maila klienta do istniejącego Issue przy wykrytym duplikacie i łączy oba relacją duplicate of.

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 utknęło w bieżącym sprincie i kto jest zablokowany?”
  • „Ile zgłoszeń mamy zamkniętych z tego cyklu, a ile zostało?”
  • „Jakie błędy klientów są teraz otwarte i które są najpilniejsze?”
  • „Które milestones w projektach są po terminie?”

Co się zmienia

Poranny przegląd sprintu zajmuje kilka minut zamiast pół godziny, a błędy od klientów trafiają do Linear automatycznie z wykrytymi duplikatami.

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

Linear to narzędzie do zarządzania pracą zespołów produktowych i inżynierskich. Workspace skupia Issues, cykle (Cycles), projekty z kamieniami milowymi i roadmapę produktu. Używają go głównie firmy technologiczne, software house'y i zespoły SaaS, które prowadzą regularne sprinty i śledzą błędy zgłaszane przez klientów.

W codziennej pracy każde zgłoszenie ma kilkanaście pól: status, priorytet, datę graniczną, etykiety, przypisaną osobę, powiązania z innymi Issues i historię komentarzy. Projekty i Milestones dają widok na terminy poza sprintami. Dane trzymane są w chmurze Linear i dostępne przez GraphQL API.

Gdzie to działa najlepiej

Kierownik produktu

Przed porannym standupem menedżer nie otwiera Linear. Asystent wysłał już raport: ile Issues Done w cyklu, które są zablokowane i przez co, które mają przeterminowaną due date i kto je ma.

Z asystentem: Standup trwa krócej, bo odpowiedzi na typowe pytania są gotowe. Blokady i opóźnienia wychodzą na jaw od razu, nie po kilkunastu minutach przeszukiwania tablicy.

Specjalista wsparcia

Po wydaniu nowej wersji aplikacji w ciągu doby przychodzi kilkanaście maili z tym samym błędem przy eksporcie. Bez integracji ktoś zakłada kilkanaście osobnych Issues albo po prostu część ignoruje.

Z asystentem: Asystent zakłada jedno Issue przy pierwszym mailu, do kolejnych dopisuje komentarze i łączy relacją duplicate of. Programista widzi od razu, że problem dotyczy wielu klientów.

Programista

Issue ma status In Review, podpięty pull request stoi od tygodnia bez aktywności i nikt nie zrobił code review. Każdy patrzy tylko na własne zadania i nikt nie pilnuje cudzych PR-ów.

Z asystentem: Asystent wyłapuje PR bez ruchu i dodaje komentarz do Issue lub powiadamia przypisaną osobę. Problem wychodzi przed zakończeniem cyklu, nie po jego zamknięciu.

Jak się łączymy

Łączymy się przez GraphQL API Linear. Jedno zapytanie zwraca naraz Issues z bieżącego cyklu ze wszystkimi polami, bez kilku wywołań po kolei. Do raportów wystarczy zakres read. Do zakładania Issues i pisania komentarzy z maili klientów potrzebny jest zakres write.

Uwierzytelnienie odbywa się przez Personal API key (Settings > API w Linear) lub OAuth 2.0, gdy każda osoba loguje się własnym kontem. Asystent działa na serwerze klienta. Do modelu AI trafia polecenie i fragment danych potrzebny do odpowiedzi, bez trenowania cudzych modeli na danych firmy. Linear obsługuje też webhooks do reagowania na zdarzenia w czasie rzeczywistym.

Czego potrzebujemy od Was

  • Konto Linear z dostępem do workspace'u (plan Free wystarczy do odczytu przez API)
  • Personal API key z Settings > API > Personal API keys lub aplikacja OAuth 2.0
  • Zakres write w kluczu API, gdy asystent ma zakładać Issues i pisać komentarze
  • Osoba z firmy znająca etykiety, statusy i strukturę cykli w Waszym workspace'ie
  • Połączone repozytorium GitHub w Linear, jeśli chcecie dane o pull requestach przy Issues

Czego asystent nie robi

  • Nie zmienia statusów, priorytetów ani przypisań w Linear bez potwierdzenia przez człowieka.
  • Nie czyta zawartości załączników binarnych dołączonych do Issues, widzi tylko ich linki.
  • Nie zastępuje planowania sprintu: wskazuje blokady i dane, decyzję o wciągnięciu Issues podejmuje zespół.
  • Nie ma dostępu do pełnych logów audytu Linear, jeśli API ich nie udostępnia w danym zakresie uprawnień.

Częste pytania

Czy asystent widzi Issues z prywatnych projektów w naszym workspace'ie?

Asystent widzi dokładnie to, co konto, do którego przypisany jest klucz API. Jeśli konto nie ma dostępu do konkretnego projektu lub zespołu w Linear, API też go nie zwróci. Zakres widoczności ustawiacie w Linear, nie w konfiguracji asystenta.

Co jeśli nasz workspace ma tysiące Issues i duże obciążenie API?

GraphQL API Linear ma rate limiting, który przy dużych workspace'ach trzeba uwzględnić. Budujemy zapytania tak, żeby pobierać tylko pola potrzebne do analizy, bez nadmiarowych danych. Zakres zapytań i częstotliwość omawiamy przed uruchomieniem.

Czy możemy zatwierdzać każde zgłoszenie przed zapisem do Linear?

Tak. Asystent może działać w trybie propozycji: przygotowuje Issues z tytułem, opisem i etykietami, a zapis przez API następuje dopiero po Waszym zatwierdzeniu. To przydatne na początku, gdy sprawdzacie, czy etykiety i priorytety są trafione.

Jak często asystent odpytuje Linear: na harmonogramie czy przez webhooks?

Raport poranny działa na harmonogramie, polling raz dziennie ze świeżymi danymi. Webhooks służą do reagowania w czasie rzeczywistym, np. gdy mail klienta ma trafić do Linear w ciągu minut, nie przy kolejnym porannym przeglądzie. Oba tryby można łączyć.

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 Linear

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

Linear 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.