Vai alla navigazione
ConfigurazioneIntegrazioni

Jira

Collega i tuoi agenti ElevenLabs a Jira Cloud

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

1

Genera un API token

Vai a Gestione degli API token Atlassian e fai clic su Create API token. Copia il token: non potrai più visualizzarlo.

2

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.

3

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

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 che riceve l’identificatore del chiamante dalla tua applicazione. In questo modo l’agente non deve chiedere l’email al chiamante a ogni chiamata.

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

1

Identificazione del chiamante

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

2

Raccogli i dettagli

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

3

Crea l'issue

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

4

Conferma al chiamante

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

Esempio di system prompt

# 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

StrumentoDescrizione
jira_create_issueCrea un’issue con progetto, riepilogo, tipo di issue e campi facoltativi come la priorità.
jira_get_issueRecupera i dettagli di un’issue specifica tramite chiave.
jira_search_issuesCerca issue per etichetta, progetto, stato, priorità, tipo, assegnatario, testo o intervallo di date.
jira_update_issueAggiorna i campi di un’issue esistente: priorità, assegnatario, etichette o descrizione.
jira_add_commentAggiunge un commento in testo semplice a un’issue.
jira_get_transitionsElenca le transizioni di workflow disponibili per un’issue.
jira_transition_issueSposta un’issue in un nuovo stato del workflow usando un ID di transizione da jira_get_transitions.
jira_link_issuesCollega due issue (ad esempio, “Blocks”, “Duplicate”, “Relates”).
jira_list_projectsElenca i progetti disponibili e le relative chiavi.
jira_get_issue_typesElenca i tipi di issue disponibili (ad esempio, Bug, Task, Story).
jira_get_prioritiesElenca i livelli di priorità disponibili.

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.