> 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

## Panoramica

Collega i tuoi agenti IA di ElevenLabs a Jira Cloud per gestire issue, monitorare progetti e automatizzare i workflow di assistenza. Questa integrazione consente ai tuoi agenti di creare e aggiornare issue, far avanzare le issue nei workflow, collegare ticket correlati per l'escalation e cercare nei vari progetti.

## Funzionalità

| Funzionalità                     | Supporto                                              |
| -------------------------------- | ----------------------------------------------------- |
| Modalità a ritenzione zero (ZRM) | Non supportata                                        |
| Allegati negli strumenti         | Non supportati — gli strumenti operano solo sul testo |

## Configurazione

Questa integrazione usa un **Jira API token** con autenticazione Basic. Ti servono l'email del tuo account Atlassian, un API token e il sottodominio Jira Cloud.

#### Genera un API token

Vai a [Gestione degli API token Atlassian](https://id.atlassian.com/manage-profile/security/api-tokens) e fai clic su **Create API token**. Copia il token: non potrai più visualizzarlo.

#### Trova il tuo sottodominio Jira

Il tuo sottodominio è la prima parte dell'URL di Jira Cloud. Ad esempio, se Jira si trova in `mycompany.atlassian.net`, il tuo sottodominio è `mycompany`.

#### Connetti in ElevenLabs

Nella configurazione dell'integrazione ElevenLabs, inserisci:

* **Email** - l'email del tuo account Atlassian
* **API Token** - il token che hai generato nel passaggio 1
* **Jira Subdomain** - il tuo sottodominio dal passaggio 2

> **Note**
>
> Per impostazione predefinita, gli API token scadono dopo un anno. Se il tuo agente non riesce più ad accedere a Jira,
> genera un nuovo token e aggiorna la connessione.

## Identificazione dei chiamanti

Lo strumento `jira_search_issues` richiede un parametro `labels` per limitare le ricerche ai ticket di un utente specifico. Ciò presuppone che il tuo workflow Jira applichi a ogni issue un'etichetta che identifica il chiamante, ad esempio convertendo un'email come `jane.smith@example.com` in un'etichetta come `jane-smith-at-example-com`.

Per automatizzare questa operazione, configura il campo `labels` come [variabile dinamica](/docs/it/eleven-agents/customization/personalization/dynamic-variables) che riceve l'identificatore del chiamante dalla tua applicazione. In questo modo l'agente non deve chiedere l'email al chiamante a ogni chiamata.

> **Note**
>
> Le etichette Jira non possono contenere spazi. Una convenzione comune consiste nel sostituire `@` con `-at-` e `.` con
> `-` (ad esempio, `jane-smith-at-example-com`). Lo strumento `jira_search_issues` cerca una corrispondenza esatta dell'etichetta,
> quindi il valore fornito deve corrispondere all'etichetta dell'issue.

## Come funziona

#### Creazione di ticket di assistenza

#### Identificazione del chiamante

L'agente identifica il chiamante tramite indirizzo email o un altro identificatore configurato nel
campo labels.

#### Raccogli i dettagli

L'agente raccoglie informazioni sull'issue dal chiamante: cosa è successo, gravità
e qualsiasi contesto rilevante.

#### Crea l'issue

L'agente crea un'issue Jira nel progetto appropriato con il tipo di issue,
la priorità e la descrizione corretti.

#### Conferma al chiamante

L'agente comunica il numero del ticket creato affinché il chiamante abbia un riferimento per i successivi aggiornamenti.

#### Risoluzione del service desk

#### Cerca il ticket

L'agente recupera un'issue Jira tramite la relativa chiave (ad esempio, PROJ-123) e comunica lo stato,
la priorità e il riepilogo correnti.

#### Aggiungi note sulla risoluzione

L'agente aggiunge un commento all'issue con i dettagli della conversazione, come i passaggi
eseguiti o le informazioni raccolte.

#### Chiudi il ticket

L'agente porta l'issue a uno stato risolto o chiuso usando le transizioni di workflow
disponibili.

## Esempio di system prompt

#### Visualizza un esempio di system prompt

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

## Strumenti disponibili

| Strumento               | Descrizione                                                                                           |
| ----------------------- | ----------------------------------------------------------------------------------------------------- |
| `jira_create_issue`     | Crea un'issue con progetto, riepilogo, tipo di issue e campi facoltativi come la priorità.            |
| `jira_get_issue`        | Recupera i dettagli di un'issue specifica tramite chiave.                                             |
| `jira_search_issues`    | Cerca issue per etichetta, progetto, stato, priorità, tipo, assegnatario, testo o intervallo di date. |
| `jira_update_issue`     | Aggiorna i campi di un'issue esistente: priorità, assegnatario, etichette o descrizione.              |
| `jira_add_comment`      | Aggiunge un commento in testo semplice a un'issue.                                                    |
| `jira_get_transitions`  | Elenca le transizioni di workflow disponibili per un'issue.                                           |
| `jira_transition_issue` | Sposta un'issue in un nuovo stato del workflow usando un ID di transizione da `jira_get_transitions`. |
| `jira_link_issues`      | Collega due issue (ad esempio, "Blocks", "Duplicate", "Relates").                                     |
| `jira_list_projects`    | Elenca i progetti disponibili e le relative chiavi.                                                   |
| `jira_get_issue_types`  | Elenca i tipi di issue disponibili (ad esempio, Bug, Task, Story).                                    |
| `jira_get_priorities`   | Elenca i livelli di priorità disponibili.                                                             |

> **Note**
>
> Le descrizioni delle issue e i commenti supportano solo testo semplice. L'integrazione li converte automaticamente nel formato
> Atlassian Document Format (ADF) di Jira. Markdown e HTML non sono supportati.

## Link utili

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