الانتقال إلى المحتوى الرئيسي
يستغرق الإعداد نحو 15 دقيقة. تحتاج إلى أربعة أشياء:
  • مفتاح ترخيص EchoAuth AI Agent. اشترِ واحدًا من المتجر إذا لم يكن لديك بعد.
  • خادم Discord يمكنك إضافة بوتات إليه وإدارة الأدوار فيه.
  • مفتاح API من OpenRouter. مفتاح OpenRouter واحد يغطي كل ما يحتاجه الوكيل: الإجابات ولقطات الشاشة والبحث.
  • اختياريًا، موقع توثيق أو بعض التوثيق المكتوب ليجيب منه الوكيل.
نحن نستضيف وكيلك ونبقيه يعمل. تقوم بإعداده من لوحة التحكم على agent.echoauth.dev.
الإعداد الموصى به. جرى الاختبار طويل الأمد باستخدام OpenRouter فقط، مع هذه النماذج الثلاثة:مزودون آخرون (NVIDIA وOpenAI وAnthropic) متاحون في لوحة التحكم، لكن هذا هو المزيج الذي اختبرناه مع مرور الوقت.

1. أنشئ حسابك

1

افتح صفحة التسجيل

انتقل إلى agent.echoauth.dev/register.
2

أدخل مفتاح الترخيص

الصق المفتاح من بريد الشراء. يبدو مثل ECHO-XXXX-XXXX-XXXX-XXXX.
3

اختر اسم مستخدم وكلمة مرور

يجب أن تكون كلمة المرور 8 أحرف على الأقل. انقر على Create account.
نموذج التسجيل مع حقول مفتاح الترخيص واسم المستخدم وكلمة المرور

صفحة التسجيل

بمجرد تفعيل ترخيصك، يُنشأ وكيلك لك. تصل إلى لوحة التحكم حيث ترى الوكيل وترخيصك وإحصاءات الاستخدام.
لوحة التحكم تعرض وكيلًا واحدًا وحالة الترخيص والاستخدام

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

إذا ظهرت عبارة No agents yet، فافتح License في الشريط الجانبي وتحقق من أن ترخيصك نشط.
انقر على وكيلك لفتح صفحته. كل ما عدا ذلك في هذا الدليل يبدأ من هنا: يفتح Configure الإعدادات، ويعرض Live logs ما يفعله الوكيل، ويطبّق Update Agent الإعدادات التي تتطلب إعادة نشر.
صفحة الوكيل مع Configure وLive logs وRestart وUpdate Agent

صفحة الوكيل

2. أنشئ بوت Discord الخاص بك

يجيب وكيلك عبر بوت Discord يخصك. أنشئ واحدًا في Discord Developer Portal.
1

أنشئ تطبيقًا

افتح Discord Developer Portal وانقر على New Application. سمّه باسم وكيل الدعم لديك، مثل “Acme Support”.
2

فعّل Message Content intent

انتقل إلى Bot. ضمن Privileged Gateway Intents، فعّل Message Content Intent واحفظ.
بدون هذا الـ intent، يتلقى البوت رسائل فارغة ولا يرد أبدًا.
3

انسخ رمز البوت

وأنت ما زلت في Bot، انقر على Reset Token وانسخ الرمز. ستلصقه في لوحة التحكم في القسم التالي. ابقه سريًا: كل من لديه الرمز يمكنه التحكم في بوتك.
4

ادعُ البوت إلى خادمك

انتقل إلى OAuth2 → URL Generator. حدّد النطاقين bot وapplications.commands ثم صلاحيات البوت هذه:
  • View Channels
  • Send Messages
  • Read Message History
  • Embed Links
  • Attach Files
افتح الرابط الناتج وأضف البوت إلى خادمك.
5

أعط البوت صلاحية الوصول إلى فئة التذاكر

تأكد من أن دور البوت يستطيع رؤية الفئة التي تُنشأ فيها قنوات تذاكرك. إذا لم يستطع رؤية القناة، فلن يستطيع الرد.

3. أضف مفاتيحك

أنشئ مفتاح API من openrouter.ai/keys وأضف بعض الرصيد إلى حساب OpenRouter الخاص بك. نموذج الرؤية مجاني، لكن نموذجي المحادثة والتضمين يُدفع مقابلهما حسب الاستخدام. ثم، في صفحة وكيلك، انقر على Configure وافتح تبويب API Keys.
تبويب API Keys يعرض مفتاح OpenRouter API ورمز بوت Discord معلّمين كـ configured

تبويب API Keys، مع مفتاح OpenRouter ورمز بوت Discord مُعدَّين

  1. الصق مفتاحك في OpenRouter API Key.
  2. الصق Discord Bot Token.
  3. انقر على Save.
يمكنك ترك حقول OpenAI وAnthropic وNVIDIA فارغة. تُخزَّن المفاتيح مشفّرة ولا تُعرض مرة أخرى بعد الحفظ. تؤكد شارة configured أن المفتاح مُعَدّ.

4. اختر نماذج الذكاء الاصطناعي

افتح تبويب AI Settings. يستخدم الوكيل ثلاثة نماذج. اضبط الثلاثة على OpenRouter واختر النماذج الموصى بها:
تبويب AI Settings مع اختيار OpenRouter لنماذج المحادثة والرؤية والتضمين

تبويب AI Settings مع نماذج OpenRouter الموصى بها

تحت نموذج التضمين، تحذر لوحة التحكم من أنه يتجاوز 2000 بُعد. هذا متوقع مع qwen/qwen3-embedding-8b. لا يزال البحث يعمل: فهو يفحص كل مقطع بدلًا من استخدام فهرس، ويبقى سريعًا مع قاعدة معرفة من بضعة آلاف مقاطع.
ثم اكتب Base Prompt. وهو التعليمات الدائمة للوكيل: لمن يعمل وما النبرة التي يستخدمها وما الذي لا يجب أن يفعله أبدًا. مثلًا:
اختر نموذج التضمين قبل أن تفهرس أي شيء. تغييره لاحقًا يجعل الفهرس الحالي غير صالح للاستخدام حتى تعيد بناءه.

5. اربطه بتذاكرك

افتح تبويب Discord. تخبر هذه الإعدادات الوكيل أين يجيب ومن يُعدّ من الفريق.
تبويب Discord مع أدوار المالك وأدوار الفريق ومعرّفات فئات التذاكر ومعرّفات بوتات التذاكر ونماذج الصور

تبويب Discord

لنسخ المعرّفات، فعّل Developer Mode في Discord من User Settings → Advanced. ثم انقر بزر الماوس الأيمن على دور أو فئة أو مستخدم واختر Copy ID.
الأدوار التي يمكنها استخدام كل أوامر الشرطة المائلة، بما في ذلك /pause_bot و/edit_base. افصل بين المعرّفات المتعددة بفواصل.
أدوار فريق الدعم لديك. عندما يكتب أحد أفراد الفريق في تذكرة، يتراجع الوكيل ويبقى صامتًا في تلك التذكرة. لإعادته، اذكر البوت في التذكرة أو استخدم /restart هناك.
الفئات التي تُنشأ فيها قنوات تذاكرك. يجيب الوكيل فقط داخل هذه الفئات.
معرّف مستخدم بوت التذاكر لديك، مثل Ticket Tool أو SellAuth Tickets. يتجاهل الوكيل البوتات الأخرى، لذا أضف بوتك هنا ليتمكن الوكيل من قراءة رسالة فتح التذكرة.
نماذج رؤية احتياطية، واحد في كل سطر، تُجرَّب بالترتيب إذا فشل نموذج الرؤية من AI Settings. ضع هذه البدائل:
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. يجيب الوكيل من مصدرين، ويمكنك استخدام أحدهما أو كليهما.
تبويب Knowledge Base مع زر Index documentation وDocs URL وقاعدة المعرفة الداخلية

تبويب Knowledge Base

استخدم هذا إذا كان توثيقك منشورًا على 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، يفحص الوكيل توثيقك كل ساعة ويعيد فهرسة الصفحات التي تغيّرت فقط.
أبقِ Documentation Retrieval وAgentic Retrieval مفعّلين. مع تفعيل الاسترجاع، يبحث الوكيل فقط عن المقاطع ذات الصلة بكل سؤال بدلًا من قراءة كل شيء في كل مرة.

7. اضبط توقيت الرد والتصعيد

افتح تبويب Behavior.
تبويب Behavior مع توقيت الرد وكلمات طلب المساعدة البشرية

تبويب Behavior

ينتظر الوكيل حتى يتوقف العميل عن الكتابة، ثم يجيب على كل شيء في رد واحد. كل رسالة جديدة تعيد تشغيل المؤقت. تحت Human Help Keywords، اسرد الكلمات التي يجب أن تُحيل التذكرة إلى فريقك، كلمة في كل سطر. مثل refund أو chargeback أو real person.

8. فعّل التنبيهات (اختياري)

افتح تبويب Notifications والصق معرّف قناة خاصة بالفريق. ينشر الوكيل هناك عندما يقترب ترخيصك من الانتهاء وعندما يرفض مزود الذكاء الاصطناعي مفتاحك أو تنفد الحصة.
تبويب Notifications مع معرّف قناة الإشعارات

تبويب Notifications

9. ابدأ الوكيل

عُد إلى صفحة وكيلك وانقر على Update Agent. يُعيد هذا نشر الوكيل برمز البوت ورابط التوثيق ونموذج التضمين الخاصين بك. تظهر المخرجات تحت الزر أثناء التشغيل.
تصل معظم الإعدادات إلى الوكيل العامل خلال نحو دقيقة، دون إعادة نشر. تحتاج إلى Update Agent فقط بعد تغيير Discord Bot Token أو Docs URL أو Embedding Model أو Sync Mode.
للتحقق من أن كل شيء يعمل:
  1. افتح تذكرة اختبار في خادمك واطرح سؤالًا يجيب عنه توثيقك.
  2. افتح Live logs في صفحة وكيلك وراقب الوكيل وهو يستلم الرسالة ويبحث في توثيقك ويرد.
Live logs تعرض بدء الوكيل ومزامنته وبحثه في التوثيق ورده في تذكرة

Live logs

تظهر شارة حالة وكيلك Online عندما يكون قيد التشغيل.

أوامر الشرطة المائلة

بمجرد أن يكون الوكيل في خادمك، يمكن للمالكين والفريق التحكم فيه من Discord. يمكنك أيضًا إيقاف الوكيل مؤقتًا من لوحة التحكم باستخدام Global Bot Pause في تبويب Discord.

أبقِ ترخيصك نشطًا

يبقى وكيلك متصلًا ما دام ترخيصك نشطًا. تعرض صفحة License الأيام المتبقية وتاريخ الانتهاء.
صفحة الترخيص مع الحالة والأيام المتبقية والخطط المتاحة

صفحة License

للتجديد، اشترِ مفتاحًا جديدًا من المتجر وانقر على Renew license والصق المفتاح. يُضاف الوقت إلى ترخيصك الحالي.

استكشاف الأخطاء وإصلاحها

  • تحقق من أن Message Content Intent مفعّل في Discord Developer Portal.
  • تحقق من أن معرّف فئة التذكرة موجود في Ticket Category IDs.
  • تحقق من أن البوت يستطيع رؤية تلك الفئة وإرسال الرسائل فيها.
  • تحقق من أن أحد أفراد الفريق لم يكتب بالفعل في التذكرة. اذكر البوت أو استخدم /restart لإعادته.
  • تحقق من أن Global Bot Pause مطفأ.
أضف معرّف مستخدم بوت التذاكر الخاص بك إلى Ticket Bot IDs في تبويب Discord.
افتح تبويب Knowledge Base. إذا كتب Documentation is not indexed yet، فانقر على Index documentation. وإذا كتب The index does not match the embedding model، فانقر على Clear and rebuild the index، أو أعد ضبط نموذج التضمين إلى النموذج المعروض واحفظ.
تحقق من أن حساب OpenRouter لديه رصيد وأن المفتاح في تبويب API Keys لا يزال صالحًا. قد تخضع النماذج المجانية مثل نموذج الرؤية لحد من معدل الطلبات في أوقات الزحام؛ عندئذ ينتقل الوكيل إلى النموذج التالي في Image Models.
افتح Live logs وابحث عن أخطاء، مثل مفتاح غير صالح أو رصيد نفد. ثم انقر على Restart في صفحة الوكيل. إذا لم ينفع ذلك، فانقر على Update Agent.