Integrazione di Devin con Jira

Esistono due modi per collegare Jira Cloud a Devin. Entrambi consentono di affidare a Devin i work item di Jira e ricevere in cambio delle pull request, ma differiscono per installazione e modalità di attivazione.

​

Quale opzione scegliere?

• Le funzionalità degli agenti di Jira Cloud sono abilitate nel tuo workspace → usa l’agente Rovo. Devin compare nel selettore degli assegnatari e nelle @menzioni come qualsiasi altro agente e riporta gli aggiornamenti nella scheda dell’agente del work item. Collegando il sito, inoltre, gli eventi dei work item di Jira diventano disponibili come trigger per le automazioni di Devin.
• Rovo è disattivato nel tuo workspace Jira → usa un utente di servizio. Devin opera tramite un account di servizio Jira creato da te e riporta gli aggiornamenti tramite commenti e collegamenti remoti.

Entrambe le opzioni eseguono normali sessioni Devin, sono compatibili con le automazioni di Devin, prevedono gli stessi requisiti e vengono fatturate allo stesso modo.

​

Automazioni di Devin

Le automazioni di Devin consentono di avviare Devin automaticamente da Jira e funzionano con entrambe le opzioni. Una volta connesso un sito Jira (collegato tramite l’app Devin for Jira o connesso con un account admin), i relativi eventi dei work item diventano disponibili come trigger Jira. Scegline uno quando crei l’automazione:

• Issue created — viene creato un work item.
• Issue updated — viene modificato un qualsiasi campo di un work item; i campi modificati sono disponibili per le condizioni dell’automazione.
• Label added — viene aggiunta un’etichetta a un work item; viene generato un evento per ciascuna etichetta.
• Status changed — cambia lo stato di un work item, oppure viene creato un work item con uno stato.
• Assigned — viene creato un work item con un assegnatario, oppure ne cambia l’assegnatario.
• Comment created — viene creato un commento su un work item. I commenti pubblicati da Devin stesso non attivano il trigger.

Le condizioni possono filtrare per progetto, etichetta, stato, assegnatario, epic (il parent del work item) e riepilogo. Al termine della sessione dell’automazione, il messaggio finale viene pubblicato come commento sul work item: dall’app Devin, se il sito è collegato tramite l’app, oppure tramite la connessione con l’utente di servizio, se il sito è connesso con un account admin. Se un sito dispone di entrambe le connessioni, ogni evento viene recapitato una sola volta, tramite la connessione con l’utente di servizio.

​

Opzione 1: agente Devin Rovo in Jira

Devin for Jira è un’app Atlassian Forge basata sul connettore per agenti Rovo. Dopo averla installata e collegata al tuo account, Devin diventa un agente sul tuo sito Jira Cloud: assegna un work item a Devin o menziona @Devin in un commento e Devin pianificherà il lavoro, scriverà il codice, aprirà una pull request e riporterà l’esito direttamente sul work item.

​

Configurazione

La configurazione prevede due fasi: prima si installa l’app sul tuo sito Jira, poi un admin di Devin collega il sito a un account Devin.

​

1. Installa l’app sul tuo sito

1. Un amministratore Jira apre Devin su Atlassian Marketplace e lo installa sul tuo sito Jira Cloud (your-site.atlassian.net).
2. L’amministratore Jira esamina le autorizzazioni richieste dall’app e conferma. L’app legge e scrive work item e commenti, legge gli utenti Jira e i relativi indirizzi email (per associarli agli utenti Devin) e verifica le autorizzazioni dei progetti.

Una volta installata l’app, Devin compare come agente sul sito, ma non può prendere in carico attività finché il sito non viene collegato a un account Devin.

​

2. Collegare il sito Jira al proprio account Devin

1. In Jira, vai su Settings > Apps e apri la pagina Devin aggiunta dall’app. Viene visualizzato il messaggio “This site is not connected to a Devin account yet.”
2. Fai clic su Connect to Devin. Si apre una pagina di Devin in una nuova scheda. Se richiesto, accedi a Devin.
3. Verifica che il sito Jira mostrato sia il tuo, scegli l’account Devin a cui collegarlo e fai clic su Link site.
4. Torna in Jira e fai clic su Check again. Ora la pagina mostra l’account Devin a cui è collegato il sito.

Il sito collegato compare in Devin in Settings > Connections > Jira come Devin app for Jira · installed from Jira, con il badge Linked. Per disconnetterlo, apri da lì il menu Actions del sito, scegli Unlink site… e conferma con Unlink site: Devin smette immediatamente di accettare nuove attività da quel sito Jira, mentre le sessioni già in esecuzione in Devin non vengono interrotte. Per ricollegarlo, un amministratore Jira deve fare di nuovo clic su Connect to Devin in Jira.

​

Trigger

Per avviare Devin automaticamente in risposta agli eventi dei work item, usa le automazioni di Devin. In alternativa, puoi avviare manualmente una sessione Devin da un work item tramite l’agente Rovo, in due modi.

​

Assegnare il work item a Devin

Seleziona Devin nel campo assegnatario del work item. Devin avvia una sessione e lavora sul work item usandone il riepilogo e la descrizione come attività.

• Se la stessa persona ripete l’assegnazione entro cinque minuti mentre l’attività è ancora attiva, le assegnazioni successive vengono considerate duplicati. Una nuova assegnazione del work item in un secondo momento, o da parte di un’altra persona, può avviare un’altra sessione anche se la prima è ancora in corso.
• Se si assegna di nuovo il work item a Devin dopo che ha terminato, viene avviata una nuova sessione.

​

Menzionare Devin con @ in un commento

Menziona @Devin in un commento con istruzioni specifiche. Devin avvia una sessione che tratta il tuo commento come l’attività da svolgere e la descrizione del work item come contesto. Quando Devin termina o si ferma per farti una domanda, pubblica il suo ultimo messaggio come commento sul work item, rivolto a te. Ogni commento che menziona Devin avvia una sessione separata. Per proseguire una sessione già in corso, rispondi invece nel pannello dell’agente.

​

Il pannello dell’agente

Mentre Devin lavora, i suoi progressi vengono visualizzati nel pannello dell’agente di Jira sul work item:

• Stato in tempo reale: il pannello dell’agente mostra in tempo reale i progressi di Devin.
• Collegamento alla sessione: il primo messaggio di Devin è un collegamento alla sessione Devin nella web app, da cui puoi seguire il lavoro o subentrare.
• Messaggi di Devin: le risposte di Devin restano nella scheda come risposte formattate con collegamenti cliccabili.
• Domande: se Devin ha bisogno di un tuo input, la scheda mostra la sua domanda. Rispondi tramite la chat dell’attività nel pannello dell’agente di Jira; la tua risposta viene inviata alla stessa sessione Devin.
• Annullamento: se annulli l’attività da Jira, Devin si interrompe e la sessione passa in sospensione.

Solo l’utente Jira che ha avviato un’attività di Devin può inviarle messaggi o annullarla da Jira. Se Devin non può accettare un work item, la scheda ne indica il motivo: ad esempio, il sito Jira non è ancora collegato a un account Devin, non è stato possibile associare il tuo account Atlassian a un utente Devin, oppure l’organizzazione o il tuo utente non possono al momento consumare altre Agent Compute Unit (ACU). Risolvi il problema, quindi assegna di nuovo il work item a Devin.

​

Collegamenti alle pull request

Le risposte di Devin nel pannello dell’agente di Jira includono i collegamenti alle pull request; le eventuali pull request aperte da Devin ma non menzionate vengono elencate in Pull requests alla fine della risposta. Per le sessioni avviate tramite @mention, il messaggio finale di Devin viene pubblicato anche come commento sul work item, ma contiene il collegamento alla pull request solo se Devin lo ha incluso.

​

Opzione 2: utente di servizio in Jira

Con questa opzione, Devin si connette al tuo sito Jira tramite OAuth e opera tramite un account di servizio Jira. In Jira non viene installato nulla: un admin di Jira autorizza Devin dalle impostazioni di Devin e tu crei in Atlassian un account di servizio che diventa l’identità di Devin in Jira, ovvero l’utente a cui assegni i work item e l’autore dei commenti di Devin. Scegli questa opzione se Rovo è disattivato nel tuo workspace Jira.

​

Configurazione

​

1. Collegati con un account amministratore

1. In Devin, vai a Settings > Connections > Jira, fai clic su Connect account e scegli Connect with an admin account.
2. Accedi ad Atlassian come amministratore di Jira e concedi l’accesso. Devin registra i propri webhook sul sito tramite questo account.

Finché non aggiungi un account di servizio, i commenti di Devin vengono pubblicati con l’account amministratore che ha collegato Jira e non è possibile assegnare work item a Devin.

​

2. Aggiungi un account di servizio

1. Configura un account di servizio Atlassian con una credenziale OAuth 2.0 e i seguenti ambiti:
   • read:me
   • read:jira-user
   • read:jira-work
   • write:jira-work
2. Concedi all’account di servizio l’accesso all’applicazione Jira e l’autorizzazione a consultare i progetti pertinenti, aggiungere commenti, modificare ed eliminare i propri commenti e collegare i problemi. Al momento del salvataggio, Devin convalida le credenziali e segnala eventuali autorizzazioni mancanti.
3. In Settings > Connections > Jira, apri il menu della connessione, scegli Add service-account credentials e inserisci il client ID e il client secret.

Da quel momento i commenti di Devin vengono pubblicati a nome dell’account di servizio e, assegnando un work item a tale account, si avvia una sessione. Se sostituisci o rimuovi le credenziali, i webhook vengono mantenuti. Normalmente Devin pubblica tramite l’account di servizio configurato. Se non è possibile ottenere il relativo token di accesso, Devin può ricorrere al token OAuth dell’admin che ha connesso Jira, per cui i commenti potrebbero comparire a nome di quell’admin.

​

3. Crea un’automazione

Per avviare automaticamente Devin in base agli eventi dei work item, crea un’automazione di Devin con un trigger Jira: vedi Automazioni di Devin.

​

Trigger

Per avviare Devin automaticamente quando i work item vengono creati o modificati, usa le automazioni di Devin. Puoi anche avviare Devin manualmente su un work item:

• Assegna il work item all’account di servizio. Devin avvia una sessione sul work item. Richiede un account di servizio.
• Aggiungi l’etichetta devin. Quando aggiungi l’etichetta a un work item esistente, la corrispondenza non distingue tra maiuscole e minuscole e si basa su parole intere: Devin, devin-workshop e devin-task avviano Devin, mentre devinworkshop e devin_workshop no. Quando un work item viene creato con etichette già impostate, il trigger basato sull’etichetta si attiva solo se un’etichetta corrisponde esattamente a devin (senza distinzione tra maiuscole e minuscole); devin-workshop non viene considerata.
• @menziona l’account di servizio in un commento. Devin avvia una sessione sul work item e aggiunge il testo del tuo commento all’attività. Se Devin ha già una sessione attiva per il work item, il tuo commento viene inoltrato a quella sessione anziché avviarne una nuova.

Finché Devin ha una sessione per un work item, le nuove assegnazioni e le nuove etichette su quell’elemento vengono ignorate e le @menzioni vengono inviate a quella sessione. Questo collegamento rimane valido per 30 giorni, oppure finché una @menzione non rileva che la sessione è terminata o è andata in errore.

​

Con quale utente viene eseguita la sessione

Devin associa l’utente Jira che ha avviato la sessione a un membro dell’account Devin collegato:

1. Innanzitutto tramite un account Atlassian collegato. I membri possono collegare il proprio account in Settings > Connections > Atlassian, consentendo a Devin di leggere Jira per conto di quella persona.
2. In alternativa tramite indirizzo email: un utente Jira la cui email corrisponde esattamente a un solo membro dell’account viene associato a quel membro, e l’associazione viene memorizzata.

La sessione viene eseguita come l’utente Devin associato: compare nel suo elenco di sessioni e rispetta le sue autorizzazioni. Se nessun membro corrisponde, oppure se il membro associato non è autorizzato a usare le sessioni Devin nell’organizzazione, la sessione viene eseguita come utente bot Jira condiviso di Devin. Se Devin non riesce a determinare un’organizzazione per il work item, lo segnala in un commento.

​

Commenti e collegamenti alle pull request

Quando viene avviata una sessione, Devin aggiunge il commento “Devin is working on your request” insieme a un collegamento alla sessione. Quando Devin crea una pull request, il relativo URL viene aggiunto come collegamento remoto al work item e pubblicato come commento, insieme al collegamento alla sessione Devin.

​

Requisiti

Per entrambe le opzioni:

• Jira Cloud. Devin for Jira è un’app Forge e la connessione OAuth utilizza Atlassian Cloud OAuth, quindi in entrambi i casi è necessario un sito Jira Cloud. Per Jira self-hosted, consulta collegare un sistema di ticketing personalizzato tramite l’API.
• Un amministratore Jira per installare l’app o autorizzare la connessione OAuth e un amministratore Devin (una persona che può gestire le integrazioni dell’account Devin) per collegare il sito o configurare la connessione.
• Un solo sito Jira per account Devin. Un sito Jira può essere collegato a un solo account Devin e un account Devin può essere collegato a un solo sito Jira alla volta. Scollega il sito corrente prima di collegarne un altro.
• Repository connessi, affinché Devin possa eseguire il push dei branch e aprire pull request. Devin può aprire pull request solo nei repository a cui ha accesso: connetti prima il tuo provider di codice sorgente, ad esempio tramite l’integrazione GitHub.

Per l’agente Rovo:

• L’app Devin for Jira installata dall’Atlassian Marketplace, con le funzionalità degli agenti di Jira Cloud abilitate nel workspace. Consulta l’Opzione 1.
• Un piano Devin Core, Team o Enterprise, con l’autorizzazione a gestire le integrazioni, oltre all’autorizzazione e a un utilizzo disponibile sufficiente per avviare sessioni.
• Ogni persona che attiva Devin deve avere un utente Devin. Devin associa l’utente Jira a un membro dell’account Devin collegato tramite il suo account Atlassian collegato o tramite l’indirizzo email. Se nessuno dei due corrisponde, la persona può collegare il proprio account in Settings > Connections > Atlassian. In alternativa, un amministratore deve verificare che la persona appartenga all’account Devin collegato e che la sua email verificata corrisponda. I work item provenienti da utenti Jira che non è possibile associare vengono rifiutati.
• Autorizzazione ad avviare sessioni. L’utente Devin associato deve essere autorizzato a usare le sessioni Devin nella propria organizzazione. Per le persone che appartengono a più organizzazioni, Devin usa prima di tutto la loro organizzazione di lavoro predefinita, che si può scegliere in Settings > Preferences. Se Devin non riesce a selezionare un’organizzazione, chiede alla persona di impostarne una predefinita.

Per l’utente di servizio:

• Un account di servizio Jira con gli ambiti e l’accesso applicativo indicati in Aggiungere un account di servizio, affinché i work item possano essere assegnati a Devin e i commenti di Devin vengano pubblicati come bot.
• Un account amministratore Jira per autorizzare la connessione. Se in seguito lo riconnetti, l’autorizzazione viene aggiornata senza perdere le credenziali dell’account di servizio né i webhook.

​

Fatturazione

Le sessioni avviate da Jira sono normali sessioni Devin. Consumano ACU nell’organizzazione Devin in cui vengono eseguite, alla stessa tariffa delle sessioni avviate dalla web app o da qualsiasi altra integrazione, e rientrano nei limiti di utilizzo di quell’organizzazione. Se l’organizzazione non può avviare nuove sessioni perché ha raggiunto il proprio limite di utilizzo, Devin rifiuta il work item in Jira: nella relativa scheda, nel caso dell’agente Rovo, oppure con un commento, nel caso dell’utente di servizio. L’installazione dell’app è gratuita. L’utilizzo di Devin viene fatturato in base al tuo piano Devin e Devin elabora i contenuti di Jira al di fuori di Atlassian.