Claude Platform Docs
Managed AgentsПервые шаги

Обзор Claude Managed Agents

Готовая настраиваемая агентная обвязка, работающая в управляемой инфраструктуре. Лучше всего подходит для длительных задач и асинхронной работы.

Anthropic предлагает два способа создания решений с Claude, каждый из которых подходит для разных сценариев использования:

Messages APIClaude Managed Agents
Что этоПрямой доступ к отправке подсказок моделиГотовая настраиваемая агентная обвязка, работающая в управляемой инфраструктуре
Лучше всего подходит дляПользовательских агентных циклов и детального контроляДлительных задач и асинхронной работы

Claude Managed Agents предоставляет «harness» (обвязку) и инфраструктуру для запуска Claude в качестве автономного агента. Вместо того чтобы создавать собственный агентный цикл, выполнение инструментов и среду выполнения, вы получаете полностью управляемую среду, в которой Claude может читать файлы, выполнять команды, просматривать веб-страницы и безопасно запускать код. Обвязка поддерживает встроенное «prompt caching» (кэширование подсказок), «compaction» (уплотнение) и другие оптимизации производительности для получения высококачественных и эффективных результатов работы агента. Чтобы вместо этого создать собственный агентный цикл с прямым доступом к модели, см. Использование Messages API.

Создайте свою первую сессию агента

Создайте сессию и отправьте своё первое событие

Типы событий, ограничения скорости, флаги CLI и другие справочные таблицы

Основные понятия

Claude Managed Agents построен вокруг четырёх понятий:

ПонятиеОписание
Agent (агент)Модель, системная подсказка, инструменты, серверы MCP и навыки
Environment (среда)Конфигурация того, где выполняются сессии: облачная песочница, управляемая Anthropic, или самостоятельно размещённая песочница в вашей собственной инфраструктуре
Session (сессия)Запущенный экземпляр агента в среде, выполняющий конкретную задачу и генерирующий выходные данные
Events (события)Сообщения, которыми обмениваются ваше приложение и агент (реплики пользователя, результаты инструментов, обновления статуса)

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

  1. Создайте агента

    Определите модель, системную подсказку, инструменты, серверы MCP и навыки. Создайте агента один раз и ссылайтесь на него по идентификатору в разных сессиях.

  2. Создайте окружение

    Настройте, где будет работать агент: в облачной песочнице или в самостоятельно размещённой песочнице на вашей собственной инфраструктуре.

  3. Запустите сессию

    Запустите сессию, которая ссылается на конфигурацию вашего агента и окружения.

  4. Отправляйте события и получайте ответы в потоковом режиме

    Отправляйте сообщения пользователя в виде событий. Claude автономно запускает инструменты и передаёт результаты обратно с помощью потоковой передачи через «server-sent events» (события, отправляемые сервером), или SSE. История событий сохраняется на стороне сервера и может быть получена полностью.

  5. Направляйте или прерывайте

    Отправляйте дополнительные пользовательские события, чтобы направлять агента в процессе выполнения, или прерывайте его, чтобы изменить направление.

Когда использовать Claude Managed Agents

Claude Managed Agents лучше всего подходит для рабочих нагрузок, которым требуется:

  • Длительное выполнение: задачи, которые выполняются минуты или часы с множеством вызовов инструментов
  • Облачная инфраструктура: безопасные песочницы с предустановленными пакетами и доступом к сети
  • Самостоятельно размещённое выполнение: песочницы на контролируемой вами инфраструктуре для соблюдения нормативных требований или требований к размещению данных
  • Минимальная инфраструктура: нет необходимости создавать собственный агентный цикл, песочницу или слой выполнения инструментов
  • Сессии с сохранением состояния: постоянные файловые системы и история разговоров на протяжении нескольких взаимодействий
  • Выполнение по расписанию: повторяющиеся запуски агента по расписанию cron с помощью развёртываний по расписанию

Поддерживаемые инструменты

Claude Managed Agents предоставляет Claude доступ к набору встроенных инструментов:

  • Bash: выполнение команд оболочки в песочнице
  • Файловые операции: чтение, запись, редактирование, glob и grep файлов в песочнице
  • Веб-поиск и загрузка: поиск в интернете и получение содержимого по URL, при необходимости с ограничением по списку разрешённых или запрещённых доменов
  • Серверы MCP: подключение к внешним поставщикам инструментов

Полный список и параметры конфигурации см. в разделе Инструменты.

Доступ к бета-версии

Чтобы начать работу, вам потребуется:

  1. Ключ API Claude
  2. Бета-заголовок managed-agents-2026-04-01 во всех запросах
  3. Доступ к Claude Managed Agents (включён по умолчанию для всех учётных записей API)

В рамках бета-версии туннели MCP и dreaming находятся в более ограниченном исследовательском предварительном доступе. Запросите доступ, чтобы включить их.

Claude Managed Agents изначально спроектирован с сохранением состояния: сессии являются длительными, корректно возобновляются после пауз и хранят историю разговоров, состояние песочницы и результаты на стороне сервера. По этой причине Managed Agents в настоящее время не подпадает под действие Zero Data Retention или соглашения HIPAA Business Associate Agreement (BAA). Вы сохраняете контроль над этими данными: вы можете в любое время через API удалять сессии и отдельно удалять любые загруженные вами файлы. Сведения о применимости для всех функций см. в разделе API и хранение данных.

См. разделы Ограничения скорости и Рекомендации по использованию бренда в справочнике.

Was this page helpful?