الانتقال إلى المحتوى الرئيسي
Factory Droid CLI (الأمر droid) هو وكيل هندسة البرمجيات الطرفي بالذكاء الاصطناعي من Factory AI.
البروتوكول: متوافق مع OpenAI
  • عنوان URL الأساسي: https://api.orcarouter.ai/v1 (يتضمن اللاحقة /v1)

​
التثبيت

macOS/Linux: 
curl -fsSL https://app.factory.ai/cli | sh
Windows (PowerShell): 
irm https://app.factory.ai/cli/windows | iex
الأمر المثبَّت هو droid.

​
الإعداد

ملف الإعداد: ~/.factory/config.json. 
{
  "custom_models": [
    {
      "model_display_name": "OrcaRouter Auto",
      "model": "orcarouter/auto",
      "base_url": "https://api.orcarouter.ai/v1",
      "api_key": "sk-orca-...",
      "provider": "generic-chat-completion-api",
      "max_tokens": 8192
    }
  ]
}
استبدل orcarouter/auto بنموذج محدّد إن فضّلت ذلك، مثل anthropic/claude-opus-4.8 أو google/gemini-2.5-flash. تستخدم معرّفات النماذج دائمًا صيغة vendor/model.

​
التشغيل

droid exec -m "orcarouter/auto" --auto low "Reply with exactly: OK"
الناتج المتوقع: OK.

​
ملاحظات

  • تُوضَع النماذج المخصّصة في مصفوفة custom_models.
  • استخدم provider: "generic-chat-completion-api" للبروتوكول المتوافق مع OpenAI.
  • يجب أن يتضمن base_url المسار /v1.
  • يتحكم --auto <low|medium|high> بـ الاستقلالية (مقدار ما يجوز للوكيل فعله دون إشراف) — وهو ليس عنصر التحكم في الاستدلال. راجع أدناه لمعرفة التفكير.
امتداد VS Code: يشترك امتداد VS Code الرسمي من Factory في نفس ملف ~/.factory/config.json الذي يستخدمه الـ CLI — فمدخل custom_models أعلاه ينطبق على كليهما، دون أي إعداد منفصل لنقطة النهاية داخل المحرّر. مع تنبيهين: لا تختبر Factory ولا تقيس الأداء بشكل كامل إلا مقابل واجهات Anthropic/OpenAI الرسمية، وهناك مشكلة معروفة قد تعيد توجيه الوكلاء الفرعيين إلى Anthropic بدلًا من نموذجك المخصّص.

​
تفعيل التفكير / الاستدلال

تحكم بجهد الاستدلال عبر الخيار -r / --reasoning-effort (منفصل عن --auto): 
droid exec -m "anthropic/claude-sonnet-4.6" -r high --auto low "What is 17*23?"
المستويات: low / medium / high (الافتراضي لكل نموذج — نماذج Anthropic معطّلة افتراضيًا، وGPT-5 افتراضيًا medium). يمكنك أيضًا ضبطه بشكل دائم في settings.json عبر reasoningEffort. تم التحقق: -r high يمرّ إلى OrcaRouter. (ملاحظة: مدخلات custom_models ليس لها حقل استدلال — تحكم به عبر -r أو settings.json.)