Panoramica di Claude Managed Agents
Harness per agenti predefinito e configurabile, eseguito su un'infrastruttura gestita. Ideale per attività di lunga durata e lavoro asincrono.
Anthropic offre due modi per sviluppare con Claude, ciascuno adatto a casi d'uso diversi:
| Messages API | Claude Managed Agents | |
|---|---|---|
| Cos'è | Accesso diretto al prompting del modello | Harness per agenti preconfigurato e personalizzabile che viene eseguito su un'infrastruttura gestita |
| Ideale per | Loop di agenti personalizzati e controllo granulare | Attività di lunga durata e lavoro asincrono |
Claude Managed Agents fornisce l'harness e l'infrastruttura per eseguire Claude come agente autonomo. Invece di costruire il tuo ciclo dell'agente, l'esecuzione degli strumenti e il runtime, ottieni un ambiente completamente gestito in cui Claude può leggere file, eseguire comandi, navigare sul web ed eseguire codice in modo sicuro. L'harness supporta nativamente il "prompt caching" (cache dei prompt), la "compaction" (compattazione) e altre ottimizzazioni delle prestazioni per output dell'agente efficienti e di alta qualità. Per costruire invece il tuo ciclo dell'agente con accesso diretto al modello, consulta Utilizzo della Messages API.
Crea la tua prima sessione dell'agente
Crea una sessione e invia il tuo primo evento
Tipi di evento, limiti di velocità, flag della CLI e altre tabelle di consultazione
Concetti fondamentali
Claude Managed Agents si basa su quattro concetti:
| Concetto | Descrizione |
|---|---|
| Agent | Il modello, il prompt di sistema, gli strumenti, i server MCP e le skill |
| Environment | Configurazione del luogo in cui vengono eseguite le sessioni: una sandbox cloud gestita da Anthropic oppure una sandbox self-hosted sulla tua infrastruttura |
| Session | Un'istanza di agente in esecuzione all'interno di un ambiente, che svolge un compito specifico e genera output |
| Events | Messaggi scambiati tra la tua applicazione e l'agente (turni dell'utente, risultati degli strumenti, aggiornamenti di stato) |
Come funziona
Crea un agente
Definisci il modello, il "system prompt" (prompt di sistema), gli strumenti, i server MCP e le skill. Crea l'agente una sola volta e fai riferimento ad esso tramite ID tra le sessioni.
Crea un ambiente
Configura dove viene eseguito l'agente: una sandbox cloud oppure una sandbox self-hosted sulla tua infrastruttura.
Avvia una sessione
Avvia una sessione che fa riferimento alla configurazione del tuo agente e del tuo ambiente.
Invia eventi e ricevi le risposte in streaming
Invia i messaggi dell'utente come eventi. Claude esegue autonomamente gli strumenti e restituisce i risultati in streaming tramite "server-sent events" (eventi inviati dal server), o SSE. La cronologia degli eventi viene conservata lato server e può essere recuperata integralmente.
Guida o interrompi
Invia ulteriori eventi utente per guidare l'agente durante l'esecuzione, oppure interrompilo per cambiare direzione.
Quando usare Claude Managed Agents
Claude Managed Agents è ideale per carichi di lavoro che richiedono:
- Esecuzione di lunga durata: attività che durano minuti o ore con più chiamate agli strumenti
- Infrastruttura cloud: sandbox sicure con pacchetti preinstallati e accesso alla rete
- Esecuzione self-hosted: sandbox su infrastruttura sotto il tuo controllo per requisiti di conformità o di residenza dei dati
- Infrastruttura minima: nessuna necessità di costruire il tuo ciclo dell'agente, la tua sandbox o il tuo livello di esecuzione degli strumenti
- Sessioni con stato: filesystem persistenti e cronologia delle conversazioni tra più interazioni
- Esecuzione pianificata: esecuzioni ricorrenti dell'agente secondo una pianificazione cron tramite i deployment pianificati
Strumenti supportati
Claude Managed Agents fornisce a Claude l'accesso a un insieme di strumenti integrati:
- Bash: esegui comandi shell nella sandbox
- Operazioni sui file: leggi, scrivi, modifica, esegui glob e grep sui file nella sandbox
- Ricerca web e fetch: cerca sul web e recupera contenuti da URL, con restrizione facoltativa a una allowlist o blocklist di domini
- Server MCP: connettiti a fornitori di strumenti esterni
Consulta Strumenti per l'elenco completo e le opzioni di configurazione.
Accesso beta
Per iniziare, hai bisogno di:
- Una chiave API di Claude
- L'header beta
managed-agents-2026-04-01su tutte le richieste - Accesso a Claude Managed Agents (abilitato per impostazione predefinita per tutti gli account API)
All'interno della beta, i tunnel MCP e il dreaming sono in una research preview più limitata. Richiedi l'accesso per abilitarli.
Claude Managed Agents è con stato per progettazione: le sessioni sono di lunga durata, riprendono senza problemi dopo le pause e memorizzano lato server la cronologia delle conversazioni, lo stato della sandbox e gli output. Per questo motivo, Managed Agents non è attualmente idoneo alla Zero Data Retention né alla copertura del Business Associate Agreement (BAA) HIPAA. Mantieni il controllo su questi dati: puoi eliminare le sessioni e, separatamente, eliminare qualsiasi file che hai caricato, in qualsiasi momento tramite l'API. Per l'idoneità di tutte le funzionalità, consulta API e conservazione dei dati.
Consulta Limiti di velocità e Linee guida per il branding nel riferimento.
Was this page helpful?