> 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

## Überblick

Verbinden Sie Ihre ElevenLabs-KI-Agenten mit Jira Cloud, um Vorgänge zu verwalten, Projekte nachzuverfolgen und Support-Workflows zu automatisieren. Diese Integration ermöglicht Ihren Agenten, Vorgänge zu erstellen und zu aktualisieren, Vorgänge durch Workflows zu führen, verwandte Tickets zur Eskalation zu verknüpfen und Projekte zu durchsuchen.

## Funktionen

| Funktion                  | Unterstützung                                  |
| ------------------------- | ---------------------------------------------- |
| Zero Retention Mode (ZRM) | Nicht unterstützt                              |
| Anhänge in Tools          | Nicht unterstützt – Tools verarbeiten nur Text |

## Einrichtung

Diese Integration verwendet ein **Jira API-Token** mit Basic-Authentifizierung. Sie benötigen die E-Mail-Adresse Ihres Atlassian-Kontos, ein API-Token und Ihre Jira-Cloud-Subdomain.

#### API-Token erstellen

Gehen Sie zur [Atlassian API-Tokenverwaltung](https://id.atlassian.com/manage-profile/security/api-tokens) und klicken Sie auf **Create API token**. Kopieren Sie das Token – Sie können es später nicht erneut anzeigen.

#### Ihre Jira-Subdomain finden

Ihre Subdomain ist der erste Teil Ihrer Jira-Cloud-URL. Wenn Ihr Jira beispielsweise unter `mycompany.atlassian.net` erreichbar ist, lautet Ihre Subdomain `mycompany`.

#### In ElevenLabs verbinden

Geben Sie in der Einrichtung der ElevenLabs-Integration Folgendes ein:

* **Email** – die E-Mail-Adresse Ihres Atlassian-Kontos
* **API Token** – das in Schritt 1 erstellte Token
* **Jira Subdomain** – Ihre Subdomain aus Schritt 2

> **Note**
>
> API-Tokens laufen standardmäßig nach einem Jahr ab. Wenn Ihr Agent nicht mehr auf Jira zugreifen kann,
> erstellen Sie ein neues Token und aktualisieren Sie die Verbindung.

## Anrufer identifizieren

Das Tool `jira_search_issues` benötigt den Parameter `labels`, um Suchen auf die Tickets eines bestimmten Nutzers zu beschränken. Dies setzt voraus, dass Ihr Jira-Workflow jedem Vorgang ein Label zuweist, das den Anrufer identifiziert – beispielsweise wird eine E-Mail wie `jane.smith@example.com` in ein Label wie `jane-smith-at-example-com` umgewandelt.

Um dies zu automatisieren, konfigurieren Sie das Feld `labels` als [dynamische Variable](/docs/de/eleven-agents/customization/personalization/dynamic-variables), die die Kennung des Anrufers von Ihrer Anwendung erhält. So muss der Agent den Anrufer nicht bei jedem Anruf nach seiner E-Mail-Adresse fragen.

> **Note**
>
> Jira-Labels dürfen keine Leerzeichen enthalten. Üblich ist, `@` durch `-at-` und `.` durch
> `-` zu ersetzen, z. B. `jane-smith-at-example-com`. Das Tool `jira_search_issues` gleicht das Label exakt ab.
> Der angegebene Wert muss daher mit dem Label des Vorgangs übereinstimmen.

## So funktioniert es

#### Support-Ticket erstellen

#### Anrufer identifizieren

Der Agent identifiziert den Anrufer anhand seiner E-Mail-Adresse oder einer anderen Kennung,
die im Feld labels konfiguriert ist.

#### Details erfassen

Der Agent sammelt Informationen über das Problem vom Anrufer: Was ist passiert, wie schwerwiegend ist es
und welcher Kontext ist relevant?

#### Vorgang erstellen

Der Agent erstellt im passenden Projekt einen Jira-Vorgang mit dem richtigen Vorgangstyp,
der passenden Priorität und Beschreibung.

#### Dem Anrufer bestätigen

Der Agent nennt die Nummer des erstellten Tickets, damit der Anrufer eine Referenz für die Nachverfolgung hat.

#### Lösung im Service Desk

#### Ticket abrufen

Der Agent ruft einen Jira-Vorgang anhand seines Schlüssels ab, z. B. PROJ-123, und nennt den aktuellen
Status, die Priorität und die Zusammenfassung.

#### Lösungsnotizen hinzufügen

Der Agent fügt dem Vorgang einen Kommentar mit Details aus der Unterhaltung hinzu, etwa zu unternommenen
Schritten oder gesammelten Informationen.

#### Ticket schließen

Der Agent verschiebt den Vorgang mithilfe der verfügbaren Workflow-Übergänge in einen gelösten oder geschlossenen
Status.

## Beispiel für einen System-Prompt

#### Beispiel für einen System-Prompt anzeigen

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

## Verfügbare Tools

| Tool                    | Beschreibung                                                                                                    |
| ----------------------- | --------------------------------------------------------------------------------------------------------------- |
| `jira_create_issue`     | Erstellt einen Vorgang mit Projekt, Zusammenfassung, Vorgangstyp und optionalen Feldern wie Priorität.          |
| `jira_get_issue`        | Ruft Details zu einem bestimmten Vorgang anhand seines Schlüssels ab.                                           |
| `jira_search_issues`    | Sucht Vorgänge nach Label, Projekt, Status, Priorität, Typ, Bearbeiter, Text oder Datumsbereich.                |
| `jira_update_issue`     | Aktualisiert Felder eines bestehenden Vorgangs: Priorität, Bearbeiter, Labels oder Beschreibung.                |
| `jira_add_comment`      | Fügt einem Vorgang einen Klartext-Kommentar hinzu.                                                              |
| `jira_get_transitions`  | Listet verfügbare Workflow-Übergänge für einen Vorgang auf.                                                     |
| `jira_transition_issue` | Verschiebt einen Vorgang mithilfe einer Übergangs-ID aus `jira_get_transitions` in einen neuen Workflow-Status. |
| `jira_link_issues`      | Verknüpft zwei Vorgänge miteinander, z. B. „Blocks“, „Duplicate“ oder „Relates“.                                |
| `jira_list_projects`    | Listet verfügbare Projekte und ihre Schlüssel auf.                                                              |
| `jira_get_issue_types`  | Listet verfügbare Vorgangstypen auf, z. B. Bug, Task oder Story.                                                |
| `jira_get_priorities`   | Listet verfügbare Prioritätsstufen auf.                                                                         |

> **Note**
>
> Vorgangsbeschreibungen und Kommentare unterstützen nur Klartext. Die Integration wandelt sie automatisch in Jiras
> Atlassian Document Format (ADF) um. Markdown und HTML werden nicht unterstützt.

## Nützliche Links

* [Jira Cloud REST API-Dokumentation](https://developer.atlassian.com/cloud/jira/platform/rest/v3/)
* [API-Tokens verwalten](https://support.atlassian.com/atlassian-account/docs/manage-api-tokens-for-your-atlassian-account/)