Создание первого Managed Agent с Claude

Почему Managed Agents

Claude Managed Agents — это first managed harness с автоматическим масштабированием и production-готовыми компонентами. Платформа эволюционировала через три поколения:

Ключевое преимущество: вы определяете логику агента, а Claude берет на себя инфраструктуру, безопасность и надежность.

Три пилона архитектуры

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

• Agent Endpoint («мозг»): где живет персона агента.
  • Модель (Claude Opus 4.7 и выше)
  • Системный промпт (описание роли и поведения)
  • Инструменты: MCP-серверы и навыки, которые может вызывать агент
• Environment («руки»): где агент действует, выполняет команды и общается с внешними системами.
  • Cloudhosted в Anthropic Cloud
  • Или собственный контейнер (BYOC) — приносите свой Docker
  • Сетевые правила, белый список URL, sandbox-ограничения
• Session: связывает агента и окружение в один диалог.
  • Уникальный ID агента + ID окружения
  • Отслеживание состояния и истории
  • Стриминг событий пользователю

Совет: разделение «мозга» и «рук» — основа безопасности и производительности. Credentials хранятся в окружении, а не видны модели.

Пример: SRE-агент за 5 шагов

Создадим агента для автоматического реагирования на инциденты (Incident Response). Вот как это работает:

1. Определение агента
   • Модель: Claude Opus 4.7
   • Системный промпт: опишите роль SRE (анализирует логи, проверяет метрики)
   • Инструменты: сколько нужно (API метрик, логи, деплойные скрипты)
2. Определение окружения
   • Песочница с сетевыми правилами
   • Белый список URL, через которые агент может обращаться к вашим системам
3. Загрузка данных
   • Файлы с логами и метриками через Files API
   • Контекстный инжиниринг критичен — дайте агенту достаточно контекста
4. Создание сессии
   • Свяжите ID агента, ID окружения и загруженные ресурсы
   • Получите Session ID для управления диалогом
5. Стриминг событий
   • Агент не отправляет токены, а события (action_started, tool_call, message_delta)
   • Локальные инструменты выполняются на вашей стороне
   • Полная observability каждого шага

Результат: агент анализирует логи, проверяет метрики, находит root-cause инцидента и предлагает исправления — всё автоматически.

Выигрыш в производительности и надежности

Архитектура Managed Agents дает четыре ключевых улучшения:

• Разделение «мозга» и «рук»
  • Безопасность: credentials не видны модели, хранятся в Environment
  • Масштабируемость: независимо масштабируете вычисления и обработку
  • Изоляция: каждый агент работает в изолированной sandbox
• Снижение latency на >90% (TTFT — Time To First Token)
  • Раньше: весь промпт + контекст → Model → ответ
  • Теперь: мозг обрабатывает событие, руки действуют параллельно
• Session Persistence
  • Сессии сохраняются в облаке
  • При перезагрузке можно возобновить диалог с той же точки
  • История и состояние не теряются
• Production-ready из коробки
  • Встроенное управление надежностью (retries, fallback)
  • Кэширование и компрессия контекста
  • Observability в Developer Console
  • Мониторинг метрик, ошибок, затрат

Важно: Event-ориентированная архитектура обеспечивает надежность. Вы видите каждое действие агента и можете вмешаться или откатить.

Расширенные возможности для опытных команд

Кроме базовой функциональности, платформа предоставляет мощные инструменты для advanced use-cases:

• Навыки и подагенты — параллельное выполнение задач, управление контекстом и делегирование
• Память и Dreaming — агент анализирует свои логи, запоминает предпочтения пользователя, становится self-learning
• Outcomes — вместо списка действий задавайте критерии успеха, агент сам выбирает путь
• Vaults — безопасное управление credentials и secrets с полной изоляцией архитектуры
• Webhooks — триггеры по внешним событиям, асинхронное управление состоянием
• Developer Console — готовый дашборд для наблюдаемости, мониторинга и управления агентами

Совет: начните с базовой функциональности, затем добавляйте расширения. Архитектура построена на composable компонентах.