> This is a page from the ElevenLabs documentation. For a complete page index, fetch https://elevenlabs.io/docs/llms.txt. For the full documentation in a single file, fetch https://elevenlabs.io/docs/llms-full.txt.

# Jira

## 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ędziach    | Nieobsł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.

#### Wygeneruj token API

Przejdź do [zarządzania tokenami API Atlassian](https://id.atlassian.com/manage-profile/security/api-tokens) i kliknij **Create API token**. Skopiuj token — nie będzie można go później ponownie wyświetlić.

#### 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`.

#### 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

> **Note**
>
> 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ą](/docs/pl/eleven-agents/customization/personalization/dynamic-variables), 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.

> **Note**
>
> 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

#### Tworzenie ticketu wsparcia

#### Identyfikacja rozmówcy

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

#### Zbieranie szczegółów

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

#### Tworzenie zgłoszenia

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

#### Potwierdzenie dla rozmówcy

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

#### Rozwiązywanie zgłoszeń w service desku

#### Wyszukanie ticketu

Agent pobiera zgłoszenie Jira na podstawie klucza (np. PROJ-123) i odczytuje jego bieżący
status, priorytet oraz podsumowanie.

#### Dodawanie notatek o rozwiązaniu

Agent dodaje do zgłoszenia komentarz ze szczegółami rozmowy, takimi jak podjęte kroki
lub zebrane informacje.

#### Zamknięcie ticketu

Agent zmienia status zgłoszenia na rozwiązane lub zamknięte, używając dostępnych przejść
workflow.

## Przykładowy prompt systemowy

#### Zobacz przykładowy prompt systemowy

```text
# 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ędzie               | Opis                                                                                                                  |
| ----------------------- | --------------------------------------------------------------------------------------------------------------------- |
| `jira_create_issue`     | Tworzy zgłoszenie z projektem, podsumowaniem, typem zgłoszenia i opcjonalnymi polami, takimi jak priorytet.           |
| `jira_get_issue`        | Pobiera szczegóły konkretnego zgłoszenia na podstawie klucza.                                                         |
| `jira_search_issues`    | Wyszukuje zgłoszenia według etykiety, projektu, statusu, priorytetu, typu, osoby przypisanej, tekstu lub zakresu dat. |
| `jira_update_issue`     | Aktualizuje pola istniejącego zgłoszenia — priorytet, osobę przypisaną, etykiety lub opis.                            |
| `jira_add_comment`      | Dodaje do zgłoszenia komentarz w zwykłym tekście.                                                                     |
| `jira_get_transitions`  | Wyświetla dostępne przejścia workflow dla zgłoszenia.                                                                 |
| `jira_transition_issue` | Przenosi 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_projects`    | Wyświetla dostępne projekty i ich klucze.                                                                             |
| `jira_get_issue_types`  | Wyświetla dostępne typy zgłoszeń (np. Bug, Task, Story).                                                              |
| `jira_get_priorities`   | Wyświetla dostępne poziomy priorytetu.                                                                                |

> **Note**
>
> 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

* [Dokumentacja Jira Cloud REST API](https://developer.atlassian.com/cloud/jira/platform/rest/v3/)
* [Zarządzanie tokenami API](https://support.atlassian.com/atlassian-account/docs/manage-api-tokens-for-your-atlassian-account/)