← Sandbox SDK / sandbox / tutorials
Настройте Claude Managed Agents
Cloudflare предоставляет самоуправляемую среду для Claude Managed Agents ↗. Цикл агента выполняется на платформе Anthropic, а Cloudflare предоставляет среду выполнения (песочницы, контроль исходящего трафика, доступ к браузеру, электронную почту и пользовательские инструменты), в которой выполняются действия агента.
Эта интеграция поставляется в виде шаблона развёртывания с открытым исходным кодом. Сделайте форк репозитория, разверните его в своём аккаунте Cloudflare и настройте по своему усмотрению.
Начало работы
Что вы получаете
Разверните плоскость управления на основе Workers, которая предоставляет вам:
- Два бэкенда песочницы : каждый агент может работать в полноценной MicroVM (Containers) или лёгкий изолят (Dynamic Workers). MicroVM предоставляют агенту полноценную среду Linux с bash и произвольными процессами. Изоляты запускаются за миллисекунды и стоят в разы дешевле сессии контейнера.
- Подключение к приватным сервисам : подключение агентов к частным внутренним сервисам через Workers VPC и Mesh не открывая их для публичного интернета.
- Контроль исходящего трафика : Направляйте весь трафик агента через настраиваемые прокси. Внедряйте учётные данные в исходящие запросы так, чтобы агент их вообще не видел, ограничивайте доступ к конкретным доменам или пишите собственный proxy middleware.
- Agent Email : выделите каждой сессии агента собственный email-адрес для отправки и получения сообщений с помощью Cloudflare Email Service.
- Инструменты запуска в браузере : предоставьте агентам headless-браузеры на основе Browser Run для веб-запросов, скриншотов и управления через CDP. Записи сессий предоставляют журнал аудита каждого действия в браузере.
- Генерация изображений : генерация изображений с помощью Workers AI.
- Пользовательские инструменты : расширяйте агентов собственными инструментами, добавляя определение функции в один файл. Инструменты выполняются в среде выполнения Workers с доступом ко всем вашим bindings. Дополнительная инфраструктура не требуется.
- Dashboard : встроенный интерфейс для управления агентами, просмотра сессий, изучения логов и подключения по SSH к запущенным MicroVM-песочницам.
Как это работает
Когда агент Claude запускает сессию, Anthropic отправляет webhook в плоскость управления на базе Workers, которая работает в вашем аккаунте Cloudflare. Она выделяет каждой сессии собственный sandbox, направляет исходящий трафик через политику egress для этой сессии и сохраняет состояние между переходами сессии в спящий режим.
Anthropic описывает это как разделение «мозга» и «рук»: цикл работы агента выполняется на стороне Anthropic (мозг), а инфраструктура для запуска и выполнения кода (руки) работает на Cloudflare.
Когда это использовать
Используйте самостоятельно управляемую среду Cloudflare, если вам нужно:
- Контроль над инфраструктурой песочницы, в которой выполняются ваши агенты
- Безопасные подключения к частным внутренним сервисам
- Пользовательские политики исходящего трафика для внедрения учётных данных и ограничения доменов
- Пользовательские инструменты, использующие привязки Cloudflare (R2, D1, KV, Vectorize и другие)
- Возможность выбирать бэкенд MicroVM или isolate отдельно для каждого агента
Начало работы
Следуйте руководство по началу работы ↗ в репозитории, чтобы развернуть плоскость управления в вашем аккаунте. Руководство описывает создание окружения Anthropic, настройку секретов, подготовку хранилища, развертывание Worker и настройку вебхуков.
Ключевая документация
В репозитории есть подробная документация по каждой возможности:
| Тема | Что рассматривается в этом разделе |
|---|---|
| Подключение к частным сервисам ↗ | Обращайтесь к сервисам в других облаках, локальной инфраструктуре или на вашем ноутбуке с помощью Workers VPC bindings |
| Применение политик исходящего трафика (egress) ↗ | Внедряйте учётные данные и ограничивайте сессии агентов. Настраивайте списки разрешений и запретов, внедрение заголовков, собственные прокси на Worker и маршрутизацию VPC |
| Песочницы: изоляты или виртуальные машины ↗ | Выберите оптимальную среду выполнения агента |
| email-адрес агента ↗ | Дайте агентам собственные адреса электронной почты и возможность отправки писем |
| Инструменты рендеринга в браузере ↗ | Наблюдаемые взаимодействия агента с браузером через Browser Run |
| Добавление собственных инструментов ↗ | Новые инструменты объявляются в одном файле: src/tools/custom-tools.ts ↗ |
| Настройка песочниц ↗ | Изменить Dockerfile и instance_type настройки бэкенда MicroVM |
| Снимки и сохранение состояния ↗ | Сохранение состояния для обоих типов sandbox |
| Архитектура ↗ | Жизненный цикл запроса от входящего webhook через диспетчеризацию к одному из бэкендов песочницы, а также все привязки Worker, которые использует плоскость управления |
| Защита доступа ↗ | Безопасный доступ к плоскости управления CMA |