---
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
  zdr:
    eligibility: not-eligible
    note: Non idoneo per ZDR, ad eccezione di Managed Agents self-hosted. Le sessioni sono risorse con stato; le trascrizioni restano finché non le elimini.
  supportedModels:
    - claude-fable-5-2
    - claude-mythos-5-2
    - claude-fable-5-1
    - claude-mythos-5-1
    - claude-fable-5
    - claude-mythos-5
    - claude-mythos-preview
    - claude-opus-5-5
    - claude-opus-5
    - claude-sonnet-5-5
    - claude-sonnet-5
    - claude-haiku-5-5
    - claude-haiku-4-5-20251001
    - claude-opus-4-8
    - claude-opus-4-7
    - claude-opus-4-6
    - claude-sonnet-4-6
    - claude-opus-4-5-20251101
    - claude-sonnet-4-5-20250929
  supportedPlatforms:
    Claude API: beta
    Claude Platform on AWS: beta
    Claude Models on Google Cloud (Anthropic managed): beta
---

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).

<Note>
  Claude Managed Agents è disponibile anche su Claude Models on Google Cloud (Anthropic managed) e Claude Platform on AWS, con alcune differenze nella disponibilità delle funzionalità e nel comportamento delle sessioni. Consulta la guida [Claude Models on Google Cloud (Anthropic managed)](https://platform.claude.com/docs/it/build-with-claude/claude-models-on-google-cloud/anthropic-managed#claude-managed-agents) oppure [Claude Managed Agents](https://platform.claude.com/docs/it/build-with-claude/claude-platform-on-aws#claude-managed-agents) nella guida di Claude Platform on AWS.
</Note>

<CardGroup cols={3}>
  <Card title="Guida rapida" icon="play" href="https://platform.claude.com/docs/it/managed-agents/quickstart">
    Crea la tua prima sessione dell’agente
  </Card>

  <Card title="Avvia una sessione" icon="code-brackets" href="https://platform.claude.com/docs/it/managed-agents/sessions">
    Crea una sessione e invia il tuo primo evento
  </Card>

  <Card title="Riferimento" icon="book" href="https://platform.claude.com/docs/it/managed-agents/reference">
    Tipi di evento, limiti di velocità, flag della CLI e altre tabelle di consultazione
  </Card>
</CardGroup>

## Concetti fondamentali

Claude Managed Agents si basa su quattro concetti:

| Concetto | Descrizione |
| ----- | ----- |
| **Agente** | Il modello, il prompt di sistema, gli strumenti, i server MCP e le skill |
| **Ambiente** | Configurazione del luogo in cui vengono eseguite le sessioni: una sandbox cloud gestita da Anthropic oppure una sandbox self-hosted sulla tua infrastruttura |
| **Sessione** | Un’istanza di agente in esecuzione all’interno di un ambiente, che svolge un compito specifico e genera output |
| **Eventi** | Messaggi scambiati tra la tua applicazione e l’agente (turni dell’utente, risultati degli strumenti, aggiornamenti di stato) |

## Come funziona

<Steps>
  <Step title="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.
  </Step>

  <Step title="Crea un ambiente">
    [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.
  </Step>

  <Step title="Avvia una sessione">
    Avvia una sessione che fa riferimento alla configurazione del tuo agente e del tuo ambiente.
  </Step>

  <Step title="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. Il servizio Managed Agents conserva la cronologia degli eventi e puoi recuperarla integralmente.
  </Step>

  <Step title="Guida o interrompi">
    Invia ulteriori eventi utente per guidare l’agente mentre è in esecuzione, oppure interrompilo per cambiare direzione.
  </Step>
</Steps>

## 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
* **Servizio self-hosted:** l’intero servizio Managed Agents sulla tua infrastruttura, con [Claude Managed Agents self-hosted](https://platform.claude.com/docs/it/managed-agents/self-hosted)
* **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

<Note>
  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. Anthropic potrebbe perfezionare i comportamenti tra una release e l’altra per migliorare gli output.
</Note>

Per iniziare, hai bisogno di:

1. Una [chiave API di Claude](https://platform.claude.com/settings/keys) dalla Claude Console.
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 un’anteprima di ricerca più limitata. Per abilitarli, [richiedi l’accesso all’anteprima di ricerca](https://claude.com/form/claude-managed-agents).

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 [conservazione zero dei dati](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. L’eccezione per la conservazione zero dei dati è Claude Managed Agents self-hosted, in cui sei tu a memorizzare questi dati, come descritto in [Per quanto tempo vengono conservati i dati](https://platform.claude.com/docs/it/managed-agents/self-hosted-data-and-access#how-long-data-is-kept). 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.

## Disponibilità

La funzionalità Managed Agents è in beta su tutti i modelli.

### Supporto API

| Stato | Piattaforme cloud | Modelli |
| ----- | ----- | ----- |
| Beta | Claude API, [Claude Platform on AWS](https://platform.claude.com/docs/it/build-with-claude/claude-platform-on-aws), [Claude Models on Google Cloud (Anthropic managed)](https://platform.claude.com/docs/it/build-with-claude/claude-models-on-google-cloud/anthropic-managed) | [Tutti i modelli](https://platform.claude.com/docs/it/models/overview) |

### Header beta richiesti

[Panoramica degli header beta](https://platform.claude.com/docs/it/api/beta-headers)

Gli header beta consentono di accedere a funzionalità sperimentali e a nuove capacità dei modelli prima che entrino a far parte dell’API standard.

* `managed-agents-2026-04-01`

### Gestione dei dati

[Panoramica sulla gestione dei dati](https://platform.claude.com/docs/it/manage-claude/api-and-data-retention#feature-eligibility)

| Elemento | Conservazione zero dei dati | HIPAA |
| ----- | ----- | ----- |
| Stato | Non idoneo | Non idoneo |
| Dettagli | Non idoneo per ZDR, ad eccezione di Managed Agents self-hosted. Le sessioni sono risorse con stato; le trascrizioni restano finché non le elimini. [Scopri di più](https://platform.claude.com/docs/it/managed-agents/self-hosted-data-and-access#how-long-data-is-kept) | Non idoneo per HIPAA. Si applica a tutte le sotto-funzionalità di Managed Agents. |

Endpoint applicabili:

* `/v1/agents`
* `/v1/sessions`
* `/v1/environments`
