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

# Devin Local

> Usa il Local Agent di Devin in Devin Desktop: il framework dell'agente di Devin CLI con sottoagenti, sandboxing, modalità Plan, alberi di lavoro e autorizzazioni.

Devin Local è il nostro framework dell'agente di nuova generazione, condiviso con [Devin CLI](https://cli.devin.ai).

Viene eseguito sulla tua macchina con accesso a file, strumenti e ambiente locali ed è l'agente locale principale di Devin Desktop.

> [card] [Modalità](https://docs.devin.ai/it/desktop/devin-local/modes.md)
>
> Code, Intelligente, Ask, Plan e Bypass Permissions, e come pianificare prima di implementare.

> [card] [Personalizzazioni](https://docs.devin.ai/it/desktop/devin-local/customizations.md)
>
> Plugin, skill, server MCP, hooks e regole, oltre alla funzionalità che mostra cosa ha caricato una sessione.

> [card] [Autorizzazioni](https://docs.devin.ai/it/desktop/devin-local/permissions.md)
>
> Regole allow, ask e deny, richieste di approvazione e autorizzazioni degli strumenti MCP.

> [card] [Alberi di lavoro](https://docs.devin.ai/it/desktop/devin-local/worktrees.md)
>
> Esegui una sessione in un worktree git ed effettua il merge delle modifiche nel tuo workspace.

## Funzionalità principali

### Efficienza nell'uso dei token

Il Local Agent di Devin è progettato per sfruttare il prompt caching, perciò la maggior parte delle attività richiede meno token per ottenere lo stesso risultato.

### Sottoagenti

Il Local Agent di Devin può avviare [sottoagenti](https://docs.devin.ai/it/cli/subagents.md) indipendenti per gestire attività secondarie, in foreground o in background. I sottoagenti condividono gli strumenti e il contesto della codebase con l'agente principale, ma operano in una catena di conversazione separata.

I sottoagenti si attivano e disattivano con il toggle **Subagents (Preview)** in `Devin Settings`.

Oltre ai profili predefiniti, puoi definire sottoagenti personalizzati come file markdown in `agents/`, utilizzando una delle due strutture seguenti:

* **File singolo** — `agents/<name>.md`, dove il nome del file diventa l'identificatore del profilo.
* **Directory** — `agents/<name>/AGENT.md`, dove il nome della directory diventa l'identificatore del profilo.

Consulta la [documentazione sui sottoagenti](https://docs.devin.ai/it/cli/subagents.md) per sapere in quali posizioni 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 impone:

* **Isolamento del filesystem** — i percorsi scrivibili derivano dai tuoi [ambiti di autorizzazione](https://docs.devin.ai/it/desktop/devin-local/permissions.md) e le regole di negazione `Read(...)` nascondono i percorsi ai comandi eseguiti in sandbox
* **Filtro di rete** — gli elenchi di domini consentiti e le liste di blocco determinano quali destinazioni l'agente può raggiungere

Gli amministratori Enterprise possono imporre il comportamento della sandbox in tutta l'organizzazione tramite le [impostazioni del team](https://cli.devin.ai/docs/enterprise/team-settings#sandbox-enforcement), ad esempio rendendo obbligatoria la modalità sandbox per tutti gli utenti e configurando regole di filtraggio dei domini a livello di organizzazione.

### Quick Review

[Quick Review](https://docs.devin.ai/it/desktop/quick-review.md) è un subagent dedicato, disponibile con il Local Agent di Devin, che consente di ottenere rapidamente feedback sulle modifiche.

## Cambiare agente

Se non hai scelto un agente preferito, le nuove schede si aprono con Devin Local. Se Devin Local non è disponibile per te, la scheda usa il primo [agente ACP](https://docs.devin.ai/it/desktop/acp.md) selezionabile; se non è disponibile alcun agente, mostra la UI predefinita della nuova scheda e attende che ne diventi disponibile uno. Puoi cambiare in qualsiasi momento l'agente per le *nuove* conversazioni tramite il selettore dell'agente nell'angolo in basso a destra di Devin Desktop: Devin Local è selezionabile anche mentre è ancora in fase di connessione.

![](https://mintcdn.com/cognitionai/WE51TvKjsiyk1ZHl/desktop/assets/windsurf/devin-local-agent-switcher.png?fit=max\&auto=format\&n=WE51TvKjsiyk1ZHl\&q=85\&s=5206df1ec64b71ae0463d56f7453aff3)

### Impostazioni dell'agente

Se Devin Local non compare nel selettore dell'agente, potrebbe essere necessario abilitarlo da `Devin Settings`:

1. Apri il riquadro comandi con `Cmd+Shift+P` (macOS) o `Ctrl+Shift+P` (Windows/Linux)
2. Apri `Devin User Settings`
3. Fai clic sulla scheda "Agents"
4. Attiva il toggle dell'agente "Devin Local"
5. Riavvia Devin Desktop

![](https://mintcdn.com/cognitionai/WE51TvKjsiyk1ZHl/desktop/assets/windsurf/devin-local-agent-settings.png?fit=max\&auto=format\&n=WE51TvKjsiyk1ZHl\&q=85\&s=b0f42c5d3d679c55c450fd9067c34303)

### Amministratori Enterprise

Devin Local è un agente incluso nel bundle che Devin Desktop recupera dal server. La sua visibilità nel selettore dell'agente dipende dall'impostazione del team **Local Agent di Devin**:

* Nei piani **Team** e negli altri piani Non-Enterprise è disponibile per impostazione predefinita (a meno che l'accesso non sia stato disabilitato per un singolo membro).
* Nei piani **Enterprise** è attivo per impostazione predefinita e un amministratore può disattivarlo per i membri.

Gli amministratori Enterprise gestiscono questa impostazione dal pannello di controllo delle impostazioni del team:

* **Amministratori di Devin Enterprise**: **Settings → Enterprise → Devin Desktop** (`app.devin.ai/org/{orgName}/settings/desktop`). In **Funzionalità**, usa il toggle **Local Agent di Devin** ("Allow members to use the Local Agent di Devin in Devin Desktop and delegate tasks to Devin's terminal agent via ACP").
* **Amministratori di Windsurf Enterprise**: il [pannello di controllo di Windsurf](https://windsurf.com/team/settings).

Quando questa impostazione è attiva, Devin Local compare nel selettore dell'agente di tutti i membri dopo il riavvio di Devin Desktop. Non serve alcuna configurazione per singolo utente né una [configurazione personalizzata del registro ACP](https://docs.devin.ai/it/desktop/acp.md#team-registry-configuration).

## Modalità con restrizioni

Quando un workspace è aperto in **Modalità con restrizioni**, al suo interno gli agenti non sono disponibili: Devin Local e tutti gli [agenti ACP](https://docs.devin.ai/it/desktop/acp.md) sono disabilitati e gli [hooks](https://docs.devin.ai/it/desktop/devin-local/customizations.md#hooks) non vengono né caricati né eseguiti.

Gli agenti tornano disponibili non appena il workspace esce dalla Modalità con restrizioni.

## 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`](https://docs.devin.ai/it/desktop/accounts/api-reference/cascade-analytics) (utilizzo del modello, messaggi inviati e consumo di crediti), nell'origine dati [`cascade_tool_usage`](https://docs.devin.ai/it/desktop/accounts/api-reference/cascade-analytics) (numero di chiamate per strumento, ad esempio Code Edit, Run Command, Search Web e MCP Tool), nell'origine dati [`cascade_lines`](https://docs.devin.ai/it/desktop/accounts/api-reference/cascade-analytics) (righe di codice scritte quotidianamente dall'agente) e nell'[origine dati Cascade](https://docs.devin.ai/it/desktop/accounts/analytics-api#cascade-data) dell'API Custom Analytics.

Devin Local non tiene traccia delle righe suggerite né delle "modalità": 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](https://devin.ai/blog/self-hosted-deployment-maintenance-mode).

## Controlli Enterprise

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

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](https://cli.devin.ai/docs/reference/permissions) personalizzate offrono un'alternativa più flessibile e possono essere usate per replicare le stesse regole.
* **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** - il Local Agent 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.

## Per approfondire

* [Guida rapida di 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)
* [Impostazioni del team](https://cli.devin.ai/docs/enterprise/team-settings)


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.