Devin Local è il nostro harness dell’agente di nuova generazione, condiviso con Devin CLI.
Funziona sul tuo computer con accesso ai file, agli strumenti e all’ambiente locali ed è l’agente locale principale per Devin Desktop.
Hai usato Cascade in precedenza? Esegui il comando Devin: Open Cascade Migration Wizard dalla command palette per trasferire i tuoi flussi di lavoro e le tue memorie in un unico flusso guidato.
Devin Settings.
Oltre ai profili integrati, puoi definire i tuoi subagent come file Markdown in agents/ utilizzando uno dei due layout:
- File singolo —
agents/<name>.md, in cui il nome del file diventa l’identificatore del profilo.
- Directory —
agents/<name>/AGENT.md, in cui il nome della directory diventa l’identificatore del profilo.
Consulta la documentazione sui subagent per sapere dove vengono individuate queste directory e come configurare un profilo.
Il Local Agent di Devin supporta il sandboxing a livello di sistema operativo. Quando è abilitata, la sandbox applica:
- Isolamento del filesystem — i percorsi scrivibili sono determinati dai tuoi ambiti di autorizzazione e le regole deny
Read(...) nascondono i percorsi ai comandi eseguiti nella sandbox
- Filtraggio di rete — allowlist e denylist di domini controllano ciò che l’agente può raggiungere
Gli amministratori Enterprise possono imporre il comportamento della sandbox in tutta l’organizzazione tramite le Settings del team, inclusi l’obbligo della modalità sandbox per tutti gli utenti e la configurazione di regole di filtraggio dei domini valide per l’intera organizzazione.
Quick Review è un subagent dedicato disponibile con Local Agent di Devin per ricevere rapidamente feedback sulle modifiche.
Le nuove schede utilizzano Devin Local se non hai scelto un agente preferito (con Cascade come alternativa se Devin Local non è disponibile). Puoi cambiare l’agente per le nuove conversazioni in qualsiasi momento tramite il selettore degli agenti nell’angolo in basso a destra di Devin Desktop: Devin Local è selezionabile anche mentre è ancora in fase di connessione.
Se Devin Local non appare nel selettore degli agenti, potrebbe essere necessario abilitarlo da Devin Settings:
- Apri la Command Palette con
Cmd+Shift+P (macOS) o Ctrl+Shift+P (Windows/Linux)
- Apri
Devin User Settings
- Fai clic sulla scheda “Agents”
- Attiva l’agente “Devin Local”
- Riavvia Devin Desktop
Puoi anche scegliere di disattivare completamente Cascade con l’impostazione devin.cascade.enabled.
Amministratori Enterprise
- Nei piani Team e negli altri piani non Enterprise è disponibile per impostazione predefinita (a meno che questo accesso non sia disabilitato per un singolo membro).
- Nei piani Enterprise è soggetto a restrizioni, quindi un admin deve abilitarlo per i membri.
Gli amministratori Enterprise gestiscono questa impostazione dalla dashboard delle Settings del team:
- Admin di Devin Enterprise — Settings → Enterprise → Windsurf (
app.devin.ai/org/{orgName}/settings/windsurf). In Features, abilita Local Agent di Devin (“Consenti ai membri di usare il Local Agent di Devin in Devin Desktop e di delegare attività all’agente Terminal di Devin tramite ACP”).
- Admin Enterprise di Windsurf — la dashboard di Windsurf.
Una volta abilitato, Devin Local compare nel selettore degli agenti per tutti i membri dopo aver riavviato Devin Desktop — non è richiesta alcuna configurazione per utente né una configurazione personalizzata dell’ACP registry.
Devin Local dispone di modalità proprie, distinte dalle modalità di Cascade. Poiché condivide l’harness dell’agente con Devin CLI, utilizza le stesse modalità dell’agente (Normal, modalità Plan e Ask) e le stesse modalità di autorizzazione. Consulta i comandi essenziali per l’elenco completo delle modalità e degli slash command per passare dall’una all’altra.
La modalità Plan è una modalità di ricerca in sola lettura: l’agente esamina il tuo codebase, definisce un approccio e chiede la tua approvazione prima di implementare qualsiasi modifica.
Il piano viene scritto in un file Markdown persistente in ~/.devin/plans/plan-<session>.md, così puoi modificarlo, riprenderlo in seguito o passarlo a una nuova sessione.
Includi la parola chiave megaplan (funzionano anche ultraplan e masterplan) nel prompt per passare la sessione alla modalità Plan e fare in modo che l’agente pianifichi in modo molto più approfondito: prima di scrivere il piano, pone almeno una domanda di chiarimento.
- Nuovo worktree — Devin Desktop crea un nuovo worktree per la sessione.
- Worktree esistente — selezionane uno già esistente dal sottomenu Local del selettore.
Quando l’agente ha terminato, fai clic su Merge nella sessione per riportare nel workspace le modifiche apportate nel worktree.
I worktree sono condivisi con le sessioni Cascade, inclusi la relativa posizione su disco e il comportamento di pulizia — consulta worktree. Con Plugin qui si intendono i plugin agente di Devin: bundle installabili che aggiungono skill, regole, hook, server MCP e subagent all’agente. Consulta plugin.Non sono correlati ai Plugin Windsurf, che portano Devin in JetBrains, VS Code e altri editor, né alle estensioni dell’editor installate all’interno di Devin Desktop: entrambi estendono l’IDE anziché l’agente. Modello delle autorizzazioni
- Le regole Deny bloccano completamente le azioni (priorità massima)
- Le regole Ask richiedono sempre l’approvazione
- Le regole Allow approvano automaticamente le azioni senza chiedere conferma
Le autorizzazioni possono applicarsi alla lettura di file, alla scrittura di file, all’esecuzione di comandi, alle richieste HTTP e agli strumenti MCP. Possono essere configurate a livello di progetto, utente o organizzazione. Consulta autorizzazioni per la sintassi delle regole.
Le regole di autorizzazione scritte con glob (ad esempio Read(**/*.pem)) trovano corrispondenza in ogni directory del workspace nella sessione, incluse le directory aggiunte dopo il suo avvio.
Rispondere alle richieste di autorizzazione
- Modificare il comando — fai clic sul comando nella scheda per modificarlo prima di approvarlo. L’azione con la bacchetta magica ti consente di descrivere in linguaggio naturale la modifica desiderata e usa un modello rapido per riscrivere il comando, che potrai poi esaminare.
- Scorciatoie da tastiera — approva, consenti sempre o rifiuta una richiesta senza usare il mouse. Le scorciatoie sono indicate sui pulsanti e nelle voci dei menu a discesa.
- Autorizzazioni valide per l’intera sessione — un’approvazione concessa per la sessione si applica a tutte le richieste successive nella stessa sessione, quindi l’agent principale e i suoi subagent non richiederanno nuovamente l’approvazione per un ambito già autorizzato.
A differenza di Cascade, la configurazione predefinita del Local Agent di Devin chiede l’approvazione prima di usare qualsiasi strumento MCP. Quando l’agente vuole invocare uno strumento MCP, puoi autorizzare quello specifico strumento o tutti gli strumenti di quel server MCP, per la sessione corrente o in modo permanente.
Gli amministratori Enterprise possono autorizzare per impostazione predefinita server MCP o strumenti specifici, in modo che le integrazioni attendibili non chiedano l’approvazione ogni volta. Per sapere come configurare queste regole, vedi autorizzazioni basate sugli strumenti.
Quando le credenziali OAuth salvate di un server scadono, lo stato Autenticazione necessaria viene visualizzato nell’elenco MCP di Devin Local, nella relativa scheda del marketplace e nella pagina dei dettagli del server.
Fai clic su Autentica per rimuovere le credenziali salvate e ripetere il flusso di autorizzazione nel browser.
Configurazione del server MCP
- Memorie — Il Local Agent di Devin non conserva le memorie tra una sessione e l’altra. Migra le memorie critiche in skills con il comando Devin: Open Cascade Migration Wizard.
- Flussi di lavoro — I flussi di lavoro non sono disponibili con il Local Agent di Devin. Migra i tuoi flussi di lavoro in skills con il comando Devin: Open Cascade Migration Wizard.
- Code Lenses - Attualmente i code lenses non attivano ancora il Local Agent di Devin.
- deploy dell’app - Il Local Agent di Devin non supporta i deploy dell’app.
- Condivisione delle conversazioni - La condivisione delle conversazioni non è ancora disponibile con il Local Agent di Devin.
Il Local Agent di Devin supporta regole e file AGENTS.md e skills per fornire contesto persistente e flussi di lavoro riutilizzabili.
L’attività di Devin Local viene riportata nell’origine dati cascade_runs (utilizzo del modello, messaggi inviati e consumo di crediti), nell’origine dati cascade_tool_usage (numero di chiamate per strumento, ad esempio Code Edit, Run Command, Search Web e MCP Tool), nell’origine dati cascade_lines (righe di codice scritte quotidianamente dall’agente) e nell’origine dati Cascade dell’API Custom Analytics.
A differenza di Cascade, Devin Local non tiene traccia di righe suggerite specifiche né delle “modalità” operative: una modifica viene eseguita solo dopo la tua approvazione, quindi le righe accettate corrispondono a quelle suggerite e il campo mode in cascade_runs non viene popolato.
Devin CLI non riporta dati di analisi per le distribuzioni ibride.
Gli admin Enterprise possono configurare il Local Agent di Devin tramite le impostazioni del team, inclusi i nuovi controlli disponibili solo con il Local Agent di Devin:
- Applicazione della sandbox - Richiedere la modalità sandbox per tutti gli utenti e configurare regole di filtro dei domini a livello di organizzazione
- Autorizzazioni granulari - Controllare quali azioni può eseguire l’agente con autorizzazioni più specifiche
- Controllo della rete - Controllare l’accesso alla rete con domini consentiti e negati
Inoltre, il controllo “Enable Cascade” può essere usato per disabilitare completamente il precedente agente Cascade e garantire che il tuo team utilizzi i nuovi controlli disponibili con Devin CLI.
Controlli Enterprise precedenti non supportati
- Limitare le chiamate agli strumenti al workspace - per impostazione predefinita, il Local Agent di Devin può leggere e modificare file solo all’interno del workspace.
Le autorizzazioni personalizzate offrono un’alternativa più flessibile e possono essere usate per replicare le stesse regole.
- Deploy dell’app - i deploy dell’app non sono ancora supportati con il Local Agent di Devin.
- Condivisione delle conversazioni - la condivisione delle conversazioni non è ancora supportata con il Local Agent di Devin.
- Chiamata globale agli strumenti disabilitata - se in precedenza hai disabilitato completamente la chiamata agli strumenti, scrivi invece una policy di autorizzazione equivalente per Devin CLI.
I seguenti controlli precedenti continueranno comunque a essere applicati come fallback se non hai ancora implementato una configurazione Enterprise delle autorizzazioni CLI:
- Esecuzione automatica dei comandi del Terminal - il Local Agent di Devin usa il proprio modello di autorizzazioni invece dei livelli di esecuzione automatica; consigliamo di usare questo modello, ma il vecchio controllo continuerà comunque a essere applicato come fallback.
- Allowlist del Terminal - implementa una policy di autorizzazione equivalente per Devin CLI per consentire comandi specifici del terminale.
- Deny list del Terminal - implementa una policy di autorizzazione equivalente per Devin CLI per bloccare comandi specifici del terminale.
