ElevenLabs CLI | ElevenLabs Documentation

Översikt

Med ElevenLabs CLI kan du komma åt dina ElevenLabs-agenter från terminalen och få 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 kodningsagent få åtkomst till och hantera dina röstagenter

Vill du gå direkt till koden?

Hitta den fullständiga 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 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 levererar 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

Initiera ett nytt projekt

elevenlabs agents init

Detta skapar projektstrukturen med konfigurationskataloger och registerfiler.

Autentisera med ElevenLabs

elevenlabs auth login

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

Skapa din första agent

elevenlabs agents add "My Assistant" --template assistant

Detta skapar en ny agentkonfiguration med assistentmallen.

Överför till ElevenLabs-plattformen

elevenlabs agents push

Detta överför din lokala agentkonfiguration till ElevenLabs-plattformen.

Projektstruktur

CLI 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 — Keychain på macOS, Credential Manager på Windows och Secret Service på Linux. När ingen nyckelring är tillgänglig använder CLI i stället ~/.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ärdiga mallar:

elevenlabs agents add "Agent Name" [options]

Alternativ:

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

Exempel:

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

Mallar

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

default

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

minimal

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

voice-only

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

text-only

Textfokuserade konversationer med inaktiverade röstfunktioner.

customer-service

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

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

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 åsidosätta lokala konfigurationer med fjärrändringar som gjorts i webbläsaren eller via API:et.

Verktygshantering

CLI stöder två typer av verktyg för att utöka agenternas funktioner:

Webhook-verktyg

HTTP API-integrationer med konfiguration för autentisering och tidsgräns:

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

Agentkonfigurationsstruktur

Varje agentkonfiguration innehåller:

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