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

# चैट मोड

> **Info**
>
> चैट मोड आपके एजेंट्स को चैट एजेंट्स की तरह काम करने देता है, यानी ऑडियो इनपुट/आउटपुट के बिना सिर्फ़ टेक्स्ट वाली बातचीत करने देता है। यह चैट इंटरफ़ेस बनाने, एजेंट्स को टेस्ट करने या जब ऑडियो की ज़रूरत न हो, तब उपयोगी है।

## अवलोकन

चैट मोड सक्षम करने के दो मुख्य तरीके हैं:

1. **एजेंट कॉन्फ़िगरेशन**: API से एजेंट बनाते समय उसे सिर्फ़ टेक्स्ट मोड के लिए कॉन्फ़िगर करें
2. **रनटाइम ओवरराइड्स**: प्रोग्राम के ज़रिए सिर्फ़ टेक्स्ट वाली बातचीत लागू करने के लिए SDK ओवरराइड्स का उपयोग करें

यह गाइड दोनों तरीकों और अलग-अलग SDKs में चैट मोड लागू करने का तरीका बताती है।

## सिर्फ़ टेक्स्ट वाले एजेंट्स बनाना

हर बातचीत के लिए इसे डिफ़ॉल्ट बनाने हेतु एजेंट को सिर्फ़ टेक्स्ट मोड के लिए कॉन्फ़िगर करें।

#### डैशबोर्ड से अपडेट करें

डैशबोर्ड में अपना एजेंट खोलें, **Advanced** टैब पर जाएं और **Text only** टॉगल सक्षम करें। अपने बदलाव सेव करें।

#### CLI से अपडेट करें

#### एजेंट कॉन्फ़िगरेशन पुल करें

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

#### \`agent_configs/\<agent-name>.json\` संपादित करें

`conversation_config.conversation.text_only` सेट करें:

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

#### अपने बदलाव पुश करें

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

#### 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**
>
> पूरी API रेफरेंस और उपलब्ध सभी कॉन्फ़िगरेशन विकल्पों के लिए [Create Agent API दस्तावेज़ में text only फ़ील्ड देखें](/docs/hi/api-reference/agents/create#request.body.conversation_config.conversation.text_only)।

## सिर्फ़ टेक्स्ट मोड के लिए रनटाइम ओवरराइड्स

ओवरराइड्स का उपयोग करके रनटाइम पर चैट मोड सक्षम करने के लिए (एजेंट स्तर पर कॉन्फ़िगर करने के बजाय), आप अपने कन्वर्सेशन कॉन्फ़िगरेशन में `textOnly` ओवरराइड का उपयोग कर सकते हैं:

```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,
    },
  },
});
```

यह कॉन्फ़िगरेशन सुनिश्चित करता है कि:

* कोई ऑडियो इनपुट/आउटपुट इस्तेमाल नहीं होता
* सभी संवाद टेक्स्ट मैसेज के ज़रिए होते हैं
* बातचीत चैट-जैसे इंटरफ़ेस मोड में चलती है

## अहम बातें

> **Warning**
>
> **ज़रूरी**: चैट मोड इस्तेमाल करते समय, आपको यह सुनिश्चित करना होगा कि `agent_response` इवेंट/कॉलबैक
> सक्रिय और सही ढंग से कॉन्फ़िगर हो। इसके बिना, एजेंट के टेक्स्ट जवाब यूज़र को भेजे या दिखाए नहीं जाएंगे।

> **Info**
>
> **सुरक्षा ओवरराइड्स**: रनटाइम ओवरराइड्स का उपयोग करते समय (एजेंट-लेवल कॉन्फ़िगरेशन नहीं), आपको अपने
> एजेंट की सुरक्षा सेटिंग्स में कन्वर्सेशन ओवरराइड्स सक्षम करने होंगे। अपने एजेंट के **Security** टैब पर जाएं और उचित ओवरराइड्स सक्षम करें। अधिक जानकारी के लिए [Overrides दस्तावेज़](/docs/hi/eleven-agents/customization/personalization/overrides) देखें।

### मुख्य आवश्यकताएं

1. **एजेंट रिस्पॉन्स इवेंट**: एजेंट के टेक्स्ट मैसेज पाने और दिखाने के लिए हमेशा `agent_response` कॉलबैक या इवेंट हैंडलर कॉन्फ़िगर करें।

2. **एजेंट कॉन्फ़िगरेशन**: अगर आपका एजेंट एजेंट सेटिंग्स में खास तौर पर चैट मोड पर सेट है, तो वह ओवरराइड के बिना अपने-आप सिर्फ़ टेक्स्ट वाली बातचीत इस्तेमाल करेगा।

3. **कोई ऑडियो इंटरफ़ेस नहीं**: सिर्फ़ टेक्स्ट मोड का उपयोग करते समय, आपको ऑडियो इंटरफ़ेस कॉन्फ़िगर करने या माइक्रोफ़ोन की अनुमति मांगने की ज़रूरत नहीं है।

### उदाहरण: एजेंट रिस्पॉन्स संभालना

```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);
    }
  },
});
```

## टेक्स्ट मैसेज भेजना

चैट मोड में, आपको ऑडियो के बजाय प्रोग्राम के ज़रिए यूज़र मैसेज भेजने होंगे:

```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?",
});
```

## कॉन्करेंसी के फ़ायदे

चैट मोड वॉइस बातचीत की तुलना में कॉन्करेंसी के महत्वपूर्ण फ़ायदे देता है:

* **ज़्यादा सीमाएं**: सिर्फ़ चैट वाली बातचीत की कॉन्करेंसी सीमा वॉइस बातचीत से 25x ज़्यादा होती है
* **अलग पूल**: टेक्स्ट बातचीत, वॉइस बातचीत की सीमाओं से स्वतंत्र एक समर्पित कॉन्करेंसी पूल का उपयोग करती है
* **स्केलेबिलिटी**: कस्टमर सपोर्ट, चैटबॉट्स या ऑटोमेटेड टेस्टिंग जैसे हाई-थ्रूपुट ऐप्लिकेशंस के लिए बेहतरीन

| प्लान       | वॉइस कॉन्करेंसी | सिर्फ़ चैट कॉन्करेंसी |
| ----------- | --------------- | --------------------- |
| मुफ़्त      | 4               | 100                   |
| स्टार्टर    | 6               | 150                   |
| क्रिएटर     | 10              | 250                   |
| प्रो        | 20              | 500                   |
| स्केल       | 30              | 750                   |
| बिज़नेस     | 30              | 750                   |
| एंटरप्राइज़ | बढ़ी हुई        | बढ़ी हुई (25x)        |

> **Note**
>
> कनेक्शन शुरू होने के दौरान, हैंडशेक प्रक्रिया में सिर्फ़ चैट वाली बातचीत को पहले आपकी कुल कॉन्करेंसी सीमा के आधार पर जांचा जाता है, फिर कनेक्शन स्थापित होने पर अलग सिर्फ़ चैट कॉन्करेंसी पूल में भेज दिया जाता है।

## उपयोग के मामले

चैट मोड इनके लिए बेहतरीन है:

* **चैट इंटरफ़ेस**: वॉइस के बिना पारंपरिक चैट UIs बनाना
* **टेस्टिंग**: ऑडियो डिपेंडेंसी के बिना एजेंट लॉजिक टेस्ट करना
* **ऐक्सेसिबिलिटी**: यूज़र्स के लिए टेक्स्ट-आधारित विकल्प देना
* **शांत वातावरण**: जब ऑडियो इनपुट/आउटपुट उचित न हो
* **इंटीग्रेशन टेस्टिंग**: एजेंट बातचीत की ऑटोमेटेड टेस्टिंग

## समस्या निवारण

### एजेंट जवाब नहीं दे रहा

अगर एजेंट के जवाब नहीं दिख रहे हैं:

1. जांचें कि `agent_response` कॉलबैक सही ढंग से कॉन्फ़िगर है
2. जांचें कि एजेंट चैट मोड के लिए कॉन्फ़िगर है या `textOnly` ओवरराइड सेट है
3. सुनिश्चित करें कि WebSocket कनेक्शन सफलतापूर्वक स्थापित है

## अगले चरण

* [एजेंट व्यवहार कस्टमाइज़ करने](/docs/hi/eleven-agents/customization/llm) के बारे में जानें
* उन्नत इंटरैक्शन के लिए [क्लाइंट इवेंट्स](/docs/hi/eleven-agents/customization/events/client-events) देखें
* सुरक्षित बातचीत के लिए [ऑथेंटिकेशन सेटअप](/docs/hi/eleven-agents/customization/authentication) देखें