Przedstawiamy ElevenLabs CLI v1

Dziś przedstawiamy v1 ElevenLabs CLI, które przenosi API ElevenLabs prosto do twojego terminala.

Agenci programistyczni już działają w terminalu, gdzie uruchamiają polecenia, odczytują wyniki, a nawet zamawiają lunch. ElevenLabs CLI zaprojektowaliśmy przede wszystkim dla agentów: oferuje dobrze udokumentowane polecenia i uporządkowane wyniki JSON, które łatwo analizować i łączyć. Zawiera też tryb --dry-run do podglądu każdej operacji, zanim wpłynie ona na twój workspace.

CLI wprowadza też agents-as-code do ElevenAgents. Pobierz każdego agenta z workspace do lokalnych plików konfiguracyjnych, edytuj je jak każdą inną część kodu, podejrzyj dokładny diff i wdrażaj na produkcję ręcznie lub przez agenta programistycznego.

Instalacja na 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

Cała platforma w jednym interfejsie

Każdy endpoint API ElevenLabs opublikowany w naszej specyfikacji OpenAPI jest dostępny jako podpolecenie:

# 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

Agenci jako kod

Agents-as-code traktuje konfigurację agentów tak jak kod aplikacji. Pracujesz na plikach na dysku, a CLI utrzymuje ich synchronizację z twoim workspace. Cały workflow mieści się w trzech poleceniach.

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

Ten sam workflow działa też na produkcji. Gałęzie oddzielają development od produkcji — gałąź deweloperska może używać testowego numeru telefonu i tańszego LLM, a produkcja prawdziwego numeru i modelu frontier. W nowych projektach elevenlabs agents init tworzy całą strukturę z szablonami startowymi dla typowych konfiguracji, np. obsługi klienta.

Przy kilku agentach dashboard wystarcza. Jednak gdy zarządzasz flotą agentów w setkach organizacji klientów albo masowo przenosisz agentów z innej platformy, tylko pliki i kontrola wersji pozwalają się skalować.

Stworzone dla agentów programistycznych i deweloperów

Agent używający CLI napotyka błędy inaczej niż człowiek. Nie odpowie na interaktywny prompt, stale ponawia próby i uczy się z komunikatów błędów. CLI zaprojektowaliśmy z myślą o tej rzeczywistości.

--help jest dla ludzi, a --schema dla agentów. Każde polecenie API wyświetla kontrakt odczytywalny dla maszyn: typy danych wejściowych, miejsce ich użycia, wymagane pola i dokładny format odpowiedzi. Dzięki temu agent może utworzyć poprawne wywołanie bez zgadywania.

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

Błędy też dają agentowi punkt zaczepienia. Agenci otrzymują je jako JSON, który mogą analizować. Gdy przez TTY wykryjemy użytkownika, wyświetlamy prosty komunikat błędu. Oba zawierają wskazówki, jak rozwiązać problem.

Dla nieprawidłowego polecenia:

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

Agenci otrzymają taki komunikat błędu:

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

Użytkownicy zobaczą za to czytelniejszy błąd ze wskazówką, jak rozwiązać problem:

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

Skills w pakiecie

--help i --schema to wbudowana dokumentacja CLI. Skills idą jednak dalej i uczą twojego agenta programistycznego całych workflow, takich jak tworzenie agenta, generowanie mowy czy transkrypcja rozmowy.

Zainstaluj je w swoim projekcie:

elevenlabs generate-skills

Agenci już działają w terminalu. Teraz działa tam też całe ElevenLabs. Zainstaluj CLI, przekaż agentowi skills i zobacz, co stworzy. Zacznij od dokumentacji.