Cookie settings

We use cookies to deliver and improve our services, analyze site usage, and if you agree, to customize or personalize your experience and market our services to you. You can read our Cookie Policy here.

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?