ElevenLabs CLI
명령줄에서 음성 에이전트를 코드로 관리하세요.
개요
ElevenLabs CLI를 사용하면 터미널에서 ElevenLabs 에이전트에 접근할 수 있어, 다음과 같은 새로운 방식으로 에이전트를 관리할 수 있습니다.
- 버전 관리 시스템에서 에이전트를 코드로 저장
- CI/CD 통합을 설정해 에이전트를 자동 배포
- 코딩 에이전트가 음성 에이전트에 접근하고 관리하도록 설정
Claude 또는 다른 MCP 클라이언트에서 작업한다면 호스팅 MCP 서버를 통해 로컬 설치 없이 에이전트 관리 도구를 사용할 수 있습니다. 에이전트를 버전 관리하려면 CLI를 사용하고, 대화형 관리에는 호스팅 MCP 서버를 사용하세요.
설치
Homebrew(macOS)와 Scoop(Windows)은 권장 설치 방법이며, 독립 실행형 바이너리를 제공합니다.
AI 코딩 어시스턴트와 작업하시나요? 프로젝트에서 elevenlabs generate-skills를 실행하면 모든 명령 그룹의
SKILL.md가 skills/에 작성되어, 문서를 붙여넣지 않아도 어시스턴트가 CLI의 전체 기능을 알 수 있습니다.
다른 위치에 저장하려면 --output-dir을 사용하세요. 이 기능은 CLI 자체에 내장된 API 정의를 읽으므로
API 키가 필요 없고 오프라인에서도 작동하며, 설치된 CLI 버전에 맞춰 최신 상태를 유지합니다.
설치 후 터미널에서 elevenlabs 명령을 전역으로 사용할 수 있습니다.
빠른 시작
프로젝트 구조
CLI는 체계적인 프로젝트 디렉터리를 생성합니다.
인증
elevenlabs auth login은 운영 체제의 키링에 자격 증명을 저장합니다. macOS에서는 Keychain, Windows에서는
Credential Manager, Linux에서는 Secret Service를 사용합니다. 키링을 사용할 수 없는 경우 CLI는 0600
권한이 적용된 ~/.config/elevenlabs/auth-keyring.json을 사용합니다. 어떤 소스가 사용 중인지 확인하려면
elevenlabs auth status를 실행하고, 저장된 항목을 삭제하려면 elevenlabs auth logout을 실행하세요.
CI에서는 로그인 대신 환경 변수 또는 .env 파일에 ELEVENLABS_API_KEY를 설정하세요.
인증 명령어
에이전트 관리
에이전트 생성
사전 구축된 템플릿을 사용해 에이전트를 생성하세요.
옵션:
--template <type>: 사용 가능한 템플릿에서 선택합니다(기본값: default).--skip-upload: 플랫폼에 업로드하지 않고 로컬에 생성합니다.
예시:
템플릿
CLI는 일반적인 사용 사례를 위한 사전 구축 템플릿 6개를 제공합니다.
default
사용 가능한 모든 필드, 적절한 기본값, 완전한 음성/텍스트 지원, 위젯 맞춤 설정, 평가 기준을 포함한 전체 구성입니다.
minimal
기본 프롬프트, 언어, TTS, 대화 설정을 포함한 필수 필드만 제공합니다.
voice-only
텍스트 입력을 비활성화하고 고급 음성 설정을 적용한 음성 상호작용 최적화 구성입니다.
text-only
customer-service
전문적이고 공감하는 프롬프트, 낮은 온도(0.1), 30분 길이, 평가 기준을 제공합니다.
assistant
균형 잡힌 창의성(온도 0.3)과 다목적 음성/텍스트 지원을 제공하는 범용 AI 어시스턴트입니다.
템플릿 명령어
동기화
로컬 구성을 ElevenLabs 플랫폼과 동기화하세요.
상태 및 모니터링
가져오기 및 내보내기
기본적으로 elevenlabs agents pull은 이미 로컬에 존재하는 에이전트를 건너뜁니다. 브라우저 또는 API에서
변경한 원격 변경 사항으로 로컬 구성을 덮어쓰려면 --update 플래그를 사용하세요.
도구 관리
CLI는 에이전트 기능을 확장하기 위한 두 가지 유형의 도구를 지원합니다.
웹훅 도구
인증 및 타임아웃 구성을 지원하는 HTTP API 통합입니다.
클라이언트 도구
클라이언트 측 직접 통합입니다.
위젯 생성
웹 통합을 위한 HTML 임베드 코드를 생성합니다.
다음과 같은 HTML 코드가 출력됩니다.
구성 파일
에이전트 구성 구조
각 에이전트 구성에는 다음이 포함됩니다.