Presentazione della CLI v1 di ElevenLabs

Oggi presentiamo la v1 della CLI di ElevenLabs, che porta l'API di ElevenLabs direttamente nel tuo terminale.

I coding agent operano già nel terminale, dove eseguono comandi, leggono risultati e perfino ordinano il pranzo. La CLI di ElevenLabs è stata progettata mettendo gli agenti al primo posto: offre comandi ben documentati e risultati JSON strutturati, facili da analizzare e concatenare. Include una modalità --dry-run per visualizzare l'anteprima di qualsiasi operazione prima che modifichi il tuo workspace.

La CLI introduce anche gli agenti come codice in ElevenAgents. Scarica ogni agente del tuo workspace in file di configurazione locali, modificali come qualsiasi altra parte della tua codebase, visualizza il diff esatto e invia le modifiche in produzione manualmente o tramite il tuo coding agent.

Installa su macOS

brew install elevenlabs/tap/elevenlabs

Windows

scoop bucket add elevenlabs https://github.com/elevenlabs/scoop-bucket
scoop install elevenlabs

cURL

curl --proto '=https' --tlsv1.2 -LsSf https://github.com/elevenlabs/cli/releases/latest/download/elevenlabs-cli-installer.sh | sh

L'intera piattaforma da un'unica interfaccia

Ogni endpoint dell'API di ElevenLabs pubblicato nella nostra specifica OpenAPI è disponibile come sottocomando:

# list every agent in your workspace as structured JSON 
elevenlabs agents list --format json

# compose a song from a prompt
elevenlabs music compose --prompt "lo-fi track for a rainy afternoon" --output track.mp3

# speak a sentence and save the audio
elevenlabs text-to-speech convert --voice-id gPPH6SLdL8XSX6GNJ40G --text "Hello from the CLI" --output hello.mp3

Agenti come codice

Gli agenti come codice trattano la configurazione degli agenti come il codice dell'applicazione. Lavori su file su disco e la CLI li mantiene sincronizzati con il tuo workspace. L'intero workflow si riduce a tre comandi.

elevenlabs agents pull              # every agent in your workspace becomes a local config file
# edit a config: change the greeting, swap the voice, update the prompt
elevenlabs agents push --dry-run    # preview exactly what would change, without changing anything
elevenlabs agents push              # apply

Lo stesso workflow si estende alla produzione. I branch tengono separati sviluppo e produzione: un branch dev può usare un numero di telefono di test e un LLM più economico, mentre la produzione usa il numero reale e un modello di frontiera. Per i nuovi progetti, elevenlabs agents init crea tutta la struttura necessaria, con template iniziali per configurazioni comuni come l'assistenza clienti.

Con pochi agenti, la dashboard è gestibile. Tuttavia, quando gestisci una flotta di agenti distribuiti tra centinaia di organizzazioni clienti o esegui una migrazione in blocco da un'altra piattaforma, file e controllo versione sono l'unico workflow che scala.

Creata per coding agent e sviluppatori

Un agente che usa una CLI fallisce in modo diverso da una persona. Non può rispondere a un prompt interattivo, riprova continuamente e apprende da ciò che gli comunica il messaggio di errore. La CLI è progettata tenendo conto di questa realtà.

--help è per le persone, --schema è per gli agenti. Ogni comando API stampa un contratto leggibile dalla macchina, con input tipizzati, la posizione di ciascuno, ciò che è obbligatorio e la struttura esatta della risposta. In questo modo l'agente può costruire una chiamata valida senza dover indovinare.

$ elevenlabs text-to-speech convert --schema
{
  "operation": "text-to-speech.convert",
  "description": "Create speech",
  "binaryResponse": true,
  "input": {
    "properties": {
      "text": { "location": "body", "type": "string" },
      "voice_id": { "location": "path", "type": "string" },
      ...
    },
    "required": ["text", "voice_id"]
  }
}

Anche gli errori danno all'agente elementi su cui lavorare. Per gli agenti, gli errori vengono restituiti in formato JSON, che possono analizzare. Quando viene rilevato un utente umano tramite TTY, viene invece mostrato un semplice messaggio di errore. Entrambi includono istruzioni per risolvere l'errore.

Dato il comando non valido:

$ elevenlabs text-to-speech convert --text "Hello from the CLI"

Gli agenti riceverebbero il seguente messaggio di errore:

$ elevenlabs text-to-speech convert --text "Hello from the CLI"
{
  "error": {
    "code": 400,
    "message": "Required parameter 'voice_id' is missing. Provide it via --voice-id or --params",
    "reason": "validationError"
  }
}

Gli utenti umani, invece, vedono questo errore più leggibile, che include un suggerimento su come risolvere il problema:

error[validation]:
 Required parameter 'voice_id' is missing. Provide it via --voice-id or --params
 Try `elevenlabs text-to-speech convert --help`

Skills incluse

--help e --schema sono il manuale integrato della CLI. Ma le skills vanno oltre e insegnano al tuo coding agent workflow completi, ad esempio come creare un agente, generare parlato o trascrivere una chiamata.

Installale nel tuo progetto:

elevenlabs generate-skills

Gli agenti operano già nel terminale. Ora anche tutto ElevenLabs è lì. Installa la CLI, fornisci le skills al tuo agente e scopri cosa realizza. Inizia con la documentazione.