Presentamos ElevenLabs CLI v1.0

Hoy presentamos la v1 de la CLI de ElevenLabs, que lleva la API de ElevenLabs directamente a tu terminal.

Agentes de programación ya viven en la terminal, donde ejecutan comandos, leen resultados e incluso piden comida. La CLI de ElevenLabs se ha diseñado pensando primero en agentes, con comandos bien documentados y resultados JSON estructurados fáciles de analizar y encadenar. Incluye un modo --dry-run para previsualizar cualquier operación antes de que afecte a tu espacio de trabajo.

La CLI también incorpora agentes como código a ElevenAgents. Descarga todos los agentes de tu espacio de trabajo en archivos de configuración locales, edítalos como cualquier otra parte de tu código, previsualiza el diff exacto y despliega en producción manualmente o mediante tu agente de programación.

Instala en 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

Toda la plataforma desde una sola interfaz

Todas las rutas de la API de ElevenLabs publicadas en nuestra especificación OpenAPI están disponibles como subcomandos:

# 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

Agentes como código

Los agentes como código tratan la configuración de los agentes igual que el código de una aplicación. Trabajas con archivos en disco y la CLI los mantiene sincronizados con tu espacio de trabajo. Todo el flujo de trabajo cabe en tres comandos.

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

El mismo flujo de trabajo se extiende a producción. Las ramas mantienen separados el desarrollo y la producción: una rama de desarrollo puede usar un número de teléfono de prueba y un LLM más económico, mientras que producción usa el número real y un modelo de vanguardia. Y para proyectos nuevos, elevenlabs agents init crea toda la estructura, con plantillas iniciales para configuraciones habituales como atención al cliente.

Con unos pocos agentes, el panel es manejable. Sin embargo, al gestionar una flota de agentes repartidos entre cientos de organizaciones de clientes o migrar agentes en bloque desde otra plataforma, los archivos y el control de versiones son el único flujo de trabajo que escala.

Creada para agentes de programación y desarrolladores

Un agente que usa una CLI falla de forma distinta a una persona. No puede responder a una solicitud interactiva, reintenta constantemente y aprende de todo lo que le indica el mensaje de error. La CLI está diseñada en torno a esta realidad.

--help es para personas; --schema es para agentes. Cada comando de la API muestra un contrato legible por máquinas con datos de entrada tipados, dónde va cada uno, qué es obligatorio y la estructura exacta de la respuesta. Esto permite al agente construir una llamada válida sin tener que adivinar.

$ 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"]
  }
}

Los errores también dan al agente algo con lo que trabajar. Para los agentes, los errores se devuelven como JSON que pueden analizar. Cuando se detecta a un usuario humano mediante TTY, se muestra en su lugar un mensaje de error en texto plano. Ambos incluyen instrucciones para corregir el error.

Dado el comando no válido:

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

Los agentes recibirían el siguiente mensaje de error:

$ 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"
  }
}

En cambio, usuarios humanos ven este error, más legible e incluye una indicación para resolver el problema:

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

Skills incluidas

--help y --schema son el manual integrado de la CLI. Pero las skills van más allá y enseñan a tu agente de programación flujos de trabajo completos, como crear un agente, generar voz o transcribir una llamada.

Instálalas en tu proyecto:

elevenlabs generate-skills

Los agentes ya viven en la terminal. Ahora ElevenLabs también. Instala la CLI, proporciona las skills a tu agente y descubre qué crea. Empieza con la documentación.