> This is a page from the ElevenLabs documentation. For a complete page index, fetch https://elevenlabs.io/docs/llms.txt. For the full documentation in a single file, fetch https://elevenlabs.io/docs/llms-full.txt.

# ElevenLabs CLI

## Omówienie

ElevenLabs CLI daje ci dostęp do agentów ElevenLabs z terminala, otwierając nowe możliwości zarządzania nimi:

* Przechowuj agentów jako kod w systemie kontroli wersji
* Skonfiguruj integrację CI/CD, by automatycznie wdrażać agentów
* Daj swojemu agentowi kodującemu dostęp do agentów głosowych i możliwość zarządzania nimi

> **Chcesz od razu przejść do kodu?**
>
> Znajdź [pełny kod źródłowy i wesprzyj projekt na GitHubie](https://github.com/elevenlabs/cli).

> **Instalacja nie jest wymagana**
>
> Jeśli pracujesz w Claude lub innym kliencie MCP, [hostowany serwer MCP](/docs/pl/eleven-agents/operate/hosted-mcp) oferuje narzędzia do zarządzania agentami bez lokalnej
> instalacji. Użyj CLI, gdy chcesz trzymać agentów w kontroli wersji; użyj hostowanego serwera MCP do
> zarządzania w rozmowie.

## Instalacja

Homebrew (macOS) i Scoop (Windows) to zalecane metody instalacji, które zapewniają samodzielny plik binarny.

**`Homebrew (macOS)`**

```bash title="Homebrew (macOS)"
brew install elevenlabs/tap/elevenlabs
```

**`Scoop (Windows)`**

```powershell title="Scoop (Windows)"
scoop bucket add elevenlabs https://github.com/elevenlabs/scoop-bucket
scoop install elevenlabs
```

**`npm`**

```bash title="npm"
npm install -g @elevenlabs/cli
```

**`curl`**

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

> **Tip**
>
> Pracujesz z asystentem AI do kodowania? Uruchom `elevenlabs generate-skills` w projekcie, aby zapisać
> `SKILL.md` dla każdej grupy poleceń w `skills/`. Dzięki temu asystent zna pełny zakres CLI
> bez wklejania dokumentacji. Użyj `--output-dir`, aby zapisać je w innym miejscu. Polecenie odczytuje
> wbudowaną definicję API CLI, więc nie potrzebuje klucza API i działa offline — oraz jest zgodne
> z zainstalowaną wersją CLI.

Po instalacji polecenie `elevenlabs` będzie dostępne globalnie w terminalu.

## Szybki start

### Zainicjuj nowy projekt

```bash
elevenlabs agents init
```

To tworzy strukturę projektu z katalogami konfiguracji i plikami rejestru.

### Uwierzytelnij się w ElevenLabs

```bash
elevenlabs auth login
```

Otworzy się okno przeglądarki, w którym uwierzytelnisz się przez OAuth. CLI zweryfikuje dane logowania i bezpiecznie je zapisze.

### Utwórz pierwszego agenta

```bash
elevenlabs agents add "My Assistant" --template assistant
```

To tworzy konfigurację nowego agenta na podstawie szablonu asystenta.

### Prześlij na platformę ElevenLabs

```bash
elevenlabs agents push
```

To przesyła lokalną konfigurację agenta na platformę ElevenLabs.

## Struktura projektu

CLI tworzy uporządkowany katalog projektu:

```
your_project/
├── agents.json              # Central agent configuration registry
├── tools.json               # Tool definitions registry
├── tests.json               # Test definitions registry
├── agent_configs/           # Agent configuration files
├── tool_configs/            # Tool configuration files
└── test_configs/            # Test configuration files
```

## Uwierzytelnianie

`elevenlabs auth login` zapisuje dane logowania w pęku kluczy systemu operacyjnego — Keychain w macOS,
Credential Manager w Windows i Secret Service w Linuxie. Gdy pęk kluczy nie jest dostępny,
CLI używa pliku `~/.config/elevenlabs/auth-keyring.json` z uprawnieniami `0600`. Uruchom
`elevenlabs auth status`, aby sprawdzić używane źródło, oraz `elevenlabs auth logout`, aby usunąć
zapisany wpis.

W CI ustaw `ELEVENLABS_API_KEY` w zmiennej środowiskowej lub pliku `.env` zamiast się logować.

### Polecenia uwierzytelniania

**`Logowanie`**

```bash title="Logowanie"
elevenlabs auth login
```

**`Wylogowanie`**

```bash title="Wylogowanie"
elevenlabs auth logout
```

## Zarządzanie agentami

### Tworzenie agentów

Twórz agentów za pomocą gotowych szablonów:

```bash
elevenlabs agents add "Agent Name" [options]
```

**Opcje:**

* `--template <type>`: Wybierz spośród dostępnych szablonów (domyślnie: default)
* `--skip-upload`: Utwórz lokalnie bez przesyłania na platformę

**Przykład:**

```bash
elevenlabs agents add "Customer Support Bot" --template customer-service
```

### Szablony

CLI oferuje sześć gotowych szablonów do typowych zastosowań:

#### default

Pełna konfiguracja ze wszystkimi dostępnymi polami, rozsądnymi ustawieniami domyślnymi, pełną obsługą głosu i tekstu, dostosowaniem widżetu oraz kryteriami oceny.

#### minimal

Tylko podstawowe pola, w tym prosty prompt, język, TTS i ustawienia rozmowy.

#### voice-only

Zoptymalizowany pod interakcje głosowe, z wyłączonym wprowadzaniem tekstu i zaawansowanymi ustawieniami głosu.

#### text-only

Rozmowy skupione na tekście z wyłączonymi funkcjami głosowymi.

#### customer-service

Profesjonalne, empatyczne prompty, niska temperatura (0.1), czas trwania 30 minut i kryteria
oceny.

#### assistant

Uniwersalny asystent AI ze zrównoważoną kreatywnością (temperatura 0.3) i wszechstronną obsługą głosu oraz tekstu.

### Polecenia szablonów

**`Lista dostępnych szablonów`**

```bash title="Lista dostępnych szablonów"
elevenlabs agents templates list
```

**`Pokaż konfigurację szablonu`**

```bash title="Pokaż konfigurację szablonu"
elevenlabs agents templates show <template>
```

### Synchronizacja

Synchronizuj lokalne konfiguracje z platformą ElevenLabs:

**`Prześlij wszystkich agentów`**

```bash title="Prześlij wszystkich agentów"
elevenlabs agents push
```

**`Podgląd zmian (symulacja)`**

```bash title="Podgląd zmian (symulacja)"
elevenlabs agents push --dry-run
```

### Status i monitorowanie

**`Sprawdź status agenta`**

```bash title="Sprawdź status agenta"
elevenlabs agents status
```

### Import i eksport

**`Importuj istniejących agentów`**

```bash title="Importuj istniejących agentów"
elevenlabs agents pull
```

**`Importuj konkretnego agenta`**

```bash title="Importuj konkretnego agenta"
elevenlabs agents pull --agent <agent_id>
```

**`Zaktualizuj agentów`**

```bash title="Zaktualizuj agentów"
elevenlabs agents pull --update
```

**`Wyświetl wszystkich agentów`**

```bash title="Wyświetl wszystkich agentów"
elevenlabs agents list
```

> **Note**
>
> Domyślnie `elevenlabs agents pull` pomija agentów, którzy już istnieją lokalnie. Użyj flagi `--update`,
> aby zastąpić lokalne konfiguracje zdalnymi zmianami wprowadzonymi w przeglądarce lub przez API.

## Zarządzanie narzędziami

CLI obsługuje dwa typy narzędzi rozszerzających możliwości agentów:

### Narzędzia webhook

Integracje HTTP API z konfiguracją uwierzytelniania i limitu czasu:

```bash
elevenlabs tools add "API Integration" --type "webhook" --config-path ./config.json
```

### Narzędzia klienckie

Bezpośrednie integracje po stronie klienta:

```bash
elevenlabs tools add "Client Function" --type "client" --config-path ./config.json
```

## Generowanie widżetu

Wygeneruj kod HTML do osadzenia na stronie:

```bash
elevenlabs agents widget embed <agent_id>
```

Polecenie zwraca kod HTML podobny do tego:

```html
<elevenlabs-convai agent-id="agent_id_here"></elevenlabs-convai>
<script src="https://unpkg.com/@elevenlabs/convai-widget-embed" async></script>
```

## Pliki konfiguracji

### Struktura konfiguracji agenta

Każda konfiguracja agenta zawiera:

```json
{
  "name": "Agent Name",
  "conversation_config": {
    "agent": {
      "language": "en",
      "prompt": {
        "prompt": "You are a helpful AI assistant.",
        "llm": "gemini-2.5-flash",
        "temperature": 0.0
      }
    },
    "tts": {
      "model_id": "eleven_turbo_v2",
      "voice_id": "cjVigY5qzO86Huf0OWal",
      "agent_output_audio_format": "pcm_16000"
    },
    "asr": {
      "provider": "scribe_realtime",
      "quality": "high",
      "user_input_audio_format": "pcm_16000"
    },
    "conversation": {
      "text_only": false,
      "max_duration_seconds": 600,
      "client_events": ["audio", "interruption"]
    }
  },
  "platform_settings": {
    "widget": {
      "variant": "full",
      "placement": "bottom-right"
    }
  },
  "tags": []
}
```

### Integracja z pipeline'em CI/CD

```yml
# In your GitHub Actions workflow
- name: Deploy ElevenAgents agents
  run: |
    npm install -g @elevenlabs/cli
    export ELEVENLABS_API_KEY=${{ secrets.ELEVENLABS_API_KEY }}
    elevenlabs agents push --dry-run  # Preview changes
    elevenlabs agents push            # Deploy
    elevenlabs agents status          # Verify deployment
```