> 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. # Modele Realtime ## Omówienie Model Realtime to model ElevenLabs stworzony do rozmów głosowych o niskich opóźnieniach, dostępny dla agentów głosowych. Każdy agent głosowy ma **tryb głosowy**: **Custom** lub **Realtime**. W trybie Custom samodzielnie wybierasz LLM, model TTS i ustawienia ASR, jak opisano w [Modelach](/docs/pl/eleven-agents/customization/llm). W trybie Realtime wybierasz model Realtime, a ElevenLabs zarządza tymi ustawieniami za ciebie. Dostępne są dwa modele Realtime: | Model | Wartość `realtime_model` | Opis | | --------------------------- | ------------------------- | ---------------------------------------------------------------------------------------------------------------- | | **Eleven Realtime v1 Mini** | `eleven_realtime_v1_mini` | Domyślny model Realtime. Najniższe opóźnienia i koszt. | | **Eleven Realtime v1 Max** | `eleven_realtime_v1_max` | Analizuje przed odpowiedzią, do złożonych instrukcji i wieloetapowego użycia narzędzi. Kosztuje więcej niż Mini. | Prompt systemowy agenta, głos, narzędzia, baza wiedzy i ustawienia tury działają tak samo w obu trybach. > **Tip** > > Korzystasz z innego API realtime, takiego jak SpaceXAI lub OpenAI? [Realtime API](/docs/pl/eleven-agents/guides/openai-realtime-compatibility) pozwala szybciej wypróbować > modele Realtime: skieruj istniejącego klienta do ElevenLabs i zachowaj używane już zdarzenia. > **Note** > > Modele Realtime są wdrażane stopniowo. Jeśli ustawienie **Tryb głosowy** nie pojawia się na karcie > **Agent** twojego agenta, modele Realtime nie są jeszcze dostępne w twoim obszarze roboczym, a API > odrzuca `realtime_model` z błędem `Realtime models are not available for this workspace.` ## Wybór trybu głosowego Pozostaw agenta w trybie Custom, jeśli zachodzi którykolwiek z poniższych warunków: * Agent używa [własnego LLM](/docs/pl/eleven-agents/customization/llm/custom-llm), Amazon Bedrock lub [Speech Engine](/docs/pl/eleven-api/guides/cookbooks/speech-engine). * Agent potrzebuje konkretnego LLM lub modelu TTS. * Węzły workflow zastępują LLM, model TTS lub inne [zarządzane ustawienie](#managed-settings). * Agent przekazuje rozmowę do agentów w trybie Custom lub od nich ją przejmuje. * Agent działa tylko tekstowo. Modele Realtime są stworzone do rozmów głosowych. W przeciwnym razie zacznij od Eleven Realtime v1 Mini. Zamiast niego wybierz Eleven Realtime v1 Max, gdy: * Agent wykonuje długie lub złożone instrukcje albo opiera się na wieloetapowych wywołaniach narzędzi, a odpowiedzi Mini nie są wystarczająco dobre. * Agent musi spełniać wymagania [Zero Retention Mode](/docs/pl/eleven-agents/customization/privacy/zrm) lub [HIPAA](/docs/pl/eleven-agents/legal/hipaa) w USA lub UE. Mini nie jest dostępny w żadnym z tych przypadków. Max nie jest dostępny w środowiskach rezydencji danych w Indiach i Singapurze oraz wymaga limitu tokenów co najmniej 1 024 albo braku limitu. Zobacz [Ograniczenia](#limitations) i [Zgodność i rezydencję danych](#compliance-and-data-residency). ## Konfiguracja #### Aktualizacja w panelu #### Otwórz kartę Agent Otwórz agenta w panelu i przejdź do karty **Agent**. #### Ustaw tryb głosowy Ustaw **Tryb głosowy** na **Realtime**. Agent przełączy się na Eleven Realtime v1 Mini. #### Wybierz model Aby zamiast tego użyć Eleven Realtime v1 Max, wybierz go z listy **Model**. #### Opublikuj Opublikuj zmiany. Publikacja nie powiedzie się, jeśli agent narusza jedną z zasad w [Ograniczeniach](#limitations). Aby wyłączyć Realtime, ustaw **Tryb głosowy** na **Custom** i opublikuj. Agent wróci do zapisanych w nim ustawień LLM, modelu TTS i ASR. #### Aktualizacja przez CLI #### Pobierz konfigurację agenta ```bash elevenlabs agents pull --agent "" ``` #### Edytuj \`agent_configs/\.json\` Ustaw `conversation_config.realtime_model`: ```json { "conversation_config": { "realtime_model": "eleven_realtime_v1_mini" } } ``` Aby wyłączyć Realtime, ustaw `realtime_model` na `null`. #### Wyślij zmiany ```bash elevenlabs agents push --agent "" ``` #### Aktualizacja przez API ```python from elevenlabs import ElevenLabs elevenlabs = ElevenLabs() elevenlabs.conversational_ai.agents.update( agent_id="agent_7101k5zvyjhmfg983brhmhkd98n6", conversation_config={ "realtime_model": "eleven_realtime_v1_mini", }, ) ``` ```typescript import { ElevenLabsClient } from "@elevenlabs/elevenlabs-js"; const elevenlabs = new ElevenLabsClient(); await elevenlabs.conversationalAi.agents.update("agent_7101k5zvyjhmfg983brhmhkd98n6", { conversationConfig: { realtimeModel: "eleven_realtime_v1_mini", }, }); ``` Aby wyłączyć Realtime, ustaw `realtime_model` na `None` w Pythonie lub `realtimeModel` na `null` w TypeScript. ## Zarządzane ustawienia Gdy ustawiony jest model Realtime, ElevenLabs zarządza poniższymi ustawieniami, a agent ignoruje zapisane dla nich wartości. Zapisane wartości zaczną znów obowiązywać po przełączeniu na Custom. | Ustawienie | Pole w `conversation_config` | | ----------------------------- | ----------------------------------------- | | LLM | `agent.prompt.llm` | | Poziom analizy | `agent.prompt.reasoning_effort` | | Budżet analizowania | `agent.prompt.thinking_budget` | | Równoległe wywołania narzędzi | `agent.prompt.enable_parallel_tool_calls` | | Limit czasu kaskady | `agent.prompt.cascade_timeout_seconds` | | Model TTS | `tts.model_id` | | Tryb ekspresyjny | `tts.expressive_mode` | | Dostawca ASR | `asr.provider` | Limit tokenów (`agent.prompt.max_tokens`) zachowuje zapisaną wartość, ale węzły workflow nie mogą go zastępować, a Eleven Realtime v1 Max wymaga wartości minimalnej. Zobacz [Ograniczenia](#limitations). Aby zmienić któreś z tych ustawień, przełącz agenta na Custom. ## Ustawienia, które nadal obowiązują Wszystkie pozostałe ustawienia agenta działają tak jak w trybie Custom, w tym: * prompt systemowy i pierwsza wiadomość * głos, w tym [obsługa wielu głosów](/docs/pl/eleven-agents/customization/voice/multi-voice-support) * [języki](/docs/pl/eleven-agents/customization/voice/customization/language) * temperatura * [narzędzia](/docs/pl/eleven-agents/customization/tools) i [baza wiedzy](/docs/pl/eleven-agents/customization/knowledge-base) * ustawienia [przebiegu rozmowy](/docs/pl/eleven-agents/customization/conversation-flow), takie jak chęć przejęcia tury, limity czasu i przerwania Panel ukrywa ustawienia LLM, w tym temperaturę, gdy agent jest w trybie Realtime. Aby zmienić temperaturę agenta Realtime, użyj CLI lub API. Jeśli model Realtime nie odpowie na czas lub zwróci błąd, agent przejdzie na zapasowe LLM zgodnie z opisem w [kaskadzie LLM](/docs/pl/eleven-agents/customization/llm/llm-cascading). Model Realtime określa, jak długo agent czeka przed przejściem na model zapasowy. ## Ograniczenia ElevenLabs sprawdza te zasady podczas publikowania agenta. Wersja robocza, która narusza jedną z nich, nadal się zapisze, ale publikacja zakończy się błędem wskazującym ustawienie do zmiany. * **Tylko agenci ElevenAgents**: Agenci utworzeni w innych produktach ElevenLabs, takich jak [Speech Engine](/docs/pl/eleven-api/guides/cookbooks/speech-engine), nie mogą używać modelu Realtime. * **Bez własnego LLM**: Tryb Realtime nie jest dostępny, gdy LLM agenta to własny LLM lub Amazon Bedrock. Przed przełączeniem wybierz wbudowany LLM w trybie Custom. * **Brak zastępowania zarządzanych ustawień przez workflow**: Węzeł workflow nie może zastępować żadnego [zarządzanego ustawienia](#managed-settings) ani limitu tokenów. Usuń zastąpienie lub pozostaw agenta w trybie Custom. * **Limit tokenów dla Max**: Eleven Realtime v1 Max wymaga limitu tokenów 1 024 lub więcej albo braku limitu. * **Przekazywanie między trybami**: Agent w trybie Realtime może [przekazywać rozmowę](/docs/pl/eleven-agents/customization/tools/system-tools/agent-transfer) tylko do innych agentów w trybie Realtime i od nich ją przejmować. Przekazywanie między agentami Mini i Max jest obsługiwane. > **Warning** > > Publikacja sprawdza tylko przekazania wykonywane przez publikowanego agenta. Przekazanie do agenta > Realtime z agenta w trybie Custom zostanie wykryte dopiero przy następnej publikacji agenta w trybie Custom; > do tego czasu przekazanie jest odrzucane podczas rozmowy, a bieżący agent pozostaje na połączeniu. Błędy przekazywania mają treść `Transfers between default and Realtime model modes are not supported.`, gdzie „default” oznacza tryb Custom. ## Zgodność i rezydencja danych Modele Realtime podlegają tym samym zasadom [Zero Retention Mode](/docs/pl/eleven-agents/customization/privacy/zrm), [HIPAA](/docs/pl/eleven-agents/legal/hipaa) i [rezydencji danych](/docs/pl/overview/administration/data-residency) co inne modele. Dostępność różni się między Mini i Max: | Środowisko | Eleven Realtime v1 Mini | Eleven Realtime v1 Max | | ------------------------------ | ----------------------- | ---------------------- | | USA | Dostępny | Dostępny | | Rezydencja danych w UE | Dostępny | Dostępny | | Rezydencja danych w Indiach | Dostępny | Niedostępny | | Rezydencja danych w Singapurze | Dostępny | Niedostępny | | Zero Retention Mode i HIPAA | Niedostępny | Dostępny w USA i UE | Zero Retention Mode obowiązuje niezależnie od tego, czy jest wymuszony w obszarze roboczym, czy włączony dla agenta. Jeśli model Realtime nie jest dostępny przy ustawieniach zgodności lub rezydencji danych agenta, ElevenLabs odrzuci go z błędem wskazującym model. Wybierz drugi model Realtime lub przełącz się na Custom. ## Cennik Agent Realtime jest rozliczany według standardowej stawki ElevenAgents za minutę, plus tokeny wejściowe, buforowane tokeny wejściowe i tokeny wyjściowe według stawek modelu Realtime. Eleven Realtime v1 Max kosztuje więcej za token niż Eleven Realtime v1 Mini. Aktualne stawki znajdziesz w [cenniku ElevenLabs](https://elevenlabs.io/pricing). ## Powiązane materiały * [Modele](/docs/pl/eleven-agents/customization/llm) * [Kaskada LLM](/docs/pl/eleven-agents/customization/llm/llm-cascading) * [Przekazywanie rozmów przez agenta](/docs/pl/eleven-agents/customization/tools/system-tools/agent-transfer) * [Zero Retention Mode](/docs/pl/eleven-agents/customization/privacy/zrm) * [Zgodność z HIPAA](/docs/pl/eleven-agents/legal/hipaa)