> ## Documentation Index
> Fetch the complete documentation index at: https://docs.echoauth.dev/llms.txt
> Use this file to discover all available pages before exploring further.

# AI एजेंट सेटअप गाइड

> लाइसेंस कुंजी से लेकर ऐसे AI एजेंट तक, जो आपके Discord टिकटों का जवाब देता है।

सेटअप में लगभग 15 मिनट लगते हैं। आपको चार चीज़ें चाहिए:

* एक EchoAuth AI Agent **लाइसेंस कुंजी**। अगर आपके पास अभी नहीं है, तो [शॉप से खरीदें](https://shop.echoauth.dev/product/echos-ai-agent-hosted)।
* एक **Discord सर्वर**, जहाँ आप बॉट जोड़ सकें और रोल मैनेज कर सकें।
* एक **[OpenRouter](https://openrouter.ai) API कुंजी**। एजेंट को जो कुछ चाहिए (जवाब, स्क्रीनशॉट और सर्च), वह सब एक OpenRouter कुंजी से चल जाता है।
* वैकल्पिक रूप से, एक **डॉक्स साइट** या लिखित दस्तावेज़, जिससे एजेंट जवाब दे सके।

हम आपका एजेंट होस्ट करते हैं और उसे चालू रखते हैं। आप इसे [agent.echoauth.dev](https://agent.echoauth.dev) के डैशबोर्ड से सेट अप करते हैं।

> [!NOTE]
>
> **सुझाया गया सेटअप।** लंबे समय तक टेस्टिंग सिर्फ़ OpenRouter के साथ की गई, इन तीन मॉडलों पर:
>
> | भूमिका | मॉडल |
> | - | - |
> | Chat / Agent | `deepseek/deepseek-v4-flash-0731` |
> | Embedding | `qwen/qwen3-embedding-8b` |
> | Vision (इमेज पहचान) | `nvidia/nemotron-3-nano-omni-30b-a3b-reasoning:free` |
>
> डैशबोर्ड में अन्य प्रोवाइडर (NVIDIA, OpenAI, Anthropic) भी उपलब्ध हैं, लेकिन यही वह संयोजन है जिसे हमने लंबे समय तक आज़माया है।

## 1. अपना अकाउंट बनाएँ

**1. रजिस्ट्रेशन पेज खोलें**

[agent.echoauth.dev/register](https://agent.echoauth.dev/register) पर जाएँ।

**2. अपनी लाइसेंस कुंजी डालें**

अपनी खरीद के ईमेल से कुंजी पेस्ट करें। यह `ECHO-XXXX-XXXX-XXXX-XXXX` जैसी दिखती है।

**3. यूज़रनेम और पासवर्ड चुनें**

आपके पासवर्ड में कम से कम 8 अक्षर होने चाहिए। **Create account** पर क्लिक करें।

![लाइसेंस कुंजी, यूज़रनेम और पासवर्ड फ़ील्ड वाला रजिस्ट्रेशन फ़ॉर्म](https://mintcdn.com/echoauth/cLGTi81QYaoRs3IW/images/ai-agent-setup/01-register.png?fit=max\&auto=format\&n=cLGTi81QYaoRs3IW\&q=85\&s=572419f600e4182cf06122e903cf3aa6)

रजिस्ट्रेशन पेज

लाइसेंस सक्रिय होते ही आपका एजेंट आपके लिए बन जाता है। आप डैशबोर्ड पर पहुँचते हैं, जहाँ आपको एजेंट, आपका लाइसेंस और उपयोग के आँकड़े दिखते हैं।

![एक एजेंट, लाइसेंस की स्थिति और उपयोग दिखाने वाला डैशबोर्ड](https://mintcdn.com/echoauth/cLGTi81QYaoRs3IW/images/ai-agent-setup/02-dashboard.png?fit=max\&auto=format\&n=cLGTi81QYaoRs3IW\&q=85\&s=2397a77fc1428106e09dcbc3b2869dab)

साइन इन करने के बाद का डैशबोर्ड

> [!NOTE]
>
> अगर **No agents yet** दिख रहा है, तो साइडबार में **License** खोलें और जाँचें कि आपका लाइसेंस सक्रिय है।

अपना एजेंट खोलने के लिए उस पर क्लिक करें। इस गाइड की बाकी सारी चीज़ें यहीं से शुरू होती हैं: **Configure** सेटिंग्स खोलता है, **Live logs** दिखाता है कि एजेंट क्या कर रहा है, और **Update Agent** उन सेटिंग्स को लागू करता है जिन्हें दोबारा डिप्लॉय करना पड़ता है।

![Configure, Live logs, Restart और Update Agent वाला एजेंट पेज](https://mintcdn.com/echoauth/cLGTi81QYaoRs3IW/images/ai-agent-setup/03-agent.png?fit=max\&auto=format\&n=cLGTi81QYaoRs3IW\&q=85\&s=6c4ca792bd16efd8e9e175519f337123)

एजेंट पेज

## 2. अपना Discord बॉट बनाएँ

आपका एजेंट एक ऐसे Discord बॉट के ज़रिए जवाब देता है जो आपका अपना है। इसे Discord Developer Portal में बनाएँ।

**1. एप्लिकेशन बनाएँ**

[Discord Developer Portal](https://discord.com/developers/applications) खोलें और **New Application** पर क्लिक करें। इसे अपने सपोर्ट एजेंट का नाम दें, जैसे "Acme Support"।

**2. Message Content intent चालू करें**

**Bot** पर जाएँ। **Privileged Gateway Intents** के नीचे **Message Content Intent** चालू करें और सेव करें।

> [!WARNING]
>
> इस intent के बिना बॉट को खाली संदेश मिलते हैं और वह कभी जवाब नहीं देता।

**3. बॉट टोकन कॉपी करें**

उसी **Bot** पेज पर **Reset Token** पर क्लिक करें और टोकन कॉपी करें। इसे अगले भाग में डैशबोर्ड में पेस्ट करना है। इसे निजी रखें: टोकन वाला कोई भी व्यक्ति आपके बॉट को कंट्रोल कर सकता है।

**4. बॉट को अपने सर्वर में आमंत्रित करें**

**OAuth2** → **URL Generator** पर जाएँ। `bot` और `applications.commands` स्कोप चुनें, फिर ये बॉट अनुमतियाँ चुनें:

* View Channels
* Send Messages
* Read Message History
* Embed Links
* Attach Files

बने हुए URL को खोलकर बॉट को अपने सर्वर में जोड़ें।

**5. बॉट को अपनी टिकट कैटेगरी का एक्सेस दें**

सुनिश्चित करें कि बॉट का रोल उस कैटेगरी को देख सकता है जिसमें आपके टिकट चैनल बनते हैं। अगर वह चैनल नहीं देख सकता, तो जवाब भी नहीं दे सकता।

## 3. अपनी कुंजियाँ जोड़ें

[openrouter.ai/keys](https://openrouter.ai/keys) पर एक API कुंजी बनाएँ और अपने OpenRouter अकाउंट में कुछ क्रेडिट जोड़ें। Vision मॉडल मुफ़्त है, लेकिन chat और embedding मॉडल का भुगतान उपयोग के हिसाब से होता है।

फिर अपने एजेंट पेज पर **Configure** पर क्लिक करें और **API Keys** टैब खोलें।

![OpenRouter API कुंजी और Discord बॉट टोकन को configured दिखाने वाला API Keys टैब](https://mintcdn.com/echoauth/cLGTi81QYaoRs3IW/images/ai-agent-setup/04-keys.png?fit=max\&auto=format\&n=cLGTi81QYaoRs3IW\&q=85\&s=635dd8eb112950e6f74cfdc24c4f5664)

API Keys टैब, जिसमें OpenRouter कुंजी और Discord बॉट टोकन सेट हैं

1. **OpenRouter API Key** में अपनी कुंजी पेस्ट करें।
2. अपना **Discord Bot Token** पेस्ट करें।
3. **Save** पर क्लिक करें।

OpenAI, Anthropic और NVIDIA फ़ील्ड आप खाली छोड़ सकते हैं। कुंजियाँ एन्क्रिप्टेड रूप में सहेजी जाती हैं और सेव करने के बाद दोबारा नहीं दिखाई जातीं। **configured** बैज पुष्टि करता है कि कुंजी सेट है।

## 4. अपने AI मॉडल चुनें

**AI Settings** टैब खोलें। एजेंट तीन मॉडल इस्तेमाल करता है। तीनों को **OpenRouter** पर सेट करें और सुझाए गए मॉडल चुनें:

| सेटिंग | यह क्या करता है | प्रोवाइडर | मॉडल |
| - | - | - | - |
| **Chat / Agent Model** | जवाब लिखता है और तय करता है कि आपके डॉक्स में क्या खोजना है। | OpenRouter | `deepseek/deepseek-v4-flash-0731` |
| **Vision Model** | ग्राहकों द्वारा टिकट में लगाए गए स्क्रीनशॉट पढ़ता है। | OpenRouter | `nvidia/nemotron-3-nano-omni-30b-a3b-reasoning:free` |
| **Embedding Model** | आपके दस्तावेज़ों को इंडेक्स करता है और उनमें खोज करता है। | OpenRouter | `qwen/qwen3-embedding-8b` |

![chat, vision और embedding मॉडल के लिए OpenRouter चुना हुआ AI Settings टैब](https://mintcdn.com/echoauth/cLGTi81QYaoRs3IW/images/ai-agent-setup/05-ai.png?fit=max\&auto=format\&n=cLGTi81QYaoRs3IW\&q=85\&s=9c43f2bab0d0ade4e7a897f04f0a21f0)

सुझाए गए OpenRouter मॉडलों के साथ AI Settings टैब

> [!NOTE]
>
> Embedding मॉडल के नीचे डैशबोर्ड चेतावनी देता है कि यह 2000 डायमेंशन से ऊपर है। `qwen/qwen3-embedding-8b` के लिए यह अपेक्षित है। खोज फिर भी काम करती है: वह इंडेक्स इस्तेमाल करने के बजाय हर पैसेज को जाँचती है, जो कुछ हज़ार पैसेज वाले नॉलेज बेस के लिए तेज़ रहता है।

फिर अपना **Base Prompt** लिखें। यह एजेंट के स्थायी निर्देश हैं: वह किसके लिए काम करता है, किस लहजे में बोलना है, और क्या कभी नहीं करना है। उदाहरण के लिए:

```text theme={null}
You are the support agent for Acme Store. Be friendly and concise.
Answer only from the documentation. If you are not sure, ask a staff member to step in.
```

> [!WARNING]
>
> कुछ भी इंडेक्स करने से पहले अपना embedding मॉडल चुन लें। बाद में उसे बदलने पर मौजूदा इंडेक्स तब तक बेकार हो जाता है जब तक आप उसे दोबारा न बनाएँ।

## 5. इसे अपने टिकटों से जोड़ें

**Discord** टैब खोलें। ये सेटिंग्स एजेंट को बताती हैं कि कहाँ जवाब देना है और स्टाफ़ कौन है।

![ओनर रोल, स्टाफ़ रोल, टिकट कैटेगरी ID, टिकट बॉट ID और इमेज मॉडल वाला Discord टैब](https://mintcdn.com/echoauth/cLGTi81QYaoRs3IW/images/ai-agent-setup/06-discord.png?fit=max\&auto=format\&n=cLGTi81QYaoRs3IW\&q=85\&s=43f9146b21aa094f8d7629f409930f57)

Discord टैब

ID कॉपी करने के लिए Discord में **User Settings** → **Advanced** के अंदर **Developer Mode** चालू करें। फिर किसी रोल, कैटेगरी या यूज़र पर राइट-क्लिक करके **Copy ID** चुनें।

> [accordion] Owner Role IDs
>
> वे रोल जो हर स्लैश कमांड इस्तेमाल कर सकते हैं, जिनमें `/pause_bot` और `/edit_base` भी शामिल हैं। कई ID को कॉमा से अलग करें।

> [accordion] Staff Role IDs
>
> आपकी सपोर्ट टीम के रोल। जब कोई स्टाफ़ सदस्य किसी टिकट में लिखता है, तो एजेंट पीछे हट जाता है और उस टिकट में चुप रहता है। उसे वापस लाने के लिए टिकट में बॉट को मेंशन करें या वहाँ `/restart` इस्तेमाल करें।

> [accordion] Ticket Category IDs
>
> वे कैटेगरी जिनमें आपके टिकट चैनल बनते हैं। एजेंट सिर्फ़ इन्हीं कैटेगरी के अंदर जवाब देता है।

> [accordion] Ticket Bot IDs
>
> आपके टिकट बॉट का यूज़र ID, जैसे Ticket Tool या SellAuth Tickets। एजेंट बाकी बॉट को अनदेखा करता है, इसलिए अपना बॉट यहाँ जोड़ें ताकि एजेंट टिकट का पहला संदेश पढ़ सके।

> [accordion] Image Models
>
> बैकअप vision मॉडल, हर पंक्ति में एक, जिन्हें AI Settings वाला vision मॉडल फ़ेल होने पर क्रम से आज़माया जाता है। ये फ़ॉलबैक डालें:\
> `nvidia/nemotron-3-nano-omni-30b-a3b-reasoning:free`\
> `google/gemma-4-31b-it:free`\
> `google/gemma-4-26b-a4b-it:free`\
> `thinkingmachines/inkling-small:free`\
> `dots-studio/dots-3-note-preview:free`

**Save** पर क्लिक करें।

## 6. एजेंट को अपना दस्तावेज़ दें

**Knowledge Base** टैब खोलें। एजेंट दो स्रोतों से जवाब देता है, और आप इनमें से एक या दोनों इस्तेमाल कर सकते हैं।

![Index documentation बटन, Docs URL और इंटरनल नॉलेज बेस वाला Knowledge Base टैब](https://mintcdn.com/echoauth/cLGTi81QYaoRs3IW/images/ai-agent-setup/07-knowledge.png?fit=max\&auto=format\&n=cLGTi81QYaoRs3IW\&q=85\&s=18150d070975d8635a2a87c251b04dfa)

Knowledge Base टैब

> [tab] Docs site
>
> इसे तब इस्तेमाल करें जब आपका दस्तावेज़ Mintlify पर प्रकाशित हो।
>
> 1. अपना **Docs URL** डालें, जैसे `https://docs.acme-store.com`, अंत में स्लैश के बिना। साइट को `/llms.txt` देना चाहिए, जो Mintlify अपने-आप करता है।
> 2. **Save** पर क्लिक करें, फिर अपने एजेंट पेज पर जाकर **Update Agent** पर क्लिक करें।
> 3. इस टैब पर लौटकर **Index documentation** पर क्लिक करें। कुछ सौ पेज में कुछ मिनट लगते हैं, और इस दौरान आप पेज छोड़ सकते हैं।
>
> **Sync Mode** को **Poll llms.txt hourly** पर रखने से एजेंट हर घंटे आपके डॉक्स जाँचता है और सिर्फ़ बदले हुए पेज दोबारा इंडेक्स करता है।

> [tab] Internal knowledge base
>
> इसे उन चीज़ों के लिए इस्तेमाल करें जो किसी डॉक्स साइट पर नहीं हैं: FAQ, नीतियाँ, एरर कोड।
>
> 1. **Internal Knowledge Base** तक स्क्रोल करें।
> 2. अपना टेक्स्ट पेस्ट करें, या **Load file** पर क्लिक करके `.txt` या `.md` फ़ाइल चुनें।
> 3. **Save** पर क्लिक करें।
>
> एजेंट इसे लगभग एक मिनट में इंडेक्स कर लेता है। सादा टेक्स्ट ठीक है: ALL CAPS में या `=====` की पंक्तियों के बीच लिखे शीर्षक खोजने योग्य सेक्शन बन जाते हैं।

**Documentation Retrieval** और **Agentic Retrieval** चालू रखें। रिट्रीवल चालू होने पर एजेंट हर बार सब कुछ पढ़ने के बजाय हर सवाल के लिए सिर्फ़ प्रासंगिक पैसेज खोजता है।

## 7. जवाब का समय और एस्केलेशन सेट करें

**Behavior** टैब खोलें।

![जवाब के समय और human help कीवर्ड वाला Behavior टैब](https://mintcdn.com/echoauth/cLGTi81QYaoRs3IW/images/ai-agent-setup/08-behavior.png?fit=max\&auto=format\&n=cLGTi81QYaoRs3IW\&q=85\&s=14df915b4ac0f9860f6e3a6b3a61d318)

Behavior टैब

एजेंट तब तक इंतज़ार करता है जब तक ग्राहक टाइप करना बंद न कर दे, फिर सबका जवाब एक ही संदेश में देता है। हर नया संदेश टाइमर को फिर से शुरू कर देता है।

| सेटिंग | डिफ़ॉल्ट | मतलब |
| - | - | - |
| After ticket opens | 45 s | पहले संदेश के बाद इंतज़ार, क्योंकि ग्राहक अक्सर विवरण या स्क्रीनशॉट जोड़ते हैं। |
| After each message | 30 s | बाद के संदेशों के बाद जवाब देने से पहले ज़रूरी शांत समय। |
| Maximum wait | 180 s | ग्राहक टाइप करता रहे तब भी इतने समय बाद जवाब दे दिया जाता है। |

**Human Help Keywords** में वे शब्द लिखें जिन पर टिकट आपकी टीम को सौंप दिया जाए, हर पंक्ति में एक। उदाहरण के लिए `refund`, `chargeback` या `real person`।

## 8. अलर्ट पाएँ (वैकल्पिक)

**Notifications** टैब खोलें और किसी निजी स्टाफ़ चैनल का ID पेस्ट करें। एजेंट वहाँ तब पोस्ट करता है जब आपका लाइसेंस समाप्त होने वाला हो और जब कोई AI प्रोवाइडर आपकी कुंजी अस्वीकार कर दे या कोटा खत्म हो जाए।

![नोटिफ़िकेशन चैनल ID वाला Notifications टैब](https://mintcdn.com/echoauth/cLGTi81QYaoRs3IW/images/ai-agent-setup/09-notifications.png?fit=max\&auto=format\&n=cLGTi81QYaoRs3IW\&q=85\&s=5906f4bf0dbdf4fa308c4958553bded2)

Notifications टैब

## 9. एजेंट शुरू करें

अपने एजेंट पेज पर लौटें और **Update Agent** पर क्लिक करें। यह एजेंट को आपके बॉट टोकन, डॉक्स URL और embedding मॉडल के साथ दोबारा डिप्लॉय करता है। चलते समय आउटपुट बटन के नीचे दिखता है।

> [!NOTE]
>
> ज़्यादातर सेटिंग्स बिना रीडिप्लॉय के लगभग एक मिनट में चल रहे एजेंट तक पहुँच जाती हैं। **Update Agent** की ज़रूरत सिर्फ़ **Discord Bot Token**, **Docs URL**, **Embedding Model** या **Sync Mode** बदलने के बाद पड़ती है।

यह जाँचने के लिए कि सब कुछ काम करता है:

1. अपने सर्वर में एक टेस्ट टिकट खोलें और ऐसा सवाल पूछें जिसका जवाब आपके डॉक्स में है।
2. अपने एजेंट पेज पर **Live logs** खोलें और देखें कि एजेंट संदेश पाता है, आपके डॉक्स खोजता है और जवाब देता है।

![एजेंट का शुरू होना, सिंक करना, डॉक्स खोजना और टिकट में जवाब देना दिखाने वाले Live logs](https://mintcdn.com/echoauth/cLGTi81QYaoRs3IW/images/ai-agent-setup/11-logs.png?fit=max\&auto=format\&n=cLGTi81QYaoRs3IW\&q=85\&s=18d1bd77e85407858cd81751cd36388e)

Live logs

जब एजेंट चल रहा होता है, तो उसका स्टेटस बैज **Online** दिखाता है।

## स्लैश कमांड

एजेंट के आपके सर्वर में आ जाने के बाद, ओनर और स्टाफ़ उसे Discord से कंट्रोल कर सकते हैं।

| कमांड | कौन | यह क्या करता है |
| - | - | - |
| `/stop` | Owner, staff | एजेंट को इस चैनल में जवाब देने से रोकें। |
| `/restart` | Owner, staff | एजेंट को इस चैनल में फिर से जवाब देने दें। |
| `/mute_existing` | Owner, staff | एजेंट को हर पहले से खुले टिकट में रोक दें। |
| `/pause_bot` | Owner | एजेंट को हर जगह रोक दें। |
| `/resume_bot` | Owner | एजेंट को हर जगह फिर से चालू करें। |
| `/edit_base` | Owner | बेस प्रॉम्प्ट एडिट करें। |
| `/chat_model` | Owner | chat मॉडल बदलें। |

आप डैशबोर्ड से भी **Discord** टैब के **Global Bot Pause** से एजेंट को रोक सकते हैं।

## अपना लाइसेंस सक्रिय रखें

आपका एजेंट तब तक ऑनलाइन रहता है जब तक आपका लाइसेंस सक्रिय है। **License** पेज बचे हुए दिन और आपकी समाप्ति तिथि दिखाता है।

![स्टेटस, बचे हुए दिन और उपलब्ध प्लान वाला License पेज](https://mintcdn.com/echoauth/cLGTi81QYaoRs3IW/images/ai-agent-setup/10-license.png?fit=max\&auto=format\&n=cLGTi81QYaoRs3IW\&q=85\&s=62db270604520c9a0c2815db6201b908)

License पेज

रिन्यू करने के लिए [शॉप](https://shop.echoauth.dev/product/echos-ai-agent-hosted) से नई कुंजी खरीदें, **Renew license** पर क्लिक करें और कुंजी पेस्ट करें। समय आपके मौजूदा लाइसेंस में जुड़ जाता है।

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

> [accordion] बॉट ऑनलाइन है लेकिन कभी जवाब नहीं देता
>
> * जाँचें कि Discord Developer Portal में **Message Content Intent** चालू है।
> * जाँचें कि टिकट की कैटेगरी ID **Ticket Category IDs** में है।
> * जाँचें कि बॉट उस कैटेगरी में संदेश देख और भेज सकता है।
> * जाँचें कि किसी स्टाफ़ सदस्य ने पहले से टिकट में न लिखा हो। बॉट को मेंशन करें या `/restart` इस्तेमाल करें।
> * जाँचें कि **Global Bot Pause** बंद है।

> [accordion] बॉट टिकट के पहले संदेश को अनदेखा करता है
>
> **Discord** टैब पर **Ticket Bot IDs** में अपने टिकट बॉट का यूज़र ID जोड़ें।

> [accordion] एजेंट मेरे दस्तावेज़ का इस्तेमाल नहीं कर रहा
>
> **Knowledge Base** टैब खोलें। अगर वहाँ **Documentation is not indexed yet** लिखा है, तो **Index documentation** पर क्लिक करें। अगर **The index does not match the embedding model** लिखा है, तो **Clear and rebuild the index** पर क्लिक करें, या embedding मॉडल को वापस वही सेट करके सेव करें जो दिखाया गया है।

> [accordion] जवाब या इंडेक्सिंग OpenRouter एरर के साथ फ़ेल होती है
>
> जाँचें कि आपके OpenRouter अकाउंट में क्रेडिट है और **API Keys** टैब वाली कुंजी अब भी वैध है। Vision मॉडल जैसे मुफ़्त मॉडल व्यस्त समय में रेट-लिमिट हो सकते हैं। तब एजेंट **Image Models** के अगले मॉडल पर चला जाता है।

> [accordion] एजेंट ने जवाब देना बंद कर दिया
>
> **Live logs** खोलें और एरर खोजें, जैसे अमान्य कुंजी या खत्म हो चुका क्रेडिट। फिर एजेंट पेज पर **Restart** पर क्लिक करें। अगर इससे मदद न मिले, तो **Update Agent** पर क्लिक करें।


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.