التوثيق ‹ تكاملات الوكلاء ‹ Aider

Aider

Aider مساعد برمجة في سطر الأوامر يعمل مباشرة داخل مستودع Git الخاص بكم. يتصل بـCloudZIR عبر وضعه «المتوافق مع OpenAI».

التثبيت#

python -m pip install aider-install
aider-install

الإعداد#

export OPENAI_API_BASE="https://api.cloudzir.com/v1"
export OPENAI_API_KEY="zir_ai_..."

cd mon-projet
aider --model openai/mina-full

البادئة openai/ تخبر Aider باستخدام بروتوكول OpenAI ؛ يبقى الاسم الحقيقي للنموذج mina-full.

إعداد دائم#

في .aider.conf.yml، في جذر المشروع أو في مجلدكم الشخصي :

openai-api-base: https://api.cloudzir.com/v1
model: openai/mina-full
weak-model: openai/mina-flash
edit-format: diff
show-model-warnings: false

والمفتاح في .env (يُستبعَد من Git) :

OPENAI_API_KEY=zir_ai_...
weak-model

يستخدم Aider نموذجًا «صغيرًا» لرسائل الالتزام (commit) وملخصات التاريخ. ضبطه على mina-flash يجنّبكم دفع سعر النموذج الرئيسي مقابل هذه المهام الثانوية.

وصف قدرات النموذج#

يعرض Aider تحذيرًا حين لا يعرف نموذجًا. لإعلامه، أنشئوا .aider.model.settings.yml :

- name: openai/mina-full
  edit_format: diff
  use_repo_map: true
  send_undo_reply: false

- name: openai/mina-flash
  edit_format: whole
  use_repo_map: false

التحقق#

aider --model openai/mina-flash --message "explique le rôle du fichier README"

يجب أن يظهر الطلب في Usage.

نصائح#

  • تضيف repo map الخاصة بـAider سياقًا إلى كل طلب : في مستودع كبير، حدّدوها (--map-tokens 1024) لضبط التكلفة.
  • أضيفوا بـ/add الملفات الضرورية فقط : كل ملف مُضاف يُعاد إرساله كاملًا في كل جولة.
  • edit-format: diff يقلّص بشدة رموز الإخراج مقارنة بوضع whole.

القيود المعروفة#

  • وضع architect يعمل : عرّفوا ببساطة نموذجَي CloudZIR (--architect --model openai/mina-full --editor-model openai/mina-low).

الإعدادات

التخصيص

استجابة API