Apresentamos a CLI v1 da ElevenLabs

Hoje, apresentamos a v1 da CLI da ElevenLabs que leva a API da ElevenLabs diretamente para o seu terminal.

Agentes de programação já usam o terminal para executar comandos, ler resultados e até pedir almoço. A CLI da ElevenLabs foi projetada priorizando agentes, com comandos bem documentados e resultados JSON estruturados, fáceis de analisar e encadear. Ela inclui um modo --dry-run para visualizar qualquer operação antes que ela afete seu workspace.

A CLI também traz agentes como código para o ElevenAgents. Baixe todos os agentes do seu workspace em arquivos locais de configuração, edite-os como qualquer outra parte da sua base de código, visualize o diff exato e envie para produção manualmente ou por meio do seu agente de programação.

Instale no 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 a plataforma em uma única interface

Todos os endpoints da API da ElevenLabs publicados na nossa especificação OpenAPI estão disponíveis 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

Agentes como código trata a configuração dos agentes da mesma forma que você trata o código da aplicação. Você trabalha com arquivos no disco, e a CLI os mantém sincronizados com seu workspace. Todo o workflow cabe em três 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

O mesmo workflow se estende à produção. As branches mantêm desenvolvimento e produção separados: uma branch de desenvolvimento pode usar um número de telefone de teste e um LLM mais barato, enquanto a produção usa o número real e um modelo de ponta. E, para novos projetos, elevenlabs agents init cria toda a estrutura, com templates iniciais para configurações comuns, como atendimento ao cliente.

Com poucos agentes, o painel é fácil de gerenciar. Porém, ao gerenciar uma frota de agentes distribuídos entre centenas de organizações de clientes ou migrar agentes em massa de outra plataforma, arquivos e controle de versão são o único workflow que escala.

Feita para agentes de programação e desenvolvedores

Um agente que usa uma CLI falha de forma diferente de uma pessoa. Ele não consegue responder a um prompt interativo, tenta novamente o tempo todo e aprende com o que a mensagem de erro informa. A CLI foi projetada considerando essa realidade.

--help é para pessoas; --schema é para agentes. Cada comando da API exibe um contrato legível por máquina, com entradas tipadas, onde cada uma deve ser inserida, o que é obrigatório e o formato exato da resposta. Isso permite que o agente construa uma chamada válida sem precisar adivinhar.

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

Os erros também dão ao agente algo com que trabalhar. Para agentes, os erros retornam como JSON que eles podem analisar. Quando um usuário humano é detectado via TTY, uma mensagem de erro simples é exibida. Ambas incluem instruções para corrigir o erro.

Dado o comando inválido:

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

Os agentes receberiam a seguinte mensagem de erro:

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

Já os usuários humanos veem este erro, mais legível e com uma dica de como resolver o problema:

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

Skills já vêm incluídas

--help e --schema são o manual integrado da CLI. Mas as skills vão além e ensinam ao seu agente de programação workflows completos, como criar um agente, gerar fala ou transcrever uma chamada.

Instale-as no seu projeto:

elevenlabs generate-skills

Os agentes já usam o terminal. Agora, toda a ElevenLabs também está nele. Instale a CLI, dê as skills ao seu agente e veja o que ele entrega. Comece com a documentação.