Vai al contenuto principale

​
Configurare l’integrazione

  1. Nel tuo account Devin su app.devin.ai, vai a Settings > Integrations > Jira e fai clic su “Connect”.
  2. Verrai reindirizzato a Jira per esaminare le autorizzazioni e concedere l’accesso a Devin.
  3. Una volta collegato, configura le etichette del playbook e, facoltativamente, imposta i trigger di automazione nella pagina delle impostazioni.
Dopo il collegamento, consigliamo di collegare un account di servizio in modo che i commenti di Devin vengano visualizzati come provenienti dal bot, e non dal tuo account personale. Vedi Collegare un account di servizio qui sotto.

​
Come avviare Devin da Jira

Esistono quattro modi per avviare una sessione di Devin da un ticket Jira:

​
Assegna il ticket a Devin

Assegna il ticket direttamente all’account di servizio di Devin in Jira. Devin utilizzerà il playbook predefinito configurato nelle impostazioni dell’integrazione Jira per iniziare a lavorare sul ticket.

​
Aggiungi un’etichetta del playbook

Aggiungi al ticket un’etichetta del playbook (ad es. !plan, !implement, !triage). Devin avvierà una sessione con il playbook specifico corrispondente all’etichetta. Queste etichette corrispondono alle etichette del playbook configurate nelle Settings dell’integrazione. Devi creare queste etichette manualmente nel tuo progetto Jira: copia il nome dell’etichetta dalle Settings dell’integrazione.

​
Aggiungi l’etichetta “devin”

Aggiungi l’etichetta devin a qualsiasi issue di Jira (potresti dover creare prima questa etichetta nel tuo progetto Jira). Devin userà il playbook predefinito per iniziare a lavorare sul ticket.
L’integrazione usa una corrispondenza basata sui confini di parola (senza distinzione tra maiuscole e minuscole), quindi qualsiasi etichetta che contiene devin come parola autonoma la attiverà — per esempio, devin, Devin, devin-workshop o devin-task. Le etichette in cui “devin” fa parte di una parola più lunga, come devinworkshop o devin_workshop, non la attiveranno.

​
Menziona @Devin in un commento

Menziona @Devin in un commento del ticket con istruzioni specifiche. Devin avvierà una sessione e userà il tuo commento come istruzione per l’attività, senza applicare un playbook. Se per il ticket esiste già una sessione, il tuo messaggio verrà inoltrato a quella sessione.

​
Configurazione dell’integrazione

​
Modalità della sessione

L’interruttore della modalità della sessione controlla come Devin risponde ai trigger di Jira:
  • Creazione diretta della sessione (abilitata per impostazione predefinita): Devin crea una sessione completa e lavora sul ticket, pubblicando aggiornamenti in Jira.
  • Solo analisi preliminare (disattivata): Devin si limita ad analizzare il ticket e pubblica un commento di analisi preliminare con un riepilogo, un piano di implementazione e una stima del livello di confidenza. Puoi quindi fare clic sul collegamento fornito per avviare manualmente una sessione.

​
Etichette dei playbook

Le etichette dei playbook ti permettono di controllare quali playbook di Devin sono disponibili come etichette in Jira. Quando aggiungi un playbook, la sua macro (ad es. !plan) diventa un’etichetta che puoi assegnare agli issue di Jira per attivare Devin con quel playbook. Le etichette devono essere create manualmente nel tuo progetto Jira: copia il nome dell’etichetta dalle impostazioni dell’integrazione.
  • Playbook predefinito: un playbook è contrassegnato come predefinito. Quando un issue viene attivato senza un’etichetta di playbook specifica (ad es. solo con l’etichetta devin o assegnando l’issue a Devin), Devin usa questo playbook predefinito.
  • Aggiunta di playbook: fai clic su “Add playbook” per aggiungere altri playbook. Si possono aggiungere solo i playbook che hanno una macro.
  • Rimozione di playbook: rimuovi un playbook per fare in modo che la sua etichetta non venga più usata come trigger.

​
Trigger di automazione

I trigger di automazione consentono a Devin di iniziare automaticamente a lavorare sui ticket quando soddisfano determinate condizioni, senza assegnazioni o etichette manuali. Puoi configurare i trigger in base a:
  • Projects: si attivano solo per i ticket in specifici progetti Jira.
  • Labels: si attivano solo quando un ticket ha etichette specifiche.
  • Statuses: si attivano solo quando un ticket raggiunge uno stato specifico (ad es. “Da fare”, “In corso”).
  • Playbook: facoltativamente, specifica quale playbook Devin deve usare per la sessione attivata.
I trigger usano il rilevamento delle transizioni, il che significa che si attivano solo quando un ticket passa da non corrispondere a corrispondere alle condizioni del trigger (ad es. quando viene aggiunta un’etichetta o cambia lo stato), non per i ticket che corrispondono già.

​
Enterprise: mappatura dei progetti Jira

Per le distribuzioni Enterprise con più organizzazioni Devin, gli amministratori possono associare i progetti Jira a organizzazioni Devin specifiche. Questo garantisce che i ticket di ciascun progetto Jira vengano instradati all’organizzazione Devin corretta. Perché l’integrazione con Jira funzioni nelle configurazioni Enterprise, è necessaria una mappatura.

​
Interagire con Devin in Jira

Una volta che Devin inizia a lavorare su un ticket, comunica tramite Jira:
  • Collegamenti alla PR: Quando Devin crea una pull request, l’URL della PR viene aggiunto automaticamente come collegamento remoto all’issue di Jira e pubblicato anche in un commento.
  • Collegamento alla sessione: Viene fornito un collegamento diretto alla sessione di Devin nell’app web, così puoi seguirne i progressi in tempo reale.
  • Messaggi di follow-up: Menziona @Devin in un commento per dare a Devin istruzioni aggiuntive o fare domande.

​
Collegamento di un account di servizio

Dopo aver collegato Jira con il tuo account amministratore, puoi facoltativamente collegare un account di servizio utilizzando le credenziali client OAuth 2.0. In questo modo, i commenti di Devin verranno visualizzati con un’identità bot dedicata anziché con il tuo account personale.
  1. Nelle impostazioni amministrative della tua organizzazione Atlassian, crea un account di servizio OAuth 2.0 con i seguenti ambiti classici:
    • read:me
    • read:jira-user
    • read:jira-work
    • write:jira-work
  2. In Settings > Integrations > Jira, fai clic su Collega account di servizio e inserisci il client ID e il client secret.