- مفتاح ترخيص EchoAuth AI Agent. اشترِ واحدًا من المتجر إذا لم يكن لديك بعد.
- خادم Discord يمكنك إضافة بوتات إليه وإدارة الأدوار فيه.
- مفتاح API من OpenRouter. مفتاح OpenRouter واحد يغطي كل ما يحتاجه الوكيل: الإجابات ولقطات الشاشة والبحث.
- اختياريًا، موقع توثيق أو بعض التوثيق المكتوب ليجيب منه الوكيل.
1. أنشئ حسابك
افتح صفحة التسجيل
أدخل مفتاح الترخيص
ECHO-XXXX-XXXX-XXXX-XXXX.اختر اسم مستخدم وكلمة مرور

صفحة التسجيل

لوحة التحكم بعد تسجيل الدخول

صفحة الوكيل
2. أنشئ بوت Discord الخاص بك
يجيب وكيلك عبر بوت Discord يخصك. أنشئ واحدًا في Discord Developer Portal.أنشئ تطبيقًا
فعّل Message Content intent
انسخ رمز البوت
ادعُ البوت إلى خادمك
bot وapplications.commands ثم صلاحيات البوت هذه:- View Channels
- Send Messages
- Read Message History
- Embed Links
- Attach Files
أعط البوت صلاحية الوصول إلى فئة التذاكر
3. أضف مفاتيحك
أنشئ مفتاح API من openrouter.ai/keys وأضف بعض الرصيد إلى حساب OpenRouter الخاص بك. نموذج الرؤية مجاني، لكن نموذجي المحادثة والتضمين يُدفع مقابلهما حسب الاستخدام. ثم، في صفحة وكيلك، انقر على Configure وافتح تبويب API Keys.
تبويب API Keys، مع مفتاح OpenRouter ورمز بوت Discord مُعدَّين
- الصق مفتاحك في OpenRouter API Key.
- الصق Discord Bot Token.
- انقر على Save.
4. اختر نماذج الذكاء الاصطناعي
افتح تبويب AI Settings. يستخدم الوكيل ثلاثة نماذج. اضبط الثلاثة على OpenRouter واختر النماذج الموصى بها:
تبويب AI Settings مع نماذج OpenRouter الموصى بها
qwen/qwen3-embedding-8b. لا يزال البحث يعمل: فهو يفحص كل مقطع بدلًا من استخدام فهرس، ويبقى سريعًا مع قاعدة معرفة من بضعة آلاف مقاطع.5. اربطه بتذاكرك
افتح تبويب Discord. تخبر هذه الإعدادات الوكيل أين يجيب ومن يُعدّ من الفريق.
تبويب Discord
Owner Role IDs
Owner Role IDs
/pause_bot و/edit_base. افصل بين المعرّفات المتعددة بفواصل.Staff Role IDs
Staff Role IDs
/restart هناك.Ticket Category IDs
Ticket Category IDs
Ticket Bot IDs
Ticket Bot IDs
Image Models
Image Models
nvidia/nemotron-3-nano-omni-30b-a3b-reasoning:freegoogle/gemma-4-31b-it:freegoogle/gemma-4-26b-a4b-it:freethinkingmachines/inkling-small:freedots-studio/dots-3-note-preview:free6. أعط الوكيل توثيقك
افتح تبويب Knowledge Base. يجيب الوكيل من مصدرين، ويمكنك استخدام أحدهما أو كليهما.
تبويب Knowledge Base
- Docs site
- Internal knowledge base
- أدخل Docs URL الخاص بك، مثل
https://docs.acme-store.com، بدون شرطة مائلة في النهاية. يجب أن يقدّم الموقع/llms.txt، وهو ما يفعله Mintlify تلقائيًا. - انقر على Save، ثم انتقل إلى صفحة وكيلك وانقر على Update Agent.
- بالعودة إلى هذا التبويب، انقر على Index documentation. تستغرق بضع مئات من الصفحات بضع دقائق، ويمكنك مغادرة الصفحة أثناء ذلك.
7. اضبط توقيت الرد والتصعيد
افتح تبويب Behavior.
تبويب Behavior
refund أو chargeback أو real person.
8. فعّل التنبيهات (اختياري)
افتح تبويب Notifications والصق معرّف قناة خاصة بالفريق. ينشر الوكيل هناك عندما يقترب ترخيصك من الانتهاء وعندما يرفض مزود الذكاء الاصطناعي مفتاحك أو تنفد الحصة.
تبويب Notifications
9. ابدأ الوكيل
عُد إلى صفحة وكيلك وانقر على Update Agent. يُعيد هذا نشر الوكيل برمز البوت ورابط التوثيق ونموذج التضمين الخاصين بك. تظهر المخرجات تحت الزر أثناء التشغيل.- افتح تذكرة اختبار في خادمك واطرح سؤالًا يجيب عنه توثيقك.
- افتح Live logs في صفحة وكيلك وراقب الوكيل وهو يستلم الرسالة ويبحث في توثيقك ويرد.

Live logs
أوامر الشرطة المائلة
بمجرد أن يكون الوكيل في خادمك، يمكن للمالكين والفريق التحكم فيه من Discord.أبقِ ترخيصك نشطًا
يبقى وكيلك متصلًا ما دام ترخيصك نشطًا. تعرض صفحة License الأيام المتبقية وتاريخ الانتهاء.
صفحة License
استكشاف الأخطاء وإصلاحها
البوت متصل لكنه لا يرد أبدًا
البوت متصل لكنه لا يرد أبدًا
- تحقق من أن Message Content Intent مفعّل في Discord Developer Portal.
- تحقق من أن معرّف فئة التذكرة موجود في Ticket Category IDs.
- تحقق من أن البوت يستطيع رؤية تلك الفئة وإرسال الرسائل فيها.
- تحقق من أن أحد أفراد الفريق لم يكتب بالفعل في التذكرة. اذكر البوت أو استخدم
/restartلإعادته. - تحقق من أن Global Bot Pause مطفأ.
يتجاهل البوت رسالة فتح التذكرة
يتجاهل البوت رسالة فتح التذكرة
الوكيل لا يستخدم توثيقي
الوكيل لا يستخدم توثيقي
تفشل الردود أو الفهرسة مع خطأ من OpenRouter
تفشل الردود أو الفهرسة مع خطأ من OpenRouter
توقف الوكيل عن الاستجابة
توقف الوكيل عن الاستجابة