Integracja JIRA
Połącz swojego asystenta AI SmartTalk z Atlassian JIRA, aby umożliwić inteligentne zarządzanie projektami i śledzenie problemów. Ta integracja pozwala Twojemu asystentowi AI na wyszukiwanie, tworzenie, aktualizowanie problemów, rejestrowanie czasu oraz zarządzanie sprintami bezpośrednio za pomocą interakcji w naturalnym języku.
Przegląd
Integracja JIRA umożliwia Twojemu asystentowi AI:
- Wyszukiwanie problemów: Znajdowanie problemów za pomocą zapytań w naturalnym języku
- Wyświetlanie szczegółów problemów: Uzyskiwanie szczegółowych informacji o konkretnych problemach
- Tworzenie problemów: Automatyczne generowanie nowych zgłoszeń, zadań lub błędów
- Aktualizowanie problemów: Modyfikowanie statusu problemu, priorytetu, przypisanego użytkownika i innych pól
- Śledzenie czasu: Rejestrowanie czasu pracy z szczegółowymi komentarzami i opisami
- Zarządzanie sprintami: Wyświetlanie tablic, sprintów i zarządzanie planowaniem sprintów
- Zarządzanie projektami: Uzyskiwanie dostępu do informacji o projektach i danych dotyczących współpracy zespołowej
Wymagania wstępne
Zanim rozpoczniesz, upewnij się, że masz:
- Aktywne konto AI SmartTalk z dostępem do konfiguracji asystenta
- Instancję JIRA Cloud lub Server z uprawnieniami administratora
- Włączony dostęp do API w swojej instancji JIRA
- Dane logowania do konta użytkownika z odpowiednimi uprawnieniami do projektów
Krok po Kroku: Konfiguracja
Krok 1: Uzyskaj dostęp do integracji JIRA
- Zaloguj się na swoje konto AI SmartTalk
- Przejdź do Administracja → Moi Asystenci → [Nazwa Twojego Asystenta]
- Kliknij na Konektory w lewym pasku bocznym
- Znajdź JIRA na liście dostępnych konektorów
- Kliknij na kafelek integracji JIRA
Krok 2: Skonfiguruj połączenie JIRA
- URL JIRA: Wprowadź URL swojej instancji JIRA (np.
https://yourcompany.atlassian.net) - Nazwa użytkownika/E-mail: Podaj adres e-mail swojego konta JIRA
- Token API: Wygeneruj i wprowadź swój token API JIRA
- Przejdź do ustawień swojego konta Atlassian
- Przejdź do Bezpieczeństwo → Tworzenie i zarządzanie tokenami API
- Wygeneruj nowy token dla integracji AI SmartTalk
- Kliknij Skonfiguruj, aby nawiązać połączenie
Krok 3: Włącz możliwości AI
Skonfiguruj możliwości AI, które chcesz włączyć:
Zarządzanie problemami (4/4)
- ✅ JIRA_SEARCH_ISSUES: Wyszukuj i filtruj problemy za pomocą języka naturalnego
- ✅ JIRA_GET_ISSUE: Pobierz szczegółowe informacje o konkretnych problemach
- ✅ JIRA_CREATE_ISSUE: Twórz nowe problemy, zadania i błędy
- ✅ JIRA_UPDATE_ISSUE: Modyfikuj istniejące problemy i ich właściwości
Śledzenie czasu (1/1)
- ✅ JIRA_LOG_TIME: Rejestruj czas pracy z komentarzami i opisami
Zarządzanie sprintami (2/2)
- ✅ JIRA_LIST_BOARDS_AND_SPRINTS: Wyświetl dostępne tablice i aktywne sprinty
- ✅ JIRA_CREATE_SPRINT: Twórz nowe sprinty i zarządzaj planowaniem sprintów
Krok 4: Synchronizacja projektów
- Kliknij Synchronizuj projekty, aby pobrać swoje projekty JIRA
- Wybierz projekty, do których Twój asystent AI ma mieć dostęp
- Skonfiguruj specyficzne dla projektu uprawnienia i poziomy dostępu
- Poczekaj na zakończenie początkowej synchronizacji
Możliwości Asystenta AI
Wyszukiwanie i zarządzanie problemami
Twój asystent AI może obsługiwać zapytania w naturalnym języku, takie jak:
Przykłady wyszukiwania:
- "Znajdź wszystkie problemy związane z ciasteczkami"
- "Pokaż mi błędy o wysokim priorytecie przypisane do Johna"
- "Wypisz wszystkie zadania w bieżącym sprincie"
- "Jakie są otwarte problemy w projekcie CCS?"
Szczegóły problemu:
User: "Powiedz mi o problemie CCS-11"
AI: Oto szczegóły dotyczące CCS-11:
- Tytuł: Przygotuj ciasteczka czekoladowe z szczegółową zawartością
- Status: Do zrobienia
- Priorytet: Niski
- Osoba przypisana: Nieprzypisany
- Opis: [Pełny opis problemu]
Tworzenie problemów
Twórz problemy za pomocą poleceń konwersacyjnych:
Przykłady tworzenia:
- "Utwórz raport błędu dotyczący problemu z logowaniem"
- "Dodaj zadanie do wdrożenia uwierzytelniania użytkowników"
- "Utwórz historię dla nowej funkcji pulpitu nawigacyjnego"
Rejestrowanie czasu
Rejestruj czas pracy w naturalnym języku:
Przykłady śledzenia czasu:
User: "@PO Bot Potwierdzam, że ciasteczka są w piekarniku dla CCS-11, i rejestruję 2 godziny przy termostacie 200"
AI Response:
✅ Czas został pomyślnie zarejestrowany dla CCS-11:
- Czas spędzony: 2 godziny
- Komentarz: Ciasteczka w piekarniku przy 200°C
- Data rozpoczęcia: 14 listopada 2025, 12:00
Zarządzanie sprintami
Zarządzaj sprintami i tablicami w spos ób konwersacyjny:
Przykłady sprintów:
- "Co jest w naszym bieżącym sprincie?"
- "Utwórz nowy sprint na przyszły tydzień"
- "Pokaż mi wszystkie dostępne tablice"
- "Przenieś CCS-11 do aktywnego sprintu"
Obsługiwane funkcje JIRA
Typy problemów
| Typ | Obsługiwany | Możliwości AI |
|---|---|---|
| Epic | ✅ | Tworzenie, aktualizacja, łączenie problemów podrzędnych |
| Historia | ✅ | Pełne operacje CRUD, szacowanie punktów historii |
| Zadanie | ✅ | Pełne zarządzanie i śledzenie zadań |
| Błąd | ✅ | Zgłaszanie błędów, przypisywanie powagi, śledzenie rozwiązań |
| Podzadanie | ✅ | Tworzenie podzadań i łączenie z problemem nadrzędnym |
Pola i właściwości
| Pole | Odczyt | Zapis | Zrozumienie AI |
|---|---|---|---|
| Podsumowanie | ✅ | ✅ | Przetwarzanie języka naturalnego |
| Opis | ✅ | ✅ | Wsparcie dla formatowania i tekstu bogatego |
| Status | ✅ | ✅ | Zarządzanie stanem przepływu pracy |
| Priorytet | ✅ | ✅ | Inteligentne przypisywanie priorytetów |
| Osoba przypisana | ✅ | ✅ | Rozpoznawanie członków zespołu |
| Zgłaszający | ✅ | ✅ | Automatyczne mapowanie użytkowników |
| Etykiety | ✅ | ✅ | Inteligentne sugestie etykiet |
| Komponenty | ✅ | ✅ | Organizacja oparta na komponentach |
| Wersja naprawy | ✅ | ✅ | Integracja planowania wydania |
Rozwiązywanie problemów
Powszechne problemy
Problemy z połączeniem
- Nieudana autoryzacja:
- Sprawdź format URL JIRA (włącz https://)
- Sprawdź ważność tokena API
- Upewnij się, że konto ma odpowiednie uprawnienia
- Przekroczenie limitu czasu sieci:
- Sprawdź dostępność instancji JIRA
- Sprawdź ustawienia zapory
- Przetestuj połączenie z serwerów AI SmartTalk
Błędy uprawnień
- Niewystarczające uprawnienia:
- Przejrzyj uprawnienia projektu JIRA dla swojego konta
- Sprawdź uprawnienia do przeglądania projektu i tworzenia zgłoszeń
- Upewnij się, że masz dostęp administratora do konfiguracji projektu
- Odmowa dostępu do projektu:
- Upewnij się, że użytkownik jest dodany do docelowych projektów
- Sprawdź ustawienia widoczności projektu
- Zweryfikuj pisownię klucza projektu
Problemy z synchronizacją
- Projekty się nie ładują:
- Odśwież synchronizację projektu
- Sprawdź wydajność instancji JIRA
- Zweryfikuj limity szybkości API
- Aktualizacje zgłoszeń nie powiodły się:
- Sprawdź uprawnienia do przepływu pracy zgłoszeń
- Zweryfikuj wymagania dotyczące pól i zasady walidacji
- Upewnij się, że zgłoszenie jest w stanie edytowalnym
Optymalizacja wydajności
Limity szybkości API
- Monitorowanie użycia: Śledź wywołania API i limity szybkości
- Operacje wsadowe: Grupuj wiele operacji, gdy to możliwe
- Strategia buforowania: Wdroż inteligentne buforowanie dla często używanych danych
Obsługa dużych instancji
- Filtrowanie projektów: Synchronizuj tylko istotne projekty
- Stronicowanie zgłoszeń: Efektywnie obsługuj duże zestawy wyników
- Selektywna synchronizacja: Wybierz konkretne typy zgłoszeń i statusy
Najlepsze praktyki
Organizacja projektu
- Jasne nazewnictwo: Używaj opisowych nazw projektów i zgłoszeń
- Spójne etykietowanie: Utrzymuj spójną taksonomię etykiet
- Regularne porządki: Archiwizuj zakończone projekty i zgłoszenia
Przykłady użycia
Automatyzacja codziennego spotkania
Członek zespołu: "Pokaż mi, nad czym pracowałem wczoraj i co jest zaplanowane na dzisiaj"
AI: "Wczoraj ukończyłeś CCS-9 (2 godziny zarejestrowane) i CCS-10 (1.5 godziny).
Dziś masz przypisane CCS-11 i CCS-12 w bieżącym sprincie."
Planowanie sprintu
Scrum Master: "Utwórz nowy sprint, który zaczyna się w poniedziałek na 2 tygodnie"
AI: "✅ Utworzono nowy sprint 'Sprint 24', który zaczyna się 18 listopada 2025 na 2 tygodnie.
Gotowy do dodania zgłoszeń z backlogu."
Zgłaszanie błędów
Tester QA: "Utwórz błąd: Formularz logowania nie waliduje poprawnie formatu e-mail, wysoki priorytet"
AI: "✅ Utworzono błąd CCS-15: 'Problem z walidacją e-mail w formularzu logowania'
- Priorytet: Wysoki
- Przypisany do: Zespół deweloperski
- Dodany do bieżącego sprintu do pilnej uwagi"
Śledzenie postępów
Właściciel produktu: "Jak nam idzie w projekcie przygotowania ciasteczek?"
AI: "Status projektu ciasteczek (CCS):
- 5 zgłoszeń ukończonych (CCS-1 do CCS-5)
- 3 w toku (CCS-7, CCS-9, CCS-11)
- 2 do zrobienia (CCS-12, CCS-13)
- Zakończenie sprintu: 67% na dobrej drodze"