Vai alla navigazione

CLI ElevenLabs

Gestisci i tuoi agenti vocali come codice dalla riga di comando.

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
Vuoi passare direttamente al codice?

Trova il codice sorgente completo e contribuisci su GitHub.

Nessuna installazione necessaria

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.

brew install elevenlabs/tap/elevenlabs

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

1

Inizializza un nuovo progetto

elevenlabs agents init

Viene così creata la struttura del progetto con directory di configurazione e file di registro.

2

Autenticati con ElevenLabs

elevenlabs auth login

Si aprirà una finestra del browser per autenticarti tramite OAuth. La CLI verificherà le credenziali e le archivierà in modo sicuro.

3

Crea il tuo primo agente

elevenlabs agents add "My Assistant" --template assistant

Viene così creata una nuova configurazione dell’agente usando il template assistant.

4

Esegui il push sulla piattaforma ElevenLabs

elevenlabs agents push

La configurazione del tuo agente locale viene caricata sulla piattaforma ElevenLabs.

Struttura del progetto

La CLI crea una directory del progetto strutturata:

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

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

elevenlabs auth login

Gestione degli agenti

Creazione degli agenti

Crea agenti usando template predefiniti:

elevenlabs agents add "Agent Name" [options]

Opzioni:

  • --template <type>: Scegli tra i template disponibili (predefinito: default)
  • --skip-upload: Crea localmente senza caricare sulla piattaforma

Esempio:

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

Template

La CLI offre sei template predefiniti per casi d’uso comuni:

Configurazione completa con tutti i campi disponibili, valori predefiniti adeguati, supporto completo per voce/testo, personalizzazione del widget e criteri di valutazione.

Solo i campi essenziali, inclusi prompt di base, lingua, TTS e impostazioni della conversazione.

Ottimizzato per le interazioni vocali, con input di testo disabilitato e impostazioni vocali avanzate.

Conversazioni incentrate sul testo con funzionalità vocali disabilitate.

Prompt professionali ed empatici, temperatura bassa (0.1), durata di 30 minuti e criteri di valutazione.

Assistente IA per uso generico con creatività bilanciata (temperatura 0.3) e supporto versatile per voce/testo.

Comandi dei template

elevenlabs agents templates list

Sincronizzazione

Mantieni sincronizzate le tue configurazioni locali con la piattaforma ElevenLabs:

elevenlabs agents push

Stato e monitoraggio

Controlla lo stato dell'agente
elevenlabs agents status

Importazione ed esportazione

elevenlabs agents pull

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:

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

Strumenti client

Integrazioni dirette lato client:

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

Generazione di widget

Genera codice HTML incorporabile per l’integrazione web:

elevenlabs agents widget embed <agent_id>

Viene generato codice HTML come questo:

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

File di configurazione

Struttura della configurazione dell’agente

Ogni configurazione dell’agente include:

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

Integrazione della 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