استخدام وكيل ترميز مثبّت كنموذج محادثة

إذا كنت تدفع بالفعل مقابل وكيل ترميز وكان مسجّلًا دخوله على الجهاز الذي يشغّل Libre WebUI، فيمكنك التحدث إليه من محادثة عادية بدل إضافة مفتاح API منفصل. يكتشف Libre WebUI واجهة سطر أوامر الوكيل ويعرضها في منتقي النماذج كأي نموذج آخر.

ما يُكتشف

عند كل طلب لقائمة النماذج، يبحث Libre WebUI في PATH للخادم عن الأوامر التالية:

النموذج	الأمر	يقدمه
Claude Code	claude	Anthropic
Codex	codex	OpenAI
Kiro	kiro-cli	AWS
OpenCode	opencode	SST
Pi	pi	Mario Zechner

يظهر كل ما يُعثر عليه ضمن مجموعة الوكلاء في منتقي النماذج. لا يُثبّت شيء نيابةً عنك ولا يلزم ملف ضبط؛ فإذا كان الأمر يعمل في shell الخادم، فسيظهر.

تعرّف الإعدادات → الدردشة → الافتراضيات هذه الإدخالات أيضًا بوصفها الوكيل، بما فيها Strands عندما يكون حسابك مسموحًا له باستخدامه. تحتفظ نماذج الإضافات باسم مزوّدها، ولا يحمل تسمية Ollama إلا نماذجه. لا يخفي تعطيل Ollama الوكلاء أو الإضافات المهيّأة. تعرض بطاقة معلومات النموذج اسم الإدخال المختار ومزوّده، ولا تعرض الحجم أو العائلة أو التنسيق إلا عندما يوفّرها كتالوجه.

اختيار نموذج، لا مجرد CLI

يمكن لكل CLI عرض عدة إدخالات في مجموعة الوكلاء:

• يقدّم Claude Code القيمة الافتراضية المسجّل دخولها إلى جانب Sonnet وOpus وHaiku، مع اختيارات صريحة هي Sonnet 5.5 (claude-sonnet-5-5) وOpus 5.5 (claude-opus-5-5) وHaiku 5.5 (claude-haiku-5-5). يتطلب Sonnet 5.5 استخدام Claude Code 2.1.284 أو أحدث، ويتطلب Opus 5.5 استخدام Claude Code 2.1.280 أو أحدث، ويتطلب Haiku 5.5 استخدام Claude Code 2.1.293 أو أحدث، وكلها مع توفّر الوصول عبر الحساب المسجّل دخوله؛ شغّل claude update لتحديث CLI. وتستمر الأسماء المستعارة Sonnet وOpus وHaiku الحالية في اتباع تعيين النموذج الحالي في CLI.
• يقدّم Codex قيمته الافتراضية المضبوطة وعائلة تسجيل الدخول الموثقة لـ ChatGPT: GPT-6 Astra وGPT-6.1 Sol (gpt-6.1-sol) وGPT-6 Sol وGPT-6 Luna وGPT-5.6 Sol وTerra وLuna وGPT-5.5 وGPT-5.3 Codex Spark. ويتوقف التوفر على تسجيل دخول CLI ووصول الحساب إلى النماذج.
• يسرد Kiro النماذج التي يستطيع حسابه المسجّل دخوله استخدامها (من kiro-cli chat --list-models) إلى جانب قيمته الافتراضية المضبوطة. تعمل كل جولة بشكل غير تفاعلي على محرك الوكلاء V3 في CLI مع تثبيت وكيله الافتراضي المدمج (vibe)، لذا لا ينطبق chat.defaultAgent مخصص. يتطلب Kiro CLI 2.27 أو أحدث.
• يعمل Pi بالنموذج المضبوط داخل CLI نفسه.
• يسرد OpenCode نماذج كل موفّر تمت المصادقة لديه (من opencode models)، ويتطلب دائمًا اختيارًا صريحًا؛ فقد تشير قيمته الافتراضية على مستوى CLI إلى خادم محلي لا يستطيع مضيف Libre WebUI الوصول إليه.

يظهر محرك Strands المدمج أيضًا في مجموعة الوكلاء عندما يكون حسابك مسموحًا له باستخدامه. وهو ليس CLI: إنه يعمل داخل الواجهة الخلفية ويشغّل نماذج Ollama ونماذج إضافات المزوّدين لديك. يستخدم إدخال Strands المجرد (strands) نموذج المحادثة الافتراضي لديك. أما الإدخالات الأخرى (strands:<route>) فتسرد إدخالًا لكل نموذج متاح، مثل Strands · gpt-5.6-sol (Codex (ChatGPT))، وتثبّت النموذج ومزوّده معًا لتلك المحادثة؛ ولا يستطيع مزوّد آخر متاح أن يحل محله أثناء الانقطاع. ولا يؤدي سرد الخيارات إلى بدء المحرك.

تعمل إدخالات Strands نفسها كنموذج مهمة تحت الإعدادات → الدردشة → الافتراضيات للعناوين التلقائية وملخصات التفكير. يستخدم استخدام النموذج الجاري اختيار Strands المحفوظ للمحادثة. تستدعي هذه الطلبات النصية القصيرة نموذج المزوّد الأساسي مباشرة؛ ولا تشغّل أدوات الوكيل أو تنشئ جلسة وكيل. تتطلب ملفات CLI الأخرى نموذج مهمة Ollama أو إضافة أو Strands لهذه الطلبات المساعدة.

يشغّل Pi كل جولة بلا حالة (--no-session)، مع تعطيل الأدوات المحلية ورسالة نظام محايدة، فلا تتأثر الردود بضبط Pi الشخصي لمستخدم نظام تشغيل الخادم، ولا تلمس المحادثات ذلك الضبط.

أما Kiro فعلى العكس في الأمرين: فهو يعمل بضبط Kiro الخاص بمستخدم الخادم — الوكيل الافتراضي المدمج مثبّت، لكن قواعد الأذونات (~/.kiro/settings/permissions.yaml) وخوادم MCP والنموذج الافتراضي المضبوط تظل سارية — وتُحفظ كل جولة كجلسة جديدة في مخزن جلسات Kiro لذلك المستخدم (يعرضها kiro-cli chat --list-sessions، وبداخلها نص المحادثة الحديث). لا يوجد خيار لإيقاف ذلك، لذا يوجد محتوى المحادثة أيضًا في المجلد المنزلي لمستخدم الواجهة الخلفية، خارج قاعدة بيانات Libre WebUI. وتبقى أدوات Kiro مفعّلة: كل ما تثق به قواعد الأذونات تلك — افتراضيًا القراءة والأوامر المخصصة للقراءة فقط مثل date — يعمل دون سؤال، ويُرفض أي استدعاء أداة يحتاج إلى موافقة، لأن جولة المحادثة لا تستطيع الرد على الطلب.

الاستخدام

1. سجّل الدخول كمسؤول.
2. ابدأ محادثة وافتح منتقي النماذج.
3. اختر إدخالًا من الوكلاء.
4. أرسل الرسائل كالمعتاد. تتدفق الردود رمزًا بعد رمز.

تُحفظ المحادثة كأي محادثة أخرى، لذا يمكنك مغادرتها والعودة إليها وإعادة تسميتها والبحث عنها من لوحة الأوامر. ترسل كل جولة نسخة من المحادثة الحديثة إلى الوكيل وتبث إجابته.

من يستطيع استخدامها وما الذي يمكنها الوصول إليه

هذه الميزة للمسؤولين فقط، والسبب مهم. يعمل الوكيل كمستخدم نظام التشغيل نفسه الذي يشغّل خادم Libre WebUI الخلفي وعلى المضيف، لا داخل حاوية Work. وبذلك يرث بيانات اعتماد الوكيل لذلك المستخدم وكل وصول تملكه هذه الوكلاء عادةً، بما فيه القدرة على قراءة الملفات وتشغيل الأوامر على الخادم إذا قررت ذلك.

اعتبر التفعيل مكافئًا لمنح الوكيل وصولًا عبر الصدفة إلى الجهاز. لذلك تُشحن الميزة معطّلة: يجب أن يفعّلها مسؤول تحت الإعدادات → إدارة المستخدمين → الوصول والسياسات → نماذج وكلاء CLI. يُحفظ الإعداد ويصبح نافذًا فورًا دون إعادة تشغيل.

يؤدي تغيير عنصر التحكم هذا إلى تحديث كتالوج النماذج فورًا؛ تحتوي فئة الوكلاء على إدخالات CLI المباشرة، بينما تحتوي نماذج الإضافات على تكاملات API للمزوّدين مثل Codex (ChatGPT). يُدرج Strands في الفئة نفسها، لكنه يتبع إعداد الوصول الخاص به محرك Strands لا هذا المفتاح، لذا يمكن أن يظهر بينما تكون نماذج وكلاء CLI معطّلة. ولا يستطيع اكتشاف نماذجه منع اكتشاف وكلاء CLI المثبتين.

ترث التثبيتات القائمة قرار الوكلاء المحفوظ سابقًا حتى حفظ إعداد CLI مستقل.

لتثبيت القرار على مستوى النشر بغض النظر عن مفتاح وقت التشغيل، اضبط متغير البيئة في أي من الاتجاهين (ويقفل ذلك المفتاح في الواجهة أيضًا):

AGENT_CLI_MODELS_ENABLED=false   # or true

إذا أردت نموذجًا يتصرف في الملفات لكنه يبقى داخل sandbox، فاستخدم Work بدلًا من ذلك؛ فهي تشغّل النماذج القادرة على الأدوات في حاوية مقيدة ومساحة عمل معزولة.

الوكلاء أنفسهم في Work

يقدّم Work الوكلاء أنفسهم بخيارات النماذج نفسها وتسجيلات الدخول نفسها، لكنه يشغّلهم داخل البيئة المعزولة للمهمة بدل المضيف، خلف وكيل خروج يُبقي الرموز الحقيقية خارج البيئة المعزولة. ولهم وضع وصول خاص بهم، واجهات CLI للوكلاء في Work، ولا يحتاجون إلى المفتاح أعلاه. راجع واجهات CLI للوكلاء في Work.

تتبع الاستخدام

افتح استخدام المزود (/usage) وابحث عن الوكلاء قرب أعلى الصفحة. توجد إدخالات صريحة لنشاط Claude Code وCodex وKiro وOpenCode وPi وStrands، مع رسالة واضحة عندما لا تحتوي الفترة المحددة على استدعاءات مسجلة.

تسجّل استدعاءات CLI عبر LWUI نتيجتها ومدتها واستخدام الرموز المبلّغ عنه. تنشئ كل عملية استدعاء حدث استخدام واحدًا؛ ولا تنشئ لقطات الاستخدام المكررة والتقارير حسب الخطوة أحداثًا أو أعداد رموز مكررة. تبقى عدادات الرموز المفقودة غير مبلّغ عنها. يسجّل إيقاف الرد إلغاءً، ولا يصبح خروج CLI الفاشل نجاحًا لمجرد إنتاج نص جزئي. لا يُستورد استخدام استدعاءات CLI خارج LWUI.

تُنسب استدعاءات Strands إلى الوكيل Strands. راجع استخدام الوكلاء للتفصيل والحدود.

الضبط

المتغير	الافتراضي	الغرض
AGENT_CLI_MODELS_ENABLED	غير مضبوط	ثبّت الميزة على true/false؛ وعدم ضبطه يرجع إلى مفتاح المسؤول (معطلة افتراضيًا)
AGENT_CLI_TIMEOUT_MS	600000	مدة تشغيل جولة وكيل واحدة قبل إنهائها

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

لا تظهر مجموعة الوكلاء. تحقق من تفعيل الميزة تحت الإعدادات → إدارة المستخدمين → الوصول والسياسات → نماذج وكلاء CLI (هي معطّلة افتراضيًا)، ومن تسجيل دخولك كمسؤول. ثم تحقق من وجود الأمر في PATH للعملية التي تشغّل الواجهة الخلفية، لا في صدفتك التفاعلية فقط. غالبًا يبدأ مدير الخدمة أو حاوية Docker أو مشغّل سطح المكتب بـ PATH أصغر كثيرًا من طرفية تسجيل الدخول.

يفشل الرد فورًا. شغّل الأمر نفسه يدويًا كمستخدم الخادم (claude -p "hello" أو codex exec "hello" أو echo hello | kiro-cli chat --no-interactive --output-format stream-json --agent-engine v3 --agent vibe). يلزم Kiro CLI 2.27 أو أحدث؛ إذ يفشل الإصدار الأقدم هنا أولًا حيث يظهر خطؤه — أما في المحادثة فلا يظهر الفشل نفسه إلا بصيغة Kiro exited unsuccessfully. تنتج معظم الإخفاقات من طلب الوكيل تسجيل دخول منتهي الصلاحية أو بلوغ حد معدل الاشتراك. لا يبلغ OpenCode خصوصًا عن انتهاء تسجيل موفّر إلا في سجلاته؛ فأعد تشغيل opencode auth login كمستخدم الخادم. يسجّل Kiro الدخول عبر kiro-cli login، وتفشل الجلسة المنتهية بالطريقة نفسها.

تتوقف الردود جزئيًا. ربما بلغت جولة طويلة AGENT_CLI_TIMEOUT_MS. ارفع القيمة أو قسّم الطلب إلى خطوات أصغر.

مستندات ذات صلة

• Work: مساحات العمل المعزولة
• متغيرات البيئة
• ربط موفّرين خارجيين ومستضافين ذاتيًا