Agenti gestitiPrimi passi

Panoramica di Claude Managed Agents

Harness per agenti preconfigurato e personalizzabile che viene eseguito in 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	Framework agente preconfigurato e personalizzabile che viene eseguito su infrastruttura gestita
Ideale per	Loop agente personalizzati e controllo granulare	Attività di lunga durata e lavoro asincrono
Scopri di più	Documentazione Messages API	Documentazione Claude Managed Agents

Claude Managed Agents fornisce l'harness e l'infrastruttura per eseguire Claude come agente autonomo. Invece di costruire il tuo ciclo 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 la cache dei prompt integrata, la compattazione e altre ottimizzazioni delle prestazioni per output degli agenti efficienti e di alta qualità.

Claude Managed Agents è disponibile anche su Claude Platform on AWS, con alcune differenze nella disponibilità delle funzionalità e nel comportamento delle sessioni. Consulta Claude Managed Agents nella guida di Claude Platform on AWS.

Guida rapida

Crea la tua prima sessione agente

Avvia una sessione

Crea una sessione e invia il tuo primo evento

Riferimento

Tipi di evento, limiti di velocità, flag 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 che definisce dove vengono eseguite le sessioni: una sandbox cloud gestita da Anthropic, oppure una sandbox self-hosted sulla tua infrastruttura
Session	Un'istanza dell'agente in esecuzione all'interno di un environment, che esegue un'attività specifica 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 prompt di sistema, gli strumenti, i server MCP e le skill. Crea l'agente una sola volta e fai riferimento ad esso tramite ID in tutte le sessioni.
Crea un ambiente
Configura dove viene eseguito l'agente: una sandbox cloud o 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 risposte in streaming
Invia i messaggi 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 eventi utente aggiuntivi 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 vengono eseguite per 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 che controlli tu per requisiti di conformità o residenza dei dati
Infrastruttura minima: nessuna necessità di costruire il tuo ciclo agente, sandbox o livello di esecuzione degli strumenti
Sessioni con stato: filesystem persistenti e cronologia delle conversazioni attraverso più interazioni
Esecuzione pianificata: esecuzioni ricorrenti dell'agente secondo una pianificazione cron tramite 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, usa glob e grep sui file nella sandbox
Ricerca e recupero web: cerca sul web e recupera contenuti da URL
Server MCP: connettiti a provider di strumenti esterni

Consulta Strumenti per l'elenco completo e le opzioni di configurazione.

Accesso beta

Claude Managed Agents è attualmente in beta. Tutti gli endpoint di Managed Agents richiedono l'header beta managed-agents-2026-04-01. L'SDK imposta automaticamente l'header beta. I comportamenti potrebbero essere perfezionati tra una release e l'altra per migliorare gli output.

Per iniziare, hai bisogno di:

Una chiave API di Claude
L'header beta managed-agents-2026-04-01 su 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 è stateful per progettazione: le sessioni sono di lunga durata, riprendono senza problemi dopo le pause e memorizzano la cronologia delle conversazioni, lo stato della sandbox e gli output lato server. Per questo motivo, Managed Agents non è attualmente idoneo per la copertura Zero Data Retention o HIPAA Business Associate Agreement (BAA). 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?

Agenti gestitiPrimi passi

Panoramica di Claude Managed Agents

Harness per agenti preconfigurato e personalizzabile che viene eseguito in 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	Framework agente preconfigurato e personalizzabile che viene eseguito su infrastruttura gestita
Ideale per	Loop agente personalizzati e controllo granulare	Attività di lunga durata e lavoro asincrono
Scopri di più	Documentazione Messages API	Documentazione Claude Managed Agents

Guida rapida

Crea la tua prima sessione agente

Avvia una sessione

Crea una sessione e invia il tuo primo evento

Riferimento

Tipi di evento, limiti di velocità, flag 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 che definisce dove vengono eseguite le sessioni: una sandbox cloud gestita da Anthropic, oppure una sandbox self-hosted sulla tua infrastruttura
Session	Un'istanza dell'agente in esecuzione all'interno di un environment, che esegue un'attività specifica 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 prompt di sistema, gli strumenti, i server MCP e le skill. Crea l'agente una sola volta e fai riferimento ad esso tramite ID in tutte le sessioni.
Crea un ambiente
Configura dove viene eseguito l'agente: una sandbox cloud o 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 risposte in streaming
Invia i messaggi 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 eventi utente aggiuntivi 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 vengono eseguite per 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 che controlli tu per requisiti di conformità o residenza dei dati
Infrastruttura minima: nessuna necessità di costruire il tuo ciclo agente, sandbox o livello di esecuzione degli strumenti
Sessioni con stato: filesystem persistenti e cronologia delle conversazioni attraverso più interazioni
Esecuzione pianificata: esecuzioni ricorrenti dell'agente secondo una pianificazione cron tramite 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, usa glob e grep sui file nella sandbox
Ricerca e recupero web: cerca sul web e recupera contenuti da URL
Server MCP: connettiti a provider 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-01 su 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.

Consulta Limiti di velocità e Linee guida per il branding nel riferimento.

Was this page helpful?

Concetti fondamentali

Come funziona

Quando usare Claude Managed Agents

Strumenti supportati

Accesso beta

Concetti fondamentali

Come funziona

Quando usare Claude Managed Agents

Strumenti supportati

Accesso beta

Concetti fondamentali

Come funziona

Quando usare Claude Managed Agents

Strumenti supportati

Accesso beta

Concetti fondamentali

Come funziona

Quando usare Claude Managed Agents

Strumenti supportati

Accesso beta