Anthropic offers two ways to build with Claude, each suited to different use cases:
| Messages API | Claude Managed Agents | |
|---|---|---|
| What it is | Direct model prompting access | Pre-built, configurable agent harness that runs in managed infrastructure |
| Best for | Custom agent loops and fine-grained control | Long-running tasks and asynchronous work |
| Learn more | Messages API docs | Claude Managed Agents docs |
Claude Managed Agents fornisce l'harness e l'infrastruttura per eseguire Claude come agente autonomo. Invece di costruire il tuo proprio ciclo agente, esecuzione di strumenti e runtime, ottieni un ambiente completamente gestito in cui Claude può leggere file, eseguire comandi, navigare il web ed eseguire codice in modo sicuro. L'harness supporta la memorizzazione in cache dei prompt integrata, la compattazione e altre ottimizzazioni delle prestazioni per output agente di alta qualità ed efficienti.
Claude Managed Agents è costruito attorno a quattro concetti:
| Concept | Description |
|---|---|
| Agent | The model, system prompt, tools, MCP servers, and skills |
| Environment | Configuration for where sessions run: an Anthropic-managed cloud container, or a self-hosted sandbox on your own infrastructure |
| Session | A running agent instance within an environment, performing a specific task and generating outputs |
| Events | Messages exchanged between your application and the agent (user turns, tool results, status updates) |
Crea un agente
Definisci il modello, il prompt di sistema, gli strumenti, i server MCP e le competenze. Crea l'agente una volta e fai riferimento ad esso tramite ID in tutte le sessioni.
Crea un ambiente
Configura un contenitore cloud con pacchetti preinstallati (Python, Node.js, Go, ecc.), regole di accesso alla rete e file montati.
Avvia una sessione
Avvia una sessione che fa riferimento alla configurazione dell'agente e dell'ambiente.
Invia eventi e trasmetti risposte
Invia messaggi utente come eventi. Claude esegue autonomamente gli strumenti e trasmette i risultati tramite server-sent events (SSE). La cronologia degli eventi viene mantenuta lato server e può essere recuperata completamente.
Guida o interrompi
Invia ulteriori eventi utente per guidare l'agente durante l'esecuzione, o interrompi per cambiare direzione.
Claude Managed Agents è ideale per carichi di lavoro che necessitano di:
Claude Managed Agents fornisce a Claude l'accesso a un set completo di strumenti integrati:
Vedi Strumenti per l'elenco completo e le opzioni di configurazione.
Claude Managed Agents è attualmente in beta. Tutti gli endpoint di Managed Agents richiedono l'intestazione beta managed-agents-2026-04-01. L'SDK imposta automaticamente l'intestazione beta. I comportamenti possono essere perfezionati tra i rilasci per migliorare gli output.
Per iniziare, hai bisogno di:
Alcune funzionalità (outcomes, multiagent e memory) sono in anteprima di ricerca. Richiedi accesso per provarle.
Gli endpoint di Managed Agents sono limitati per organizzazione:
| Operazione | Limite |
|---|---|
| Crea endpoint (agenti, sessioni, ambienti, ecc.) | 60 richieste al minuto |
| Leggi endpoint (recupera, elenca, trasmetti, ecc.) | 600 richieste al minuto |
Si applicano anche i limiti di spesa a livello di organizzazione e limiti di velocità basati su livello.
Per i partner che integrano Claude Managed Agents, l'uso del branding Claude è facoltativo. Quando fai riferimento a Claude nel tuo prodotto:
Consentito:
Non consentito:
Il tuo prodotto dovrebbe mantenere il suo proprio branding e non sembrare Claude Code, Claude Cowork o qualsiasi altro prodotto Anthropic. Per domande sulla conformità del branding, contatta il team di vendita di Anthropic.
Was this page helpful?