Skip to navigation
Monitoren

ElevenLabs CLI

Beheer je spraakagenten als code vanaf de command line.

Overzicht

Met de ElevenLabs CLI krijg je vanuit je terminal toegang tot je ElevenLabs-agents, waardoor je ze op nieuwe manieren kunt beheren:

  • Sla agents als code op in je versiebeheersysteem
  • Stel CI/CD-integratie in om je agents automatisch te deployen
  • Geef je coding agent toegang tot en beheer over je spraakagenten
Liever meteen naar de code?

Bekijk de volledige broncode en draag bij op GitHub.

Geen installatie nodig

Als je met Claude of een andere MCP-client werkt, biedt de gehoste MCP- server tools voor agentbeheer zonder lokale installatie. Gebruik de CLI wanneer je agents in versiebeheer wilt; gebruik de gehoste MCP-server voor beheer via gesprekken.

Installatie

Homebrew (macOS) en Scoop (Windows) zijn de aanbevolen installatiemethoden en leveren een zelfstandige binary.

brew install elevenlabs/tap/elevenlabs

Werk je met een AI-code-assistent? Voer elevenlabs generate-skills uit in je project om voor elke commandogroep een SKILL.md naar skills/ te schrijven, zodat je assistent alle mogelijkheden van de CLI kent zonder dat je documentatie hoeft te plakken. Gebruik --output-dir om ze ergens anders te plaatsen. Dit leest de eigen ingebouwde API-definitie van de CLI, dus er is geen API-sleutel nodig en het werkt offline — en het blijft afgestemd op de versie van de CLI die je hebt geïnstalleerd.

Na de installatie is de opdracht elevenlabs overal in je terminal beschikbaar.

Snel aan de slag

1

Initialiseer een nieuw project

elevenlabs agents init

Hiermee maak je de projectstructuur met configuratiemappen en registerbestanden.

2

Verifieer je bij ElevenLabs

elevenlabs auth login

Hiermee wordt een browservenster geopend om je via OAuth te verifiëren. De CLI controleert de inloggegevens en slaat ze veilig op.

3

Maak je eerste agent

elevenlabs agents add "My Assistant" --template assistant

Hiermee maak je een nieuwe agentconfiguratie met de assistant-template.

4

Push naar het ElevenLabs-platform

elevenlabs agents push

Hiermee upload je je lokale agentconfiguratie naar het ElevenLabs-platform.

Projectstructuur

De CLI maakt een gestructureerde projectmap:

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

Verificatie

elevenlabs auth login slaat inloggegevens op in de sleutelring van je besturingssysteem — Keychain op macOS, Credential Manager op Windows en de Secret Service op Linux. Als er geen sleutelring beschikbaar is, valt de CLI terug op ~/.config/elevenlabs/auth-keyring.json met machtigingen 0600. Voer elevenlabs auth status uit om te zien welke bron wordt gebruikt, en elevenlabs auth logout om de opgeslagen vermelding te verwijderen.

Stel voor CI ELEVENLABS_API_KEY in de omgeving of in een .env-bestand in, in plaats van in te loggen.

Verificatieopdrachten

elevenlabs auth login

Agentbeheer

Agents maken

Maak agents met vooraf gebouwde templates:

elevenlabs agents add "Agent Name" [options]

Opties:

  • --template <type>: Kies uit beschikbare templates (standaard: default)
  • --skip-upload: Maak lokaal zonder naar het platform te uploaden

Voorbeeld:

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

Templates

De CLI biedt zes vooraf gebouwde templates voor veelvoorkomende toepassingen:

Volledige configuratie met alle beschikbare velden, verstandige standaardwaarden, volledige ondersteuning voor spraak/tekst, widgetaanpassing en evaluatiecriteria.

Alleen essentiële velden, waaronder een basisprompt, taal, TTS en gespreksinstellingen.

Geoptimaliseerd voor spraakinteracties met uitgeschakelde tekstinvoer en geavanceerde spraakinstellingen.

Gesprekken gericht op tekst, met uitgeschakelde spraakfuncties.

Professionele empathische prompts, lage temperatuur (0.1), een duur van 30 minuten en evaluatiecriteria.

AI-assistent voor algemene doeleinden met gebalanceerde creativiteit (temperatuur 0.3) en veelzijdige ondersteuning voor spraak/tekst.

Templateopdrachten

elevenlabs agents templates list

Synchronisatie

Houd je lokale configuraties gesynchroniseerd met het ElevenLabs-platform:

elevenlabs agents push

Status en monitoring

Agentstatus controleren
elevenlabs agents status

Importeren en exporteren

elevenlabs agents pull

Standaard slaat elevenlabs agents pull agents over die al lokaal bestaan. Gebruik de vlag --update om lokale configuraties te overschrijven met externe wijzigingen die in de browser of via de API zijn aangebracht.

Toolbeheer

De CLI ondersteunt twee typen tools om de mogelijkheden van agents uit te breiden:

Webhooktools

HTTP API-integraties met configuratie voor authenticatie en time-outs:

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

Clienttools

Rechtstreekse client-side-integraties:

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

Widget genereren

Genereer HTML-embedcode voor integratie op het web:

elevenlabs agents widget embed <agent_id>

Dit levert HTML-code op zoals:

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

Configuratiebestanden

Structuur van de agentconfiguratie

Elke agentconfiguratie bevat:

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

# 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