Monitorowanie

ElevenLabs CLI

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

Omówienie

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

  • Przechowuj agentów jako kod w systemie kontroli wersji
  • Skonfiguruj integrację CI/CD, by automatycznie wdrażać agentów
  • Daj swojemu agentowi kodującemu dostęp do agentów głosowych i możliwość zarządzania nimi
Chcesz od razu przejść do kodu?

Znajdź pełny kod źródłowy i wesprzyj projekt na GitHubie.

Instalacja nie jest wymagana

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 trzymać agentów w kontroli wersji; użyj hostowanego serwera MCP do zarządzania w rozmowie.

Instalacja

Homebrew (macOS) i Scoop (Windows) to zalecane metody instalacji, które zapewniają 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

1

Zainicjuj nowy projekt

elevenlabs agents init

To tworzy strukturę projektu z katalogami konfiguracji i plikami rejestru.

2

Uwierzytelnij się w ElevenLabs

elevenlabs auth login

Otworzy się okno przeglądarki, w którym uwierzytelnisz się przez OAuth. CLI zweryfikuje dane logowania i bezpiecznie je zapisze.

3

Utwórz pierwszego agenta

elevenlabs agents add "My Assistant" --template assistant

To tworzy konfigurację nowego agenta na podstawie szablonu asystenta.

4

Prześlij na platformę ElevenLabs

elevenlabs agents push

To przesyła lokalną konfigurację 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 pęku kluczy systemu operacyjnego — Keychain w macOS, Credential Manager w Windows i Secret Service w Linuxie. Gdy pęk kluczy nie jest dostępny, CLI używa 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 zmiennej środowiskowej 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ń:

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

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

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

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

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

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

Synchronizuj lokalne konfiguracje z platformą ElevenLabs:

elevenlabs agents push

Status i monitorowanie

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>

Polecenie zwraca 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-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": []
}

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