> 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.
import { YoutubeEmbed } from "../../../components/YoutubeEmbed";
### ElevenLabs CLI
[ElevenLabs CLI v1.0.0](https://github.com/elevenlabs/cli/releases/tag/v1.0.0) jest już dostępne. Każda operacja ElevenLabs API jest dostępna jako podkomenda, z wynikami w formatach JSON, tabeli, YAML i CSV, automatyczną paginacją oraz uzupełnianiem poleceń w powłoce.
CLI oferuje też lokalne workflow konfiguracji dla ElevenAgents. Zapisuj konfiguracje agentów, narzędzi i testów jako pliki, synchronizuj je poleceniami push i pull, zarządzaj gałęziami, uruchamiaj testy, instaluj komponenty interfejsu ElevenLabs i wybieraj region rezydencji danych.
Zainstaluj CLI, uwierzytelnij się i zarządzaj agentami jak kodem.
### Procedury
Procedury są teraz ogólnie dostępne w ElevenAgents. Procedura zawiera instrukcje dotyczące konkretnego zadania oraz wyzwalacz, który określa, kiedy mają zastosowanie. W trakcie rozmowy agent ładuje odpowiednią procedurę, dzięki czemu jeden agent może obsługiwać różne zadania bez umieszczania wszystkich instrukcji w promcie systemowym.
Używaj procedur swobodnych, gdy agent może dostosować sformułowania lub kolejność instrukcji. Używaj procedur strukturyzowanych, gdy kroki muszą być wykonywane w określonej kolejności. Obu typów można używać wraz z workflow w tym samym agencie.
Dowiedz się, kiedy używać procedur i czym różnią się od promptów oraz workflow.
Twórz instrukcje w języku naturalnym, które agent może dostosować do rozmowy.
Określ typowane kroki, które agent wykonuje w stałej kolejności.
### ElevenAgents
- **Tickety oceny rozmów**: Dodaliśmy API do tworzenia ticketów dotyczących działania agentów, tworzenia ręcznych ticketów do dalszej obsługi, wyświetlania ticketów, przypisywania członków obszaru roboczego, aktualizacji statusu i osoby przypisanej oraz dodawania komentarzy do ticketu lub konkretnej tury.
- **Obserwowalność rozmów**: Klienci realtime mogą otrzymywać zdarzenie `context_usage` po każdej zakończonej turze agenta. Zdarzenie podaje model, liczbę tokenów promptu i limit kontekstu modelu.
### Wydania SDK
#### JavaScript SDK
- [v2.65.0](https://github.com/elevenlabs/elevenlabs-js/releases/tag/v2.65.0) - Dodano klientów i typy dla ticketów oceny rozmów oraz zwięzłych podsumowań rozmów. API rozmów zyskują filtry procedury, nieprawidłowego wywołania narzędzia i sortowania; API procedur zyskują wybór wersji agenta; API tematów zyskują ustawienia szczegółów oceny i sortowanie według frustracji. Wydanie dodaje też pola częstotliwości odświeżania bazy wiedzy, środowiska testowego i integracji alertów oraz typy wiadomości realtime dla Dubbing.
#### Python SDK
- [v2.65.0](https://github.com/elevenlabs/elevenlabs-python/releases/tag/v2.65.0) - Dodano klientów i typy dla ticketów oceny rozmów oraz zwięzłych podsumowań rozmów. API rozmów zyskują filtry procedury, nieprawidłowego wywołania narzędzia i sortowania; API procedur zyskują wybór wersji agenta; API tematów zyskują ustawienia szczegółów oceny i sortowanie według frustracji. Wydanie dodaje też pola częstotliwości odświeżania bazy wiedzy, środowiska testowego i integracji alertów, a także zachowuje powtarzające się pola multipart dla `keyterms` w Speech to Text i `webhook_ids` w Dubbing.
#### Swift SDK
- [v3.3.0](https://github.com/elevenlabs/elevenlabs-swift-sdk/releases/tag/v3.3.0) - Dodano typowane parsowanie błędów klienta, obsługę `expects_response` i bezpieczne typowo wyniki narzędzi. Uruchamianie WebRTC jest teraz gotowe, gdy agent dołącza, zamiast czekać na subskrypcję ścieżki audio. Wydanie wzmacnia też obsługę URL-i, wycisza szum nieznanych zdarzeń i usuwa alokację wątku realtime z obsługi programowego wyciszania.
#### Pakiety
- [@elevenlabs/client@1.19.1](https://github.com/elevenlabs/packages/releases/tag/%40elevenlabs%2Fclient%401.19.1), [@elevenlabs/react@1.12.3](https://github.com/elevenlabs/packages/releases/tag/%40elevenlabs%2Freact%401.12.3), [@elevenlabs/react-native@1.2.21](https://github.com/elevenlabs/packages/releases/tag/%40elevenlabs%2Freact-native%401.2.21), [@elevenlabs/convai-widget-core@0.16.2](https://github.com/elevenlabs/packages/releases/tag/%40elevenlabs%2Fconvai-widget-core%400.16.2) i [@elevenlabs/convai-widget-embed@0.16.2](https://github.com/elevenlabs/packages/releases/tag/%40elevenlabs%2Fconvai-widget-embed%400.16.2) - Przechwytywanie wyjścia WebRTC korzysta teraz ze ścieżek AudioWorklet hostowanych samodzielnie przy restrykcyjnych zasadach bezpieczeństwa treści. Buforowanie workletów uwzględnia żądane źródło, dzięki czemu wcześniejszy wbudowany URL nie zastąpi ścieżki hostowanej samodzielnie. Błędy konfiguracji React Native wskazują teraz na `@elevenlabs/react-native`.
- [@elevenlabs/client@1.20.0](https://github.com/elevenlabs/packages/releases/tag/%40elevenlabs%2Fclient%401.20.0), [@elevenlabs/react@1.12.4](https://github.com/elevenlabs/packages/releases/tag/%40elevenlabs%2Freact%401.12.4), [@elevenlabs/react-native@1.2.22](https://github.com/elevenlabs/packages/releases/tag/%40elevenlabs%2Freact-native%401.2.22), [@elevenlabs/convai-widget-core@0.16.3](https://github.com/elevenlabs/packages/releases/tag/%40elevenlabs%2Fconvai-widget-core%400.16.3) i [@elevenlabs/convai-widget-embed@0.16.3](https://github.com/elevenlabs/packages/releases/tag/%40elevenlabs%2Fconvai-widget-embed%400.16.3) - Dodano opcjonalne `webRtc.iceTransportPolicy`. Ustaw je na `relay`, aby ograniczyć kandydatów WebRTC ICE do przekaźników TURN w sieciach blokujących bezpośredni ruch UDP.
- [@elevenlabs/client@1.21.0](https://github.com/elevenlabs/packages/releases/tag/%40elevenlabs%2Fclient%401.21.0), [@elevenlabs/react@1.13.0](https://github.com/elevenlabs/packages/releases/tag/%40elevenlabs%2Freact%401.13.0), [@elevenlabs/types@0.21.1](https://github.com/elevenlabs/packages/releases/tag/%40elevenlabs%2Ftypes%400.21.1), [@elevenlabs/react-native@1.2.23](https://github.com/elevenlabs/packages/releases/tag/%40elevenlabs%2Freact-native%401.2.23), [@elevenlabs/convai-widget-core@0.16.4](https://github.com/elevenlabs/packages/releases/tag/%40elevenlabs%2Fconvai-widget-core%400.16.4) i [@elevenlabs/convai-widget-embed@0.16.4](https://github.com/elevenlabs/packages/releases/tag/%40elevenlabs%2Fconvai-widget-embed%400.16.4) - Dodano callback `onContextUsage` i typ `ContextUsageEvent`. React udostępnia callback przez `useConversation`. React Native rozwiązuje teraz moduły przez warunek eksportu pakietu zamiast wykrywania globalnego obiektu przeglądarki.
- [@elevenlabs/client@1.22.0](https://github.com/elevenlabs/packages/releases/tag/%40elevenlabs%2Fclient%401.22.0), [@elevenlabs/react@1.14.0](https://github.com/elevenlabs/packages/releases/tag/%40elevenlabs%2Freact%401.14.0), [@elevenlabs/types@0.22.0](https://github.com/elevenlabs/packages/releases/tag/%40elevenlabs%2Ftypes%400.22.0), [@elevenlabs/react-native@1.2.24](https://github.com/elevenlabs/packages/releases/tag/%40elevenlabs%2Freact-native%401.2.24), [@elevenlabs/convai-widget-core@0.17.0](https://github.com/elevenlabs/packages/releases/tag/%40elevenlabs%2Fconvai-widget-core%400.17.0) i [@elevenlabs/convai-widget-embed@0.17.0](https://github.com/elevenlabs/packages/releases/tag/%40elevenlabs%2Fconvai-widget-embed%400.17.0) - Dodano rozbudowaną treść pierwszej wiadomości z odpowiedziami przycisków z atrybucją, `onExternalAgentDisconnected` i `onMCPToolApprovalRequest`. WebRTC używa teraz wybranego urządzenia wejściowego, zachowuje stan wyciszenia przy zmianie mikrofonu i przerywa konfigurację, jeśli nie można wysłać danych inicjujących. Widget dodaje status kolejki współbieżności, opcjonalny wybór języka na zwiniętym wyzwalaczu oraz renderowanie pierwszej wiadomości dla agentów obsługujących tekst i głos.
### API
## Nowe endpointy
### ElevenAgents
- Dodano dziewięć endpointów ticketów oceny rozmów:
- [Utwórz ticket rozmowy](/docs/pl/api-reference/triage-tickets/create-agent-conversation-ticket-route) - `POST /v1/convai/triage-tickets`. Żądanie wymaga `conversation_id` (string) i akceptuje `qa_comment` (nullable string, 1–10 000 znaków) oraz do 200 komentarzy do tur.
- [Lista ticketów](/docs/pl/api-reference/triage-tickets/list-agent-conversation-tickets-route) - `GET /v1/convai/agents/{agent_id}/triage-tickets`, z paginacją kursorową.
- [Utwórz ręczny ticket](/docs/pl/api-reference/triage-tickets/create-manual-agent-ticket-route) - `POST /v1/convai/agents/{agent_id}/triage-tickets`. Żądanie wymaga `qa_comment` (string, 1–10 000 znaków).
- [Lista użytkowników, którym można przypisać ticket](/docs/pl/api-reference/triage-tickets/get-assignable-users-route) - `GET /v1/convai/agents/{agent_id}/triage-tickets/assignable-users`. Odpowiedź zawiera członków obszaru roboczego, którzy nie są kontami usługowymi, oraz informację, czy każdy z nich ma dostęp do agenta.
- [Pobierz ticket](/docs/pl/api-reference/triage-tickets/get-agent-conversation-ticket-route) - `GET /v1/convai/triage-tickets/{agentqa_ticket_id}`.
- [Zaktualizuj ticket](/docs/pl/api-reference/triage-tickets/update-agent-conversation-ticket-route) - `PATCH /v1/convai/triage-tickets/{agentqa_ticket_id}`. Żądanie akceptuje opcjonalne `status` i nullable `assignee_user_id`.
- [Usuń ticket](/docs/pl/api-reference/triage-tickets/delete-agent-conversation-ticket-route) - `DELETE /v1/convai/triage-tickets/{agentqa_ticket_id}`.
- [Dodaj komentarz](/docs/pl/api-reference/triage-tickets/add-ticket-comment-route) - `POST /v1/convai/triage-tickets/{agentqa_ticket_id}/comments`. Żądanie wymaga `comment` (string, 1–10 000 znaków).
- [Dodaj komentarz do tury](/docs/pl/api-reference/triage-tickets/add-turn-comment-route) - `POST /v1/convai/triage-tickets/{agentqa_ticket_id}/turn-comments`. Żądanie wymaga indeksu `turn_index` od zera (integer) oraz `comment` (string, 1–10 000 znaków).
## Zaktualizowane endpointy
### ElevenAgents
- [Pobierz podpisany URL](/docs/pl/api-reference/conversations/get-signed-url) - `GET /v1/convai/conversation/get-signed-url`
- Dodano opcjonalne `debug_events_request` (boolean, domyślnie `false`). Zdarzenia debugowania wymagają dostępu edytora do agenta.
- [Pobierz token WebRTC](/docs/pl/api-reference/conversations/get-webrtc-token) - `GET /v1/convai/conversation/token`
- Dodano opcjonalne `debug_events_request` (boolean, domyślnie `false`). Starsza ścieżka `GET /v1/convai/conversation/get_signed_url` akceptuje ten sam parametr.
- [Lista rozmów](/docs/pl/api-reference/conversations/list) - `GET /v1/convai/conversations`
- Dodano opcjonalne `triggered_procedure_ids` (nullable string array, maksymalnie 50), aby dopasować rozmowy, w których uruchomiono dowolną wskazaną procedurę.
- Dodano opcjonalne `include_invalid_tool_calls` (boolean, domyślnie `false`), aby uwzględniać wywołania narzędzi, które się nie uruchomiły.
- Dodano opcjonalne `sort_direction` (`asc` lub `desc`, domyślnie `desc`) dla czasu rozpoczęcia połączenia.
- [Wyszukaj tekstowo wiadomości w rozmowach](/docs/pl/api-reference/conversations/messages/text-search) - `GET /v1/convai/conversations/messages/text-search`
- Dodano opcjonalne `triggered_procedure_ids` (nullable string array, maksymalnie 50).
- Dodano opcjonalne `include_invalid_tool_calls` (boolean, domyślnie `false`).
- [Pobierz tematy rozmów agenta](/docs/pl/api-reference/conversations/topics/get) - `GET /v1/convai/agents/{agent_id}/topics`
- Dodano opcjonalne `include_evaluation_criteria` (boolean, domyślnie `true`).
- Dodano `frustration` do `sort_by`.
- Odpowiedzi tematów zyskują nullable `success_rate` (number), a cała odpowiedź zyskuje `aggregated_run_count` (integer, domyślnie `0`).
- `from_unix_secs` jest zaokrąglane w dół do początku dnia UTC. Ograniczony zakres agreguje ukończone dzienne uruchomienia wykrywania; pominięcie obu granic zwraca najnowsze uruchomienie.
- [Lista procedur](/docs/pl/api-reference/agents/procedures/list) (`GET /v1/convai/agents/{agent_id}/branches/{branch_id}/procedures`) i [Pobierz procedurę](/docs/pl/api-reference/agents/procedures/get) (`GET /v1/convai/agents/{agent_id}/branches/{branch_id}/procedures/{procedure_id}`)
- Dodano opcjonalne nullable `agent_version_id` (string), aby pobierać procedury z konkretnej wersji agenta.
- [Utwórz test](/docs/pl/api-reference/tests/create) i [Zaktualizuj test](/docs/pl/api-reference/tests/update)
- Dodano opcjonalne nullable `environment` (string) do schematów testów jednostkowych odpowiedzi, symulacji i wywołań narzędzi. Wartość wybiera adresy URL, nagłówki i połączenia autoryzacji dla danego środowiska; domyślnie jest to `production`.
- [Utwórz dokument z URL](/docs/pl/api-reference/knowledge-base/create-from-url), [Utwórz zadanie crawlowania](/docs/pl/api-reference/knowledge-base/create-crawl-job) i [Utwórz folder](/docs/pl/api-reference/knowledge-base/create-folder)
- Dodano opcjonalne nullable `minimum_frequency_days` (integer, 1–180) dla automatycznej synchronizacji. Wartość domyślna to `7`, a częstotliwość bardziej restrykcyjnego folderu nadrzędnego ma pierwszeństwo.
### Music
- [Lista Music Finetunes](/docs/pl/api-reference/music/finetunes/list) - `GET /v1/music/finetunes`
- Zwiększono maksymalne `page_size` ze 100 do 150. Wartość domyślna nadal wynosi 50.
## Zmiany schematów
### ElevenAgents
- Żądania aktualizacji agenta zyskują opcjonalne nullable `procedures` (`object`). Każda wartość wymaga `procedure_id` i `version_id` (stringi). Pusty obiekt usuwa wszystkie procedury.
- Konfiguracja inicjowania rozmowy zyskuje `enable_procedure_ids_from_client` (boolean, domyślnie `false`). Dane inicjujące zyskują opcjonalne nullable `procedure_ids` (string array); pusta tablica wyłącza wszystkie procedury dla agenta rozpoczynającego rozmowę.
- `ClientEvent` zyskuje `context_usage`.
- Zastąpienia soft timeout zyskują opcjonalne nullable `additional_soft_timeout_messages` (string array).
- Stałe wartości w modelach analizy i zastępowania schematu akceptują teraz `null`.
- Domyślne wartości konfiguracji widgetu dla `mic_muting_enabled` i `transcript_enabled` zmieniły się z `false` na `true`. Ustaw je jawnie na `false`, aby zachować wcześniejsze działanie.
### Obszar roboczy
- Odpowiedzi [Pobierz użytkownika](/docs/pl/api-reference/user/get) usunęły `xi_api_key` z `UserResponseModel`.
- `ResourceMetadataResponseModel.role_to_group_ids` akceptuje teraz niestandardowe identyfikatory ról jako klucze zamiast ograniczać je do `admin`, `editor`, `commenter` i `viewer`.
- Odpowiedzi bezpośredniego publikowania zyskują opcjonalne nullable `restricted_to_user_email_domains` (string array).
- Odpowiedzi oczekującej zmiany subskrypcji dodają `go` do `next_tier`.