Managed Agents

Managed Agents — бета-продукт Anthropic (заголовок managed-agents-2026-04-01, SDK выставляет его автоматически) для запуска stateful-агентов на стороне сервера. В отличие от Claude API с tool use, где вы сами хостите цикл агента и инструменты, и в отличие от Claude Agent SDK, где вы собираете собственный harness, здесь Anthropic выполняет цикл агента на своём оркестрационном слое и поднимает контейнер на каждую сессию, внутри которого исполняются инструменты агента: bash, файловые операции, код.

Как это работает

Продукт построен вокруг трёх объектов. Agent (/v1/agents) — сохранённая, версионируемая конфигурация: модель, системный промпт, инструменты, MCP-серверы, skills. Каждое обновление создаёт неизменяемую версию, а сессия может закрепиться (pin) за конкретной версией. Session (/v1/sessions) — один stateful-запуск: ссылается на агента и environment_id, подключает ресурсы (файлы, GitHub-репозитории, memory stores) и vault_ids. Environment (/v1/environments) — переиспользуемый шаблон контейнера: тип cloud (сеть unrestricted или limited со списком allowed_hosts) либо self_hosted, когда инструменты выполняются в вашей инфраструктуре через воркер с исходящим polling, а цикл агента остаётся на стороне Anthropic. Жизненный цикл сессии: rescheduling → running ↔ idle → terminated. Кэширование промптов, автоматическая компактизация контекста и extended thinking встроены. Для мультиагентных сценариев агент-координатор получает ростер до 20 агентов; сабагенты работают как потоки (до 25 одновременно), разделяя файловую систему, но не историю разговора; допускается один уровень делегирования.

Когда применять

Выбирайте Managed Agents, когда нужно, чтобы Anthropic выполнял и цикл агента, и хостил песочницу для инструментов: долгие stateful-запуски с рабочей директорией на каждую задачу, стриминг событий в интерфейс, версионируемые конфигурации агентов, переиспользуемые между сессиями. Если вы хотите хостить вычисления сами и полностью контролировать цикл — берите Claude API с tool use или Agent SDK. Managed Agents доступен в first-party API и на Claude Platform on AWS, но недоступен на Amazon Bedrock, Google Vertex и Microsoft Foundry.

Типичные ошибки

Главный анти-паттерн — вызывать agents.create() при каждом запуске: агент создаётся один раз, дальше на него ссылаются по ID, а изменения вносятся обновлением, порождающим новую версию. Вторая ошибка — путать Managed Agents с Claude Agent SDK: SDK — это библиотека для вашего собственного harness, а здесь оркестрацию и контейнер держит Anthropic. Не рассчитывайте на доступность продукта на Amazon Bedrock или Google Vertex. И не кладите секреты в системный промпт — он сохраняется в истории событий сессии.

Как это работает

Когда применять

Типичные ошибки

Связанные понятия

Полезные ресурсы