CLI ElevenLabs
Panoramica
La CLI di ElevenLabs ti consente di accedere ai tuoi agenti ElevenLabs dal terminale, offrendoti nuovi modi per gestirli:
- Archivia gli agenti come codice nel tuo sistema di controllo delle versioni
- Configura l’integrazione CI/CD per distribuire automaticamente i tuoi agenti
- Consenti al tuo coding agent di accedere ai tuoi agenti vocali e gestirli
Se lavori da Claude o da un altro client MCP, il server MCP gestito offre strumenti di gestione degli agenti senza installazione locale. Usa la CLI quando vuoi gestire gli agenti nel controllo delle versioni; usa il server MCP gestito per la gestione conversazionale.
Installazione
Homebrew (macOS) e Scoop (Windows) sono i metodi di installazione consigliati e forniscono un binario autonomo.
Lavori con un assistente di coding IA? Esegui elevenlabs generate-skills nel tuo progetto per creare un
file SKILL.md per ogni gruppo di comandi in skills/, così il tuo assistente conosce tutte le funzionalità della CLI
senza che tu debba incollare la documentazione. Usa --output-dir per inserirli altrove. Il comando legge la definizione API
integrata della CLI, quindi non richiede una chiave API e funziona offline — inoltre rimane allineato
alla versione della CLI che hai installato.
Dopo l’installazione, il comando elevenlabs sarà disponibile globalmente nel tuo terminale.
Avvio rapido
Inizializza un nuovo progetto
Viene così creata la struttura del progetto con directory di configurazione e file di registro.
Autenticati con ElevenLabs
Si aprirà una finestra del browser per autenticarti tramite OAuth. La CLI verificherà le credenziali e le archivierà in modo sicuro.
Struttura del progetto
La CLI crea una directory del progetto strutturata:
Autenticazione
elevenlabs auth login archivia le credenziali nel portachiavi del tuo sistema operativo: Keychain su macOS,
Credential Manager su Windows e Secret Service su Linux. Dove non è disponibile alcun portachiavi, la
CLI usa come alternativa ~/.config/elevenlabs/auth-keyring.json con autorizzazioni 0600. Esegui
elevenlabs auth status per vedere quale origine è in uso e elevenlabs auth logout per rimuovere la
voce archiviata.
Per CI, imposta ELEVENLABS_API_KEY nell’ambiente o in un file .env invece di effettuare l’accesso.
Comandi di autenticazione
Gestione degli agenti
Creazione degli agenti
Crea agenti usando template predefiniti:
Opzioni:
--template <type>: Scegli tra i template disponibili (predefinito: default)--skip-upload: Crea localmente senza caricare sulla piattaforma
Esempio:
Template
La CLI offre sei template predefiniti per casi d’uso comuni:
default
Configurazione completa con tutti i campi disponibili, valori predefiniti adeguati, supporto completo per voce/testo, personalizzazione del widget e criteri di valutazione.
minimal
Solo i campi essenziali, inclusi prompt di base, lingua, TTS e impostazioni della conversazione.
voice-only
Ottimizzato per le interazioni vocali, con input di testo disabilitato e impostazioni vocali avanzate.
text-only
customer-service
Prompt professionali ed empatici, temperatura bassa (0.1), durata di 30 minuti e criteri di valutazione.
assistant
Assistente IA per uso generico con creatività bilanciata (temperatura 0.3) e supporto versatile per voce/testo.
Comandi dei template
Sincronizzazione
Mantieni sincronizzate le tue configurazioni locali con la piattaforma ElevenLabs:
Stato e monitoraggio
Importazione ed esportazione
Per impostazione predefinita, elevenlabs agents pull ignora gli agenti già presenti in locale. Usa il flag
--update per sovrascrivere le configurazioni locali con le modifiche remote effettuate nel browser o tramite l’API.
Gestione degli strumenti
La CLI supporta due tipi di strumenti per estendere le capacità degli agenti:
Strumenti webhook
Integrazioni API HTTP con configurazione di autenticazione e timeout:
Strumenti client
Integrazioni dirette lato client:
Generazione di widget
Genera codice HTML incorporabile per l’integrazione web:
Viene generato codice HTML come questo:
File di configurazione
Struttura della configurazione dell’agente
Ogni configurazione dell’agente include: