Tools
التفاعلات
يضيف الوكيل تفاعلات الرموز التعبيرية ويزيلها باستخدام الإجراء react لأداة message. يختلف السلوك باختلاف القناة.
كيفية العمل
{ "action": "react", "messageId": "msg-123", "emoji": "thumbsup"}- يكون
emojiمطلوبًا عند إضافة تفاعل. - عيّن
emojiإلى سلسلة فارغة ("") لإزالة تفاعل (تفاعلات) البوت على القنوات التي تدعم ذلك. - عيّن
remove: trueلإزالة رمز تعبيري محدد واحد (يتطلب قيمةemojiغير فارغة). - في القنوات التي تستخدم تفاعلات الحالة، يتيح تعيين
trackToolCalls: trueفي تفاعل لبيئة التشغيل إعادة استخدام الرسالة التي أُضيف إليها التفاعل لإضافة تفاعلات لاحقة تشير إلى تقدم الأداة أثناء الدور نفسه.
سلوك القنوات
Discord وSlack
- تزيل قيمة
emojiالفارغة جميع تفاعلات البوت على الرسالة. - يزيل
remove: trueالرمز التعبيري المحدد فقط.
Nextcloud Talk
- إضافة التفاعلات فقط: يكون
emojiمطلوبًا ويجب ألا يكون فارغًا. - لم تُربط إزالة التفاعل بعدُ باستدعاء حذف؛ يُرفض
remove: trueبخطأ صريح بدلًا من عدم تنفيذ أي إجراء بصمت. - يتطلب تسجيل بوت Talk مع ميزة
reaction(راجع توثيق قناة Nextcloud Talk).
Telegram
- تزيل قيمة
emojiالفارغة تفاعلات البوت. - يزيل
remove: trueالتفاعلات أيضًا، لكنه يظل يتطلب قيمةemojiغير فارغة للتحقق من صحة استدعاء الأداة.
- تزيل قيمة
emojiالفارغة تفاعل البوت. - يُحوَّل
remove: trueداخليًا إلى رمز تعبيري فارغ (مع استمرار اشتراطemojiفي استدعاء الأداة). - لدى WhatsApp خانة واحدة لتفاعل البوت لكل رسالة؛ يؤدي إرسال تفاعل جديد إلى استبداله بدلًا من تكديس عدة رموز تعبيرية.
Zalo Personal (zalouser)
- يتطلب قيمة
emojiغير فارغة لكل من الإضافة والإزالة. - يزيل
remove: trueتفاعل الرمز التعبيري المحدد.
Feishu/Lark
- يستخدم الإجراء
reactنفسه الذي تستخدمه القنوات الأخرى (الإضافة والإزالة والسرد عبر معرّفات تفاعلات الرسائل)، وليس أداة منفصلة. - تتطلب الإضافة قيمة
emojiغير فارغة (تُحوَّل إلىemoji_typeفي Feishu، مثلSMILEوTHUMBSUPوHEART). - يتطلب
remove: trueقيمةemojiغير فارغة، ويزيل تفاعل البوت المطابق لنوع ذلك الرمز التعبيري. - تؤدي قيمة
emojiالفارغة معclearAll: trueإلى إزالة جميع تفاعلات البوت على الرسالة.
Signal
- تتحكم
channels.signal.reactionNotificationsفي إشعارات التفاعلات الواردة: يعطّلها"off"، ويصدر"own"(الافتراضي) أحداثًا عندما يتفاعل المستخدمون مع رسائل البوت، ويصدر"all"أحداثًا لجميع التفاعلات، بينما يصدر"allowlist"أحداثًا فقط للمرسلين الموجودين فيchannels.signal.reactionAllowlist.
iMessage
- التفاعلات الصادرة هي ردود النقر في iMessage (
loveوlikeوdislikeوlaughوemphasizeوquestion)؛ ويجب أن تتطابق قيمةemojiمع أحد هذه الأنواع لإضافة تفاعل. - يزيل
remove: trueمن دون نوع رد نقر معروف جميع أنواع ردود النقر؛ أما مع نوع معروف، فيزيل ذلك النوع فقط.
مستوى التفاعل
يحدّد reactionLevel لكل قناة معدل إرسال الوكيل لتفاعلاته الخاصة. القيم: off أو ack أو minimal أو extensive.
- إشعارات التفاعلات في Telegram -
channels.telegram.reactionLevel(الافتراضيminimal) - مستوى التفاعل في WhatsApp -
channels.whatsapp.reactionLevel(الافتراضيminimal) - التفاعلات في Signal -
channels.signal.reactionLevel(الافتراضيminimal)
ذو صلة
- إرسال الوكيل - أداة
messageالتي تتضمنreact - القنوات - إعدادات خاصة بكل قناة
Was this useful?
