Riferimento
Tipi di evento, flag CLI del worker self-hosted, tipi di server MCP supportati, limiti di velocità e linee guida sul branding per Claude Managed Agents.
Questa pagina raccoglie materiale di riferimento per Claude Managed Agents. Per le guide orientate alle attività, segui i link in ciascuna sezione. Per le operazioni sulla risorsa sessione, consulta Operazioni sulle sessioni.
Tipi di evento
Le stringhe dei tipi di evento persistiti seguono una convenzione di denominazione {domain}.{action}; i delta di evento solo-stream (vedi la scheda Delta di evento) sono l'eccezione. Consulta Stream di eventi della sessione per l'invio, lo streaming e l'elenco degli eventi. I tipi di evento webhook sono elencati separatamente in Iscriversi ai webhook, e alcuni dei loro nomi differiscono da quelli dello stream (ad esempio, session.status_idled anziché session.status_idle).
| Tipo | Descrizione |
|---|---|
user.message | Un messaggio utente con contenuto di testo, immagine o documento. |
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 (risultato) 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 SDK e la CLI lo fanno automaticamente. |
Worker self-hosted
Questi sono i flag CLI 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 in cui gli strumenti leggono e scrivono file. Il valore predefinito è . (la directory corrente); la directory di lavoro predefinita di 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 agli strumenti per i file di leggere e scrivere percorsi al di fuori di --workdir. Il controllo della workdir è una protezione solo per gli strumenti per i file, non una sandbox; non vincola bash. |
--max-idle | Quanto 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'acquisizione di log strutturati. Il valore predefinito è text. |
Il worker CLI non monta i memory store (archivi di memoria): una sessione che ne collega uno viene comunque eseguita, ma l'agente non trova nulla al mount_path dello store e nessuna modifica viene sincronizzata verso lo store. Per usare i memory store nelle sessioni su un ambiente self-hosted, esegui invece il worker SDK; consulta Usare i memory store.
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 dovrebbe supportare il trasporto streamable HTTP 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.
Limiti di velocità
Gli endpoint di Managed Agents sono soggetti a "rate limit" (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.
Linee guida sul 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 tendina)
- "Claude" (quando all'interno di un menu già etichettato "Agents")
- "{YourAgentName} Powered by Claude" (se hai già un nome per il tuo agente)
Non consentito:
- "Claude Code" o "Claude Code Agent"
- "Claude Cowork" o "Claude Cowork Agent"
- ASCII art con il marchio 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.
Was this page helpful?