استخدام وكيل ترميز مثبّت كنموذج محادثة
إذا كنت تدفع بالفعل مقابل وكيل ترميز وكان مسجّلًا دخوله على الجهاز الذي يشغّل Libre WebUI، فيمكنك التحدث إليه من محادثة عادية بدل إضافة مفتاح API منفصل. يكتشف Libre WebUI واجهة سطر أوامر الوكيل ويعرضها في منتقي النماذج كأي نموذج آخر.
ما يُكتشف
عند كل طلب لقائمة النماذج، يبحث Libre WebUI في PATH للخادم عن الأوامر التالية:
| النموذج | الأمر | يقدمه |
|---|---|---|
| Claude Code | claude | Anthropic |
| Codex | codex | OpenAI |
| OpenCode | opencode | SST |
| Pi | pi | Mario Zechner |
يظهر كل ما يُعثر عليه ضمن مجموعة الوكلاء في منتقي النماذج. لا يُثبّت شيء نيابةً عنك ولا يلزم ملف ضبط؛ فإذا كان الأمر يعمل في shell الخادم، فسيظهر.
اختيار نموذج، لا مجرد CLI
يمكن لكل CLI عرض عدة إدخالات في مجموعة الوكلاء:
- يقدّم Claude Code القيمة الافتراضية المسجّل دخولها إلى جانب Sonnet وOpus وHaiku.
- يقدّم Codex قيمته الافتراضية المضبوطة وعائلة تسجيل الدخول الموثقة لـ ChatGPT: GPT-5.6 Sol وTerra وLuna وGPT-5.3 Codex Spark.
- يعمل Pi بالنموذج المضبوط داخل CLI نفسه.
- يسرد OpenCode نماذج كل موفّر تمت المصادقة لديه
(من
opencode models)، ويتطلب دائمًا اختيارًا صريحًا؛ فقد تشير قيمته الافتراضية على مستوى CLI إلى خادم محلي لا يستطيع مضيف Libre WebUI الوصول إليه.
يشغّل Pi كل جولة بلا حالة (--no-session)، مع تعطيل الأدوات المحلية ورسالة
نظام محايدة، فلا تتأثر الردود بضبط Pi الشخصي لمستخدم نظام تشغيل الخادم،
ولا تلمس المحادثات ذلك الضبط.
الاستخدام
- سجّل الدخول كمسؤول.
- ابدأ محادثة وافتح منتقي النماذج.
- اختر إدخالًا من الوكلاء.
- أرسل الرسائل كالمعتاد. تتدفق الردود رمزًا بعد رمز.
تُحفظ المحادثة كأي محادثة أخرى، لذا يمكنك مغادرتها والعودة إليها وإعادة تسميتها والبحث عنها من لوحة الأوامر. ترسل كل جولة نسخة من المحادثة الحديثة إلى الوكيل وتبث إجابته.
من يستطيع استخدامها وما الذي يمكنها الوصول إليه
هذه الميزة للمسؤولين فقط، والسبب مهم. يعمل الوكيل كمستخدم نظام التشغيل نفسه الذي يشغّل خادم Libre WebUI الخلفي وعلى المضيف، لا داخل حاوية Work. وبذلك يرث بيانات اعتماد الوكيل لذلك المستخدم وكل وصول تملكه هذه الوكلاء عادةً، بما فيه القدرة على قراءة الملفات وتشغيل الأوامر على الخادم إذا قررت ذلك.
تعامل مع تفعيل هذه الميزة كما لو أنك تمنح الوكيل وصول shell إلى الجهاز. لذلك تأتي معطلة: يجب على مسؤول تشغيلها من الإعدادات ← إدارة المستخدمين ← الوكلاء. يُحفظ الإعداد ويسري فورًا من دون إعادة تشغيل.
لتثبيت القرار على مستوى النشر بغض النظر عن مفتاح وقت التشغيل، اضبط متغير البيئة في أي من الاتجاهين (ويقفل ذلك المفتاح في الواجهة أيضًا):
AGENT_CLI_MODELS_ENABLED=false # or true
إذا أردت نموذجًا يتصرف في الملفات لكنه يبقى داخل sandbox، فاستخدم Work بدلًا من ذلك؛ فهي تشغّل النماذج القادرة على الأدوات في حاوية مقيدة ومساحة عمل معزولة.
الضبط
| المتغير | الافتراضي | الغرض |
|---|---|---|
AGENT_CLI_MODELS_ENABLED | غير مضبوط | ثبّت الميزة على true/false؛ وعدم ضبطه يرجع إلى مفتاح المسؤول (معطلة افتراضيًا) |
AGENT_CLI_TIMEOUT_MS | 600000 | مدة تشغيل جولة وكيل واحدة قبل إنهائها |
استكشاف الأخطاء وإصلاحها
لا تظهر مجموعة الوكلاء. تأكد من تفعيل الميزة في
الإعدادات ← إدارة المستخدمين ← الوكلاء (فهي معطلة افتراضيًا) ومن تسجيل دخولك مسؤولًا،
ثم تحقق من وجود الأمر في PATH للعملية التي تشغّل الخادم الخلفي، لا في shell
التفاعلي فقط. غالبًا يبدأ مدير خدمة أو حاوية Docker أو مشغّل سطح المكتب
بـ PATH أصغر كثيرًا من طرفية تسجيل الدخول.
يفشل الرد فورًا. شغّل الأمر نفسه يدويًا كمستخدم الخادم
(claude -p "hello" أو codex exec "hello"). تنتج معظم الإخفاقات من طلب
الوكيل تسجيل دخول منتهي الصلاحية أو بلوغ حد معدل الاشتراك. لا يبلغ OpenCode
خصوصًا عن انتهاء تسجيل موفّر إلا في سجلاته؛ فأعد تشغيل opencode auth login
كمستخدم الخادم.
تتوقف الردود جزئيًا. ربما بلغت جولة طويلة AGENT_CLI_TIMEOUT_MS. ارفع
القيمة أو قسّم الطلب إلى خطوات أصغر.