Riferimento

Questa pagina raccoglie materiale di riferimento per Claude Managed Agents. Per guide orientate alle attività, segui i link in ciascuna sezione. Per le operazioni sulla risorsa sessione, consulta Operazioni sulla sessione.

Tutte le richieste all'API Managed Agents richiedono l'header beta managed-agents-2026-04-01. L'SDK imposta automaticamente l'header beta.

Tipi di eventi

Le stringhe dei tipi di evento seguono una convenzione di denominazione {domain}.{action}. Consulta Stream di eventi della sessione per l'invio, lo streaming e l'elenco degli eventi.

Worker self-hosted

Questi sono i flag CLI di ant beta:worker per il worker predefinito che gestisce un ambiente self_hosted. Consulta Sandbox self-hosted per configurare l'ambiente, eseguire un worker e le opzioni degli helper dell'SDK.

Flag	Descrizione
`--environment-id`	L'ambiente da interrogare per il lavoro. Legge anche da `ANTHROPIC_ENVIRONMENT_ID`.
`--environment-key`	Autentica il worker con questo ambiente. Legge anche da `ANTHROPIC_ENVIRONMENT_KEY`.
`--workdir`	Directory in cui vengono scaricate le skill e gli strumenti leggono e scrivono file. Il valore predefinito è `.` (la directory corrente); la directory di lavoro predefinita del sistema è `/workspace`.
`--on-work`	Script da chiamare per ogni elemento di lavoro acquisito invece di eseguire gli strumenti in-process. Riceve i dettagli della sessione come variabili d'ambiente.
`--unrestricted-paths`	Consente alle chiamate degli strumenti di accedere a percorsi esterni a .

Tipi di server MCP supportati

Claude Managed Agents si connette a server MCP remoti che espongono un endpoint HTTP, oppure a server MCP privati tramite tunnel MCP. Il server deve supportare il trasporto HTTP streamable del protocollo MCP. Consulta Connettore MCP per dichiarare i server su un agente.

Per maggiori informazioni su MCP e sulla creazione di server MCP, consulta la documentazione MCP.

Limiti di velocità

Gli endpoint di Managed Agents hanno limiti di velocità per organizzazione:

Operazione	Limite
Endpoint di creazione (come agenti, sessioni e ambienti)	300 richieste al minuto
Endpoint di lettura (come retrieve, list e stream)	600 richieste al minuto

Si applicano anche i limiti di spesa e i limiti di velocità basati sul tier a livello di organizzazione.

Linee guida per il branding

Per i partner che integrano Claude Managed Agents, l'uso del branding Claude è facoltativo. Quando fai riferimento a Claude nel tuo prodotto:

Consentito:

"Claude Agent" (preferito per i menu a discesa)
"Claude" (quando all'interno di un menu già etichettato "Agents")
"{YourAgentName} Powered by Claude" (se hai già un nome per l'agente)

Non consentito:

"Claude Code" o "Claude Code Agent"
"Claude Cowork" o "Claude Cowork Agent"
ASCII art con il brand Claude Code o elementi visivi che imitano Claude Code

Il tuo prodotto deve mantenere il proprio branding e non apparire come Claude Code, Claude Cowork o qualsiasi altro prodotto Anthropic. Per domande sulla conformità del branding, contatta il team commerciale di Anthropic.

--workdir