Gestione progetti

Collegare Jira a un agente IA autonomo

Un agente Atako collegato a Jira può cercare, creare e far avanzare le issue nei Suoi workflow, con gli stessi diritti dell'account che ha generato il token.

Scritto dagli agenti di Atako · Rivisto e approvato da Romain Laodicina · CTO di Atako

Workflow possibili

Smistamento e definizione delle priorità dei ticket in arrivo

A partire da un segnale ricevuto tramite un canale di supporto o un modulo, l'agente crea l'issue con il tipo e la priorità corretti (create_issue), la assegna secondo le Sue regole aziendali (assign_issue) e aggiunge il contesto ricevuto come commento (add_comment). Il team ritrova un ticket già classificato, senza doverlo leggere una prima volta per smistarlo prima di iniziare il lavoro vero e proprio.

Report settimanale di avanzamento dello sprint

L'agente interroga le issue dello sprint in corso con una query JQL (search_issues), recupera il tempo registrato (list_worklogs) e le modifiche recenti (get_issue_changelog), poi pubblica una sintesi come commento sull'epic o sul ticket padre (add_comment). Il report è disponibile ogni lunedì mattina senza una riunione di stato preliminare, con i ticket bloccati messi in evidenza invece di essere sommersi nell'elenco completo dello sprint.

Monitoraggio e chiusura dei ticket collegati a un incidente

Non appena una correzione viene confermata da un altro canale, l'agente verifica le transizioni di workflow disponibili (list_transitions), fa avanzare il ticket (transition_issue), lo collega all'incidente originario (create_issue_link) e avvisa i watcher interessati. Il ticket conserva una traccia completa del percorso, utile per un post-mortem scritto senza dover ricostruire la cronologia a posteriori a partire da messaggi Slack sparsi o dalla memoria di ciascuno.

Azioni del connettore

  • search_issues (lettura, JQL)

    Cerca issue con una query JQL.

  • get_issue (lettura)

    Recupera un'issue tramite id o chiave.

  • get_issue_changelog (lettura)

    Recupera la cronologia delle modifiche di un'issue.

  • list_worklogs (lettura)

    Elenca il tempo registrato su un'issue.

  • list_transitions (lettura)

    Elenca le transizioni di workflow disponibili per un'issue.

  • list_projects (lettura)

    Elenca i progetti visibili dall'account.

  • create_issue (scrittura)

    Crea un'issue in un progetto.

  • update_issue (scrittura)

    Aggiorna i campi di un'issue esistente.

  • transition_issue (scrittura)

    Fa avanzare un'issue nel suo workflow.

  • add_comment (scrittura)

    Aggiunge un commento a un'issue.

  • assign_issue (scrittura)

    Assegna un'issue a un utente.

  • add_worklog (scrittura)

    Registra il tempo dedicato a un'issue.

  • create_issue_link (scrittura)

    Collega due issue tra loro (blocca, riguarda).

Prerequisiti

  • Account Jira con diritti browse, create ed edit sui progetti interessati (l'amministrazione Jira non è obbligatoria).
  • Generare un token API su id.atlassian.com, sezione Security poi API tokens.
  • Conoscere il nome del sito Jira (lo yourcompany di yourcompany.atlassian.net).
  • Comporre l'identificativo nella forma email:token per l'autenticazione.
  • Su Atako, un diritto di amministrazione delle integrazioni per concedere il grant all'agente.

Come connettersi

  1. 1

    Generare un token API Atlassian

    Su id.atlassian.com, andare in Security poi API tokens, creare un token, dargli un nome e copiarlo.

  2. 2

    Comporre l'identificativo di connessione

    Combinare l'email dell'account Jira e il token API nella forma email:token.

  3. 3

    Collegare Jira in Atako

    In Impostazioni poi Integrazioni, inserire il nome del sito Jira e incollare l'identificativo.

  4. 4

    Concedere il grant all'agente

    Dalla pagina dell'agente o dalla connessione, selezionare le azioni precise autorizzate e il loro ambito.

Perché collegare un agente autonomo a Jira

Jira resta il luogo in cui un team tecnico segue le proprie issue, ma lo smistamento, i solleciti e il reporting attorno a queste issue consumano un tempo sproporzionato rispetto al lavoro di sviluppo vero e proprio. Un agente Atako collegato a Jira tramite tool calling può svolgere parte di questo lavoro in continuo, nel proprio ambiente, senza attendere una riunione di stato settimanale.

La differenza rispetto a un webhook o a uno script pianificato classico: l'agente gira ininterrottamente e interpreta una situazione prima di agire. Può ricevere un segnale da un altro canale (email, Slack), interrogare Jira con una query JQL per ritrovare il contesto, poi decidere di creare un'issue, di commentarla o di farla avanzare nel workflow, secondo le azioni che gli sono state concesse.

Il connettore Jira copre 39 azioni secondo la documentazione Atako (24 in lettura, 15 in scrittura), dalla ricerca JQL al monitoraggio dei worklog. Un uso concreto lato prodotto: il triage degli incidenti CI/CD, dove l'agente correla un fallimento della pipeline con i commit recenti prima di aprire un ticket Jira già documentato.

Limiti e buone pratiche

Atlassian sta facendo evolvere i propri limiti di velocità sull'API Jira Cloud verso un modello a punti, in cui ogni richiesta consuma un costo variabile in base alla propria complessità, con un tetto a raffica al secondo oltre al tetto orario. Un agente che interroga molte issue in una volta deve quindi paginare le chiamate invece di caricare tutto in un'unica richiesta.

Il token API eredita rigorosamente i permessi dell'account Jira che lo ha creato: se quell'account non ha accesso a un progetto, nemmeno l'agente ce l'avrà, qualunque sia il grant configurato lato Atako.

Come per ogni integrazione, la sola connessione non dà alcun accesso: serve un grant preciso (agente, azione, ambito). Consulti il modello di permessi e i piani prima di collegare l'agente ai Suoi progetti Jira.

Casi d'uso correlati

Integrazioni correlate

Domande frequenti

L'agente può chiudere da solo un ticket Jira?

Sì, se dispone dell'azione transition_issue con ambito di scrittura e se il workflow del progetto consente la transizione richiesta. Senza questo grant esplicito, l'agente può leggere e commentare ma non far avanzare lo stato di un'issue.

Bisogna essere amministratori Jira per collegare l'agente?

No. Il token API eredita i diritti dell'account che lo ha generato: un account con accesso browse, create ed edit sui progetti interessati è sufficiente, l'amministrazione Jira completa non è necessaria.

Come si revoca l'accesso dell'agente a Jira?

Eliminare il token API da id.atlassian.com, oppure revocare la connessione lato Atako. In entrambi i casi, tutti gli agenti che usano questa connessione perdono l'accesso immediatamente.

L'agente può eliminare definitivamente un'issue Jira?

L'azione delete_issue esiste nel connettore, comprese le sottoattività associate, ma è disponibile solo se il grant dell'agente lo autorizza esplicitamente con ambito di scrittura.

Cosa leggere dopo

Fonti

Romain Laodicina

CTO di Atako

Questo contenuto è stato redatto dagli agenti IA di Atako, poi rivisto, corretto e approvato da Romain Laodicina, CTO di Atako.

Distribuisci i tuoi primi agenti IA

Crea il tuo account gratuitamente e avvia un agente in pochi minuti, senza codice.

Resta un passo avanti nell'IA.

Ricevi le novità di prodotto, i nuovi agenti e le nostre analisi sull'IA direttamente nella tua casella email. Niente spam, disiscrizione in qualsiasi momento.