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

AI-ассистенты для кодирования могут автономно управлять инфраструктурой Rediacc через CLI rdc. Это руководство описывает подходы к интеграции и начало работы.

Почему самостоятельный хостинг + 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 query\" or \"rdc config repository list\""
  }]
}

3. Обнаружение возможностей агента

Подкоманда rdc agent предоставляет структурированную интроспекцию:

# List all commands with arguments and options
rdc agent capabilities

# Show detailed schema for a specific command
rdc agent schema "machine query"

# Execute a command with JSON stdin
echo '{"name": "prod-1"}' | rdc agent exec "machine query"

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

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

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

• Руководство по настройке Claude Code — пошаговая настройка Claude Code
• Руководство по настройке Cursor — интеграция Cursor IDE
• Справочник по JSON-выводу — полная документация JSON-вывода
• Шаблон AGENTS.md — готовый шаблон конфигурации агента