Discord
أضف تفاعل /ask الموقَّع إلى تطبيق Discord وخادمه.
أضف تفاعل /ask الموقَّع إلى تطبيق Discord وخادمه.
إنشاء تطبيق Discord#
اتبع الدليلين الرسميين من Discord: البدء السريع للتطبيقات ونظرة عامة على التفاعلات. أنشئ تطبيقًا في بوابة المطورين في Discord (Discord Developer Portal) واجمع القيم التالية:
| حقل Make Agent Fast | موقعه في Discord | الغرض |
|---|---|---|
| Application ID | General Information | يحدد التطبيق والأمر |
| Public Key | General Information | يتحقق من تفاعلات موقَّعة بخوارزمية Ed25519؛ يتكوّن من 64 خانة سداسية عشرية بالضبط |
| Bot token | صفحة Bot | يتحقق من التطبيق ويسجّل الأمر /ask؛ احتفظ به سرًا |
تؤدي إعادة تعيين رمز البوت إلى إبطال الرمز السابق فورًا. المفتاح العام (Public Key) ليس سريًا، لكن يجب أن يعود إلى التطبيق نفسه الذي ينتمي إليه رمز البوت.
الربط وتسجيل /ask#
افتح صفحة القنوات الخاصة بالـ agent، واختر Discord، وأدخل القيم الثلاث، ثم اضغط اتصال.
يتحقق Make Agent Fast من رمز البوت عبر نقطة نهاية التطبيق في Discord، ويرفض أي Public Key لا يطابق التطبيق. كما يصحّح تلقائيًا أي Application ID أُدخل بشكل خاطئ إلى المعرّف الحقيقي للتطبيق الذي جرت مصادقته، ثم ينشئ الأمر العام /ask question أو يحدّثه دون حذف أي أوامر أخرى للتطبيق.
بعد الحفظ، انسخ Interactions Endpoint URL المعروض إلى الحقل General Information → Interactions Endpoint URL في Discord ثم احفظ. يرسل Discord طلب PING موقَّعًا؛ يتحقق Make Agent Fast من التوقيع ويعيد الاستجابة المطلوبة PONG.
التثبيت والاختبار#
استخدم إعدادات التثبيت في Discord لتفويض التطبيق في خادم تجريبي مع الأذونات اللازمة لأوامر التطبيق. قد يستغرق انتشار الأوامر العامة بعض الوقت.
شغّل /ask، واملأ الخيار المطلوب question، ثم أرسل. يؤكد Make Agent Fast استلام التفاعل قبل انتهاء المهلة القصيرة في Discord، ثم يشغّل الـ agent، ثم يعدّل الرد الأصلي المؤجَّل. يُحفظ سجل المحادثة لكل مستخدم في Discord على حدة، بحيث تحتفظ طلبات /ask اللاحقة بالسياق.
الموصّل الحالي نصي فقط. فهو لا يقرأ القنوات الصوتية أو المرفقات أو رسائل القنوات العادية أو الرسائل المباشرة؛ ولا يصل إلى الـ agent سوى تفاعل /ask المسجَّل.
التدوير أو قطع الاتصال#
إذا تعرّض رمز البوت للكشف، فأعد تعيينه في Discord، ثم حدّث الموصّل، وتحقق من /ask مرة أخرى. وإذا تغيّر التطبيق نفسه، فحدّث القيم الثلاث وInteractions Endpoint URL الخاص بذلك التطبيق.
لا يؤدي تعطيل الموصّل أو إزالته إلى حذف تطبيق Discord أو الأمر العام. أزل التطبيق من الخوادم، واحذف بيانات اعتماد المزوّد غير المستخدمة بشكل منفصل عند إيقافه نهائيًا.
استكشاف الأخطاء وإصلاحها#
| العَرَض | الحل |
|---|---|
| يرفض الموصّل الحقول | استخدم رمز البوت والـ Public Key المكوَّن من 64 خانة من التطبيق نفسه |
| يرفض Discord نقطة النهاية | تأكد من أنها عامة وتعمل عبر HTTPS، والصق نقطة النهاية التي جرى إنشاؤها، وأعد حفظ بيانات الاعتماد قبل المحاولة مجددًا |
الأمر /ask غير ظاهر | تأكد من تثبيت الأمر وتفويضه، وانتظر انتشار الأوامر العامة، ثم أعد الاتصال لتسجيله من جديد |
| يظهر أن التطبيق لم يستجب للتفاعل | تأكد من تفعيل الموصّل، وافحص الأخطاء في Make Agent Fast وDiscord؛ ويجب أن ينجح التحقق من توقيع نقطة النهاية |
| تُتجاهل رسائل الدردشة الأخرى | هذا متوقع؛ فالتكامل يتعامل مع /ask فقط |
| الرد مقتطع | رسائل الرد في Discord محدودة بـ 2,000 حرف |
لا تكشف رمز البوت أبدًا في كود العميل أو المستودعات أو السجلات أو لقطات الشاشة.