AI 에이전트 통합 개요

AI 코딩 어시스턴트는 rdc CLI를 통해 Rediacc 인프라를 자율적으로 관리할 수 있습니다. 이 가이드에서는 통합 방식과 시작하는 방법을 설명합니다.

셀프호스팅과 AI 에이전트의 조합

Rediacc의 아키텍처는 에이전트 친화적으로 설계되어 있습니다.

CLI 우선: 모든 작업은 rdc 명령어로 수행되며, GUI가 필요하지 않습니다.
SSH 기반: 에이전트가 학습 데이터에서 가장 잘 알고 있는 프로토콜입니다.
JSON 출력: 모든 명령어는 일관된 봉투 형식으로 --output json을 지원합니다.
Docker 격리: 각 레포지토리는 자체 데몬과 네트워크 네임스페이스를 갖습니다.
스크립트 가능: --yes는 확인 프롬프트를 건너뛰고, --dry-run은 파괴적 작업을 미리 확인합니다.

통합 방식

1. AGENTS.md / CLAUDE.md 템플릿

가장 빠르게 시작할 수 있는 방법입니다. AGENTS.md 템플릿을 프로젝트 루트에 복사하세요.

Claude Code용 CLAUDE.md
Cursor용 .cursorrules
Windsurf용 .windsurfrules

이 파일은 에이전트에게 사용 가능한 명령어, 아키텍처, 관례에 대한 전체 맥락을 제공합니다.

2. JSON 출력 파이프라인

에이전트가 서브셸에서 rdc를 호출하면 출력이 자동으로 JSON으로 전환됩니다(non-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 서브커맨드는 구조화된 내부 검사 기능을 제공합니다.

# 모든 명령어와 인수 및 옵션 목록 확인
rdc agent capabilities

# 특정 명령어의 상세 스키마 확인
rdc agent schema --command "machine query"

# JSON stdin으로 명령어 실행
echo '{"name": "prod-1"}' | rdc agent exec "machine query"

CLI 참조: rdc agent capabilities · rdc agent schema

에이전트용 주요 플래그

플래그	목적
`--output json` / `-o json`	머신 가독 JSON 출력
`--yes` / `-y`	대화형 확인 건너뜀
`--quiet` / `-q`	안내용 stderr 출력 억제
`--fields name,status`	특정 필드로 출력 제한
`--dry-run`	파괴적 작업을 실행하지 않고 미리 확인

안전성 및 가드레일

CLI는 AI 에이전트를 키보드 앞의 사람과 다르게 처리합니다. 민감한 작업은 사전 지식 증명((--current 플래그)이 필요하고, 대화형 편집기 흐름은 기본적으로 거부되며, 모든 거부는 감사 로그에 기록됩니다. AI 에이전트 안전성 및 가드레일 문서에는 전체 방화벽 테이블, 지식 게이트 모델, REDIACC_ALLOW_CONFIG_EDIT 스코프 재정의, 해시 체인 감사 로그가 설명되어 있습니다.

다음 단계

AI 에이전트 안전성 및 가드레일, 에이전트가 할 수 있는 것과 없는 것, 지식 게이트, 감사 로그
Claude Code 설정 가이드, 단계별 Claude Code 설정 방법
Cursor 설정 가이드, Cursor IDE 통합
JSON 출력 참조, 전체 JSON 출력 문서
AGENTS.md 템플릿, 복사해서 바로 쓰는 에이전트 설정 템플릿