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

# Local Agent di Devin

> Usa direttamente in Devin Desktop lo stesso harness dell'agente di Devin CLI.

Devin Local è il nostro harness per agenti di nuova generazione, condiviso con [Devin CLI](https://cli.devin.ai).

Funziona sul tuo computer con accesso ai file, agli strumenti e all'ambiente locali ed è pensato per sostituire gradualmente Cascade come agente locale principale.

<Note>
  Devin Local è attualmente in anteprima e presenta alcune [limitazioni](#limitations) rispetto a Cascade. Devin Local non è supportato nel plugin JetBrains per Devin Desktop.
</Note>

<div id="key-improvements">
  ## Miglioramenti principali
</div>

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.

<div id="token-efficiency">
  ### Efficienza dei token
</div>

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.

<div id="subagents">
  ### Subagents
</div>

Il Local Agent di Devin può generare [subagent](https://cli.devin.ai/docs/subagents) 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.

<div id="sandboxing">
  ### Sandboxing
</div>

Il Local Agent di Devin supporta il sandboxing a livello di sistema operativo. Quando è abilitata, la sandbox applica:

* **Isolamento del filesystem** — i percorsi leggibili e scrivibili sono determinati dai tuoi ambiti di autorizzazione
* **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](https://cli.devin.ai/docs/enterprise/team-settings#sandbox-enforcement), inclusi l'obbligo della modalità sandbox per tutti gli utenti e la configurazione di regole di filtraggio dei domini valide per l'intera organizzazione.

<div id="quick-review">
  ### Quick Review
</div>

[Quick Review](/it/desktop/quick-review) è un subagent dedicato disponibile con Local Agent di Devin per ricevere rapidamente feedback sulle modifiche.

<div id="switching-your-agent">
  ## Cambiare il tuo agente
</div>

Nella maggior parte dei casi, puoi passare a `Devin Local` quando avvii *nuove* conversazioni tramite il selettore dell'agente nell'angolo in basso a destra di Devin Desktop.

<Frame>
  <img src="https://mintcdn.com/cognitionai/WE51TvKjsiyk1ZHl/desktop/assets/windsurf/devin-local-agent-switcher.png?fit=max&auto=format&n=WE51TvKjsiyk1ZHl&q=85&s=5206df1ec64b71ae0463d56f7453aff3" width="844" height="252" data-path="desktop/assets/windsurf/devin-local-agent-switcher.png" />
</Frame>

<div id="agent-settings">
  ### Impostazioni agente
</div>

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

<Frame>
  <img src="https://mintcdn.com/cognitionai/WE51TvKjsiyk1ZHl/desktop/assets/windsurf/devin-local-agent-settings.png?fit=max&auto=format&n=WE51TvKjsiyk1ZHl&q=85&s=b0f42c5d3d679c55c450fd9067c34303" width="1200" height="200" data-path="desktop/assets/windsurf/devin-local-agent-settings.png" />
</Frame>

Puoi anche scegliere di disattivare completamente Cascade con l'impostazione `devin.cascade.enabled`.

<div id="differences">
  ## Differenze
</div>

<div id="permissions-model">
  ### Modello delle autorizzazioni
</div>

Devin Local sostituisce i [livelli di esecuzione automatica](/it/desktop/terminal#auto-execution-levels) 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.

<div id="mcp-permissions">
  ### Autorizzazioni MCP
</div>

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.

<Frame>
  <img src="https://mintcdn.com/cognitionai/awLyB8V-RSMAHpBB/desktop/assets/windsurf/devin-local-mcp-permissions.png?fit=max&auto=format&n=awLyB8V-RSMAHpBB&q=85&s=c10aa13cbe249f0aa4f67d502c25ebf4" width="1300" height="486" data-path="desktop/assets/windsurf/devin-local-mcp-permissions.png" />
</Frame>

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](/it/cli/reference/permissions#tool-based-permissions).

<div id="mcp-server-configuration">
  ### Configurazione del server MCP
</div>

Con Local Agent di Devin, i server MCP si configurano tramite [file di configurazione](https://cli.devin.ai/docs/extensibility/mcp/configuration) sul computer locale.

Il percorso del file dipende dall'ambito:

| Ambito          | Posizione                     | Condiviso con il team?                   |
| --------------- | ----------------------------- | ---------------------------------------- |
| Progetto        | `.devin/config.json`          | Sì (tracciato nel controllo di versione) |
| Override locale | `.devin/config.local.json`    | No (gitignored)                          |
| Utente          | `~/.config/devin/config.json` | No                                       |

<div id="skills">
  ## Skills
</div>

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](https://cli.devin.ai), 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](#limitations)) — basta definire una procedura ripetibile una sola volta e l'agente la invocherà automaticamente quando pertinente.

Consulta la [documentazione delle skills di Devin CLI](/it/cli/extensibility/skills/overview) per maggiori dettagli su come creare, configurare e definirne l'ambito.

<div id="limitations">
  ## Limitazioni
</div>

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](/it/desktop/cascade/skills).
* **Flussi di lavoro** — I flussi di lavoro non sono disponibili con il Local Agent di Devin. Migra i tuoi flussi di lavoro in [skills](/it/desktop/cascade/skills).
* **Codemaps** — Il Local Agent di Devin non legge ancora i [codemaps](/it/desktop/codemaps).
* **Code Lenses** - Attualmente i [code lenses](/it/desktop/command/windsurf-related-features) non attivano ancora il Local Agent di Devin.
* **Fast Context** - Devin Local usa dei subagent per esplorare il codice, ma non ha la stessa UI di contesto rapido di Cascade.
* **deploy dell'app** - Il Local Agent di Devin non supporta i deploy dell'app.
* **Anteprime nel browser** - Il Local Agent di Devin non supporta ancora le [anteprime nel browser](/it/desktop/previews), incluso lo strumento di selezione degli elementi DOM.
* **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](https://cli.devin.ai/docs/extensibility/rules) e [skills](https://cli.devin.ai/docs/extensibility/skills/overview) per fornire contesto persistente e flussi di lavoro riutilizzabili.

<div id="analytics">
  ### Analisi
</div>

Il Local Agent di Devin non riporta ancora tutti i dati di analisi raccolti da Cascade. I seguenti dati vengono raccolti per Cascade ma **non** per Devin Local:

* **Utilizzo degli strumenti** — L'origine dati [`cascade_tool_usage`](/it/desktop/accounts/api-reference/cascade-analytics) (conteggio delle chiamate per strumento, come Code Edit, Run Command, Search Web e MCP Tool) include solo le sessioni di Cascade. Le chiamate agli strumenti effettuate dal Local Agent di Devin non vengono riportate. Per monitorare o limitare l'utilizzo degli strumenti con il Local Agent di Devin, usa invece [hooks](/it/cli/extensibility/hooks/overview) e [autorizzazioni](/it/cli/reference/permissions).
* **Righe suggerite e accettate** — L'origine dati [`cascade_lines`](/it/desktop/accounts/api-reference/cascade-analytics) (righe di codice suggerite e accettate ogni giorno) non include il codice scritto dal Local Agent di Devin.
* **Modalità Write/Read** — Il Local Agent di Devin non riporta una modalità di Cascade, quindi il campo `mode` nell'origine dati `cascade_runs` non viene valorizzato per l'attività di Devin Local.

L'attività di Devin Local è comunque inclusa nell'origine dati [`cascade_runs`](/it/desktop/accounts/api-reference/cascade-analytics) (utilizzo del modello, messaggi inviati e consumo di crediti) e nell'[origine dati Cascade](/it/desktop/accounts/analytics-api#cascade-data) dell'API Custom Analytics.

Devin CLI non riporta dati di analisi per le [distribuzioni ibride](https://devin.ai/blog/self-hosted-deployment-maintenance-mode).

<div id="enterprise-controls">
  ### Controlli Enterprise
</div>

Gli admin Enterprise possono configurare il Local Agent di Devin tramite le [impostazioni del team](https://windsurf.com/team/settings), inclusi i [nuovi controlli disponibili solo con il Local Agent di Devin](https://cli.devin.ai/docs/enterprise/team-settings):

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

<div id="unsupported-enterprise-controls">
  #### Controlli Enterprise precedenti non supportati
</div>

I seguenti controlli Enterprise precedenti non sono disponibili con l’agente locale di Devin:

* **Limitare le chiamate agli strumenti al workspace** - per impostazione predefinita, l’agente locale di Devin può leggere e modificare file solo all'interno del workspace.
  Le [autorizzazioni](https://cli.devin.ai/docs/reference/permissions) 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 l’agente locale di Devin.
* **Condivisione delle conversazioni** - la condivisione delle conversazioni non è ancora supportata con l’agente locale di Devin.
* **Abilitare o disabilitare Cascade per il team** - questa impostazione controlla solo l'agente Cascade precedente e non si applica all’agente locale di Devin o a Devin CLI.
* **Chiamata globale agli strumenti disabilitata** - se in precedenza hai disabilitato completamente la chiamata agli strumenti, scrivi invece una [policy di autorizzazione](https://cli.devin.ai/docs/reference/permissions) 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** - l’agente locale di Devin usa il proprio [modello di autorizzazioni](https://cli.devin.ai/docs/reference/permissions) 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](https://cli.devin.ai/docs/reference/permissions) equivalente per Devin CLI per consentire comandi specifici del terminale.
* **Deny list del Terminal** - implementa una [policy di autorizzazione](https://cli.devin.ai/docs/reference/permissions) equivalente per Devin CLI per bloccare comandi specifici del terminale.

<div id="further-reading">
  ## Per saperne di più
</div>

* [Guida rapida a Devin CLI](https://cli.devin.ai/docs)
* [Comandi essenziali](https://cli.devin.ai/docs/essential-commands)
* [Panoramica sull'estensibilità](https://cli.devin.ai/docs/extensibility)
* [Settings del team](https://cli.devin.ai/docs/enterprise/team-settings)