Pular para o conteúdo principal

Agentes Gerenciados

Avançado

Se construir seu próprio loop de agente é mais infraestrutura do que você quer manter, uma opção de agente gerenciado (hospedado pela Anthropic) executa o loop para você — assim você foca no trabalho do agente, e não no encanamento de sessões, retentativas e estado.

O que o "gerenciado" te oferece

Em vez de implementar e hospedar o loop manualmente, você recebe blocos de construção hospedados, como:

  • Sessões — execuções persistentes do agente que você pode retomar.
  • Ambientes — um lugar para o agente operar com suas ferramentas.
  • Memória — estado que se mantém entre turnos/execuções sem que você precise conectar um banco de dados.
  • Agendamento — agentes que rodam em uma programação, sem supervisão.

(Os nomes exatos e a área de cobertura evoluem — trate a documentação oficial como autoritativa.)

Quando escolher gerenciado vs. personalizado

Escolha gerenciado quando…Escolha um loop personalizado / SDK quando…
Você quer hospedagem, estado e agendamento resolvidosVocê precisa de controle total sobre o loop e as ferramentas
Você está prototipando rapidamenteVocê tem necessidades estritas de infraestrutura/conformidade personalizadas
Simplicidade operacional importa mais que controleVocê está integrando profundamente na sua própria stack

É um espectro — chamada única → workflow → agente personalizado (SDK) → gerenciado. Comece tão simples quanto a tarefa permitir; suba de nível apenas quando precisar.

Os mesmos guardrails se aplicam

Hospedado ou não, um agente autônomo ainda executa ações. Mantenha privilégio mínimo, custo/iterações limitados e aprovação humana para etapas arriscadas — veja Protegendo Agentes e Endurecendo Execuções Autônomas.

Próximo