Anthropic предлагает два способа разработки с Claude, каждый из которых подходит для разных сценариев использования:
| Messages API | Claude Managed Agents | |
|---|---|---|
| Что это | Прямой доступ к модели через подсказки | Готовая настраиваемая агентная оболочка, работающая в управляемой инфраструктуре |
| Лучше всего подходит для | Пользовательских агентных циклов и детального контроля | Длительных задач и асинхронной работы |
| Подробнее | Документация по Messages API | Документация по Claude Managed Agents |
Claude Managed Agents предоставляет оболочку и инфраструктуру для запуска Claude в качестве автономного агента. Вместо того чтобы создавать собственный цикл агента, механизм выполнения инструментов и среду выполнения, вы получаете полностью управляемое окружение, в котором Claude может читать файлы, выполнять команды, просматривать веб-страницы и безопасно исполнять код. Оболочка поддерживает встроенное кэширование подсказок, сжатие контекста и другие оптимизации производительности для получения качественных и эффективных результатов работы агента.
Claude Managed Agents также доступен в Claude Platform на AWS с некоторыми отличиями в доступности функций и поведении сессий. См. раздел Claude Managed Agents в руководстве по Claude Platform на AWS.
Создайте свою первую сессию агента
Создайте сессию и отправьте первое событие
Типы событий, ограничения скорости, флаги CLI и другие справочные таблицы
Claude Managed Agents строится на четырёх концепциях:
| Понятие | Описание |
|---|---|
| Агент | Модель, системная подсказка, инструменты, серверы MCP и навыки |
| Среда | Конфигурация места выполнения сессий: облачная песочница под управлением Anthropic или самостоятельно размещённая песочница на вашей собственной инфраструктуре |
| Сессия | Запущенный экземпляр агента внутри среды, выполняющий конкретную задачу и генерирующий выходные данные |
| События | Сообщения, которыми обмениваются ваше приложение и агент (ходы пользователя, результаты инструментов, обновления статуса) |
Создайте агента
Определите модель, системную подсказку, инструменты, серверы MCP и навыки. Создайте агента один раз и ссылайтесь на него по идентификатору в разных сессиях.
Создайте окружение
Настройте, где будет работать агент: в облачной песочнице или в самостоятельно размещённой песочнице на вашей собственной инфраструктуре.
Запустите сессию
Запустите сессию, которая ссылается на конфигурацию вашего агента и окружения.
Отправляйте события и получайте ответы в потоке
Отправляйте пользовательские сообщения в виде событий. Claude автономно выполняет инструменты и передаёт результаты обратно через «server-sent events» (события, отправляемые сервером), или SSE. История событий сохраняется на стороне сервера и может быть получена полностью.
Направляйте или прерывайте
Отправляйте дополнительные пользовательские события, чтобы направлять агента в процессе выполнения, или прерывайте его, чтобы изменить направление работы.
Claude Managed Agents лучше всего подходит для рабочих нагрузок, которым требуется:
Claude Managed Agents предоставляет Claude доступ к набору встроенных инструментов:
Полный список и параметры конфигурации см. в разделе Инструменты.
Claude Managed Agents в настоящее время находится в стадии бета-тестирования. Все конечные точки Managed Agents требуют бета-заголовка managed-agents-2026-04-01. SDK устанавливает бета-заголовок автоматически. Поведение может уточняться между выпусками для улучшения результатов.
Чтобы начать работу, вам потребуется:
managed-agents-2026-04-01 во всех запросахВ рамках бета-версии туннели MCP и сновидения находятся в более ограниченной исследовательской предварительной версии. Запросите доступ, чтобы включить их.
Claude Managed Agents по своей архитектуре сохраняет состояние: сессии являются длительными, корректно возобновляются после пауз и хранят историю разговора, состояние песочницы и результаты на стороне сервера. По этой причине Managed Agents в настоящее время не подпадает под действие политики нулевого хранения данных (Zero Data Retention) и соглашения делового партнёра HIPAA (BAA). Вы сохраняете контроль над этими данными: вы можете удалять сессии, а также отдельно удалять любые загруженные вами файлы в любое время через API. Информацию о применимости для всех функций см. в разделе API и хранение данных.
См. разделы Ограничения скорости и Рекомендации по брендингу в справочнике.
Was this page helpful?