KonfiguracjaIntegracje

Jira

Połącz swoich agentów ElevenLabs z Jira Cloud

Omówienie

Połącz swoich agentów AI ElevenLabs z Jira Cloud, by zarządzać zgłoszeniami, śledzić projekty i automatyzować workflow wsparcia. Ta integracja pozwala agentom tworzyć i aktualizować zgłoszenia, zmieniać ich statusy w workflow, łączyć powiązane tickety w ramach eskalacji oraz przeszukiwać projekty.

Możliwości

MożliwośćObsługa
Tryb zerowej retencji (ZRM)Nieobsługiwany
Załączniki w narzędziachNieobsługiwane — narzędzia działają tylko na tekście

Konfiguracja

Ta integracja używa tokenu API Jira z uwierzytelnianiem Basic. Potrzebujesz adresu e-mail konta Atlassian, tokenu API i subdomeny Jira Cloud.

1

Wygeneruj token API

Przejdź do zarządzania tokenami API Atlassian i kliknij Create API token. Skopiuj token — nie będzie można go później ponownie wyświetlić.

2

Znajdź subdomenę Jira

Twoja subdomena to pierwsza część adresu URL Jira Cloud. Na przykład jeśli Jira jest pod adresem mycompany.atlassian.net, twoja subdomena to mycompany.

3

Połącz w ElevenLabs

W konfiguracji integracji ElevenLabs wpisz:

  • E-mail — adres e-mail konta Atlassian
  • Token API — token wygenerowany w kroku 1
  • Subdomena Jira — subdomena z kroku 2

Tokeny API domyślnie wygasają po roku. Jeśli agent przestanie mieć dostęp do Jira, wygeneruj nowy token i zaktualizuj połączenie.

Identyfikowanie rozmówców

Narzędzie jira_search_issues wymaga parametru labels, aby ograniczyć wyszukiwanie do ticketów konkretnego użytkownika. Zakłada to, że workflow Jira przypisuje do każdego zgłoszenia etykietę identyfikującą rozmówcę — na przykład zamienia adres e-mail jane.smith@example.com w etykietę jane-smith-at-example-com.

Aby to zautomatyzować, skonfiguruj pole labels jako zmienną dynamiczną, która otrzymuje identyfikator rozmówcy z twojej aplikacji. Dzięki temu agent nie musi pytać rozmówcy o e-mail przy każdym połączeniu.

Etykiety Jira nie mogą zawierać spacji. Często zastępuje się @ przez -at-, a . przez - (np. jane-smith-at-example-com). Narzędzie jira_search_issues dopasowuje etykietę dokładnie, więc podana wartość musi być zgodna z etykietą w zgłoszeniu.

Jak to działa

1

Identyfikacja rozmówcy

Agent identyfikuje rozmówcę na podstawie adresu e-mail lub innego identyfikatora skonfigurowanego w polu labels.

2

Zbieranie szczegółów

Agent zbiera od rozmówcy informacje o problemie — co się stało, jak poważny jest problem i wszelki istotny kontekst.

3

Tworzenie zgłoszenia

Agent tworzy zgłoszenie Jira w odpowiednim projekcie, z właściwym typem zgłoszenia, priorytetem i opisem.

4

Potwierdzenie dla rozmówcy

Agent odczytuje numer utworzonego ticketu, aby rozmówca miał go na potrzeby dalszego kontaktu.

Przykładowy prompt systemowy

# Personality
You are a helpful IT support agent responsible for managing support tickets in Jira. Be friendly, professional, and efficient.
# Environment
You operate in a support setting via voice or chat, where you help users report issues, check ticket status, and manage existing requests.
# Tone
Begin by asking how you can help. If the caller has an existing issue, ask whether they have the ticket number. If they are reporting a new issue, collect details about the problem.
Ask one question at a time and wait for the response before proceeding.
# Goal
For new issues:
- Collect a clear description of the problem
- Determine severity and urgency
- Create the ticket in the appropriate project with the right issue type and priority
- Read back the ticket number
For existing issues:
- If the caller provides a ticket number, look it up by key
- If the caller wants to check on their issues, search using the labels field
- Provide status updates
- Add comments or update priority when requested
- Always confirm before making changes
# Guardrails
- Do not discuss topics outside of IT support.
- Never expose raw Jira API responses, internal IDs, or technical field names to the caller.
- Always confirm with the caller before creating, updating, or transitioning issues.

Dostępne narzędzia

NarzędzieOpis
jira_create_issueTworzy zgłoszenie z projektem, podsumowaniem, typem zgłoszenia i opcjonalnymi polami, takimi jak priorytet.
jira_get_issuePobiera szczegóły konkretnego zgłoszenia na podstawie klucza.
jira_search_issuesWyszukuje zgłoszenia według etykiety, projektu, statusu, priorytetu, typu, osoby przypisanej, tekstu lub zakresu dat.
jira_update_issueAktualizuje pola istniejącego zgłoszenia — priorytet, osobę przypisaną, etykiety lub opis.
jira_add_commentDodaje do zgłoszenia komentarz w zwykłym tekście.
jira_get_transitionsWyświetla dostępne przejścia workflow dla zgłoszenia.
jira_transition_issuePrzenosi zgłoszenie do nowego statusu workflow, używając identyfikatora przejścia z jira_get_transitions.
jira_link_issuesŁączy ze sobą dwa zgłoszenia (np. “Blocks”, “Duplicate”, “Relates”).
jira_list_projectsWyświetla dostępne projekty i ich klucze.
jira_get_issue_typesWyświetla dostępne typy zgłoszeń (np. Bug, Task, Story).
jira_get_prioritiesWyświetla dostępne poziomy priorytetu.

Opisy zgłoszeń i komentarze obsługują tylko zwykły tekst. Integracja automatycznie konwertuje je do formatu Atlassian Document Format (ADF) Jira. Markdown i HTML nie są obsługiwane.

Przydatne linki