본문으로 건너뛰기

CLI 레퍼런스

DROID+는 AI 에이전트 런타임을 관리하기 위한 하위 명령 세트가 포함된 단일 바이너리로 제공됩니다.

droid​

DROID+ — 헤드리스 AI 에이전트 런타임 엔진. nginx가 웹사이트를 서비스하는 것처럼, DROID+는 AI 에이전트를 서비스합니다. 하나의 바이너리, 하나의 설정으로 몇 분 만에 프로덕션 준비가 완료된 에이전트를 구축할 수 있습니다.

사용법:

droid [command]

사용 가능한 명령:

명령설명
init새로운 DROID+ 프로젝트 초기화
upDROID+ 런타임 시작
down실행 중인 DROID+ 인스턴스 중지
agents실행 중인 에이전트 목록 표시
agents reload에이전트 설정 핫 리로드
healthDROID+ 서버 상태 확인
version버전 정보 출력

글로벌 플래그:

플래그설명
-h, --helpdroid에 대한 도움말

droid init​

최소한의 DROID+ 설정, 에이전트 예시 및 .env 템플릿이 포함된 새 디렉토리를 생성합니다.

사용법:

droid init [project-name]

인수:

  • project-name — 생성할 디렉토리 이름 (기본값: my-agent)

예시:

droid init skincare-bot
cd skincare-bot

생성되는 파일:

  • droid.yaml — 메인 설정 파일
  • configs/agents/example.yaml — 에이전트 설정 예시
  • .env.example — 환경 변수 템플릿

droid up​

OpenAI 호환 API 및 관리 API와 함께 DROID+ AI 에이전트 런타임을 시작합니다.

사용법:

droid up [flags]

플래그:

플래그타입기본값설명
--config, -cstring자동 감지설정 파일 경로
--daemon, -dboolfalse백그라운드에서 실행 (프로덕션 환경에서는 systemd/docker 권장)

예시:

# 자동 감지된 설정으로 시작
droid up

# 특정 설정 파일로 시작
droid up --config /etc/droid/droid.yaml

# 백그라운드에서 시작
droid up -d

droid down​

PID 파일을 사용하여 실행 중인 DROID+ 프로세스에 SIGTERM 신호를 보냅니다.

사용법:

droid down

예시:

droid down

droid agents​

관리 API를 쿼리하여 로드된 모든 에이전트와 해당 상태를 나열합니다.

사용법:

droid agents [flags]

플래그:

플래그타입기본값설명
--portint8081관리 API 포트

예시:

# 기본 포트에서 에이전트 목록 표시
droid agents

# 커스텀 관리 포트에서 에이전트 목록 표시
droid agents --port 9091

droid agents reload​

런타임을 재시작하지 않고 에이전트 설정을 핫 리로드합니다. 에이전트 디렉토리를 읽고 변경 사항을 적용합니다.

사용법:

droid agents reload

예시:

# 새 에이전트 YAML 추가 후 리로드
cp new-agent.yaml configs/agents/
droid agents reload

droid health​

OpenAI 호환 API 및 관리 API 상태 확인 엔드포인트를 확인합니다.

사용법:

droid health [flags]

플래그:

플래그타입기본값설명
--openai-portint8080OpenAI API 포트
--management-portint8081관리 API 포트

예시:

# 기본 포트에서 상태 확인
droid health

# 커스텀 포트에서 상태 확인
droid health --openai-port 9080 --management-port 9081

droid version​

DROID+ 버전 정보를 출력합니다.

사용법:

droid version [flags]

플래그:

플래그설명
--jsonJSON 형식으로 출력

예시:

droid version
# DROID+ v0.5.0 (community) built ...

droid version --json
# {"version":"0.5.0","edition":"community","commit":"...","build_time":"..."}