Kling Digital
ru
Контакты
2026-11-19
8 МИН ЧТЕНИЯ
Рекомендуемое руководство

OpenHands: руководство по автономному ИИ-агенту разработки в изолированной песочнице

OpenHands — открытая платформа автономной разработки ПО под лицензией MIT без привязки к поставщикам языковых моделей. В изолированных песочницах Docker или Kubernetes агент редактирует множество файлов, ставит зависимости, запускает тесты и итеративно устраняет сбои. В обзоре разобраны модульный V1 SDK, детерминированный EventStream, политики безопасности, Microagents и нативная интеграция серверов MCP.

OpenHands: руководство по автономному ИИ-агенту разработки в изолированной песочнице

Прямой доступ автономного ИИ-агента к оболочке рабочей станции разработчика способен сломать локальные инструменты сразу нескольких репозиториев после одной неудачной установки пакета. В рамках трендов экосистемы открытых ИИ-агентов ноября 2026 года команды, создающие промышленные решения искусственного интеллекта, выбирают OpenHands, поскольку контейнерная изоляция лежит в основе его исполнения.

Что такое OpenHands? OpenHands (эволюция проектов OpenDevin и All-Hands-AI) — вендор-независимая открытая платформа автономной разработки ПО под лицензией MIT. В изолированных песочницах Docker или Kubernetes агент редактирует множество файлов репозитория, устанавливает зависимости, запускает модульные и интеграционные тесты и итеративно устраняет сбои до прохождения проверок без риска для хостовой ОС.

Важно

Краткое резюме — архитектурные опоры OpenHands

  • Лицензия MIT без привязки к вендору: Платформа, Software Agent SDK, CLI и контур оценки открыты под лицензией MIT и работают с коммерческими API и локальными моделями.
  • Изолированные правки и автономные тесты: Docker Runtime по умолчанию и Kubernetes Remote Runtime изолируют изменения файлов, зависимости и тестовые прогоны в эфемерных контейнерах.
  • Модульный V1 SDK и контроль: Детерминированный EventStream, политики (AlwaysConfirm, ConfirmRisky, NeverConfirm), --llm-approve, Microagents и нативный MCP с OAuth.

Модульная архитектура OpenHands V1 и EventStream

OpenHands перешла к разделенной архитектуре V1 в основном репозитории OpenHands и Software Agent SDK, объединив веб-среду и headless-конвейеры CI на одном ядре.

Разделение пакетов V1

  • openhands.sdk: Содержит LLM, Agent, Conversation, Event и политики безопасности. Совместимость с LiteLLM позволяет менять провайдера через переменные окружения без правки кода.
  • openhands.tools: Типизированные инструменты — TerminalTool для оболочки, FileEditorTool для точных многофайловых патчей и TaskTrackerTool для планирования этапов.
  • openhands.workspace: Абстрагирует границу между локальной папкой, эфемерным контейнером Docker и удаленной средой.
  • openhands.agent_server: Предоставляет REST и WebSocket API для браузерного Agent Canvas и OpenHands CLI.

Детерминированный журнал EventStream

Вместо неструктурированной переписки OpenHands записывает каждый шаг планирования, команду оболочки, патч файла и вывод ошибок тестов в упорядоченный поток EventStream. Сервер openhands.agent_server транслирует эти события по WebSocket в браузерный интерфейс Agent Canvas и консольный клиент CLI, позволяя инженерам наблюдать изменения диффов и потоки stdout/stderr в реальном времени без прямого подключения к оболочке контейнера. С флагом LOG_ALL_EVENTS=true платформенные команды получают воспроизводимый разбор сбоев при остановке задачи, проверяемый аудиторский след для служб информационной безопасности и надежное возобновление длительных миграций после обрыва связи.

Многофайловые изменения в песочнице и цикл тестирования

Промышленные исправления и новые серверные функции почти всегда затрагивают схемы базы данных, сервисный слой, маршруты API и набор фикстур одновременно. OpenHands решает эту задачу, объединяя согласованную правку нескольких файлов с жесткой контейнерной изоляцией.

Docker Runtime, Kubernetes Remote Runtime и Local Runtime

По умолчанию Docker Runtime поднимает чистый эфемерный контейнер на каждую сессию, полностью изолируя установку библиотек, компиляцию и тестовые серверы внутри пространств имен контейнера; после закрытия сессии контейнер удаляется, а хост остается нетронутым. Для масштабных CI-конвейеров, массового обновления репозиториев и параллельных прогонов оценки Remote Runtime разворачивает изолированные поды Kubernetes, исключая конкуренцию за локальные блокировки и ресурсы. Для легких правок в заранее подготовленной локальной папке предусмотрен явный режим Local Runtime.

Замкнутая верификация до зеленых тестов

Внутри песочницы агент декомпозирует задачу через TaskTrackerTool, синхронно обновляет связанные модули через FileEditorTool, устанавливает недостающие зависимости проекта и запускает модульные и интеграционные тесты через TerminalTool. При падении проверок агент считывает трассировку стека и сообщения компилятора из EventStream, определяет первопричину в основном коде или тестовом сценарии, применяет новый патч и повторяет прогон до полного зеленого статуса. В заказной разработке программного обеспечения этот замкнутый цикл закрывает долг по тестам, ускоряет обновление фреймворков и формирует pull request с воспроизводимым протоколом прохождения проверок.

Установка, headless CLI, Docker-песочница и Python SDK

Полный справочник доступен на docs.openhands.dev и openhands.dev. Поддерживаются три способа запуска: CLI, Docker или Python V1 SDK.

Установка CLI, автономный режим и команды MCP

Установите CLI через uv на Python 3.12 (или pip install openhands-ai), запустите Agent Canvas с --mount-cwd (опционально --gpu), выполняйте headless-задачи с --llm-approve и управляйте MCP:

uv tool install openhands --python 3.12
openhands serve --mount-cwd
openhands --headless --llm-approve \
  --task "Исправить гонку при обновлении токена в auth-сервисе и пройти pytest"
openhands mcp add internal-docs --url https://mcp.example.internal/sse
openhands mcp list

Запуск изолированной песочницы в Docker

Развертывание приложения с образом agent-server и полным логированием событий:

docker run -it --rm --pull=always \
  -e AGENT_SERVER_IMAGE_REPOSITORY=ghcr.io/openhands/agent-server \
  -e AGENT_SERVER_IMAGE_TAG=1.26.0-python \
  -e LOG_ALL_EVENTS=true \
  -v /var/run/docker.sock:/var/run/docker.sock \
  -v ~/.openhands:/.openhands \
  -v $(pwd):/workspace:rw \
  -p 3000:3000 \
  --add-host host.docker.internal:host-gateway \
  --name openhands-app \
  docker.openhands.dev/openhands/openhands:1.8
Предупреждение

Привилегии Docker-сокета: Монтирование /var/run/docker.sock позволяет запускать соседние sandbox-контейнеры с правами управления контейнерами на хосте. Не включайте NeverConfirm на рабочих станциях с боевыми ключами облака или личными SSH-ключами; изолируйте автономные запуски на защищенных CI-раннерах или в Kubernetes Remote Runtime.

Программная оркестрация на Python V1 SDK

Платформенные команды встраивают контуры ремонта кода напрямую через openhands.sdk:

import os
from openhands.sdk import LLM, Agent, Conversation, Tool
from openhands.sdk.security.confirmation_policy import ConfirmRisky
from openhands.tools.file_editor import FileEditorTool
from openhands.tools.task_tracker import TaskTrackerTool
from openhands.tools.terminal import TerminalTool
llm = LLM(
    model=os.getenv("LLM_MODEL", "anthropic/claude-sonnet-4-5-20250929"),
    api_key=os.getenv("LLM_API_KEY"),
    base_url=os.getenv("LLM_BASE_URL"),
)
agent = Agent(
    llm=llm,
    tools=[
        Tool(name=TerminalTool.name),
        Tool(name=FileEditorTool.name),
        Tool(name=TaskTrackerTool.name),
    ],
)
conversation = Conversation(agent=agent, workspace=os.getcwd())
conversation.set_confirmation_policy(ConfirmRisky())
conversation.send_message(
    "Исправить округление копеек в биллинге и подтвердить все unit-тесты."
)
conversation.run()

Политики безопасности, Microagents и поддержка MCP

Контейнер защищает хост, а политики контролируют допустимые команды и соблюдение стандартов репозитория.

Политики подтверждения и LLM-анализатор

  • AlwaysConfirm: Требует явного подтверждения перед каждой командой и правкой файла.
  • ConfirmRisky: Сбалансированный режим по умолчанию; безопасные чтения и тесты идут без пауз, рискованные команды ждут одобрения.
  • NeverConfirm: Полностью непрерывная работа только для эфемерных CI-песочниц с ограниченными правами.

Флаг --llm-approve подключает LLM-анализатор безопасности, который до исполнения оценивает семантику команды и блокирует деструктивное удаление, утечки секретов и сторонние скрипты.

Microagents и нативный MCP с OAuth

Архитектурные регламенты, ограничения миграций баз данных и требования к код-ревью фиксируются как Microagents в формате Markdown с YAML-заголовком (name, trigger_type, keywords) в каталоге ~/.openhands/microagents/ при полной совместимости с переносимой структурой .agents/skills/. При совпадении путей файлов или ключевых слов микроагент автоматически подгружает стандарты репозитория в контекст без ручного повторения инструкций в каждом промпте. Нативный MCP (openhands mcp add, openhands mcp list) поддерживает внешние и корпоративные серверы инструментов с OAuth-аутентификацией. Для анализа бинарных файлов и закрытых протоколов инструменты из руководства по архитектуре REA (Reverse Engineer Anything) MCP подключаются напрямую к сессии OpenHands, позволяя переводить находки реверс-инжиниринга в протестированный исходный код внутри одной изолированной песочницы.

Совет

Совет по внедрению: Начинайте работу с новым репозиторием в связке ConfirmRisky + --llm-approve и версионируйте Microagents в Git. Разбор EventStream после первого спринта позволит точно настроить пороги перед переходом к headless CI.

Архитектурное сравнение: OpenHands, OpenCode, Goose и закрытые агенты

КритерийOpenHandsOpenCodeGooseЗакрытые облачные / IDE-агенты
Модель исполненияАвтономный цикл (Agent Canvas, CLI, Headless, Python V1 SDK)Интерактивная нативная терминальная среда (TUI)Десктоп, CLI и программируемые API-рецептыЗакрытый плагин IDE или облако вендора
Изоляция песочницыЭфемерный Docker Runtime и Kubernetes Remote (+ Local)Локальный каталог и оболочка разработчикаЛокальная среда; контейнеры внешниеЗависит от вендора; облако или IDE
Многофайловые тестыЗависимости, полные тесты и итеративные правки в контейнереИнтерактивные правки с терминальными тестамиМногошаговые цепочки через расширения и рецептыНеоднородно; сборки часто ограничены
Привязка к моделиНет — лицензия MIT, коммерческие и локальные модели LiteLLMНет — мультипровайдер и локальные эндпоинтыНет — открытый код, гибкий выбор моделейВысокая — привязка к моделям вендора
MCP и расширяемостьНативный MCP (openhands mcp add, OAuth), Microagents, V1 SDKШирокая поддержка серверов MCP и инструментовЭкосистема расширений MCP и YAML-рецептыТолько одобренные закрытые коннекторы

Для быстрой интерактивной работы в терминале стоит изучить обзор открытого терминального ИИ-агента OpenCode, а для единых сценариев десктопа, CLI и API — руководство по открытому ИИ-агенту Goose. Когда критичны контейнерная изоляция, автономные многофайловые тесты и аудит EventStream в CI, OpenHands уверенно занимает свою нишу.

Корпоративное внедрение и практика Kling Digital

Переход от локальных экспериментов с OpenHands к промышленной инженерной платформе требует четырех обязательных контуров контроля:

  1. Фильтрация исходящего трафика (Egress): Ограничьте сетевой доступ sandbox-контейнеров только внутренними зеркалами пакетов и корпоративным LLM-шлюзом.
  2. Изоляция короткоживущих секретов: Храните ключи API и Git-токены вне примонтированной рабочей папки, выдавая временные токены с минимальными правами строго на активную ветку.
  3. Централизованное архивирование EventStream: Направляйте журналы LOG_ALL_EVENTS=true в неизменяемое хранилище наблюдаемости, чтобы каждый pull request сохранял полную историю выполнения.
  4. Обязательный человеческий контроль и SAST: Рассматривайте зеленые тесты в песочнице как подтверждение работоспособности, а не право на слияние; каждое изменение должно проходить ревью инженером и статический анализ безопасности.

Kling Digital проектирует вендор-независимые песочницы автономной разработки, кластеры Kubernetes Remote Runtime и OAuth-интеграции MCP. Обсудите архитектуру OpenHands V1 с нашей командой на странице контакты Kling Digital.

Часто задаваемые вопросы

Часто задаваемые вопросы по этому руководству.

Назад к новостям
Поделиться

Комментарии (0)

Поделитесь своим мнением и опытом с сообществом.

Комментариев пока нет. Будьте первым, кто оставит отзыв!

Оставить комментарий

Ваш комментарий будет опубликован после модерации администратором.

Тематический авторитет и ресурсный центр

Архитектурные бенчмарки, руководства и цифровые инструменты

Матрицы сравнения, подробные B2B-руководства и интерактивные калькуляторы для принятия точных технических решений.

Техническое сравнение

Сравнение Next.js и WordPress

Загрузка быстрее секунды, защита без уязвимых плагинов и расчет полной стоимости на 3 года.

Читать полный сравнительный анализ
Архитектурный анализ

Архитектурное сравнение Framer и Next.js

Инструменты визуального дизайна против суверенного корпоративного full-stack ПО.

Читать полный сравнительный анализ

Свежие статьи

Наши последние руководства по технологиям, дизайну и разработке.

Смотреть все