Scegliere un ambiente per l'agente
Decidi se gli strumenti e il codice di Claude Managed Agents vengono eseguiti in un ambiente cloud gestito da Anthropic o in una sandbox self-hosted, e scopri cosa cambia se passi dall'uno all'altra.
Un ambiente stabilisce dove vengono eseguiti gli strumenti e il codice del tuo agente. Vengono eseguiti in una sandbox. Una sandbox è uno spazio di lavoro isolato, come un container, in cui l'agente esegue comandi e lavora sui file. Hai due opzioni:
- Ambiente cloud: Anthropic esegue la sandbox per te. Ogni sessione ottiene il proprio container Linux nuovo su un'infrastruttura gestita da Anthropic, con linguaggi, database e utilità comuni già installati. Scegli tu le sue regole di rete e gli eventuali pacchetti aggiuntivi da installare.
- Sandbox self-hosted: Esegui la sandbox sulla tua infrastruttura. Claude continua a essere eseguito dal lato di Anthropic e decide quale strumento chiamare successivamente. Un programma che esegui tu, chiamato "worker" (processo di lavoro), esegue le chiamate agli strumenti bash e file dell'agente sulle tue macchine e restituisce ogni risultato. Può anche servire strumenti personalizzati.
La definizione dell'agente è la stessa qualunque opzione tu scelga. Imposti il modello, il prompt e gli strumenti sull'agente, non sull'ambiente.
Inizia con un ambiente cloud
Se non sei sicuro di quale scegliere, o se usi Claude Managed Agents per la prima volta, inizia con un ambiente cloud, come fa la guida rapida. Anthropic esegue un container isolato per ogni sessione, con linguaggi e strumenti comuni già installati, quindi non devi ospitare nulla. Scegli una sandbox self-hosted solo se gli strumenti devono essere eseguiti su un'infrastruttura che controlli.
Confronta le opzioni
La tabella confronta le due opzioni.
| Ambiente cloud (predefinito) | Sandbox self-hosted | |
|---|---|---|
| Dove vengono eseguiti strumenti e codice | Una sandbox gestita da Anthropic | Il tuo worker, sulla tua infrastruttura |
| Cosa raggiunge Anthropic | La cronologia della conversazione, i risultati degli strumenti, i file e lo stato della sandbox, le skill e i memory store | La cronologia della conversazione, i risultati degli strumenti, le skill e i memory store. I file e i processi della sandbox restano sul tuo worker. |
| Cosa gestisci tu | Nulla | Gli host dei worker, il loro hardening, i loro limiti di rete e la chiave dell'ambiente con cui il tuo worker si autentica |
| Accesso alla rete | Regole di rete che imposti sull'ambiente | La tua policy di rete |
| Montaggio di file e repository GitHub | Gestito da Anthropic | Gestito da te |
| Memory store | Montati da Anthropic in /mnt/memory/ | Scaricati in /mnt/memory/ e sincronizzati dal worker |
| Ciclo di vita della sandbox | Gestito da Anthropic | Gestito da te |
| Scegli questa opzione quando | È l'opzione predefinita. Non hai bisogno che gli strumenti vengano eseguiti sulla tua infrastruttura. | Gli strumenti devono essere eseguiti su un'infrastruttura che controlli. |
Quando scegliere una sandbox self-hosted
Una sandbox self-hosted è adatta quando l'agente deve fare una delle seguenti cose:
- Lavorare su dati che non possono lasciare la tua rete: I file e i processi dell'agente restano sul tuo worker. Ciò che uno strumento restituisce al modello raggiunge comunque il servizio Managed Agents.
- Raggiungere servizi interni non instradabili pubblicamente: Gli strumenti bash e file dell'agente, e qualsiasi strumento personalizzato servito dal tuo worker, vengono eseguiti all'interno della tua rete. È Anthropic, non il tuo worker, a connettersi ai server MCP dell'agente. Uno privato potrebbe trovarsi davanti al tuo sistema di ticketing interno o al wiki aziendale. Per raggiungerlo, puoi usare un tunnel MCP con entrambe le opzioni. I tunnel MCP sono in anteprima di ricerca e per usarli occorre richiedere l'accesso. Consulta Sandbox self-hosted e tunnel MCP.
- Operare sotto i controlli di conformità e audit della tua organizzazione: Gli strumenti vengono eseguiti su host di cui gestisci tu configurazione, log e audit.
Cosa non cambia con una sandbox self-hosted
Con entrambe le opzioni, la cronologia della conversazione e i risultati degli strumenti vanno al servizio Managed Agents, gestito da Anthropic. È così che il modello riceve il risultato di ogni chiamata a uno strumento. Anche gli strumenti di ricerca web e recupero web vengono eseguiti dal lato di Anthropic, non nella sandbox. Consulta Limitare i domini di web search e web fetch. Nessuna delle due opzioni cambia la copertura di conformità di Managed Agents o per quanto tempo conserva la cronologia della conversazione. Consulta API e conservazione dei dati.
Cosa ti assumi e a cosa rinunci con una sandbox self-hosted
Una sandbox self-hosted ti rende l'operatore degli host dei worker. Esegui l'hardening dell'immagine della sandbox, controlli il traffico di rete in uscita, archivi e ruoti la chiave dell'ambiente e isoli le sessioni l'una dall'altra. La pagina Modello di sicurezza contiene i dettagli.
Rinunci inoltre a queste funzionalità dell'ambiente cloud:
- Risorse della sessione
fileegithub_repository. Prepari tu i file di input e sei responsabile anche del montaggio del tuo repository GitHub. - Rilevamento delle skill dal repository.
- Credenziali di tipo variabile d'ambiente nei vault.
- I runtime e pacchetti preinstallati di una sandbox cloud. Una sandbox self-hosted dispone di ciò che fornisce il tuo worker.
Differenze su Claude Platform on AWS
Se usi Claude Managed Agents tramite Claude Platform on AWS, Anthropic continua a gestire il servizio. Lì, una sandbox self-hosted non può usare i memory store, i worker non usano una chiave dell'ambiente e i tunnel MCP non sono disponibili. Consulta Claude Managed Agents su Claude Platform on AWS e Funzionalità non supportate.
Passa da un ambiente cloud a una sandbox self-hosted
Per passare a una sandbox self-hosted, mantieni l'agente, crea un ambiente self_hosted e fai riferimento al suo ID nelle nuove sessioni e nei nuovi deployment.
- Cosa viene mantenuto: La definizione dell'agente, la chiave API o le credenziali AWS usate dalla tua applicazione, le tue skill, i tuoi server MCP e i tuoi memory store.
- Cosa è nuovo: Un ambiente
self_hosted, una chiave dell'ambiente che generi nella Claude Console e un worker che esegui tu. La guida rapida alle sandbox self-hosted copre tutti e tre. - Cosa smette di funzionare: Le funzionalità elencate in Cosa ti assumi e a cosa rinunci con una sandbox self-hosted.
Su Claude Platform on AWS, i memory store non vengono trasferiti a una sandbox self-hosted e il worker non usa una chiave dell'ambiente. Consulta Differenze su Claude Platform on AWS.
Was this page helpful?