أدوات مدمجة

الوضع المرفوع

ما الذي يفعله

  • /elevated on يعمل على مضيف البوابة ويحتفظ بموافقات التنفيذ (مثل /elevated ask).
  • /elevated full يعمل على مضيف البوابة و يوافق تلقائيًا على التنفيذ (يتخطى موافقات التنفيذ).
  • /elevated ask يعمل على مضيف البوابة لكنه يحتفظ بموافقات التنفيذ (مثل /elevated on).
  • on/ask لا تفرضان exec.security=full؛ سياسة الأمان/الطلب المُهيأة لا تزال سارية.
  • يغير السلوك فقط عندما يكون الوكيل معزولاً (وإلا فإن التنفيذ يعمل بالفعل على المضيف).
  • أشكال التوجيه: /elevated on|off|ask|full, /elev on|off|ask|full.
  • يتم قبول on|off|ask|full فقط؛ أي شيء آخر يُرجع تلميحًا ولا يغير الحالة.

ما الذي يتحكم فيه (وما لا يتحكم فيه)

  • بوابات التوفر: tools.elevated هي الأساس العالمي. يمكن لـ agents.list[].tools.elevated تقييد الوضع المرفوع لكل وكيل بشكل أكبر (يجب أن يسمح كليهما).
  • حالة الجلسة: /elevated on|off|ask|full يحدد مستوى الرفع لمفتاح الجلسة الحالي.
  • التوجيه المضمن: /elevated on|ask|full داخل رسالة ينطبق على تلك الرسالة فقط.
  • المجموعات: في محادثات المجموعة، يتم احترام توجيهات الوضع المرفوع فقط عندما يتم ذكر الوكيل. الرسائل التي تحتوي على أوامر فقط والتي تتجاوز متطلبات الذكر تُعامل على أنها مذكورة.
  • التنفيذ على المضيف: الوضع المرفوع يجبر exec على الانتقال إلى مضيف البوابة؛ full يضبط أيضًا security=full.
  • الموافقات: full يتخطى موافقات التنفيذ؛ on/ask تحترمها عندما تتطلب قواعد القائمة المسموحة/الطلب ذلك.
  • الوكلاء غير المعزولين: لا تأثير على الموقع؛ يؤثر فقط على البوابات، التسجيل، والحالة.
  • سياسة الأداة لا تزال سارية: إذا تم رفض exec بواسطة سياسة الأداة، لا يمكن استخدام الوضع المرفوع.
  • منفصل عن /exec: /exec يضبط الإعدادات الافتراضية للجلسة للمرسلين المصرح لهم ولا يتطلب الوضع المرفوع.

ترتيب التحليل

  1. توجيه مضمن في الرسالة (ينطبق على تلك الرسالة فقط).
  2. تجاوز الجلسة (يتم تعيينه عن طريق إرسال رسالة تحتوي على التوجيه فقط).
  3. الإعداد الافتراضي العام (agents.defaults.elevatedDefault في التكوين).

تعيين إعداد افتراضي للجلسة

  • أرسل رسالة تكون فقط التوجيه (يُسمح بالمسافات البيضاء)، على سبيل المثال /elevated full.
  • يتم إرسال رد تأكيد (تم تعيين الوضع المرفوع إلى full... / تم تعطيل الوضع المرفوع.).
  • إذا كان الوصول المرفوع معطلاً أو لم يكن المرسل مدرجًا في القائمة المسموحة المعتمدة، يرد التوجيه بخطأ قابل للتنفيذ ولا يغير حالة الجلسة.
  • أرسل /elevated (أو /elevated:) بدون وسيط لرؤية مستوى الرفع الحالي.

التوفر + القوائم المسموحة

  • بوابة الميزة: tools.elevated.enabled (يمكن أن يكون الإعداد الافتراضي معطلاً عبر التكوين حتى لو كان الكود يدعمه).
  • قائمة المرسلين المسموح لهم: tools.elevated.allowFrom مع قوائم مسموحة لكل مزود (مثل discord, whatsapp).
  • تطابق إدخالات القائمة المسموحة بدون بادئة قيم هوية محددة للمرسل فقط (SenderId, SenderE164, From)؛ لا تُستخدم حقول توجيه المستلم أبدًا للتفويض المرفوع.
  • تتطلب بيانات تعريف المرسل القابلة للتغيير بادئات صريحة:
    • name:<value> تطابق SenderName
    • username:<value> تطابق SenderUsername
    • tag:<value> تطابق SenderTag
    • id:<value>, from:<value>, e164:<value> متاحة لاستهداف الهوية الصريح
  • بوابة لكل وكيل: agents.list[].tools.elevated.enabled (اختياري؛ يمكنه فقط تقييد المزيد).
  • قائمة مسموحة لكل وكيل: agents.list[].tools.elevated.allowFrom (اختياري؛ عند تعيينها، يجب أن يطابق المرسل كلا القائمتين المسموحتين العامة + لكل وكيل).
  • الاحتياطي لـ Discord: إذا تم حذف tools.elevated.allowFrom.discord، تُستخدم قائمة channels.discord.allowFrom كاحتياطي (قديم: channels.discord.dm.allowFrom). اضبط tools.elevated.allowFrom.discord (حتى []) للتجاوز. لا تستخدم القوائم المسموحة لكل وكيل الاحتياطي.
  • يجب اجتياز جميع البوابات؛ وإلا يُعامل الوضع المرفوع على أنه غير متاح.

التسجيل + الحالة

  • يتم تسجيل مكالمات التنفيذ المرفوعة على مستوى المعلومات.
  • تتضمن حالة الجلسة وضع الرفع (مثل elevated=ask, elevated=full).

أداة PDFأداة التنفيذ