CLI ElevenLabs

Gérez vos agents vocaux sous forme de code depuis votre ligne de commande.

Présentation

L’interface en ligne de commande ElevenLabs vous permet d’accéder à vos agents ElevenLabs depuis votre terminal et ouvre de nouvelles possibilités pour les gérer :

Stockez les agents sous forme de code dans votre système de gestion de versions
Configurez une intégration CI/CD pour déployer automatiquement vos agents
Autorisez votre agent de codage à accéder à vos agents vocaux et à les gérer

Vous préférez accéder directement au code ?

Retrouvez le code source complet et contribuez sur GitHub.

Aucune installation requise

Si vous travaillez depuis Claude ou un autre client MCP, le serveur MCP hébergé propose des outils de gestion des agents sans installation locale. Utilisez l’interface en ligne de commande lorsque vous souhaitez placer vos agents sous contrôle de version ; utilisez le serveur MCP hébergé pour une gestion conversationnelle.

Installation

Homebrew (macOS) et Scoop (Windows) sont les méthodes d’installation recommandées et fournissent un binaire autonome.

brew install elevenlabs/tap/elevenlabs

Vous travaillez avec un assistant de programmation IA ? Exécutez elevenlabs generate-skills dans votre projet pour créer un fichier SKILL.md pour chaque groupe de commandes dans skills/, afin que votre assistant connaisse toutes les fonctionnalités de la CLI sans que vous ayez à copier la documentation. Utilisez --output-dir pour les placer ailleurs. Cette commande lit la propre définition d’API intégrée à la CLI, elle ne nécessite donc aucune clé API et fonctionne hors ligne, tout en restant synchronisée avec la version de la CLI que vous avez installée.

Après l’installation, la commande elevenlabs sera disponible globalement dans votre terminal.

Démarrage rapide

Initialiser un nouveau projet

elevenlabs agents init

Cette commande crée la structure du projet avec les répertoires de configuration et les fichiers de registre.

S’authentifier auprès d’ElevenLabs

elevenlabs auth login

Cette commande ouvre une fenêtre de navigateur afin de vous authentifier via OAuth. L’interface en ligne de commande vérifie les identifiants et les stocke de manière sécurisée.

Créer votre premier agent

elevenlabs agents add "My Assistant" --template assistant

Cette commande crée une nouvelle configuration d’agent à l’aide du modèle assistant.

Envoyer vers la plateforme ElevenLabs

elevenlabs agents push

Cette commande charge votre configuration d’agent locale sur la plateforme ElevenLabs.

Structure du projet

L’interface en ligne de commande crée un répertoire de projet structuré :

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

Authentification

elevenlabs auth login stocke les identifiants dans le trousseau de votre système d’exploitation : Keychain sur macOS, Gestionnaire d’identifiants sur Windows et Secret Service sur Linux. Lorsqu’aucun trousseau n’est disponible, l’interface en ligne de commande utilise ~/.config/elevenlabs/auth-keyring.json avec les autorisations 0600. Exécutez elevenlabs auth status pour voir la source utilisée et elevenlabs auth logout pour supprimer l’entrée stockée.

Pour l’intégration continue, définissez ELEVENLABS_API_KEY dans l’environnement ou dans un fichier .env au lieu de vous connecter.

Commandes d’authentification

elevenlabs auth login

Gestion des agents

Création d’agents

Créez des agents à l’aide de modèles prédéfinis :

elevenlabs agents add "Agent Name" [options]

Options :

--template <type> : choisissez parmi les modèles disponibles (par défaut : default)
--skip-upload : créez localement sans charger sur la plateforme

Exemple :

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

Modèles

L’interface en ligne de commande propose six modèles prédéfinis pour les cas d’usage courants :

default

Configuration complète avec tous les champs disponibles, des valeurs par défaut pertinentes, une prise en charge complète de la voix et du texte, la personnalisation du widget et des critères d’évaluation.

minimal

Champs essentiels uniquement, notamment le prompt de base, la langue, la synthèse vocale et les paramètres de conversation.

voice-only

Optimisé pour les interactions vocales, avec saisie de texte désactivée et paramètres vocaux avancés.

text-only

Conversations axées sur le texte, avec fonctionnalités vocales désactivées.

customer-service

Prompts professionnels et empathiques, faible température (0,1), durée de 30 minutes et critères d’évaluation.

assistant

Assistant IA polyvalent offrant un équilibre entre créativité (température de 0,3) et prise en charge flexible de la voix et du texte.

Commandes des modèles

elevenlabs agents templates list

Synchronisation

Maintenez vos configurations locales synchronisées avec la plateforme ElevenLabs :

elevenlabs agents push

État et suivi

Vérifier l'état de l'agent

elevenlabs agents status

Importation et exportation

elevenlabs agents pull

Par défaut, elevenlabs agents pull ignore les agents qui existent déjà localement. Utilisez l’option --update pour remplacer les configurations locales par les modifications distantes effectuées dans le navigateur ou via l’API.

Gestion des outils

L’interface en ligne de commande prend en charge deux types d’outils pour étendre les capacités des agents :

Outils webhook

Intégrations d’API HTTP avec authentification et configuration du délai d’expiration :

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

Outils client

Intégrations directes côté client :

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

Générez du code d’intégration HTML pour le web :

elevenlabs agents widget embed <agent_id>

Cette commande génère du code HTML comme suit :

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

Fichiers de configuration

Structure de la configuration d’un agent

Chaque configuration d’agent comprend :

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

Intégration au pipeline CI/CD

# 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