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 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.
Le stringhe dei tipi di eventi persistenti seguono una convenzione di denominazione {domain}.{action}; i delta degli eventi solo stream (vedi la scheda Delta degli eventi) sono l'eccezione. Consulta Stream degli eventi di sessione per l'invio, lo streaming e l'elenco degli eventi.
| Tipo | Descrizione |
|---|---|
user.message | Un messaggio utente con contenuto testuale. |
user.interrupt | Interrompe 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 sessioni con ambienti self_hosted, la tua integrazione è responsabile di fornire i risultati di agent_toolset. Gli helper 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 configurare l'ambiente, eseguire un worker e le opzioni degli helper 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 reclamato invece di eseguire gli strumenti in-process. Riceve i dettagli della sessione come variabili d'ambiente. |
--unrestricted-paths | Consente alle chiamate di strumenti di accedere a percorsi al di fuori di --workdir. |
--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 deve supportare il trasporto HTTP streamable del protocollo MCP. Consulta Connettore MCP per dichiarare i server su un agente.
Per ulteriori 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 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 vendite di Anthropic.
Was this page helpful?