Local Agent di Devin

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.

​

Miglioramenti principali

Dal lancio iniziale di Cascade, le capacità dei modelli si sono evolute notevolmente. Devin Local è stato sviluppato da zero per sfruttare in modo efficiente questi progressi.

​

Efficienza dei token

Il Local Agent di Devin è significativamente più efficiente nell’uso dei token, con una maggiore enfasi sul caching dei prompt. La maggior parte delle attività richiede fino al 30% di token in meno rispetto a Cascade per ottenere lo stesso risultato.

​

Subagents

Il Local Agent di Devin può generare subagent indipendenti per gestire sottoattività, sia in primo piano sia in background. I subagent condividono gli strumenti e il contesto della codebase con l’agente principale, ma operano nella propria conversazione. I subagent sono controllati dal toggle Subagents (anteprima) in 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.

​

Sandboxing

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

Quick Review è un subagent dedicato disponibile con Local Agent di Devin per ricevere rapidamente feedback sulle modifiche.

​

Cambiare il tuo agente

Le nuove schede utilizzano Devin Local se non hai scelto un agente preferito. Se Devin Local non è disponibile, la scheda utilizza il primo agente ACP selezionabile e, se nessun agente è disponibile, mostra l’interfaccia predefinita della nuova scheda e attende finché non ce n’è uno. Le nuove conversazioni non iniziano mai su Cascade, ma le tue conversazioni Cascade esistenti restano disponibili dalla cronologia e dalla barra laterale. 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.

​

Impostazioni agente

Se Devin Local non appare nel selettore degli agenti, potrebbe essere necessario abilitarlo da Devin Settings:

1. Apri la Command Palette con Cmd+Shift+P (macOS) o Ctrl+Shift+P (Windows/Linux)
2. Apri Devin User Settings
3. Fai clic sulla scheda “Agents”
4. Attiva l’agente “Devin Local”
5. Riavvia Devin Desktop

​

Amministratori Enterprise

Devin Local è un agente incluso che Devin Desktop scarica dal server. La sua presenza nel selettore degli agenti è controllata dall’impostazione del team Local Agent di Devin:

• 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:

• Amministratori Enterprise di Devin — Settings → Enterprise → Devin Desktop (app.devin.ai/org/{orgName}/settings/desktop). 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”).
• Amministratori 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.

​

Modalità

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.

​

Modalità Plan

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.

​

Sessioni worktree

Puoi eseguire una sessione Devin Local all’interno di un worktree Git, in modo che l’agente possa modificare, compilare ed eseguire test senza intervenire sul workspace principale. Quando avvii una sessione, seleziona la posizione dal selettore della posizione dell’agente:

• 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.

​

Personalizzazioni

La sezione Personalizzazioni elenca tutto ciò che una sessione Devin Local ha caricato — regole, skill, hook, server MCP e plugin — nonché ciò che sono disponibili nel repository, nell’organizzazione e nell’account. Puoi aprirla selezionando Apri personalizzazioni dal menu della nuova scheda in uno spazio agente oppure dal menu contestuale di una sessione Devin Local nella barra laterale dell’agente.

​

Modalità con restrizioni

Quando un workspace è aperto in Modalità con restrizioni, al suo interno gli agenti non sono disponibili: Cascade, Devin Local e tutti gli agenti ACP sono disabilitati e gli hook non vengono né caricati né eseguiti. Gli agenti tornano disponibili quando il workspace non è più in Modalità con restrizioni.

​

Differenze

​

Modello delle autorizzazioni

Devin Local sostituisce i livelli di esecuzione automatica con un sistema di autorizzazioni più granulare per controllare quali azioni l’agente può eseguire:

• 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

Quando l’agent richiede un’approvazione, la scheda della richiesta offre diverse modalità di risposta:

• 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.

​

Autorizzazioni MCP

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.

​

Riautenticazione MCP

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

Con Local Agent di Devin, i server MCP si configurano tramite file di configurazione sul computer locale. Il percorso del file dipende dall’ambito:

​

Skills

Le skills sono pacchetti riutilizzabili di istruzioni richiamati dal modello (ed eventuali script) che estendono le capacità del Local Agent di Devin. Poiché Devin Local condivide lo stesso harness dell’agente di Devin CLI, utilizza lo stesso formato delle skills e lo stesso meccanismo di rilevamento. Le skills sono anche il modo consigliato per migrare le memorie e i flussi di lavoro di Cascade, che non sono supportati dal Local Agent di Devin (vedi Limitazioni) — basta definire una procedura ripetibile una sola volta e l’agente la invocherà automaticamente quando pertinente. Consulta la documentazione delle skills di Devin CLI per maggiori dettagli su come creare, configurare e definirne l’ambito.

​

Limitazioni

Il divario riguarda entrambi i lati: plugin e subagent non hanno alcun equivalente in Cascade, mentre le release recenti hanno portato la modalità di pianificazione e le sessioni di worktree con merge allo stesso livello di Cascade. L’elenco seguente riguarda le funzionalità di Cascade che questo agente non ha ancora. Le seguenti funzionalità non sono attualmente supportate con il Local Agent di Devin:

• 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.
• deploy dell’app - Il Local Agent di Devin non supporta i deploy dell’app.
• Arena Mode - La Arena Mode non è 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. È supportata anche la condivisione delle conversazioni. In Devin Desktop, scegli Share conversation dal menu delle azioni sotto un turn completato; in Devin CLI o in un altro client ACP, esegui /share. L’agente carica un transcript ripulito (segreti oscurati, prompt di sistema e definizioni degli strumenti rimossi) e restituisce un collegamento da condividere con il tuo team. La condivisione è disponibile solo se la tua organizzazione consente la condivisione delle conversazioni, se hai effettuato l’accesso con un account Devin (non un account solo Windsurf) e se il client supporta la condivisione.

​

Analisi

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.

​

Controlli Enterprise

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

Il controllo della condivisione delle conversazioni dell’organizzazione viene rispettato: quando la condivisione è disabilitata per l’organizzazione, il Local Agent di Devin non propone né Share conversation né /share. 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

I seguenti controlli Enterprise precedenti non sono disponibili con il Local Agent di Devin:

• 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.
• 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.

​

Per saperne di più

• Guida rapida a Devin CLI
• Comandi essenziali
• Panoramica sull’estensibilità
• Settings del team