О чём урок
Модернизация кода никогда не заканчивается. Устаревшие зависимости, риски безопасности, требования соответствия и устаревшие шаблоны продолжают накапливаться в больших кодовых базах, а один массивный PR для миграции сложно рецензировать и рискованно объединять. Агент миграции кода должен работать в контролируемой среде, выполняя по одной ограниченной задаче за раз: проверять соответствующий репозиторий, редактировать файлы, запускать проверки и возвращать патч. В этом руководстве используется Agents SDK с harness вне песочницы: оркестрация остается в доверенном хост-процессе, в то время как команды оболочки и редактирование файлов выполняются в изолированных средах выполнения. Такое разделение позволяет хост-harness использовать секреты, инструменты и внешние сервисы, предоставляя песочнице только те файлы и команды, которые необходимы для выполнения задачи. К концу этого руководства вы сможете: Держать harness агента вне среды выполнения, которая запускает команды оболочки и редактирует файлы Разбивать задачу модернизации на части репозитория размером с задачу Валидировать каждую часть с помощью тестов, проверок, артефактов и журнала аудита Менять провайдеров песочницы без переписывания агента Пример представляет собой миграцию кода двух сервисов. Каждый сервис работает в своей собственной песочнице и возвращает свой собственный пакет патчей, той же формы, которую можно использовать для открытия отдельных pull request'ов для ревью и CI. В каждой песочнице агент мигрирует обертку клиента OpenAI из Chat Completions в Responses API. Попутно он запускает тесты, патчит приложение и тесты, выполняет проверку компиляции, повторно запускает тесты и возвращает типизированный отчет о миграции с патчем. Мы будем запускать песочницу с Docker локально. Код, специфичный для провайдера, изолирован от создания песочницы, поэтому один и тот же harness и агент могут указывать на хостинг-провайдеров песочницы, таких как E2B или Cloudflare, без изменения SandboxAgent, tools, manifest или prompt. Доверенный хост-процесс владеет Agents SDK harness, tools, MCP servers, учетными данными, политикой и аудитом. Среда выполнения получает только ограниченное рабочее пространство для текущей задачи и возможности, ориентированные на песочницу, необходимые для выполнения команд и редактирования файлов.
План урока
- Архитектура: песочница как инструмент
- Требования
- Установка зависимостей
- Импорт хост-harness
- 1. Определение задач миграции
- 2. Проверка базового состояния до внесения изменений агентом
- 3. Подготовка рабочего пространства песочницы
- 4. Определение агента песочницы
Урок входит в полный доступ. Полный текст и видео открываются после оплаты. Первые уроки каждого курса бесплатны.