Vai al contenuto principale
Cascade è l’agente legacy di Devin Desktop. Devin Desktop non avvia più nuove conversazioni di Cascade e non riapre più quelle precedenti. Le nuove conversazioni vengono avviate con Devin Local.

Panoramica

Cascade di Devin Desktop porta la collaborazione tra persone e AI a un nuovo livello. Prima di Devin Local, Cascade era l’agente locale di Devin Desktop. Cascade non è più disponibile nel selettore dell’agente.
Devin Local e tutti gli altri agenti ACP non sono disponibili quando un workspace è aperto in Modalità con restrizioni.

Terminal

Un’esperienza Terminal potenziata.

Flussi di lavoro

Automatizza le traiettorie ripetitive.

Selezione del modello

Seleziona il modello desiderato dal menu di selezione sotto il campo di input della conversazione di Cascade. Fai clic qui sotto per consultare l’elenco completo dei modelli disponibili e la loro disponibilità nei diversi piani e fasce di prezzo.

Modelli

Disponibilità dei modelli in Devin Desktop.

Cascade Code / Cascade Chat

Cascade offre due modalità principali: Code e Chat. La modalità Code consente a Cascade di creare e modificare il codice della tua codebase, mentre la modalità Chat è ottimizzata per rispondere a domande sulla tua codebase o sui principi generali di programmazione. In modalità Chat, Cascade può proporti nuovo codice che puoi accettare e inserire.

Piani ed elenchi Todo

Cascade dispone di funzionalità di pianificazione integrate che contribuiscono a migliorare le prestazioni nelle attività più lunghe. In background, un agente di pianificazione specializzato perfeziona di continuo il piano a lungo termine, mentre il modello che hai selezionato si concentra sulle azioni a breve termine previste da quel piano. Cascade crea un elenco Todo all’interno della conversazione per monitorare l’avanzamento delle attività complesse. Per modificare il piano, ti basta chiedere a Cascade di aggiornare l’elenco Todo. Cascade può anche aggiornare automaticamente il piano man mano che acquisisce nuove informazioni nel corso di una conversazione, ad esempio una Memoria.

Messaggi in coda

Mentre attendi che Cascade completi l’attività attuale, puoi mettere in coda nuovi messaggi, che verranno eseguiti in ordine al termine dell’attività. Per aggiungere un messaggio alla coda, digitalo mentre Cascade è in esecuzione e premi Enter.
  • Invia subito: premi di nuovo Enter con la casella di testo vuota per inviarlo immediatamente.
  • Elimina: rimuovi un messaggio qualsiasi dalla coda prima che venga inviato

Chiamata agli strumenti

Cascade ha a disposizione diversi strumenti, come Search, Analyze, MCP e il terminale. È in grado di rilevare quali pacchetti e strumenti stai utilizzando, quali devono essere installati e persino di installarli al posto tuo. Ti basta chiedere a Cascade come eseguire il tuo progetto e premere Accept.
Per impostazione predefinita, Cascade può effettuare fino a 40 invocazioni per prompt. Se la traiettoria si interrompe al raggiungimento di questo limite, premi il pulsante continue e Cascade riprenderà da dove si era interrotto. Tuttavia, a causa dei costi della chiamata agli strumenti, ogni continue verrà conteggiato come un nuovo credito di prompt.
Puoi attivare l’impostazione Auto-Continue per fare in modo che Cascade prosegua automaticamente la risposta, anziché fermarsi, quando raggiunge il limite di invocazioni. Questo consumerà uno o più crediti di prompt in base al modello che stai utilizzando. In settings.json, corrisponde all’impostazione devin.autoContinue: 0 o un valore negativo attiva la continuazione automatica, per cui Cascade prosegue senza limiti, mentre un valore positivo (il predefinito è 40) la disattiva, per cui Cascade si ferma al limite di invocazioni e ti chiede se continuare.

Input vocale

Usa l’input vocale per interagire con Cascade tramite la tua voce. Nella sua versione attuale, consente di trascrivere in testo ciò che dici.

Punti di ripristino con nome e ripristini

Puoi annullare le modifiche apportate da Cascade. Ti basta passare il mouse sul prompt originale e fare clic sulla freccia di ripristino a destra, oppure ripristinare direttamente dall’indice. In questo modo tutte le modifiche al codice verranno annullate, riportando la tua codebase allo stato in cui si trovava al passaggio desiderato.
Al momento i ripristini sono irreversibili, quindi fai attenzione!
Puoi anche creare, direttamente dalla conversazione, uno snapshot/punto di ripristino con nome dello stato attuale del tuo progetto, a cui potrai tornare facilmente e da cui potrai ripristinare in qualsiasi momento.

Consapevolezza in tempo reale

Una funzionalità unica di Devin Desktop e Cascade è la consapevolezza in tempo reale delle tue azioni: non serve più includere nel prompt il contesto su ciò che hai fatto in precedenza. Ti basta scrivere a Cascade: «Continua».

Inviare i problemi all’agente

Quando il tuo codice presenta problemi che compaiono nel pannello Problems in fondo all’editor, puoi inviarli all’agente come contesto:
  • Fai clic su Send all to agent in cima al pannello Problems per inviare tutti i problemi attualmente elencati.
  • Fai clic su Send to agent accanto a un file nel pannello Problems per inviare solo i problemi di quel file.

Spiega e correggi

Per qualsiasi errore che incontri nell’editor, ti basta selezionarlo e fare clic su Explain and Fix per farlo correggere a Cascade.

Ignorare i file

Se vuoi che Cascade ignori determinati file, puoi aggiungerli a .devinignore (o al file legacy .codeiumignore) nella root del tuo workspace. In questo modo Cascade non potrà visualizzare, modificare o creare file all’interno dei percorsi indicati. Puoi specificare i percorsi dei file con un formato simile a quello di .gitignore. Per maggiori dettagli, consulta Ignorare i file.

.codeiumignore globale

Per i clienti aziendali che gestiscono più repository, è possibile imporre regole di esclusione su tutti i repository inserendo un file .codeiumignore globale nella cartella ~/.codeium/. Questa configurazione globale si applica a tutti i workspace di Devin Desktop sul tuo sistema e si aggiunge a eventuali file .codeiumignore specifici dei singoli repository.

Integrazione con i linter

Cascade può correggere automaticamente gli errori di lint nel codice generato. Questa funzionalità è attiva per impostazione predefinita, ma puoi disabilitarla facendo clic su Auto-fix nella tool call e poi su disable. Queste modifiche non consumano crediti.
Quando Cascade apporta una modifica allo scopo principale di correggere errori di lint che ha introdotto e rilevato automaticamente, può renderla gratuita, senza addebito di crediti. Questo perché la correzione degli errori di lint aumenta il numero di chiamate agli strumenti effettuate da Cascade.

Condividere la tua conversazione

I collegamenti condivisi alle conversazioni di Cascade non funzionano più. Devin Desktop ha rimosso le pagine di condivisione delle conversazioni di Cascade.

Menzione con @ delle conversazioni precedenti

Puoi anche fare riferimento a conversazioni precedenti all’interno di altre conversazioni tramite una @-mention. In questo caso, Cascade recupererà le informazioni più pertinenti e utili, come i riepiloghi e i punti di ripristino delle conversazioni, oltre alle parti specifiche della conversazione che richiedi. In genere non recupera l’intera conversazione, per non sovraccaricare la finestra di contesto.

Cascade simultanei

Gli utenti possono avere più Cascade in esecuzione contemporaneamente. Puoi passare dall’uno all’altro tramite il menu a discesa in alto a sinistra del pannello Cascade.
Se due Cascade modificano lo stesso file nello stesso momento, le modifiche possono entrare in conflitto e talvolta la seconda non andrà a buon fine.
Se prevedi che due Cascade modifichino file simili, valuta l’uso degli alberi di lavoro per mantenerli isolati.

Flussi di lavoro

I flussi di lavoro consentono agli utenti di definire una serie di passaggi per guidare Cascade nello svolgimento di attività ripetitive, come la distribuzione di un servizio o la risposta ai commenti sulle PR. I flussi di lavoro vengono salvati come file markdown e offrono agli utenti e ai loro team un modo semplice e ripetibile per eseguire i processi chiave. Una volta salvati, i flussi di lavoro possono essere invocati in Cascade tramite un comando slash nel formato /[name-of-workflow].
I flussi di lavoro sono esclusivamente manuali: Cascade non invocherà mai un flusso di lavoro in automatico. Se vuoi che Cascade applichi una procedura in autonomia, usa invece una Skill.
I flussi di lavoro sono specifici di Cascade: Devin Local non li supporta. Migra i tuoi flussi di lavoro alle skill.

Come funziona

In genere, le regole forniscono indicazioni ai modelli linguistici di grandi dimensioni offrendo un contesto persistente e riutilizzabile a livello di prompt. I flussi di lavoro estendono questo concetto fornendo una sequenza strutturata di passaggi o prompt a livello di traiettoria, che guida il modello attraverso una serie di attività o azioni interconnesse.
Per eseguire un flusso di lavoro, basta invocarlo in Cascade con il comando /[workflow-name].
Puoi richiamare altri flussi di lavoro all’interno di un flusso di lavoro!

Ad esempio, /workflow-1 può includere istruzioni come “Call /workflow-2” e “Call /workflow-3”.
Una volta invocato il flusso di lavoro, Cascade elabora in sequenza ogni passaggio definito, eseguendo azioni o generando risposte secondo quanto specificato.

Come creare un flusso di lavoro

Per iniziare a usare i flussi di lavoro, fai clic sull’icona Customizations nel menu a scorrimento laterale in alto a destra in Cascade, quindi apri il pannello Workflows. Qui puoi fare clic sul pulsante + Global o + Workspace per creare un nuovo flusso di lavoro, rispettivamente a livello globale o di workspace. I flussi di lavoro vengono salvati come file Markdown nelle directory .devin/workflows/ (o nella directory legacy .windsurf/workflows/) e contengono un titolo, una descrizione e una serie di passaggi con istruzioni specifiche che Cascade deve seguire.

Rilevamento dei flussi di lavoro

Devin Desktop rileva automaticamente i flussi di lavoro in più posizioni, offrendo un’organizzazione flessibile:
  • Workspace attuale e sottodirectory: tutte le directory .devin/workflows/ (e le directory legacy .windsurf/workflows/) presenti nel tuo workspace attuale e nelle sue sottodirectory
  • Struttura del repository Git: nei repository Git, Devin Desktop risale anche fino alla directory radice Git per cercare flussi di lavoro nelle directory padre
  • Supporto per workspace multipli: quando nello stesso workspace sono aperte più cartelle, i flussi di lavoro vengono deduplicati e mostrati con il percorso relativo più breve

Posizioni di archiviazione dei flussi di lavoro

Quando crei un nuovo flusso di lavoro tramite la UI, questo viene salvato nella directory .devin/workflows/ del tuo workspace attuale, non necessariamente nella directory radice Git. Se hai rifiutato la migrazione per un workspace che contiene ancora una directory .windsurf/, viene invece salvato in .windsurf/workflows/. Per creare un flusso di lavoro globale, usa il pulsante + Global nel pannello dei flussi di lavoro oppure crea il file direttamente in ~/.codeium/windsurf/global_workflows/. Ogni file di flusso di lavoro può contenere al massimo 12000 caratteri.

Generare un flusso di lavoro con Cascade

Puoi anche chiedere a Cascade di generare flussi di lavoro per te! Funziona particolarmente bene con i flussi di lavoro che prevedono una serie di passaggi in un determinato strumento CLI.

Esempi di flussi di lavoro

I flussi di lavoro si prestano a moltissimi casi d’uso, ad esempio:

/address-pr-comments

Questo è un flusso di lavoro che il nostro team usa internamente per gestire i commenti sulle PR:

/git-workflows

Esegui i commit con formati predefiniti e crea pull request con titoli e descrizioni standardizzati tramite i comandi CLI appropriati.

/dependency-management

Automatizza l’installazione o l’aggiornamento delle dipendenze del progetto a partire da un file di configurazione (ad es. requirements.txt, package.json).

/code-formatting

Esegui automaticamente formattatori di codice (come Prettier, Black) e linter (come ESLint, Flake8) al salvataggio dei file o prima del commit, per mantenere uno stile di codice coerente e individuare subito gli errori.

/run-tests-and-fix

Esegui o aggiungi test unitari o end-to-end e correggi automaticamente gli errori per garantire la qualità del codice prima di commit, merge o distribuzione.

/deployment

Automatizza i passaggi per distribuire la tua applicazione in diversi ambienti (sviluppo, staging, produzione), inclusi gli eventuali controlli pre-distribuzione o verifiche post-distribuzione necessari.

/security-scan

Integra e avvia scansioni delle vulnerabilità di sicurezza sulla tua codebase all’interno della pipeline CI/CD o su richiesta.

Flussi di lavoro a livello di sistema (Enterprise)

Le organizzazioni Enterprise possono distribuire flussi di lavoro a livello di sistema, disponibili globalmente in tutti i workspace e non modificabili dagli utenti finali privi di autorizzazioni di amministratore. È la soluzione ideale per applicare a livello di organizzazione processi di sviluppo, procedure di distribuzione e flussi di lavoro di conformità. I flussi di lavoro a livello di sistema vengono caricati da directory specifiche per ciascun sistema operativo. Devin Desktop carica la directory dei flussi di lavoro Devin, se esiste, e ripiega sulla directory legacy dei flussi di lavoro Windsurf solo in caso contrario. Il contenuto delle due directory non viene combinato, quindi, quando crei la directory Devin, spostaci gli eventuali flussi di lavoro legacy: macOS:
Linux/WSL:
Windows:
Inserisci i file dei tuoi flussi di lavoro (in formato .md) nella directory corrispondente al tuo sistema operativo. Il sistema caricherà automaticamente tutti i file .md presenti in queste directory.

Precedenza dei flussi di lavoro

Quando esistono flussi di lavoro con lo stesso nome su più livelli, quelli a livello di sistema hanno la precedenza più alta:
  1. Sistema (priorità più alta) - Flussi di lavoro a livello di organizzazione distribuiti dall’IT
  2. Workspace - Flussi di lavoro specifici del progetto in .devin/workflows/ (o nel percorso legacy .windsurf/workflows/)
  3. Globale - Flussi di lavoro definiti dall’utente in ~/.codeium/windsurf/global_workflows/
  4. Integrato - Flussi di lavoro predefiniti forniti da Devin Desktop
Di conseguenza, se un’organizzazione distribuisce un flusso di lavoro a livello di sistema con un determinato nome, questo esegue l’override di qualsiasi flusso di lavoro del workspace, globale o integrato con lo stesso nome. Nell’interfaccia utente di Devin Desktop, i flussi di lavoro a livello di sistema sono contrassegnati dall’etichetta “Sistema” e non possono essere eliminati dagli utenti finali.
Importante: i flussi di lavoro a livello di sistema devono essere gestiti dal tuo team IT o dal team di sicurezza. Assicurati che i tuoi team interni gestiscano distribuzione, aggiornamenti e conformità secondo le policy della tua organizzazione. A tale scopo puoi usare strumenti e flussi di lavoro standard come la Gestione dei Dispositivi Mobili (MDM) o la Gestione della Configurazione.

Alberi di lavoro

Devin Desktop supporta gli alberi di lavoro git per eseguire attività di Cascade in parallelo senza interferire con il tuo workspace principale. Con gli alberi di lavoro, ogni conversazione di Cascade dispone di una propria sessione, così Cascade può apportare modifiche, eseguire la build e testare il codice senza interferire con il tuo workspace principale. Anche Devin Local può avviare una sessione in un albero di lavoro esistente, scelto tramite il selettore della posizione dell’agente, e riportare le modifiche con il pulsante Merge.

Utilizzo di base degli alberi di lavoro

Il modo più semplice per iniziare a usare gli alberi di lavoro è passare alla modalità “Albero di lavoro” nell’angolo in basso a destra del campo di input di Cascade.
Al momento puoi passare a un albero di lavoro solo all’inizio di una sessione di Cascade. Una volta avviata, una conversazione non può essere spostata in un altro albero di lavoro.
Dopo che Cascade ha modificato i file nell’albero di lavoro, puoi fare clic su “merge” per riportare tali modifiche nel tuo workspace principale.

Posizione

Gli alberi di lavoro sono organizzati per nome del repo all’interno di ~/.windsurf/worktrees/<repo_name>. A ogni albero di lavoro viene assegnato un nome casuale univoco. Per visualizzare l’elenco degli alberi di lavoro attivi, puoi eseguire git worktree list dalla directory del repository.
Poiché gli alberi di lavoro si trovano in una directory diversa da quella del progetto originale, i sistemi di build o gli strumenti che si basano su percorsi relativi (ad es. riferimenti a ../shared-lib, dipendenze collegate tramite collegamento simbolico o dipendenze sorgente di un monorepo risolte tramite percorso) potrebbero non funzionare all’interno di un albero di lavoro. Se il tuo progetto usa percorsi relativi che puntano all’esterno della directory radice del repository, configura un hook post_setup_worktree per creare i collegamenti simbolici necessari o copiare i file richiesti nelle posizioni previste.

Hook di configurazione

Ogni worktree contiene una copia dei file del tuo repository, ma non include i file .env né altri pacchetti non version-controlled. Se vuoi includere file o pacchetti aggiuntivi in ogni worktree, puoi usare l’hook post_setup_worktree per copiarli nella directory del worktree. L’hook post_setup_worktree viene eseguito dopo la creazione e la configurazione di ogni worktree, all’interno della directory del nuovo worktree. La variabile d’ambiente $ROOT_WORKSPACE_PATH punta al percorso del workspace originale e può essere usata per accedere ai file o eseguire comandi a partire dal repository originale.

Esempio

Copia i file dell’ambiente e installa le dipendenze quando viene creato un nuovo worktree. Config (in .windsurf/hooks.json):
Script (hooks/setup_worktree.sh):
Questo hook garantisce che ogni worktree disponga automaticamente della configurazione dell’ambiente necessaria e delle dipendenze richieste.

Pulizia

Devin Desktop elimina automaticamente gli alberi di lavoro meno recenti quando ne crea uno nuovo, per evitare un uso eccessivo dello spazio su disco. Ogni workspace può contenere fino a 20 alberi di lavoro. Gli alberi di lavoro vengono eliminati in base all’ultimo accesso: i meno recenti vengono rimossi per primi. La pulizia avviene separatamente per ogni workspace, così gli alberi di lavoro di repository diversi restano indipendenti tra loro. Inoltre, se elimini manualmente una conversazione di Cascade, Devin Desktop elimina automaticamente l’albero di lavoro associato.

Pannello Controllo del codice sorgente

Per impostazione predefinita, Devin Desktop non mostra nel pannello SCM gli alberi di lavoro creati da Cascade. Per cambiare questo comportamento e visualizzare gli alberi di lavoro nel pannello SCM, imposta git.showDevinWorktrees su true nelle impostazioni.
La vecchia impostazione git.showWindsurfWorktrees è deprecata. Viene ancora rispettata nelle configurazioni esistenti se git.showDevinWorktrees non è impostata, ma d’ora in poi usa git.showDevinWorktrees.