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 loop 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 la "prompt caching" (cache dei prompt) integrata, la compattazione e altre ottimizzazioni delle prestazioni per output degli agenti di alta qualità ed efficienti.
Crea la tua prima sessione agente
Crea una sessione e invia il tuo primo evento
Tipi di eventi, limiti di velocità, flag della CLI e altre tabelle di consultazione
Claude Managed Agents è costruito attorno a 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) |
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 referenzialo tramite ID tra 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
Lancia una sessione che fa riferimento alla configurazione del tuo agente e del tuo ambiente.
Invia eventi e ricevi risposte in streaming
Invia 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 persistita lato server e può essere recuperata per intero.
Guida o interrompi
Invia eventi utente aggiuntivi per guidare l'agente durante l'esecuzione, o interrompilo per cambiare direzione.
Claude Managed Agents è ideale per carichi di lavoro che richiedono:
Claude Managed Agents dà a Claude accesso a un insieme di strumenti integrati:
Consulta Strumenti per l'elenco completo e le opzioni di configurazione.
Per iniziare, hai bisogno di:
managed-agents-2026-04-01 su tutte le richiesteAll'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 in modo pulito 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 per la copertura Zero Data Retention o per il Business Associate Agreement (BAA) HIPAA. Mantieni il controllo su questi dati: puoi eliminare le sessioni, ed eliminare separatamente 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?