> 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

## Översikt

Anslut dina AI-agenter från ElevenLabs till Jira Cloud för att hantera ärenden, följa projekt och automatisera supportflöden. Integrationen gör det möjligt för dina agenter att skapa och uppdatera ärenden, flytta ärenden genom arbetsflöden, länka relaterade ärenden för eskalering och söka i projekt.

## Funktioner

| Funktion                  | Stöd                                        |
| ------------------------- | ------------------------------------------- |
| Zero retention mode (ZRM) | Stöds inte                                  |
| Bilagor i verktyg         | Stöds inte — verktygen hanterar endast text |

## Konfiguration

Den här integrationen använder en **Jira API-token** med Basic-autentisering. Du behöver e-postadressen till ditt Atlassian-konto, en API-token och din Jira Cloud-underdomän.

#### Skapa en API-token

Gå till [hantering av Atlassian API-token](https://id.atlassian.com/manage-profile/security/api-tokens) och klicka på **Create API token**. Kopiera tokenen — du kan inte se den igen.

#### Hitta din Jira-underdomän

Din underdomän är den första delen av din Jira Cloud-URL. Om din Jira till exempel finns på `mycompany.atlassian.net` är din underdomän `mycompany`.

#### Anslut i ElevenLabs

Ange följande i installationsprogrammet för ElevenLabs-integrationen:

* **Email** — e-postadressen till ditt Atlassian-konto
* **API Token** — tokenen du skapade i steg 1
* **Jira Subdomain** — din underdomän från steg 2

> **Note**
>
> API-token upphör som standard efter ett år. Om agenten inte längre kan komma åt Jira
> skapar du en ny token och uppdaterar anslutningen.

## Identifiera uppringare

Verktyget `jira_search_issues` kräver parametern `labels` för att begränsa sökningar till en specifik användares ärenden. Detta förutsätter att ditt Jira-arbetsflöde tilldelar varje ärende en etikett som identifierar uppringaren — till exempel genom att omvandla en e-postadress som `jane.smith@example.com` till en etikett som `jane-smith-at-example-com`.

För att automatisera detta konfigurerar du fältet `labels` som en [dynamisk variabel](/docs/sv/eleven-agents/customization/personalization/dynamic-variables) som tar emot uppringarens identifierare från din applikation. Då behöver agenten inte fråga uppringaren om e-postadressen vid varje samtal.

> **Note**
>
> Jira-etiketter får inte innehålla mellanslag. En vanlig konvention är att ersätta `@` med `-at-` och `.` med
> `-` (t.ex. `jane-smith-at-example-com`). Verktyget `jira_search_issues` matchar etiketten exakt,
> så det angivna värdet måste matcha etiketten på ärendet.

## Så fungerar det

#### Skapa supportärenden

#### Identifiera uppringaren

Agenten identifierar uppringaren via e-postadress eller en annan identifierare som har konfigurerats i
fältet labels.

#### Samla in information

Agenten samlar in information om problemet från uppringaren — vad som hände, allvarlighetsgrad
och relevant sammanhang.

#### Skapa ärendet

Agenten skapar ett Jira-ärende i rätt projekt med rätt ärendetyp,
prioritet och beskrivning.

#### Bekräfta med uppringaren

Agenten läser upp numret på det skapade ärendet så att uppringaren har en referens för uppföljning.

#### Lösning via servicedesk

#### Sök upp ärendet

Agenten hämtar ett Jira-ärende med dess nyckel (t.ex. PROJ-123) och läser upp aktuell
status, prioritet och sammanfattning.

#### Lägg till lösningsanteckningar

Agenten lägger till en kommentar i ärendet med information från konversationen, till exempel vidtagna
åtgärder eller insamlad information.

#### Stäng ärendet

Agenten flyttar ärendet till statusen löst eller stängt med tillgängliga övergångar i
arbetsflödet.

## Exempel på systemprompt

#### Visa exempel på systemprompt

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

## Tillgängliga verktyg

| Verktyg                 | Beskrivning                                                                                                    |
| ----------------------- | -------------------------------------------------------------------------------------------------------------- |
| `jira_create_issue`     | Skapa ett ärende med projekt, sammanfattning, ärendetyp och valfria fält som prioritet.                        |
| `jira_get_issue`        | Hämta information om ett specifikt ärende via dess nyckel.                                                     |
| `jira_search_issues`    | Sök efter ärenden efter etikett, projekt, status, prioritet, typ, tilldelad person, text eller datumintervall. |
| `jira_update_issue`     | Uppdatera fält i ett befintligt ärende — prioritet, tilldelad person, etiketter eller beskrivning.             |
| `jira_add_comment`      | Lägg till en kommentar i oformaterad text till ett ärende.                                                     |
| `jira_get_transitions`  | Lista tillgängliga arbetsflödesövergångar för ett ärende.                                                      |
| `jira_transition_issue` | Flytta ett ärende till en ny arbetsflödesstatus med ett övergångs-ID från `jira_get_transitions`.              |
| `jira_link_issues`      | Länka ihop två ärenden (t.ex. ”Blocks”, ”Duplicate”, ”Relates”).                                               |
| `jira_list_projects`    | Lista tillgängliga projekt och deras nycklar.                                                                  |
| `jira_get_issue_types`  | Lista tillgängliga ärendetyper (t.ex. Bug, Task, Story).                                                       |
| `jira_get_priorities`   | Lista tillgängliga prioritetsnivåer.                                                                           |

> **Note**
>
> Ärendebeskrivningar och kommentarer kan endast vara oformaterad text. Integrationen omvandlar dem automatiskt till Jiras
> Atlassian Document Format (ADF). Markdown och HTML stöds inte.

## Användbara länkar

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