ElevenLabs CLI
Hantera dina röstagenter som kod från kommandoraden.
Översikt
Med ElevenLabs CLI kan du komma åt dina ElevenLabs-agenter från terminalen, vilket ger dig nya sätt att hantera dem:
- Spara agenter som kod i ditt versionshanteringssystem
- Konfigurera CI/CD-integration för att automatiskt distribuera dina agenter
- Låt din kodagent komma åt och hantera dina röststyrda agenter
Om du arbetar från Claude eller en annan MCP-klient erbjuder den hostade MCP- servern verktyg för agenthantering utan lokal installation. Använd CLI:t när du vill ha agenter i versionshantering; använd den hostade MCP-servern för konversationsbaserad hantering.
Installation
Homebrew (macOS) och Scoop (Windows) är de rekommenderade installationsmetoderna och levereras med en fristående binärfil.
Arbetar du med en AI-kodningsassistent? Kör elevenlabs generate-skills i ditt projekt för att skapa en
SKILL.md för varje kommandogrupp i skills/, så att assistenten känner till hela CLI:ts yta
utan att du behöver klistra in dokumentation. Använd --output-dir för att lägga dem någon annanstans. Detta läser CLI:ts egen
inbäddade API-definition, så det kräver ingen API-nyckel och fungerar offline — och det följer
den version av CLI:t som du har installerad.
Efter installationen är kommandot elevenlabs tillgängligt globalt i terminalen.
Snabbstart
Initiera ett nytt projekt
Detta skapar projektstrukturen med konfigurationskataloger och registerfiler.
Projektstruktur
CLI:t skapar en strukturerad projektkatalog:
Autentisering
elevenlabs auth login lagrar autentiseringsuppgifter i operativsystemets nyckelring — Nyckelhanterare i macOS,
Autentiseringshanteraren i Windows och Secret Service i Linux. Där ingen nyckelring är tillgänglig återgår
CLI:t till ~/.config/elevenlabs/auth-keyring.json med behörigheten 0600. Kör
elevenlabs auth status för att se vilken källa som används och elevenlabs auth logout för att ta bort den
lagrade posten.
För CI anger du ELEVENLABS_API_KEY i miljön eller i en .env-fil i stället för att logga in.
Autentiseringskommandon
Agenthantering
Skapa agenter
Skapa agenter med förbyggda mallar:
Alternativ:
--template <type>: Välj bland tillgängliga mallar (standard: default)--skip-upload: Skapa lokalt utan att ladda upp till plattformen
Exempel:
Mallar
CLI:t erbjuder sex förbyggda mallar för vanliga användningsområden:
default
Komplett konfiguration med alla tillgängliga fält, rimliga standardvärden, fullt stöd för röst/text, widgetanpassning och utvärderingskriterier.
minimal
Endast grundläggande fält, inklusive enkel prompt, språk, TTS och konversationsinställningar.
voice-only
Optimerad för röstinteraktioner med inaktiverad textinmatning och avancerade röstinställningar.
text-only
customer-service
Professionella empatiska promptar, låg temperatur (0.1), 30 minuters varaktighet och utvärderingskriterier.
assistant
AI-assistent för allmänna ändamål med balanserad kreativitet (temperatur 0.3) och mångsidigt stöd för röst/text.
Mallkommandon
Synkronisering
Håll dina lokala konfigurationer synkroniserade med ElevenLabs-plattformen:
Status och övervakning
Import och export
Som standard hoppar elevenlabs agents pull över agenter som redan finns lokalt. Använd flaggan --update
för att ersätta lokala konfigurationer med fjärrändringar som gjorts i webbläsaren eller via API:t.
Verktygshantering
CLI:t har stöd för två typer av verktyg som utökar agenternas funktioner:
Webhook-verktyg
HTTP API-integrationer med autentiserings- och timeoutkonfiguration:
Klientverktyg
Direkta integrationer på klientsidan:
Widgetgenerering
Generera HTML-inbäddningskod för webbintegration:
Detta ger HTML-kod som:
Konfigurationsfiler
Agentkonfigurationens struktur
Varje agentkonfiguration innehåller: