Hoppa till navigering

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
Vill du gå direkt till koden?

Hitta den kompletta källkoden och bidra på GitHub.

Ingen installation krävs

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.

brew install elevenlabs/tap/elevenlabs

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

1

Initiera ett nytt projekt

elevenlabs agents init

Detta skapar projektstrukturen med konfigurationskataloger och registerfiler.

2

Autentisera med ElevenLabs

elevenlabs auth login

Detta öppnar ett webbläsarfönster för autentisering via OAuth. CLI:t verifierar autentiseringsuppgifterna och lagrar dem säkert.

3

Skapa din första agent

elevenlabs agents add "My Assistant" --template assistant

Detta skapar en ny agentkonfiguration med assistentmallen.

4

Skicka till ElevenLabs-plattformen

elevenlabs agents push

Detta laddar upp din lokala agentkonfiguration till ElevenLabs-plattformen.

Projektstruktur

CLI:t skapar en strukturerad projektkatalog:

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

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

elevenlabs auth login

Agenthantering

Skapa agenter

Skapa agenter med förbyggda mallar:

elevenlabs agents add "Agent Name" [options]

Alternativ:

  • --template <type>: Välj bland tillgängliga mallar (standard: default)
  • --skip-upload: Skapa lokalt utan att ladda upp till plattformen

Exempel:

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

Mallar

CLI:t erbjuder sex förbyggda mallar för vanliga användningsområden:

Komplett konfiguration med alla tillgängliga fält, rimliga standardvärden, fullt stöd för röst/text, widgetanpassning och utvärderingskriterier.

Endast grundläggande fält, inklusive enkel prompt, språk, TTS och konversationsinställningar.

Optimerad för röstinteraktioner med inaktiverad textinmatning och avancerade röstinställningar.

Textfokuserade konversationer med inaktiverade röstfunktioner.

Professionella empatiska promptar, låg temperatur (0.1), 30 minuters varaktighet och utvärderingskriterier.

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

elevenlabs agents templates list

Synkronisering

Håll dina lokala konfigurationer synkroniserade med ElevenLabs-plattformen:

elevenlabs agents push

Status och övervakning

Kontrollera agentstatus
elevenlabs agents status

Import och export

elevenlabs agents pull

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:

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

Klientverktyg

Direkta integrationer på klientsidan:

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

Widgetgenerering

Generera HTML-inbäddningskod för webbintegration:

elevenlabs agents widget embed <agent_id>

Detta ger HTML-kod som:

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

Konfigurationsfiler

Agentkonfigurationens struktur

Varje agentkonfiguration innehåller:

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

CI/CD-pipelineintegration

# 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