Vai al contenuto principale

Documentation Index

Fetch the complete documentation index at: https://docs.devin.ai/llms.txt

Use this file to discover all available pages before exploring further.

Le automazioni ti permettono di collegare eventi esterni — messaggi Slack, webhook GitHub, aggiornamenti dei ticket Linear, pianificazioni e webhook personalizzati — a sessioni di Devin che si avviano automaticamente. Invece di taggare manualmente Devin ogni volta che viene segnalato un bug o che un controllo CI fallisce, definisci il trigger una sola volta e Devin gestisce ogni evento non appena arriva.

​
Concetti fondamentali

Un’automazione ha tre componenti:
ParteCosa fa
TriggerL’evento che attiva l’automazione (ad es. un messaggio su Slack in #bugs, un fallimento della CI su GitHub, una modifica di label in Linear)
CondizioniFiltri facoltativi che restringono il trigger (ad es. attivarla solo quando la label è bug, solo per una repo specifica)
actionCosa fa Devin quando il trigger si attiva: avvia una nuova sessione, invia un messaggio a una sessione esistente oppure agisce come monitor di triage

​
Tipi di azione

ActionDescrizione
Avvia sessioneCrea una nuova sessione Devin con il prompt che definisci. Il payload dell’evento viene incluso automaticamente come contesto.
Invia messaggio alla sessioneInvia un messaggio a una sessione Devin esistente e persistente — utile per inviare eventi a una sessione che mantiene lo stato.
Triage DevinUn Devin persistente che monitora un canale Slack. Analizza ogni messaggio in arrivo, decide cosa richiede attenzione e avvia sub-Devin per gli elementi che richiedono approfondimenti. Per maggiori dettagli, vedi Auto-triage.
Notifica emailTi invia un’email quando viene eseguita l’automazione — a ogni esecuzione, solo in caso di errori o solo in caso di esito positivo.

​
Fonti di attivazione

SourceEvent typesExample use case
SlackNuovo messaggio, reazione aggiuntaFai triage delle segnalazioni di bug in #incidents, aggiungi la reazione 🚨 per avviare un’indagine
GitHubCommento su issue, PR aperta/aggiornata, revisione PR, check run (CI), pushCorreggi automaticamente i fallimenti della CI, rispondi ai commenti /devin sulle issue
LinearIssue creata, etichetta aggiunta, stato modificato, priorità modificata, assegnataFai triage dei bug quando viene aggiunta un’etichetta, implementa i ticket quando vengono assegnati a Devin
PianificazioneRicorrente (basata su cron)Controlli quotidiani degli errori in Sentry, Aggiornamenti settimanali delle dipendenze, smoke test notturni
WebhookRichiesta HTTP in ingressoCollega qualsiasi sistema esterno (PagerDuty, Datadog, Sentry, strumenti personalizzati) a Devin tramite un URL webhook
Una singola automazione può avere più trigger: si combinano con logica OR, quindi l’automazione si attiva quando corrisponde uno qualsiasi dei trigger. Per esempio, puoi avere un’automazione che si attiva sia in caso di fallimento della CI su GitHub sia con una reazione su Slack.

​
Creare un’automazione

​
Dalla pagina delle automazioni

  1. Vai su automazione nella barra laterale
  2. Fai clic su New automation (oppure usa l’input della chat per descrivere in linguaggio naturale ciò che vuoi ottenere — Devin genererà per te la configurazione dell’automazione)
  3. Configura il trigger, le condizioni e l’action
  4. Fai clic su Save

​
Da un template

  1. Vai a Automazioni nella barra laterale
  2. Fai clic su Template in alto a destra
  3. Sfoglia la galleria dei template: ogni template è un’automazione preconfigurata per un flusso di lavoro comune
  4. Fai clic su un template per precompilare l’editor con il trigger, l’action e i limiti consigliati
  5. Personalizza la configurazione (ad es. seleziona il canale Slack o la repo) e salva

​
Uso del linguaggio naturale

Nella pagina delle automazioni, puoi descrivere nel campo di input della chat in basso ciò che vuoi fare — ad esempio: “Quando un controllo CI fallisce su my-org/my-repo, fai in modo che Devin lo corregga ed esegua il push sullo stesso branch.” Devin genererà per te la configurazione dell’automazione, che potrai esaminare e salvare.

​
Configurazione dei trigger

​
Trigger Slack

I trigger Slack si attivano quando viene pubblicato un messaggio o viene aggiunta una reazione in un canale a cui Devin è stato invitato.
  • Messaggio Slack: Si attiva alla pubblicazione di nuovi messaggi in un canale specifico. Devi selezionare il canale durante la configurazione del trigger.
  • Reazione Slack: Si attiva quando a un messaggio viene aggiunta una specifica reazione emoji (ad es. 🚨 per gli incidenti). Puoi filtrare in base al nome della reazione e al canale.
Perché il trigger funzioni, Devin deve essere invitato nel canale Slack. Devi anche aver collegato il tuo account Slack personale in Settings > Integrations > Slack.

​
Trigger di GitHub

I trigger di GitHub si attivano in risposta agli eventi del repository. Devi selezionare un repository specifico per ogni trigger.
  • Commento su issue: Si attiva quando viene pubblicato un commento su una issue di GitHub. In genere viene usato con una condizione starts_with "/devin", così gli utenti possono digitare /devin su qualsiasi issue per attivare Devin.
  • Pull request: Si attiva sugli eventi della PR (apertura, sincronizzazione, ecc.).
  • Review della pull request: Si attiva quando viene inviata una review su una PR.
  • Commento di review della pull request: Si attiva sui singoli commenti di review.
  • Check run (CI): Si attiva quando un controllo CI viene completato. Filtra per conclusion = failure per correggere automaticamente le build non riuscite.
  • Push: Si attiva quando viene eseguito un push su un branch.
Per motivi di sicurezza, le automazioni GitHub funzionano solo con repository privati.

​
Trigger di Linear

I trigger di Linear si attivano in risposta agli eventi relativi alle issue nel tuo workspace Linear connesso. Devi selezionare un team per ogni trigger.
  • Issue creata: Si attiva quando viene creata una nuova issue nel team selezionato.
  • Label aggiunta: Si attiva quando una label viene applicata a un’issue (ad es. bug, devin).
  • Stato modificato: Si attiva quando cambia lo stato di un’issue (ad es. viene spostata in “In Progress”).
  • Priorità modificata: Si attiva quando cambia la priorità di un’issue.
  • Assegnata: Si attiva quando un’issue viene assegnata a qualcuno.

​
Trigger di pianificazione

I trigger di pianificazione si attivano periodicamente in base a regole di ricorrenza standard.
  • Ricorrente: imposta la frequenza (oraria, giornaliera, settimanale) e l’ora. Dietro le quinte, le pianificazioni utilizzano il formato RRULE di iCalendar.
Gli orari vengono visualizzati nel tuo fuso orario locale, ma sono archiviati internamente in UTC.

​
Trigger webhook

I trigger webhook consentono di collegare qualsiasi sistema esterno a Devin tramite un endpoint HTTPS univoco.
  1. Crea un’automazione con un trigger Webhook
  2. Dopo aver salvato, copia l’URL del webhook e il segreto dalla pagina dei dettagli dell’automazione
  3. Configura il tuo sistema esterno (PagerDuty, Datadog, Sentry o qualsiasi strumento personalizzato) in modo che invii richieste HTTP POST a questo URL
  4. Facoltativamente aggiungi un filtro del payload — un pattern regex a cui il corpo della richiesta deve corrispondere affinché l’automazione si attivi
Il payload del webhook viene incluso nel prompt della sessione di Devin come contesto. I payload di dimensioni superiori a 200 KB vengono troncati automaticamente.

​
Configurare le actions

​
Avvia sessione

L’azione più comune. Quando il trigger si attiva, Devin avvia una nuova sessione con il tuo prompt. Il payload dell’evento (ad es. il testo del messaggio di Slack, il corpo del webhook di GitHub o i dettagli del ticket di Linear) viene aggiunto automaticamente al prompt, in modo che Devin abbia il contesto completo. Opzioni:
  • Prompt: Le istruzioni che Devin segue. Scrivilo come faresti con un normale prompt per Devin.
  • Playbook (facoltativo): Usa @playbook-name nel tuo prompt per includere un playbook con istruzioni aggiuntive.
  • Tag (facoltativo): Aggiungi tag alle sessioni create da questa automazione per facilitare il filtraggio.

​
Invia un messaggio a una sessione

Invia un messaggio a una sessione Devin esistente e di lunga durata. Utile quando vuoi che un’unica sessione persistente elabori gli eventi nel tempo, invece di avviare una nuova sessione per ciascun evento. Devi selezionare la sessione di destinazione durante la configurazione di questa action.

​
Triage con Devin (monitor)

Crea una sessione persistente di Devin che monitora un canale Slack. Per tutti i dettagli su questo tipo di action, consulta la guida all’auto-triage.

​
Notifica email

Invia una notifica email quando viene eseguita l’automazione. Scegli quando inviare la notifica:
  • Sempre — a ogni esecuzione
  • In caso di errore — solo quando la sessione non riesce o si verifica un errore
  • In caso di successo — solo quando la sessione si completa correttamente

​
Limiti e protezioni

Le automazioni includono controlli integrati per evitare un utilizzo incontrollato:

​
Limite di ACU

Imposta un budget massimo di ACU (Agent Compute Unit) per ogni sessione avviata da questa automazione. Se Devin raggiunge il limite, la sessione si arresta. In questo modo, una singola esecuzione non può consumare risorse eccessive.

​
Limite di invocazione

Imposta un limite al numero di volte in cui l’automazione può attivarsi entro un intervallo di tempo. Ad esempio, “al massimo 10 invocazioni all’ora” impedisce che un canale Slack particolarmente attivo o una raffica di fallimenti della CI generino decine di sessioni. Entrambi i campi sono facoltativi — se non vengono impostati, l’automazione viene eseguita senza alcun limite.

​
Policy di rete

Puoi abilitare una policy di rete per limitare gli host esterni a cui possono accedere le sessioni dell’automazione. Questo è particolarmente importante per le automazioni che elaborano input utente non attendibile (ad es. messaggi Slack, payload di webhook). Puoi aggiungere domini specifici all’allowlist se Devin deve raggiungere servizi esterni.

​
Integrazioni MCP

Collegare le integrazioni MCP è vivamente consigliato: migliorano notevolmente la qualità delle automazioni, perché consentono a Devin di accedere a dati di runtime come logs, metriche e dettagli sugli errori.
Le automazioni usano le integrazioni MCP per consentire a Devin di accedere a strumenti esterni. Quando crei un’automazione, la sezione Connections mostra quali server MCP sono consigliati e il loro stato di connessione. Ad esempio, il template “Daily Sentry Error Fixes” consiglia Sentry MCP, così Devin può recuperare da Sentry gli errori non risolti. Il template “Datadog Alert Investigation” consiglia Datadog MCP per recuperare metriche e tracce. Abilita i server MCP in Settings > MCP Marketplace prima di creare automazioni che ne hanno bisogno.

​
Accesso agli strumenti di Slack

Per impostazione predefinita, le sessioni di automazione possono leggere e scrivere nei canali Slack coinvolti nel trigger. Puoi concedere l’accesso ad altri canali Slack nella sezione strumenti di Slack dell’editor di automazione. Questa opzione è utile quando Devin deve leggere più canali oltre a quello che ha attivato l’automazione.

​
Attività e monitoraggio

Ogni automazione tiene traccia della cronologia delle proprie invocazioni. Nella pagina dei dettagli dell’automazione, la scheda Activity mostra:
  • Invocazioni recenti con timestamp
  • Se ogni invocazione è riuscita o è stata ignorata
  • Collegamenti alle sessioni Devin create
  • Messaggi di errore per le invocazioni non riuscite
La pagina dell’elenco delle automazioni mostra uno sparkline per ogni automazione, fornendo una panoramica visiva dell’attività degli ultimi 30 giorni.

​
Attivazione e disattivazione

Attiva o disattiva un’automazione in qualsiasi momento dall’elenco delle automazioni o dalla pagina di dettaglio. Le automazioni disattivate smettono di elaborare gli eventi, ma mantengono la configurazione. Quando riattivi un’automazione, l’elaborazione degli eventi riprende immediatamente.

​
Template

Devin include una libreria di template di automazione predefiniti per i flussi di lavoro più comuni:
TemplateCategoriaCosa fa
Triage delle segnalazioni di bug su SlackMonitoraggioMonitora un canale Slack e smista automaticamente le segnalazioni di bug in arrivo
CI Failure FixerCI/CDCorregge automaticamente i controlli CI che non superano la verifica sulle PR
/devin issue fixCI/CDRisponde ai commenti /devin nelle issue di GitHub
SRE Incident ResponseMonitoraggioAnalizza gli incidenti quando viene aggiunta una reazione 🚨
Daily Sentry Error FixesMonitoraggioRecupera ogni giorno i principali errori di Sentry e apre PR con la soluzione
Datadog Alert InvestigationMonitoraggioAnalizza gli alert Datadog pubblicati su Slack
Bug Report TriageTriageSmista i ticket di Linear con l’etichetta bug
Customer Support TriageTriagePrepara bozze di risposta ai messaggi di supporto in Slack
Linear Ticket ImplementationTriageImplementa i ticket con etichetta devin in Linear
Nightly QA & Smoke TestsMaintenanceEsegue test end-to-end ogni notte e apre ticket per le regressioni
Aggiornamenti settimanali delle dipendenzeMaintenanceCerca i package obsoleti e apre PR di aggiornamento
Weekly ChangelogMaintenanceRaccoglie le PR unite in un changelog categorizzato
Sfoglia tutti i template in automazione > Templates nell’app Devin.