ElevenLabs CLI

Verwalten Sie Ihre Sprachagenten als Code über die Befehlszeile.

Überblick

Mit der ElevenLabs CLI greifen Sie über Ihr Terminal auf Ihre ElevenLabs-Agenten zu und erhalten neue Möglichkeiten für deren Verwaltung:

Speichern Sie Agenten als Code in Ihrem Versionskontrollsystem
Richten Sie eine CI/CD-Integration ein, um Ihre Agenten automatisch bereitzustellen
Geben Sie Ihrem Coding-Agent Zugriff auf Ihre Sprachagenten und deren Verwaltung

Direkt zum Code?

Den vollständigen Quellcode finden Sie auf GitHub und können dazu beitragen.

Keine Installation erforderlich

Wenn Sie mit Claude oder einem anderen MCP-Client arbeiten, bietet der gehostete MCP- Server Tools zur Agentenverwaltung ohne lokale Installation. Verwenden Sie die CLI für Agenten in der Versionskontrolle; für die konversationelle Verwaltung nutzen Sie den gehosteten MCP-Server.

Installation

Homebrew (macOS) und Scoop (Windows) sind die empfohlenen Installationsmethoden und stellen eine eigenständige Binärdatei bereit.

brew install elevenlabs/tap/elevenlabs

Arbeiten Sie mit einem KI-Coding-Assistenten? Führen Sie in Ihrem Projekt elevenlabs generate-skills aus, um für jede Befehlsgruppe eine SKILL.md in skills/ zu schreiben. So kennt Ihr Assistent den gesamten Funktionsumfang der CLI, ohne dass Sie Dokumentation einfügen müssen. Mit --output-dir können Sie sie an einem anderen Ort ablegen. Dies liest die eigene eingebettete API-Definition der CLI, benötigt also keinen API-Schlüssel und funktioniert offline — und bleibt mit der von Ihnen installierten CLI-Version synchron.

Nach der Installation ist der Befehl elevenlabs global in Ihrem Terminal verfügbar.

Schnellstart

Neues Projekt initialisieren

elevenlabs agents init

Dadurch wird die Projektstruktur mit Konfigurationsverzeichnissen und Registrierungsdateien erstellt.

Bei ElevenLabs anmelden

elevenlabs auth login

Dadurch wird ein Browserfenster geöffnet, um sich über OAuth anzumelden. Die CLI überprüft die Anmeldedaten und speichert sie sicher.

Ersten Agenten erstellen

elevenlabs agents add "My Assistant" --template assistant

Dadurch wird eine neue Agentenkonfiguration mit der Assistant-Vorlage erstellt.

Auf die ElevenLabs-Plattform übertragen

elevenlabs agents push

Dadurch wird Ihre lokale Agentenkonfiguration auf die ElevenLabs-Plattform hochgeladen.

Projektstruktur

Die CLI erstellt ein strukturiertes Projektverzeichnis:

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

Authentifizierung

elevenlabs auth login speichert Anmeldedaten im Schlüsselbund Ihres Betriebssystems — im Schlüsselbund unter macOS, im Anmeldeinformations-Manager unter Windows und im Secret Service unter Linux. Wenn kein Schlüsselbund verfügbar ist, greift die CLI auf ~/.config/elevenlabs/auth-keyring.json mit den Berechtigungen 0600 zurück. Führen Sie elevenlabs auth status aus, um die verwendete Quelle anzuzeigen, und elevenlabs auth logout, um den gespeicherten Eintrag zu entfernen.

Für CI setzen Sie ELEVENLABS_API_KEY in der Umgebung oder einer .env-Datei, statt sich anzumelden.

Befehle zur Authentifizierung

elevenlabs auth login

Agentenverwaltung

Agenten erstellen

Erstellen Sie Agenten mit vorgefertigten Vorlagen:

elevenlabs agents add "Agent Name" [options]

Optionen:

--template <type>: Wählen Sie aus verfügbaren Vorlagen (Standard: default)
--skip-upload: Lokal erstellen, ohne auf die Plattform hochzuladen

Beispiel:

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

Vorlagen

Die CLI bietet sechs vorgefertigte Vorlagen für häufige Anwendungsfälle:

default

Vollständige Konfiguration mit allen verfügbaren Feldern, sinnvollen Standardeinstellungen, umfassender Sprach-/Textunterstützung, Widget-Anpassung und Bewertungskriterien.

minimal

Nur wesentliche Felder, einschließlich grundlegender Prompt-, Sprach-, TTS- und Konversationseinstellungen.

voice-only

Optimiert für Sprachinteraktionen mit deaktivierter Texteingabe und erweiterten Spracheinstellungen.

text-only

Textorientierte Konversationen mit deaktivierten Sprachfunktionen.

customer-service

Professionelle, empathische Prompts, niedrige Temperatur (0.1), Dauer von 30 Minuten und Bewertungskriterien.

assistant

KI-Assistent für allgemeine Zwecke mit ausgewogener Kreativität (Temperatur 0.3) und vielseitiger Sprach-/Textunterstützung.

Vorlagenbefehle

elevenlabs agents templates list

Synchronisierung

Halten Sie Ihre lokalen Konfigurationen mit der ElevenLabs-Plattform synchron:

elevenlabs agents push

Status und Überwachung

Check agent status

elevenlabs agents status

Import und Export

elevenlabs agents pull

Standardmäßig überspringt elevenlabs agents pull Agenten, die bereits lokal vorhanden sind. Verwenden Sie das Flag --update, um lokale Konfigurationen mit Remote-Änderungen zu überschreiben, die im Browser oder über die API vorgenommen wurden.

Toolverwaltung

Die CLI unterstützt zwei Tool-Typen, um die Funktionen von Agenten zu erweitern:

Webhook-Tools

HTTP-API-Integrationen mit Authentifizierung und Timeout-Konfiguration:

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

Client-Tools

Direkte clientseitige Integrationen:

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

Generieren Sie HTML-Einbettungscode für die Webintegration:

elevenlabs agents widget embed <agent_id>

Dies gibt HTML-Code wie diesen aus:

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

Konfigurationsdateien

Struktur der Agentenkonfiguration

Jede Agentenkonfiguration enthält:

{
  "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-Pipeline-Integration

# 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