Claude Managed Agents self-hosted

Claude Managed Agents self-hosted è Managed Agents sulla tua infrastruttura, che può essere un account cloud o un data center on-premise. Sei tu a ospitare il servizio e le sandbox. Il modello viene eseguito presso Anthropic o presso un provider che scegli tu.

Managed Agents ha due parti che puoi ospitare:

• Sandbox: I container, le VM o altri workspace isolati in cui gli strumenti di un agente eseguono comandi e lavorano sui file. Consulta Sandbox self-hosted.
• Il servizio: L’API, il ciclo dell’agente e l’archiviazione per agenti, sessioni e cronologia delle sessioni.

Le sandbox self-hosted trasferiscono a te la prima parte. Managed Agents self-hosted estende questa configurazione: ospiti anche il servizio. Il nome di ciascuna opzione indica cosa ospiti:

In queste pagine, il servizio ospitato è il servizio così come lo esegue Anthropic, e il tuo server è il servizio così come lo esegui tu, con il proprio database. Entrambi hanno la stessa API, quindi l’SDK e la CLI ant funzionano con il tuo server, e il resto della documentazione di Managed Agents si applica. Differenze rispetto al servizio ospitato elenca le eccezioni.

Quando scegliere Managed Agents self-hosted

Scegli Managed Agents self-hosted quando hai bisogno di una delle seguenti cose:

• Archiviazione sulla tua infrastruttura: Devi archiviare tu stesso agenti, sessioni e cronologia delle sessioni.
• La tua scelta del provider di inferenza: Le chiamate al modello devono essere inviate ad Amazon Bedrock, Claude Models on Google Cloud (Google managed), Microsoft Foundry o al tuo gateway di modelli. Consulta Provider di inferenza.

Se hai bisogno solo che gli strumenti vengano eseguiti sulla tua infrastruttura, usa le sandbox self-hosted, in cui è Anthropic a eseguire il servizio. Consulta Scegliere un ambiente per l’agente.

Con Managed Agents self-hosted, esegui e proteggi un server, il suo database e le tue sandbox, e installi ogni versione tu stesso. Alcune funzionalità esistono solo nel servizio ospitato, quindi controlla Differenze rispetto al servizio ospitato prima di decidere.

Cosa viene eseguito e dove

Uno o più server, il loro database e le tue sandbox costituiscono un deployment.

• Server (cma-server): Fornisce l’API, esegue il ciclo dell’agente e archivia agenti, sessioni e la cronologia di ogni sessione. Chiama il tuo provider di inferenza ogni volta che l’agente ha bisogno del modello. Il server non esegue mai gli strumenti di shell o di file di un agente.
• Database: PostgreSQL 16 o successivo. Senza un database, il server mantiene i propri dati in memoria, e un riavvio li cancella.
• Worker: Programmi che ricevono lavoro dal server ed eseguono gli strumenti di shell e di file dell’agente nelle tue sandbox. Un worker è un comando ant beta:worker o un worker dell’SDK.
• Le tue applicazioni: Il tuo codice e i tuoi script, che raggiungono il server con l’SDK o la CLI ant.
• Console sul tuo server: Una pagina web all’indirizzo del server, dove gli utenti accedono tramite il tuo provider di identità per creare agenti ed eseguire sessioni. Consulta Usare la console sul tuo server.
• CLI di amministrazione (cma-server-admin): Crea gli ambienti e le relative “environment key” (chiavi di ambiente). Viene eseguita su Linux (x86-64 e Arm) e su macOS con Apple silicon.

Le tue responsabilità di sicurezza

Il Modello di sicurezza delle sandbox self-hosted si applica qui, con due differenze. Ciò che quella pagina attribuisce ad Anthropic è tua responsabilità, incluso proteggere il server, ospitare i memory store e rilevare un utilizzo insolito. Quella pagina suggerisce inoltre un workspace e un ambiente separati per ogni confine di fiducia. Qui, ogni livello di fiducia richiede un proprio deployment, come spiega Multitenancy.

Le tre credenziali

Cosa esce dalla tua rete

Per ogni chiamata al modello, il server invia al tuo provider di inferenza la conversazione fino a quel momento, inclusi gli input e i risultati degli strumenti. Per impostazione predefinita, si tratta dell’API di Claude. Una chiamata all’API di Claude include anche gli ID della relativa sessione e dell’agente e dell’ambiente di quella sessione. Dati e accesso in Claude Managed Agents self-hosted elenca ogni connessione effettuata dal server. Indica anche dove vanno i log e chi può raggiungere il server.

Da dove iniziare

Per richiedere l’accesso al download, contatta il tuo team di riferimento Anthropic. Poi segui Iniziare con Claude Managed Agents self-hosted per avviare un server ed eseguire una prima sessione.

L’archivio di ogni release include una guida per l’operatore relativa a quella versione, operator-guide.md. Fai leggere quel file a Claude, in modo che Claude possa aiutarti a configurare ed eseguire il tuo server e a scrivere codice che vi si connette.