Anthropic offers two ways to build with Claude, each suited to different use cases:
| Messages API | Claude Managed Agents | |
|---|---|---|
| What it is | Direct model prompting access | Pre-built, configurable agent harness that runs in managed infrastructure |
| Best for | Custom agent loops and fine-grained control | Long-running tasks and asynchronous work |
| Learn more | Messages API docs | Claude Managed Agents docs |
Claude Managed Agents fornece o harness e a infraestrutura para executar Claude como um agente autônomo. Em vez de construir seu próprio loop de agente, execução de ferramentas e runtime, você obtém um ambiente totalmente gerenciado onde Claude pode ler arquivos, executar comandos, navegar na web e executar código com segurança. O harness suporta cache de prompt integrado, compactação e outras otimizações de desempenho para saídas de agente de alta qualidade e eficientes.
Claude Managed Agents é construído em torno de quatro conceitos:
| Concept | Description |
|---|---|
| Agent | The model, system prompt, tools, MCP servers, and skills |
| Environment | Configuration for where sessions run: an Anthropic-managed cloud container, or a self-hosted sandbox on your own infrastructure |
| Session | A running agent instance within an environment, performing a specific task and generating outputs |
| Events | Messages exchanged between your application and the agent (user turns, tool results, status updates) |
Criar um agente
Defina o modelo, prompt do sistema, ferramentas, servidores MCP e habilidades. Crie o agente uma vez e faça referência a ele por ID em todas as sessões.
Criar um ambiente
Configure um contêiner em nuvem com pacotes pré-instalados (Python, Node.js, Go, etc.), regras de acesso à rede e arquivos montados.
Iniciar uma sessão
Inicie uma sessão que faça referência à sua configuração de agente e ambiente.
Enviar eventos e transmitir respostas
Envie mensagens do usuário como eventos. Claude executa ferramentas autonomamente e transmite resultados de volta via server-sent events (SSE). O histórico de eventos é persistido no servidor e pode ser recuperado na íntegra.
Orientar ou interromper
Envie eventos de usuário adicionais para orientar o agente durante a execução ou interrompa-o para mudar de direção.
Claude Managed Agents é melhor para cargas de trabalho que precisam de:
Claude Managed Agents oferece a Claude acesso a um conjunto abrangente de ferramentas integradas:
Veja Ferramentas para a lista completa e opções de configuração.
Claude Managed Agents está atualmente em beta. Todos os endpoints de Managed Agents exigem o cabeçalho beta managed-agents-2026-04-01. O SDK define o cabeçalho beta automaticamente. Os comportamentos podem ser refinados entre versões para melhorar as saídas.
Para começar, você precisa de:
Certos recursos (outcomes, multiagent e memory) estão em visualização de pesquisa. Solicite acesso para experimentá-los.
Os endpoints de Managed Agents têm limite de taxa por organização:
| Operação | Limite |
|---|---|
| Criar endpoints (agentes, sessões, ambientes, etc.) | 60 solicitações por minuto |
| Ler endpoints (recuperar, listar, transmitir, etc.) | 600 solicitações por minuto |
Os limites de gastos em nível de organização e limites de taxa baseados em camada também se aplicam.
Para parceiros que integram Claude Managed Agents, o uso da marca Claude é opcional. Ao fazer referência a Claude em seu produto:
Permitido:
Não permitido:
Seu produto deve manter sua própria marca e não parecer ser Claude Code, Claude Cowork ou qualquer outro produto Anthropic. Para dúvidas sobre conformidade de marca, entre em contato com a equipe de vendas da Anthropic.
Was this page helpful?