> 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. ### ElevenAgents - **Kolejkowanie połączeń i dźwięk oczekiwania**: Dodaliśmy [kolejkowanie połączeń](/docs/pl/eleven-agents/guides/call-queueing) dla agentów, którzy osiągnęli limit równoczesnych połączeń. Osoby w kolejce słyszą dźwięk oczekiwania i otrzymują zdarzenia `queue_status`, dopóki nie zostaną przyjęte lub nie minie limit czasu. Nowe metody API pozwalają przesyłać lub usuwać własny dźwięk oczekiwania. - **Metadane wersji testowej**: Wyniki testów agenta wskazują teraz wersję agenta, na której je uruchomiono, oraz to, czy obejmowały zmiany w wersji roboczej. Podsumowania wywołań pokazują też, kiedy częściowe ponowne przesłania uruchomiono na innych wersjach. - **Metadane modelu i konta**: Konfiguracja LLM agenta obsługuje teraz `gemini-3.8-flash`. Odpowiedzi kont WhatsApp wskazują, czy konto korzysta z Cloud API, czy z procesu rejestracji współistniejącej. ### Muzyka - **Obsługa API Music v2.5**: Endpointy Music i SDK obsługują teraz `music_v2_5`. Fragmenty generowania planu kompozycji obsługują do 6132 znaków, maksymalnie 30 wierszy po 200 znaków. ### Wydania SDK #### JavaScript SDK - [v2.68.0](https://github.com/elevenlabs/elevenlabs-js/releases/tag/v2.68.0) - Dodano metody przesyłania i usuwania dźwięku oczekiwania agenta. Wygenerowano ponownie typy dla kolejkowania połączeń, odwołań do procedur, tworzenia gałęzi wersji roboczej, limitów zapytań RAG, metadanych wersji testowej, `gemini-3.8-flash` i `music_v2_5`. #### Python SDK - [v2.68.0](https://github.com/elevenlabs/elevenlabs-python/releases/tag/v2.68.0) - Dodano synchroniczne i asynchroniczne metody przesyłania oraz usuwania dźwięku oczekiwania agenta. Wygenerowano ponownie typy dla kolejkowania połączeń, procedur, tworzenia gałęzi wersji roboczej, limitów zapytań RAG, metadanych wersji testowej, `gemini-3.8-flash` i `music_v2_5`. Wrapper `compose_detailed` obsługuje teraz każdy wygenerowany identyfikator modelu muzycznego oraz plany kompozycji oparte na promptach i fragmentach. #### iOS SDK - [v3.3.1](https://github.com/elevenlabs/elevenlabs-swift-sdk/releases/tag/v3.3.1) - Uzgadnia wiadomości agenta według `response_id` zamiast `event_id`, zachowując wiele odpowiedzi wokół wywołań narzędzi i zapobiegając przypinaniu przesyłanych części lub poprawek do niewłaściwej wiadomości. #### ElevenLabs CLI - [v1.3.0](https://github.com/elevenlabs/cli/releases/tag/v1.3.0) - Dodano opcjonalne metadane `--intent` do generowanych poleceń API. Dodano `elevenlabs feedback missing-capability` do zgłaszania workflow, których CLI nie obsługuje. #### Pakiety - [@elevenlabs/convai-widget-core@0.18.2](https://github.com/elevenlabs/packages/releases/tag/%40elevenlabs%2Fconvai-widget-core%400.18.2) i [@elevenlabs/convai-widget-embed@0.18.2](https://github.com/elevenlabs/packages/releases/tag/%40elevenlabs%2Fconvai-widget-embed%400.18.2) - Naprawiono zduplikowane odpowiedzi agenta po wywołaniach narzędzi i procedur. Przesyłane odpowiedzi tekstowe zachowują formatowanie Markdown, a rozmowy głosowe nie renderują już niewypowiedzianych przesyłanych części czatu. Pakiet embed ogranicza też zdarzenia `user_activity` do jednego na sekundę i usuwa limit po zakończeniu sesji. ### API ## Nowe endpointy ### ElevenAgents - [Prześlij dźwięk oczekiwania agenta](/docs/pl/api-reference/agents/hold-audio/create) - `POST /v1/convai/agents/{agent_id}/hold-audio` - Przyjmuje wymagany `hold_audio_file` (binarny) jako dane formularza multipart. Plik musi być w formacie MP3 lub WAV, mieć maksymalnie 40 MB i 180 sekund. - Zwraca wymagane `agent_id` (string) i `hold_audio` (`AgentHoldAudioConfig`). Obiekt dźwięku oczekiwania wymaga `audio_path`, `audio_url`, `original_filename` (string), `duration_secs` (number) i `size_bytes` (integer). - [Usuń dźwięk oczekiwania agenta](/docs/pl/api-reference/agents/hold-audio/delete) - `DELETE /v1/convai/agents/{agent_id}/hold-audio` - Usuwa własny klip, aby osoby w kolejce słyszały domyślny ton oczekiwania. - Zwraca wymagane `agent_id` (string). ## Zaktualizowane endpointy ### ElevenAgents - [Utwórz agenta](/docs/pl/api-reference/agents/create), [Pobierz agenta](/docs/pl/api-reference/agents/get) i [Zaktualizuj agenta](/docs/pl/api-reference/agents/update) - Dodano opcjonalne `platform_settings.queueing_config` (`AgentQueueingConfig`) z `enabled` (boolean, domyślnie `false`) i `wait_timeout_seconds` (integer, 1–1800, domyślnie `180`). - Odpowiedzi konfiguracji kolejki zawierają tylko do odczytu nullable `hold_audio` (`AgentHoldAudioConfig`). Odpowiedzi agenta zawierają też opcjonalne `default_hold_audio_url` (string). - [Pobierz rozmowę](/docs/pl/api-reference/conversations/get) - `GET /v1/convai/conversations/{conversation_id}` - Metadane dodają opcjonalne nullable `queue_wait_secs` (number). Czas w kolejce nie jest uwzględniany w `call_duration_secs` ani rozliczanym czasie. - [Utwórz gałąź agenta](/docs/pl/api-reference/agents/branches/create) - `POST /v1/convai/agents/{agent_id}/branches` - Dodano opcjonalne `include_draft` (boolean, domyślnie `false`). Gdy ma wartość `true`, gałąź utworzona z końca gałęzi obejmuje zestaw procedur z wersji roboczej wywołującego. - [Wyświetl procedury](/docs/pl/api-reference/agents/procedures/list) oraz endpointy tworzenia, pobierania i wersji roboczej procedur - Elementy listy dodają opcjonalne `referenced_tool_ids`, `referenced_kb_ids`, `referenced_procedure_ids` i `referenced_dynamic_variables` (tablice stringów). - Odpowiedzi agenta i podglądu scalania dodają opcjonalne `procedures`, mapę z kluczem będącym identyfikatorem procedury. - [Wyświetl wywołania testowe](/docs/pl/api-reference/tests/test-invocations/list) - `GET /v1/convai/test-invocations` - Dodano opcjonalne nullable `search` (string) do filtrowania testów i folderów według nazwy. - [Uruchom testy agenta](/docs/pl/api-reference/tests/run-tests) i [Pobierz wywołanie testowe](/docs/pl/api-reference/tests/test-invocations/get) - Odpowiedzi wywołania zestawu testów i uruchomienia testu jednostkowego dodają opcjonalne nullable `version_id` (string) oraz opcjonalne `ran_against_draft` (boolean, domyślnie `false`). - Podsumowania wywołań dodają też opcjonalne `runs_diverged_from_version` (boolean, domyślnie `false`). - `POST /v1/convai/agents/{agent_id}/knowledge-base/rag-query` - Treść żądania dodaje opcjonalne nullable nadpisania specyficzne dla zapytania: `max_documents_length` (integer, 1–50 000) i `max_retrieved_rag_chunks_count` (integer, 1–20). - [Pobierz konto WhatsApp](/docs/pl/api-reference/whats-app/accounts/get) - `GET /v1/convai/whatsapp-accounts/{phone_number_id}` - Dodano opcjonalne `account_type` (`WhatsAppAccountType`, domyślnie `cloud_api`). Wartości to `cloud_api` i `coexistence`. - [Oblicz oczekiwane użycie LLM](/docs/pl/api-reference/agents/calculate) - `POST /v1/convai/agent/{agent_id}/llm-usage/calculate` - `LLMUsageCalculatorLLMResponseModel` dodaje wymagane `price_per_message` (number). ### Muzyka - `MusicModelID` dodaje `music_v2_5` dla `POST /v1/music/video-to-music`, `POST /v1/music/plan`, [Twórz muzykę](/docs/pl/api-reference/music/compose), `POST /v1/music/detailed`, `POST /v1/music/detailed/stream`, `POST /v1/music/stream`, `POST /v1/music/upload` i `POST /v1/music/finetunes`. - `GenerationChunk.text` zwiększa `maxLength` z 6000 do 6132 znaków dla `POST /v1/music/plan`, `POST /v1/music`, `POST /v1/music/detailed`, `POST /v1/music/detailed/stream`, `POST /v1/music/stream` i `POST /v1/music/upload`. Nazwy sekcji mogą zawierać 1–100 znaków, a fragmenty do 30 wierszy po 200 znaków. ## Zmiany w schemacie ### ElevenAgents - Zdarzenia serwera w czasie rzeczywistym dodają `queue_status`. Wymagane `queue_status_event.status` przyjmuje `waiting`, `admitted` lub `timed_out`; `timed_out` poprzedza kod zamknięcia WebSocket `4300`. Dźwięk oczekiwania nadal jest dostarczany jako zwykłe zdarzenia `audio`. - Enum `LLM` dodaje `gemini-3.8-flash`, w tym nadpisania inicjowania rozmowy. - Unie wyników narzędzi systemowych rozmowy dodają `start_procedure_success`, `start_procedure_error`, `end_procedure_success` i `end_procedure_error`. - `FeaturesUsageCommonModel` dodaje opcjonalne statusy funkcji `freeform_procedure` i `structured_procedure`.