ElevenLabs CLI

Zarządzaj agentami głosowymi jak kodem z poziomu wiersza poleceń.

Omówienie

CLI ElevenLabs daje ci dostęp do agentów ElevenLabs z terminala i otwiera nowe możliwości zarządzania nimi:

Przechowuj agentów jako kod w systemie kontroli wersji
Skonfiguruj integrację CI/CD, aby automatycznie wdrażać agentów
Pozwól swojemu agentowi programistycznemu uzyskiwać dostęp do agentów głosowych i nimi zarządzać

Chcesz od razu przejść do kodu?

Znajdź pełny kod źródłowy i dodaj swój wkład na GitHubie.

Bez instalacji

Jeśli pracujesz w Claude lub innym kliencie MCP, hostowany serwer MCP oferuje narzędzia do zarządzania agentami bez lokalnej instalacji. Użyj CLI, gdy chcesz przechowywać agentów w kontroli wersji; hostowanego serwera MCP użyj do zarządzania konwersacyjnego.

Instalacja

Homebrew (macOS) i Scoop (Windows) to zalecane metody instalacji, które dostarczają samodzielny plik binarny.

brew install elevenlabs/tap/elevenlabs

Pracujesz z asystentem AI do kodowania? Uruchom elevenlabs generate-skills w projekcie, aby zapisać SKILL.md dla każdej grupy poleceń w skills/. Dzięki temu asystent zna pełny zakres CLI bez wklejania dokumentacji. Użyj --output-dir, aby zapisać je w innym miejscu. Polecenie odczytuje wbudowaną definicję API CLI, więc nie potrzebuje klucza API i działa offline — oraz jest zgodne z zainstalowaną wersją CLI.

Po instalacji polecenie elevenlabs będzie dostępne globalnie w terminalu.

Szybki start

Zainicjuj nowy projekt

elevenlabs agents init

Spowoduje to utworzenie struktury projektu z katalogami konfiguracji i plikami rejestru.

Uwierzytelnij się w ElevenLabs

elevenlabs auth login

Otworzy się okno przeglądarki, aby uwierzytelnić cię przez OAuth. CLI zweryfikuje dane logowania i bezpiecznie je zapisze.

Utwórz pierwszego agenta

elevenlabs agents add "My Assistant" --template assistant

Spowoduje to utworzenie nowej konfiguracji agenta na podstawie szablonu asystenta.

Wyślij na platformę ElevenLabs

elevenlabs agents push

Spowoduje to przesłanie lokalnej konfiguracji agenta na platformę ElevenLabs.

Struktura projektu

CLI tworzy uporządkowany katalog projektu:

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

Uwierzytelnianie

elevenlabs auth login zapisuje dane logowania w systemowym magazynie kluczy — Keychain w macOS, Credential Manager w Windows i Secret Service w Linuxie. Gdy magazyn kluczy nie jest dostępny, CLI używa awaryjnie pliku ~/.config/elevenlabs/auth-keyring.json z uprawnieniami 0600. Uruchom elevenlabs auth status, aby sprawdzić używane źródło, oraz elevenlabs auth logout, aby usunąć zapisany wpis.

W CI ustaw ELEVENLABS_API_KEY w zmiennych środowiskowych lub pliku .env zamiast się logować.

Polecenia uwierzytelniania

elevenlabs auth login

Zarządzanie agentami

Tworzenie agentów

Twórz agentów za pomocą gotowych szablonów:

elevenlabs agents add "Agent Name" [options]

Opcje:

--template <type>: Wybierz spośród dostępnych szablonów (domyślnie: default)
--skip-upload: Utwórz lokalnie bez przesyłania na platformę

Przykład:

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

Szablony

CLI oferuje sześć gotowych szablonów do typowych zastosowań:

default

Pełna konfiguracja ze wszystkimi dostępnymi polami, sensownymi ustawieniami domyślnymi, pełną obsługą głosu i tekstu, personalizacją widżetu oraz kryteriami oceny.

minimal

Tylko podstawowe pola, w tym podstawowy prompt, język, TTS i ustawienia rozmowy.

voice-only

Zoptymalizowany pod interakcje głosowe, z wyłączonym wprowadzaniem tekstu i zaawansowanymi ustawieniami głosu.

text-only

Rozmowy oparte na tekście z wyłączonymi funkcjami głosowymi.

customer-service

Profesjonalne, empatyczne prompty, niska temperatura (0.1), czas trwania 30 minut i kryteria oceny.

assistant

Uniwersalny asystent AI ze zrównoważoną kreatywnością (temperatura 0.3) i wszechstronną obsługą głosu oraz tekstu.

Polecenia szablonów

elevenlabs agents templates list

Synchronizacja

Utrzymuj lokalne konfiguracje zsynchronizowane z platformą ElevenLabs:

elevenlabs agents push

Status i monitoring

Sprawdź status agenta

elevenlabs agents status

Import i eksport

elevenlabs agents pull

Domyślnie elevenlabs agents pull pomija agentów, którzy już istnieją lokalnie. Użyj flagi --update, aby zastąpić lokalne konfiguracje zdalnymi zmianami wprowadzonymi w przeglądarce lub przez API.

Zarządzanie narzędziami

CLI obsługuje dwa typy narzędzi rozszerzających możliwości agentów:

Narzędzia webhook

Integracje HTTP API z konfiguracją uwierzytelniania i limitu czasu:

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

Narzędzia klienckie

Bezpośrednie integracje po stronie klienta:

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

Generowanie widżetu

Wygeneruj kod HTML do osadzenia na stronie:

elevenlabs agents widget embed <agent_id>

Wynikiem będzie kod HTML podobny do tego:

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

Pliki konfiguracji

Struktura konfiguracji agenta

Każda konfiguracja agenta zawiera:

{
  "name": "Agent Name",
  "conversation_config": {
    "agent": {
      "language": "en",
      "prompt": {
        "prompt": "You are a helpful AI assistant.",
        "llm": "gemini-3.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": []
}

Integracja z pipeline’em 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