STRUCTUREцифровые системыОбсудить проект
НОВОСТЬ · Engineering

ИИ-агенты и Docker: автор d9c отделил диагностику от опасных команд

Разработчик терминального менеджера d9c рассказал, как предоставил ИИ-агентам доступ к Docker без передачи им обычного неограниченного командного интерфейса. В проекте появились управляемые операции, структурированные ответы и отдельные ограничения для потенциально разрушительных действий.

Главное

Когда помощник анализирует сбой контейнера через обычную оболочку, ему приходится разбирать табличный вывод, выбирать команды и самостоятельно ограничивать объём логов. Автор d9c приводит другой риск: диагностические команды могут незаметно передать модели значения переменных окружения или конфигурацию сервиса. Поэтому для машинного взаимодействия он сделал отдельную точку входа поверх уже существующего SSH-транспорта, а не предложил агенту прямой доступ к сокету Docker.

В основе решения находится единое описание доступных операций с аргументами, обработчиком и уровнем опасности. На этом реестре построены интерфейс командной строки и MCP-сервер: оба способа обращения к контейнерам используют одинаковые проверки. Результаты для агента выдаются в JSON, ошибки имеют коды и подсказки, а длинные ответы ограничиваются по объёму. Это уменьшает потребность в разборе произвольного терминального текста и позволяет точнее отличать проблему соединения от ошибки в аргументах.

Подробности

Действия разделены на чтение, обратимые изменения и разрушительные операции. По умолчанию агент может собирать сведения, но не менять состояние контейнеров; разрешения задаются отдельно, в том числе для конкретного хоста. Для потенциально опасной команды сначала можно получить план через dry-run, а удаление требует явного подтверждения. Запуск произвольной команды внутри контейнера автор также относит к опасным действиям: её последствия нельзя надёжно оценить только по названию инструмента.

Дополнительные ограничения касаются не только удаления. d9c скрывает значения чувствительных переменных при просмотре конфигураций, не принимает неизвестный ключ SSH-хоста автоматически и фиксирует попытки записывающих операций в журнале аудита. При этом вывод контейнеров считается недоверенным: программа может записать в лог текст, похожий на указание для модели. Одних предупреждений в описаниях инструментов недостаточно, поэтому запреты должны применяться на уровне самого исполняющего интерфейса.

Что это меняет

Автор проверил поведение решения на демонстрационных окружениях и обнаружил важную границу автоматического согласования. В одном сценарии Claude Code корректно показал план удаления тестовых контейнеров и запросил разрешение, а в другом режиме выполнил удаление без отдельного вопроса. После этого требования к подтверждению согласовали между инструкциями и инструментами; исправление описано для версии d9c 1.35.3. Этот опыт показывает, почему безопасный результат отдельного теста ещё не доказывает надёжность процедуры подтверждения.

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

Первоисточник

Материал подготовлен STRUCTURE по открытой публикации Habr. Текст и иллюстрации первоисточника не воспроизводятся целиком.

Читать исходную новость целиком ↗