Запуск публичного бета-тестирования Anthropic Claude Managed Agents: 5 минут до запуска полностью управляемого ИИ-агента

8 апреля 2026 года компания Anthropic официально открыла публичную бета-версию Claude Managed Agents на платформе Claude. Этот новый фреймворк для полностью управляемых агентов (Managed Agent Harness) объединяет «цикл агента + выполнение инструментов + песочницу + сохранение состояния» в набор REST API. Теперь разработчикам не нужно самостоятельно выстраивать цикл работы агента, слой вызова инструментов или среду выполнения — достаточно обратиться к трем эндпоинтам: /v1/agents, /v1/environments и /v1/sessions. Это позволяет Claude выполнять длительные задачи в безопасной изолированной среде в качестве автономного агента.

Вместе с публичной бета-версией были представлены заголовок запроса managed-agents-2026-04-01 (Beta), новый набор инструментов agent_toolset_20260401 и протокол потоковой передачи событий на базе Server-Sent Events. В этой статье мы объединили официальную документацию и последние примечания к выпуску (Release Notes), чтобы систематизировать ключевые концепции Claude Managed Agents, способы интеграции API, модель событий и правила тарификации. Также мы подготовили готовый к использованию код на Python / curl, который поможет вам запустить реальную сессию Managed Agent менее чем за 5 минут.

Что такое Claude Managed Agents: позиционирование управляемых агентов

Прежде чем переходить к Managed Agents, нужно прояснить их отличие от стандартного Messages API. Anthropic предлагает два пути построения решений: Messages API отвечает за прямой вызов модели и подходит для сценариев, где вам нужен полный контроль над циклом агента. Managed Agents же предоставляют преднастроенную и конфигурируемую среду выполнения агента, которая идеально подходит для длительных, асинхронных рабочих нагрузок, требующих изоляции в песочнице.

Различия в позиционировании с Messages API

🎯 Совет по выбору: Если вы создаете фоновую задачу, где ИИ должен «автономно писать код, запускать скрипты, просматривать веб-страницы и затем суммировать результаты», Managed Agents будут гораздо удобнее, чем ручная связка Messages API с собственной песочницей. Рекомендую провести сравнительный тест обоих подходов на платформе APIYI apiyi.com, чтобы быстро понять, какой из них лучше подходит для вашей задачи.

Четыре основные концепции

Claude Managed Agents построены на четырех фундаментальных понятиях:

• Агент (Agent): статическое определение модели, системного промпта, инструментов, серверов MCP и навыков (Skills). Создается один раз и может переиспользоваться в нескольких сессиях, поддерживает версионирование.
• Среда (Environment): шаблон облачного контейнера, который описывает предустановленные пакеты, сетевые политики и подключенные файлы.
• Сессия (Session): конкретный экземпляр выполнения (Агент + Среда), отвечающий за выполнение разовых или длительных задач.
• События (Events): сообщения, передаваемые между сессией и клиентом, включая сообщения пользователя, вызовы инструментов, результаты инструментов, изменения состояния и т.д.

Анализ ключевых возможностей Managed Agents: песочница, инструментарий и SSE-потоки

Разобравшись с основными концепциями, давайте посмотрим, какие реальные возможности они предлагают в бета-версии.

Безопасная песочница и настройка контейнеров

Каждая сессия запускается в изолированном облачном контейнере со следующими характеристиками:

• Предустановленные среды выполнения: Python, Node.js, Go и другие популярные языки готовы к работе «из коробки».
• Сетевые политики: Поддерживаются режимы unrestricted (без ограничений) и более строгие режимы с ограниченным доступом, чтобы песочница не стала каналом для утечки данных.
• Файловая система: Файлы внутри контейнера сохраняются в течение всего жизненного цикла сессии, агент может считывать и записывать их между шагами.
• Монтируемые ресурсы: В Environment можно заранее подключить файлы данных или скрипты.

Встроенный набор инструментов agent_toolset_20260401

Публичная бета-версия предоставляет единый идентификатор набора инструментов agent_toolset_20260401, который активирует все предустановленные инструменты разом:

🎯 Совет разработчикам: agent_toolset_20260401 — это «общий переключатель» для быстрой проверки прототипов. В продакшене рекомендуется включать только нужный поднабор инструментов согласно принципу минимальных привилегий. Если вы хотите сравнить стоимость токенов для разных наборов инструментов через APIYI apiyi.com, можно просто переключить base_url и использовать тот же код.

Модель потоковых событий Server-Sent Events (SSE)

В отличие от традиционной модели API сообщений «один запрос — один ответ», Managed Agents используют модель событийного управления + передачу данных через SSE. Основные типы событий:

Быстрый старт с Claude Managed Agents: полный процесс интеграции API

Ниже представлен максимально краткий пример кода для выполнения полной сессии Managed Agent. Основные этапы: создание агента → создание среды → создание сессии → отправка сообщения и подписка на SSE-поток.

Предварительные условия

1. API-ключ Claude (или совместимый ключ APIYI apiyi.com).
2. Заголовок anthropic-beta: managed-agents-2026-04-01 в каждом запросе; официальный SDK добавит его автоматически, при использовании curl нужно указать вручную.
3. Обновление Python SDK до последней версии: pip install -U anthropic.

Минималистичный пример на Python

from anthropic import Anthropic

client = Anthropic(
    # Использование прокси APIYI позволяет использовать текущий код без правок в SDK
    base_url="https://api.apiyi.com",
    api_key="YOUR_API_KEY",
)

# 1. Создание агента
agent = client.beta.agents.create(
    name="Coding Assistant",
    model="claude-sonnet-4-6",
    system="You are a helpful coding assistant.",
    tools=[{"type": "agent_toolset_20260401"}],
)

# 2. Создание среды (неограниченная сеть)
env = client.beta.environments.create(
    name="quickstart-env",
    config={"type": "cloud", "networking": {"type": "unrestricted"}},
)

# 3. Создание сессии
session = client.beta.sessions.create(
    agent=agent.id,
    environment_id=env.id,
    title="Quickstart session",
)

# 4. Открытие SSE-потока и отправка сообщения пользователя
with client.beta.sessions.events.stream(session.id) as stream:
    client.beta.sessions.events.send(
        session.id,
        events=[{
            "type": "user.message",
            "content": [{
                "type": "text",
                "text": "Generate the first 20 Fibonacci numbers to fibonacci.txt",
            }],
        }],
    )
    for event in stream:
        if event.type == "agent.message":
            for block in event.content:
                print(block.text, end="")
        elif event.type == "agent.tool_use":
            print(f"\n[Using tool: {event.name}]")
        elif event.type == "session.status_idle":
            print("\n\nAgent finished.")
            break

# Создание агента с заголовком Beta
curl -sS https://api.apiyi.com/v1/agents \
  -H "x-api-key: $ANTHROPIC_API_KEY" \
  -H "anthropic-version: 2023-06-01" \
  -H "anthropic-beta: managed-agents-2026-04-01" \
  -H "content-type: application/json" \
  -d '{
    "name": "Coding Assistant",
    "model": "claude-sonnet-4-6",
    "system": "You are a helpful coding assistant.",
    "tools": [{"type": "agent_toolset_20260401"}]
  }'

# Структура запросов для создания Environment и Session аналогична, см. официальную документацию quickstart
# Для подписки на SSE-поток используйте:
# curl -N -H "Accept: text/event-stream" \
#   https://api.apiyi.com/v1/sessions/$SESSION_ID/stream

🎯 Совет по переиспользованию кода: указанный выше base_url для APIYI apiyi.com позволяет получить доступ к тестовым интерфейсам Managed Agents в материковом Китае с низкой задержкой. Все параметры официального SDK, заголовки Beta и типы событий полностью совместимы, никакой дополнительной обертки не требуется.

Графическая схема пяти этапов

[Клиент] ──1. создать агента──────────▶ [API]
[Клиент] ──2. создать среду───────────▶ [API]
[Клиент] ──3. создать сессию──────────▶ [API]
[Клиент] ──4. открыть SSE-поток───────▶ [API]
[Клиент] ──5. отправить user.message──▶ [API]
         ◀─ agent.message / tool_use / tool_result / status_idle ──

Суть процесса: сначала события, потом потоковый прием. Официальные рекомендации — сначала открыть SSE-поток, а затем отправлять событие пользователя, чтобы не пропустить промежуточные состояния.

Основные правила Claude Managed Agents: лимиты, биллинг и брендинг

В публичной бета-версии уже четко определены производственные параметры. Ниже приведены три правила, которые больше всего волнуют разработчиков.

Правила ограничения скорости (Rate Limits)

Лимиты рассчитываются для организации (Organization) и не зависят от уровня (Tier) аккаунта:

Кроме того, общие лимиты потребления и ограничения скорости по уровню аккаунта (Tier) продолжают действовать. Для высоконагруженных задач с массовым использованием агентов необходимо заранее планировать распределение нагрузки или использовать APIYI (apiyi.com) для распределения запросов между пулом из нескольких аккаунтов.

Модель тарификации

Стоимость использования Managed Agents состоит из двух частей:

1. Стоимость времени работы сессии: $0,08 за час сессии.
2. Стоимость токенов модели: по стандартному тарифу выбранной модели Claude (например, Sonnet 3.5 / Opus 3.5).

Нет никаких дополнительных подписок или фиксированных расходов на инфраструктуру. Это означает, что неактивная, но не закрытая сессия продолжает тарифицироваться по часам. Обязательно вызывайте метод завершения сессии после выполнения задачи.

Требования к брендингу

Anthropic установила четкие правила использования бренда Claude для партнеров:

• ✅ Разрешено: Claude Agent, Claude (в контексте меню), {YourAgentName} Powered by Claude.
• ❌ Запрещено: Claude Code, Claude Code Agent, Claude Cowork и подобные названия; запрещено копировать ASCII-арт или визуальные элементы Claude Code.

🎯 Совет по соблюдению правил: При разработке агентских продуктов для бизнеса рекомендуется делать упор на собственный бренд, указывая партнерство только в технических примечаниях фразой "Powered by Claude". Если вам нужна официальная авторизация бренда или шаблоны UI, вы можете получить инструкции по партнерским каналам через APIYI (apiyi.com).

Типовые сценарии использования Claude Managed Agents: что стоит переносить в первую очередь

Хотя публичная версия всё ещё содержит функции, находящиеся на стадии Research Preview (outcomes, multiagent, memory), для следующих четырех сценариев решение уже готово к внедрению.

Четыре типа рабочих нагрузок, подходящих для миграции

Сценарии, в которых использование пока не рекомендуется

• Диалоги с экстремально низкой задержкой: Запуск сессии и накладные расходы SSE не подходят для UI с откликом в миллисекунды.
• Локальные развертывания с жесткими требованиями к комплаенсу: Managed Agents — это облачный сервис, он не поддерживает on-premise решение.
• Исследовательские проекты с кастомным циклом агента (agent loop): По-прежнему рекомендуется использовать Messages API для создания собственного цикла.

🎯 Совет по миграции: Попробуйте перенести существующие задачи, работающие на "Messages API + самописном планировщике инструментов", на Managed Agents для сравнительного теста. Запустите одну и ту же задачу с одним промптом на обеих версиях, чтобы сравнить стоимость токенов и процент успешных завершений. Через APIYI (apiyi.com) вы можете использовать один и тот же ключ для доступа к обоим типам интерфейсов, чтобы не переключаться между ними во время тестов.

FAQ: Подводные камни при работе с Managed Agents

Q1: Нужно ли вручную добавлять managed-agents-2026-04-01?

При использовании официальных SDK (Python / TypeScript / Go / Java / C# / Ruby / PHP) добавлять ничего не нужно — SDK автоматически внедряет этот заголовок в Beta-пути. Вручную прописывать anthropic-beta: managed-agents-2026-04-01 нужно только при использовании нативного curl или самописных HTTP-клиентов. Рекомендуем при работе через сервис-прокси API APIYI (apiyi.com) использовать стандартные пути для обеспечения максимальной совместимости.

Q2: Теряется ли сессия при разрыве SSE-потока?

Нет. История событий сессии сохраняется на стороне сервера. После переподключения к эндпоинту /v1/sessions/{id}/stream вы продолжите получать последующие события, а API дошлет недостающие данные из буфера. Это в корне отличается от Messages API с его моделью «один запрос — один ответ».

Q3: Как прервать выполнение агента?

Managed Agents поддерживают управление на лету (mid-execution steering): просто отправьте еще одно сообщение user.message в тот же эндпоинт /events — это прервет текущий цикл вызова инструментов и изменит направление работы. Также можно принудительно завершить сессию через специальный эндпоинт прерывания.

Q4: В каких случаях списывается оплата за сессию?

Оплата взимается в размере $0.08/час, пока сессия находится в «рабочем» состоянии (даже если агент в статусе status_idle). Рекомендуем явно закрывать сессии по завершении задачи, чтобы избежать лишних трат. С помощью панели детализации счетов APIYI (apiyi.com) можно быстро выявить зависшие сессии.

Q5: Какие модели Claude поддерживают Managed Agents?

На этапе публичного бета-тестирования поддерживаются три основные модели: Claude Sonnet 4.6, Claude Opus 4.6 и Claude Haiku 4.5. Большое контекстное окно (1 млн токенов) доступно по умолчанию для Opus 4.6 и Sonnet 4.6, дополнительные Beta-заголовки для этого не требуются.

Q6: Можно ли перенести существующие Agent Skills / MCP Server?

Да. В определении агента можно напрямую объявить список серверов MCP и ссылки на навыки (Skills). Managed Agents используют протокол Agent Skills Beta, выпущенный в октябре 2025 года, поэтому существующие наборы навыков можно интегрировать без доработок.

Итоги: Переход на новую парадигму разработки с Managed Agents

Запуск публичного бета-тестирования Claude Managed Agents означает, что Anthropic официально включила «инфраструктуру агентов» в свою линейку продуктов. Для разработчиков ценность этого обновления заключается не в одной функции, а в устранении пяти главных проблем при создании агентских систем: реализации циклов, выполнении инструментов, изоляции песочницы, персистентности состояний и протоколе потоковой передачи событий. Достаточно добавить Beta-заголовок managed-agents-2026-04-01 и вызвать три эндпоинта, чтобы превратить Claude в полноценного автономного исполнителя.

В сочетании с новейшими моделями Claude Sonnet 4.6 / Opus 4.6, контекстом в 1 млн токенов, Agent Skills и автоматическим кэшированием, Managed Agents впервые позволяют реализовать масштабируемые корпоративные решения для длительных, асинхронных и мультиинструментальных агентских задач. Рекомендуем сначала протестировать их в сценариях с низким риском (автоматизация отчетов, создание шаблонов кода), а затем постепенно переносить критически важные бизнес-процессы.

🎯 Рекомендация: Командам, готовым к миграции, советуем указать base_url на APIYI (apiyi.com). Это позволит использовать код официальных SDK, обеспечит стабильную скорость доступа из Китая и позволит параллельно тестировать работу Messages API и Managed Agents для принятия взвешенных решений.

— Команда APIYI (техническая команда apiyi.com)