Перейти к основному содержанию Перейти к навигации Перейти к нижнему колонтитулу

Обзор интеграции с AI-агентами

Как Claude Code, Cursor и Cline управляют инфраструктурой Rediacc через rdc: JSON-вывод, интроспекция агентов и защитные ограждения.

Честно говоря, rdc изначально проектировался с учётом агентов. Claude Code, Cursor, Cline: любой AI-ассистент, вызывающий rdc в подоболочке, получает структурированный JSON-вывод, машиночитаемые ошибки и защитные ограждения, необходимые для автономного управления инфраструктурой Rediacc. Вот как работает эта интеграция.

Почему самостоятельный хостинг + AI-агенты

Архитектура Rediacc хорошо подходит для агентов:

  • CLI в первую очередь: каждая операция, это команда rdc, GUI не требуется
  • На основе SSH: протокол, который агенты лучше всего знают из обучающих данных
  • JSON-вывод: все команды поддерживают --output json с единообразным конвертом
  • Изоляция Docker: каждый репозиторий получает собственный демон и сетевое пространство имён
  • Скриптуемость: --yes пропускает подтверждения, --dry-run предварительно показывает деструктивные операции

Подходы к интеграции

1. Шаблон AGENTS.md / CLAUDE.md

Самый быстрый способ начать. Скопируйте наш шаблон AGENTS.md в корень проекта:

  • CLAUDE.md для Claude Code
  • .cursorrules для Cursor
  • .windsurfrules для Windsurf

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

2. Конвейер JSON-вывода

Когда агенты вызывают rdc в подоболочке, вывод автоматически переключается на JSON (определение не-TTY). Каждый JSON-ответ использует единообразный конверт:

{
  "success": true,
  "command": "machine query",
  "data": { ... },
  "errors": null,
  "warnings": [],
  "metrics": { "duration_ms": 42 }
}

Ответы с ошибками включают поля retryable и guidance:

{
  "success": false,
  "errors": [{
    "code": "NOT_FOUND",
    "message": "Machine \"prod-2\" not found",
    "retryable": false,
    "guidance": "Verify the resource name with \"rdc machine status\" or \"rdc repo list\""
  }]
}

Ключевые флаги для агентов

ФлагНазначение
--output json / -o jsonМашиночитаемый JSON-вывод
--yes / -yПропуск интерактивных подтверждений
--quiet / -qПодавление информационного вывода в stderr
--fields name,statusОграничение вывода определёнными полями
--dry-runПредварительный просмотр деструктивных операций без выполнения

Безопасность и ограждения

CLI не приравнивает агентов к человеку за терминалом. Для чувствительных операций требуется подтверждение знания текущего состояния (флаг --current), интерактивные потоки с редактором по умолчанию отклоняются, и каждый отказ фиксируется в журнале аудита. Справочник Безопасность и ограждения AI-агентов охватывает полную таблицу правил, модель knowledge-gate, переопределение области действия REDIACC_ALLOW_CONFIG_EDIT и журнал аудита с хеш-цепочкой.

Следующие шаги