메인 콘텐츠로 건너뛰기
Avala CLI를 사용하면 데이터셋 목록, 내보내기 생성, 클라우드 스토리지 관리 등을 명령줄에서 직접 수행할 수 있습니다.

​
설치

curl -fsSL https://avala.ai/install.sh | bash
설치 스크립트는 Python 버전을 감지하고, pip을 통해 avala[cli]를 설치하며, 설정을 검증합니다. Python 3.9+ 이상이 필요합니다. 이렇게 하면 포맷된 터미널 출력을 위한 Click 및 Rich와 함께 avala 명령이 설치됩니다.

​
인증

환경 변수로 API 키를 설정하세요 (권장): 
export AVALA_API_KEY="avk_your_api_key"
또는 모든 명령에 플래그로 전달하세요: 
avala --api-key avk_your_api_key datasets list
인터렉티브하게 자격 증명을 설정하려면: 
avala configure

​
명령

​
datasets

# 모든 데이터셋 목록
avala datasets list

# 결과 제한
avala datasets list --limit 10

# 특정 데이터셋 가져오기
avala datasets get <uid>

​
projects

# 모든 프로젝트 목록
avala projects list

# 특정 프로젝트 가져오기
avala projects get <uid>

​
exports

# 모든 내보내기 목록
avala exports list

# 내보내기 세부정보 가져오기
avala exports get <uid>

# 새 내보내기 생성
avala exports create --project <uid>
avala exports create --dataset <uid>

​
storage-configs

클라우드 스토리지 연결 관리 (AWS S3, Google Cloud Storage). 
# 스토리지 구성 목록
avala storage-configs list

# S3 버킷 추가
avala storage-configs create \
  --name "Production S3" \
  --provider aws_s3 \
  --s3-bucket-name my-bucket \
  --s3-bucket-region us-west-1 \
  --s3-access-key-id $AWS_ACCESS_KEY_ID \
  --s3-secret-access-key $AWS_SECRET_ACCESS_KEY

# 스토리지 연결 테스트
avala storage-configs test <uid>

​
agents

자동화 에이전트를 관리합니다. 
# 에이전트 목록
avala agents list

# 에이전트 생성
avala agents create \
  --name "QA Bot" \
  --events "task.completed,result.submitted" \
  --callback-url https://example.com/hook

​
webhooks

웹훅 구독을 관리합니다. 
# 웹훅 목록
avala webhooks list

# 웹훅 생성
avala webhooks create \
  --target-url https://example.com/webhook \
  --events "task.completed,export.ready"

​
환경 변수

변수설명기본값
AVALA_API_KEYAvala API 키.필수
AVALA_BASE_URLAPI 기본 URL 재정의.https://api.avala.ai/api/v1

​
출력 형식

CLI는 포맷된 출력을 위해 Rich를 사용합니다:
  • 목록 명령은 포맷된 테이블로 결과를 표시합니다.
  • 가져오기 명령은 키-값 세부 뷰를 표시합니다.
  • 생성/삭제 명령은 확인 메시지를 출력합니다.
출력이 파이프되거나 리다이렉트될 때 색상과 포맷이 자동으로 비활성화됩니다.