---
title: Panoramica di Claude Managed Agents
url: https://platform.claude.com/docs/it/managed-agents/overview
description: Harness per agenti predefinito e configurabile, eseguito su un'infrastruttura gestita. Ideale per attività di lunga durata e lavoro asincrono.
featureMetadata:
topic:
title: Managed Agents
url: https://platform.claude.com/docs/en/managed-agents/overview
status: beta
betaHeader: managed-agents-2026-04-01
---
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](https://platform.claude.com/docs/it/build-with-claude/working-with-messages).
Claude Managed Agents è disponibile anche su Claude Platform su AWS, con alcune differenze nella disponibilità delle funzionalità e nel comportamento delle sessioni. Consulta [Claude Managed Agents](https://platform.claude.com/docs/it/build-with-claude/claude-platform-on-aws#claude-managed-agents) nella guida di Claude Platform su AWS.
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
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.
[Configura dove viene eseguito l'agente](https://platform.claude.com/docs/it/managed-agents/choosing-an-environment): una sandbox cloud oppure una [sandbox self-hosted](https://platform.claude.com/docs/it/managed-agents/self-hosted-sandboxes) sulla tua infrastruttura.
Avvia una sessione che fa riferimento alla configurazione del tuo agente e del tuo ambiente.
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.
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](https://platform.claude.com/docs/it/managed-agents/scheduled-deployments)
## 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](https://platform.claude.com/docs/it/managed-agents/tools) per l'elenco completo e le opzioni di configurazione.
## Accesso beta
Claude Managed Agents è 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:
1. Una [chiave API di Claude](https://platform.claude.com/settings/keys)
2. L'header beta `managed-agents-2026-04-01` su tutte le richieste
3. Accesso a Claude Managed Agents (abilitato per impostazione predefinita per tutti gli account API)
All'interno della beta, i [tunnel MCP](https://platform.claude.com/docs/it/agents-and-tools/mcp-tunnels/overview) e il [dreaming](https://platform.claude.com/docs/it/managed-agents/dreams) sono in una research preview più limitata. [Richiedi l'accesso](https://claude.com/form/claude-managed-agents) 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](https://platform.claude.com/docs/it/manage-claude/api-and-data-retention#zero-data-retention-zdr-scope) né alla copertura del Business Associate Agreement (BAA) HIPAA. Mantieni il controllo su questi dati: puoi [eliminare le sessioni](https://platform.claude.com/docs/it/managed-agents/session-operations#deleting-a-session) e, separatamente, eliminare qualsiasi [file](https://platform.claude.com/docs/it/build-with-claude/files#delete-a-file) che hai caricato, in qualsiasi momento tramite l'API. Per l'idoneità di tutte le funzionalità, consulta [API e conservazione dei dati](https://platform.claude.com/docs/it/manage-claude/api-and-data-retention#feature-eligibility).
Consulta [Limiti di velocità](https://platform.claude.com/docs/it/managed-agents/reference#rate-limits) e [Linee guida per il branding](https://platform.claude.com/docs/it/managed-agents/reference#branding-guidelines) nel riferimento.