ElevenLabs CLI | ElevenLabs Documentation

개요

ElevenLabs CLI를 사용하면 터미널에서 ElevenLabs 에이전트에 액세스하여 새로운 방식으로 관리할 수 있습니다.

버전 관리 시스템에 에이전트를 코드로 저장
에이전트를 자동 배포하도록 CI/CD 통합 설정
코딩 에이전트가 음성 에이전트에 액세스하고 관리하도록 허용

바로 코드로 이동하고 싶으신가요?

설치 불필요

Claude 또는 다른 MCP 클라이언트에서 작업하는 경우, 호스팅 MCP 서버는 로컬 설치 없이 에이전트 관리 도구를 제공합니다. 에이전트를 버전 관리하려면 CLI를 사용하고, 대화형 관리에는 호스팅 MCP 서버를 사용하세요.

설치

Homebrew(macOS)와 Scoop(Windows)은 권장 설치 방법이며 독립 실행형 바이너리를 제공합니다.

brew install elevenlabs/tap/elevenlabs

AI 코딩 어시스턴트와 작업하시나요? 프로젝트에서 elevenlabs generate-skills를 실행하면 모든 명령 그룹의 SKILL.md가 skills/에 작성되어, 문서를 붙여넣지 않아도 어시스턴트가 CLI의 전체 기능을 알 수 있습니다. 다른 위치에 저장하려면 --output-dir을 사용하세요. 이 기능은 CLI 자체에 내장된 API 정의를 읽으므로 API 키가 필요 없고 오프라인에서도 작동하며, 설치된 CLI 버전에 맞춰 최신 상태를 유지합니다.

설치 후 터미널 어디에서나 elevenlabs 명령을 사용할 수 있습니다.

빠른 시작

새 프로젝트 초기화

elevenlabs agents init

구성 디렉터리와 레지스트리 파일이 포함된 프로젝트 구조를 생성합니다.

ElevenLabs 인증

elevenlabs auth login

OAuth를 통해 인증할 브라우저 창이 열립니다. CLI는 자격 증명을 확인하고 안전하게 저장합니다.

첫 번째 에이전트 생성

elevenlabs agents add "My Assistant" --template assistant

assistant 템플릿을 사용하여 새 에이전트 구성을 생성합니다.

ElevenLabs 플랫폼에 푸시

elevenlabs agents push

로컬 에이전트 구성을 ElevenLabs 플랫폼에 업로드합니다.

프로젝트 구조

CLI는 구조화된 프로젝트 디렉터리를 생성합니다.

your_project/
├── agents.json              # Central agent configuration registry
├── tools.json               # Tool definitions registry
├── tests.json               # Test definitions registry
├── agent_configs/           # Agent configuration files
├── tool_configs/            # Tool configuration files
└── test_configs/            # Test configuration files

인증

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를 설정하세요.

인증 명령

elevenlabs auth login

에이전트 관리

에이전트 생성

사전 구축된 템플릿으로 에이전트를 생성하세요.

elevenlabs agents add "Agent Name" [options]

옵션:

--template <type>: 사용 가능한 템플릿에서 선택(기본값: default)
--skip-upload: 플랫폼에 업로드하지 않고 로컬에서 생성

예시:

elevenlabs agents add "Customer Support Bot" --template customer-service

템플릿

CLI는 일반적인 사용 사례를 위한 6개의 사전 구축 템플릿을 제공합니다.

default

사용 가능한 모든 필드, 합리적인 기본값, 전체 음성/텍스트 지원, 위젯 사용자 지정 및 평가 기준을 포함한 완전한 구성입니다.

minimal

기본 프롬프트, 언어, TTS, 대화 설정을 포함한 필수 필드만 제공합니다.

voice-only

텍스트 입력을 비활성화하고 고급 음성 설정을 적용해 음성 상호작용에 최적화되었습니다.

text-only

음성 기능을 비활성화한 텍스트 중심 대화입니다.

customer-service

전문적이고 공감하는 프롬프트, 낮은 온도(0.1), 30분 지속 시간 및 평가 기준을 제공합니다.

assistant

균형 잡힌 창의성(온도 0.3)과 다목적 음성/텍스트 지원을 제공하는 범용 AI 어시스턴트입니다.

템플릿 명령

elevenlabs agents templates list

동기화

로컬 구성을 ElevenLabs 플랫폼과 동기화하세요.

elevenlabs agents push

상태 및 모니터링

에이전트 상태 확인

elevenlabs agents status

가져오기 및 내보내기

elevenlabs agents pull

기본적으로 elevenlabs agents pull은 이미 로컬에 있는 에이전트를 건너뜁니다. 브라우저 또는 API에서 변경된 원격 구성으로 로컬 구성을 덮어쓰려면 --update 플래그를 사용하세요.

도구 관리

CLI는 에이전트 기능을 확장하기 위한 두 가지 유형의 도구를 지원합니다.

웹훅 도구

인증 및 시간 제한 구성을 지원하는 HTTP API 통합입니다.

elevenlabs tools add "API Integration" --type "webhook" --config-path ./config.json

클라이언트 도구

직접적인 클라이언트 측 통합입니다.

elevenlabs tools add "Client Function" --type "client" --config-path ./config.json

위젯 생성

웹 통합을 위한 HTML 임베드 코드를 생성하세요.

elevenlabs agents widget embed <agent_id>

다음과 같은 HTML 코드가 출력됩니다.

<elevenlabs-convai agent-id="agent_id_here"></elevenlabs-convai>
<script src="https://unpkg.com/@elevenlabs/convai-widget-embed" async></script>

구성 파일

에이전트 구성 구조

각 에이전트 구성에는 다음이 포함됩니다.

{
  "name": "Agent Name",
  "conversation_config": {
    "agent": {
      "language": "en",
      "prompt": {
        "prompt": "You are a helpful AI assistant.",
        "llm": "gemini-2.5-flash",
        "temperature": 0.0
      }
    },
    "tts": {
      "model_id": "eleven_turbo_v2",
      "voice_id": "cjVigY5qzO86Huf0OWal",
      "agent_output_audio_format": "pcm_16000"
    },
    "asr": {
      "provider": "scribe_realtime",
      "quality": "high",
      "user_input_audio_format": "pcm_16000"
    },
    "conversation": {
      "text_only": false,
      "max_duration_seconds": 600,
      "client_events": ["audio", "interruption"]
    }
  },
  "platform_settings": {
    "widget": {
      "variant": "full",
      "placement": "bottom-right"
    }
  },
  "tags": []
}

CI/CD 파이프라인 통합

# In your GitHub Actions workflow
- name: Deploy ElevenAgents agents
  run: |
    npm install -g @elevenlabs/cli
    export ELEVENLABS_API_KEY=${{ secrets.ELEVENLABS_API_KEY }}
    elevenlabs agents push --dry-run  # Preview changes
    elevenlabs agents push            # Deploy
    elevenlabs agents status          # Verify deployment