Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
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 sulle sessioni.
Le richieste all'API Managed Agents richiedono l'header beta managed-agents-2026-04-01, ad eccezione degli endpoint del memory store, che utilizzano invece agent-memory-2026-07-22. L'SDK imposta automaticamente l'header beta corretto. Consulta Header beta.
Le stringhe dei tipi di eventi persistiti seguono una convenzione di denominazione {domain}.{action}; i delta degli eventi solo in streaming (vedi la scheda Delta degli eventi) sono l'eccezione. Consulta Stream di eventi della sessione per l'invio, lo streaming e l'elenco degli eventi.
| Tipo | Descrizione |
|---|---|
user.message | Un messaggio utente con contenuto di testo, immagine o documento. |
user.interrupt | Ferma l'agente durante l'esecuzione. |
user.custom_tool_result | Risposta a una chiamata di strumento personalizzato da parte dell'agente. |
user.tool_confirmation | Approva o nega una chiamata di strumento dell'agente o MCP quando una policy di autorizzazione richiede conferma. |
user.define_outcome | Definisce un outcome verso cui l'agente deve lavorare. |
user.tool_result | Solo per le sessioni con ambienti self_hosted, la tua integrazione è responsabile di fornire i risultati di agent_toolset. Gli helper dell'SDK e la CLI lo fanno automaticamente. |
Questi sono i flag CLI di ant beta:worker per il worker predefinito che gestisce un ambiente self_hosted. Consulta Sandbox self-hosted per la configurazione dell'ambiente, l'esecuzione di 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 in cui gli strumenti leggono e scrivono i 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 rivendicato invece di eseguire gli strumenti in-process. Riceve i dettagli della sessione come variabili d'ambiente. |
--unrestricted-paths | Consente agli strumenti file di leggere e scrivere percorsi al di fuori di --workdir. Il controllo della workdir è una protezione solo per gli strumenti file, non una sandbox; non vincola bash. |
--max-idle | Quanto tempo attendere dopo che la sessione diventa inattiva con uno stop reason end_turn prima di arrestarsi. Il valore predefinito è 60s. |
--log-format | Formato di output dei log. Usa json per l'ingestione di log strutturati. Il valore predefinito è text. |
Claude Managed Agents si connette a server MCP remoti che espongono un endpoint HTTP, o a server MCP privati tramite tunnel MCP. Il server dovrebbe supportare il trasporto HTTP streamable del protocollo MCP; i server che supportano solo il trasporto SSE deprecato funzionano comunque tramite un fallback automatico. 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.
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 recupero, elenco e stream) | 1.200 richieste al minuto |
Si applicano anche i limiti di spesa e i limiti di velocità per livello di utilizzo a livello di organizzazione.
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 proprio branding e non apparire come 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?