Loading...
    • Costruisci
    • Admin
    • Modelli e prezzi
    • Client SDK
    • Riferimento API
    Search...
    ⌘K
    Primi passi
    Introduzione a ClaudeAvvio rapido
    Costruire con Claude
    Panoramica delle funzionalitàUtilizzo delle Messages APIGestione dei motivi di arresto
    Capacità del modello
    Ragionamento estesoRagionamento adattivoImpegnoModalità rapida (beta: anteprima di ricerca)Output strutturatiCitazioniMessaggi in streamingElaborazione batchRisultati di ricercaRifiuti in streamingSupporto multilingueEmbeddings
    Strumenti
    PanoramicaCome funziona l'uso degli strumentiStrumento di ricerca webStrumento di recupero webStrumento di esecuzione del codiceStrumento di memoriaStrumento BashStrumento di utilizzo del computerStrumento editor di testo
    Infrastruttura degli strumenti
    Ricerca strumentiChiamata programmatica degli strumentiStreaming granulare degli strumenti
    Gestione del contesto
    Finestre di contestoCompattazioneModifica del contestoCaching dei promptConteggio dei token
    Lavorare con i file
    Files APISupporto PDFImmagini e visione
    Skills
    PanoramicaAvvio rapidoBest practiceSkills per l'impresaSkills nell'API
    MCP
    Server MCP remotiConnettore MCP
    Prompt engineering
    PanoramicaBest practice per i promptStrumenti di prompting in Console
    Testa e valuta
    Definisci il successo e crea valutazioniUtilizzo dello strumento di valutazione in ConsoleRiduzione della latenza
    Rafforzare i guardrail
    Ridurre le allucinazioniAumentare la coerenza dell'outputMitigare i jailbreakRidurre la perdita di prompt
    Risorse
    Glossario
    Note di rilascio
    Claude Platform
    Console
    Log in
    Loading...
    Loading...
    Loading...
    Loading...
    Loading...
    Loading...
    Loading...
    Loading...
    Loading...
    Loading...
    Loading...
    Loading...
    Loading...
    Loading...
    Loading...
    Loading...

    Solutions

    • AI agents
    • Code modernization
    • Coding
    • Customer support
    • Education
    • Financial services
    • Government
    • Life sciences

    Partners

    • Amazon Bedrock
    • Google Cloud's Vertex AI

    Learn

    • Blog
    • Catalog
    • Courses
    • Use cases
    • Connectors
    • Customer stories
    • Engineering at Anthropic
    • Events
    • Powered by Claude
    • Service partners
    • Startups program

    Company

    • Anthropic
    • Careers
    • Economic Futures
    • Research
    • News
    • Responsible Scaling Policy
    • Security and compliance
    • Transparency

    Learn

    • Blog
    • Catalog
    • Courses
    • Use cases
    • Connectors
    • Customer stories
    • Engineering at Anthropic
    • Events
    • Powered by Claude
    • Service partners
    • Startups program

    Help and security

    • Availability
    • Status
    • Support
    • Discord

    Terms and policies

    • Privacy policy
    • Responsible disclosure policy
    • Terms of service: Commercial
    • Terms of service: Consumer
    • Usage policy
    Primi passi

    Panoramica di Claude Managed Agents

    Harness agente precostruito e configurabile che viene eseguito in infrastruttura gestita. Ideale per attività di lunga durata e lavoro asincrono.

    Anthropic offers two ways to build with Claude, each suited to different use cases:

    Messages APIClaude Managed Agents
    What it isDirect model prompting accessPre-built, configurable agent harness that runs in managed infrastructure
    Best forCustom agent loops and fine-grained controlLong-running tasks and asynchronous work
    Learn moreMessages API docsClaude 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 degli strumenti e runtime, ottieni un ambiente completamente gestito dove Claude può leggere file, eseguire comandi, navigare il web ed eseguire codice in modo sicuro. L'harness supporta la memorizzazione nella cache dei prompt integrata, la compattazione e altre ottimizzazioni delle prestazioni per output di agenti di alta qualità ed efficienti.

    Was this page helpful?

    • Concetti fondamentali
    • Come funziona
    • Quando utilizzare Claude Managed Agents
    • Strumenti supportati
    • Accesso beta
    • Limiti di velocità
    • Linee guida di branding
    Quickstart

    Crea la tua prima sessione agente

    API Reference

    Documentazione completa degli endpoint

    Concetti fondamentali

    Claude Managed Agents è costruito attorno a quattro concetti:

    ConceptDescription
    AgentThe model, system prompt, tools, MCP servers, and skills
    EnvironmentA configured container template (packages, network access)
    SessionA running agent instance within an environment, performing a specific task and generating outputs
    EventsMessages exchanged between your application and the agent (user turns, tool results, status updates)

    Come funziona

    1. 1

      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 nelle sessioni.

    2. 2

      Crea un ambiente

      Configura un contenitore cloud con pacchetti preinstallati (Python, Node.js, Go, ecc.), regole di accesso alla rete e file montati.

    3. 3

      Avvia una sessione

      Avvia una sessione che fa riferimento alla configurazione dell'agente e dell'ambiente.

    4. 4

      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.

    5. 5

      Guida o interrompi

      Invia ulteriori eventi utente per guidare l'agente durante l'esecuzione, o interrompi per cambiare direzione.

    Quando utilizzare Claude Managed Agents

    Claude Managed Agents è ideale per carichi di lavoro che necessitano di:

    • Esecuzione di lunga durata - Attività che vengono eseguite per minuti o ore con più chiamate di strumenti
    • Infrastruttura cloud - Contenitori sicuri con pacchetti preinstallati e accesso alla rete
    • Infrastruttura minima - Nessuna necessità di costruire il tuo proprio ciclo agente, sandbox o livello di esecuzione degli strumenti
    • Sessioni stateful - File system persistenti e cronologia delle conversazioni tra più interazioni

    Strumenti supportati

    Claude Managed Agents fornisce a Claude l'accesso a un set completo di strumenti integrati:

    • Bash - Esegui comandi shell nel contenitore
    • Operazioni su file - Leggi, scrivi, modifica, glob e grep file nel contenitore
    • Ricerca web e recupero - Cerca il web e recupera contenuti da URL
    • Server MCP - Connettiti a provider di strumenti esterni

    Vedi Strumenti per l'elenco completo e le opzioni di configurazione.

    Accesso beta

    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 le versioni per migliorare gli output.

    Per iniziare, hai bisogno di:

    1. Una chiave API Claude
    2. L'intestazione beta di cui sopra su tutte le richieste
    3. Accesso a Claude Managed Agents (abilitato per impostazione predefinita per tutti gli account API)

    Alcune funzionalità (outcomes, multiagent e memory) sono in anteprima di ricerca. Richiedi accesso per provarle.

    Limiti di velocità

    Gli endpoint di Managed Agents sono limitati per organizzazione:

    OperazioneLimite
    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.

    Linee guida di 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 un nome agente esistente)

    Non consentito:

    • "Claude Code" o "Claude Code Agent"
    • "Claude Cowork" o "Claude Cowork Agent"
    • Arte ASCII con branding Claude Code o elementi visivi che imitano Claude Code

    Il tuo prodotto dovrebbe mantenere il 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.