Presentazione della CLI v1 di ElevenLabs

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

Gli agenti di coding vivono già nel terminale, dove eseguono comandi, leggono i risultati e persino ordinano il pranzo. La CLI di ElevenLabs è progettata dando priorità agli agenti: offre comandi ben documentati e risultati JSON strutturati, facili da analizzare e concatenare. Include una modalità --dry-run per visualizzare in anteprima qualsiasi operazione prima che modifichi il tuo workspace.

La CLI porta gli agenti come codice anche 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 inviali in produzione manualmente o tramite il tuo agente di coding.

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 in locale e la CLI li mantiene sincronizzati con il tuo workspace. L'intero workflow richiede solo 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 separano sviluppo e produzione: un branch di sviluppo 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 assistenza clienti.

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

Progettata per agenti di coding e sviluppatori

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

--help è per le persone, --schema è per gli agenti. Ogni comando API restituisce un contratto leggibile dalla macchina con input tipizzati, la posizione di ciascuno, ciò che è obbligatorio e la struttura esatta della risposta. Così 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 qualcosa su cui lavorare. Per gli agenti, gli errori vengono restituiti come 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 e con 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`

Le skills sono già incluse

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

Installale nel tuo progetto:

elevenlabs generate-skills

Gli agenti vivono già nel terminale. Ora anche tutto ElevenLabs è lì. Installa la CLI, fornisci le skills al tuo agente e scopri cosa riesce a creare. Inizia dalla documentazione.