> 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.

# Tryb czatu

> **Info**
>
> Tryb czatu pozwala agentom działać jako agenci czatu, czyli prowadzić rozmowy wyłącznie tekstowe bez
> wejścia/wyjścia audio. Przydaje się do tworzenia interfejsów czatu, testowania agentów lub gdy audio
> nie jest potrzebne.

## Omówienie

Są dwa główne sposoby włączenia trybu czatu:

1. **Konfiguracja agenta**: Skonfiguruj agenta do trybu wyłącznie tekstowego podczas tworzenia go przez API
2. **Nadpisania w trakcie działania**: Użyj nadpisań SDK, aby programowo wymusić rozmowy wyłącznie tekstowe

Ten przewodnik omawia oba podejścia i wdrażanie trybu czatu w różnych SDK.

## Tworzenie agentów wyłącznie tekstowych

Skonfiguruj agenta do trybu wyłącznie tekstowego, aby był to domyślny tryb każdej rozmowy z tym agentem.

#### Aktualizacja w panelu

Otwórz agenta w panelu, przejdź do karty **Advanced** i włącz przełącznik **Text only**. Zapisz zmiany.

#### Aktualizacja przez CLI

#### Pobierz konfigurację agenta

```bash
elevenlabs agents pull --agent "<agent-name>"
```

#### Edytuj \`agent_configs/\<agent-name>.json\`

Ustaw `conversation_config.conversation.text_only`:

```json
{
  "conversation_config": {
    "conversation": {
      "text_only": true
    }
  }
}
```

#### Wyślij zmiany

```bash
elevenlabs agents push --agent "<agent-name>"
```

#### Aktualizacja przez API

```python
from elevenlabs import ElevenLabs

elevenlabs = ElevenLabs()

elevenlabs.conversational_ai.agents.update(
    agent_id="agent_7101k5zvyjhmfg983brhmhkd98n6",
    conversation_config={
        "conversation": {"text_only": True},
    },
)
```

```typescript
import { ElevenLabsClient } from "@elevenlabs/elevenlabs-js";

const elevenlabs = new ElevenLabsClient();

await elevenlabs.conversationalAi.agents.update("agent_7101k5zvyjhmfg983brhmhkd98n6", {
  conversationConfig: {
    conversation: { textOnly: true },
  },
});
```

> **Info**
>
> Pełną dokumentację API i wszystkie dostępne opcje konfiguracji znajdziesz w [polu text only w dokumentacji API Create Agent ](/docs/pl/api-reference/agents/create#request.body.conversation_config.conversation.text_only).

## Nadpisania w trakcie działania dla trybu wyłącznie tekstowego

Aby włączyć tryb czatu w trakcie działania za pomocą nadpisań (zamiast konfiguracji na poziomie agenta), możesz użyć nadpisania `textOnly` w konfiguracji rozmowy:

```python
from elevenlabs.client import ElevenLabs
from elevenlabs.conversational_ai.conversation import Conversation, ConversationInitiationData

# Configure for text-only mode with proper structure
conversation_override = {
    "conversation": {
        "text_only": True
    }
}

config = ConversationInitiationData(
    conversation_config_override=conversation_override
)

conversation = Conversation(
    elevenlabs,
    agent_id,
    requires_auth=bool(api_key),
    config=config,
    # Important: Ensure agent_response callback is set
    callback_agent_response=lambda response: print(f"Agent: {response}"),
    callback_user_transcript=lambda transcript: print(f"User: {transcript}"),
)

conversation.start_session()
```

```javascript
const conversation = await Conversation.startSession({
  agentId: "<your-agent-id>",
  overrides: {
    conversation: {
      textOnly: true,
    },
  },
});
```

Ta konfiguracja zapewnia, że:

* Nie jest używane wejście/wyjście audio
* Cała komunikacja odbywa się przez wiadomości tekstowe
* Rozmowa działa w trybie interfejsu podobnego do czatu

## Ważne uwagi

> **Warning**
>
> **Krytyczne**: Podczas korzystania z trybu czatu musisz dopilnować, aby zdarzenie/callback `agent_response` było
> aktywne i poprawnie skonfigurowane. Bez tego tekstowe odpowiedzi agenta nie zostaną wysłane ani
> wyświetlone użytkownikowi.

> **Info**
>
> **Nadpisania zabezpieczeń**: Gdy używasz nadpisań w trakcie działania (a nie konfiguracji na poziomie agenta), musisz
> włączyć nadpisania rozmowy w ustawieniach zabezpieczeń agenta. Przejdź do karty
> **Security** agenta i włącz odpowiednie nadpisania. Więcej informacji znajdziesz w [dokumentacji nadpisań ](/docs/pl/eleven-agents/customization/personalization/overrides).

### Kluczowe wymagania

1. **Zdarzenie odpowiedzi agenta**: Zawsze konfiguruj callback lub procedurę obsługi zdarzenia `agent_response`, aby odbierać i wyświetlać wiadomości tekstowe agenta.

2. **Konfiguracja agenta**: Jeśli agent jest ustawiony na tryb czatu w ustawieniach agenta, automatycznie użyje rozmów wyłącznie tekstowych bez nadpisania.

3. **Brak interfejsu audio**: W trybie wyłącznie tekstowym nie musisz konfigurować interfejsów audio ani prosić o uprawnienia do mikrofonu.

### Przykład: obsługa odpowiedzi agenta

```python
def handle_agent_response(response):
    """Critical handler for displaying agent messages"""
    print(f"Agent: {response}")  # Update your UI with the response
    update_chat_ui(response)

config = ConversationInitiationData(
    conversation_config_override={"conversation": {"text_only": True}}
)

conversation = Conversation(
  elevenlabs,
  agent_id,
  config=config,
  callback_agent_response=handle_agent_response,
)

conversation.start_session()
```

```javascript
const conversation = await Conversation.startSession({
  agentId: "<your-agent-id>",
  overrides: {
    conversation: {
      textOnly: true,
    },
  },
  // Critical: Handle agent responses
  onMessage: (message) => {
    if (message.type === "agent_response") {
      console.log("Agent:", message.text);
      // Display in your UI
      displayAgentMessage(message.text);
    }
  },
});
```

## Wysyłanie wiadomości tekstowych

W trybie czatu musisz wysyłać wiadomości użytkownika programowo zamiast przez audio:

```python
# Send a text message to the agent
conversation.send_user_message("Hello, how can you help me today?")
```

```javascript
// Send a text message to the agent
conversation.sendUserMessage({
  text: "Hello, how can you help me today?",
});
```

## Korzyści dla współbieżności

Tryb czatu zapewnia znaczną przewagę we współbieżności nad rozmowami głosowymi:

* **Wyższe limity**: Rozmowy wyłącznie tekstowe mają limity współbieżności 25 razy wyższe niż rozmowy głosowe
* **Osobna pula**: Rozmowy tekstowe korzystają z dedykowanej puli współbieżności, niezależnej od limitów rozmów głosowych
* **Skalowalność**: Idealne do aplikacji o dużej przepustowości, takich jak obsługa klienta, chatboty czy automatyczne testy

| Plan       | Współbieżność głosowa | Współbieżność tylko czatu |
| ---------- | --------------------- | ------------------------- |
| Free       | 4                     | 100                       |
| Starter    | 6                     | 150                       |
| Creator    | 10                    | 250                       |
| Pro        | 20                    | 500                       |
| Scale      | 30                    | 750                       |
| Business   | 30                    | 750                       |
| Enterprise | Podwyższona           | Podwyższona (25x)         |

> **Note**
>
> Podczas inicjowania połączenia rozmowy wyłącznie tekstowe są najpierw sprawdzane względem całkowitego
> limitu współbieżności w trakcie handshake, a po ustanowieniu połączenia są przenoszone do osobnej puli
> współbieżności tylko czatu.

## Zastosowania

Tryb czatu jest idealny do:

* **Interfejsów czatu**: Tworzenia tradycyjnych interfejsów czatu bez głosu
* **Testowania**: Testowania logiki agenta bez zależności od audio
* **Dostępności**: Zapewniania użytkownikom alternatyw tekstowych
* **Cichych środowisk**: Gdy wejście/wyjście audio nie jest odpowiednie
* **Testów integracyjnych**: Automatycznego testowania rozmów agentów

## Rozwiązywanie problemów

### Agent nie odpowiada

Jeśli odpowiedzi agenta się nie wyświetlają:

1. Sprawdź, czy callback `agent_response` jest poprawnie skonfigurowany
2. Sprawdź, czy agent jest skonfigurowany do trybu czatu lub ustawiono nadpisanie `textOnly`
3. Upewnij się, że połączenie WebSocket zostało pomyślnie ustanowione

## Następne kroki

* Dowiedz się więcej o [dostosowywaniu zachowania agenta](/docs/pl/eleven-agents/customization/llm)
* Poznaj [zdarzenia klienta](/docs/pl/eleven-agents/customization/events/client-events) dla zaawansowanych interakcji
* Zobacz [konfigurację uwierzytelniania](/docs/pl/eleven-agents/customization/authentication) dla bezpiecznych rozmów