# إعداد الذكاء الاصطناعي

اتصل بمزود API، أو بنموذج محلي، أو بوكيل CLI مثبت.

اختر الطريقة التي تريد العمل بها. يستطيع Oleafly تشغيل مساعده المدمج مقابل واجهة API لنموذج، أو الاتصال بنموذج محلي، أو استخدام وكيل CLI مثبت.

| ما تملكه فعلًا… | اختر… |
| --- | --- |
| مفتاح API لنموذج | **Providers and keys** |
| خادم نماذج محلي | **Ollama** أو مزود مخصص متوافق مع OpenAI |
| وكيل برمجة مثبت | [**وكلاء CLI**](/docs/cli-agents/) |
| عميل MCP خارجي | [**MCP**](/docs/mcp/) |

افتح **Settings → AI Assistant** لضبط المسار الذي تريده. يمكنك إبقاء عدة مزودين متصلين وتبديل النماذج في المحادثة.

لا تملك مفتاح API؟ يمكن لوكيل CLI سجّلت الدخول إليه أن يحل محله. اختره بوصفه نموذج Tools، فتستخدمه Oleafly Tools وميزات الذكاء الاصطناعي الأخرى في Oleafly. انظر [استخدم وكيلًا بدل مفتاح API](/docs/cli-agents/#use-an-agent-instead-of-an-api-key).

![Settings → AI Assistant → Providers and keys. وسّع مزودك لضبطه. يقع Ollama قرب أسفل القائمة.](https://cdn.oleafly.com/images/screenshots/desktop/docs/settings-providers-dark-window-v2.png#view=519,89,883,902)

![مفاتيح المزوّدين ووكلاء سطر الأوامر والمهارات في إعدادات المساعد.](https://cdn.oleafly.com/images/gifs/desktop/settings-ai-agents.gif?v=2)

## الاتصال بمزود

1. افتح **Providers and keys** ووسّع أحد المزودين.
2. أدخل مفتاح API الخاص به ثم احفظ.
3. يتحقق Oleafly من الاتصال ويحدّث قائمة النماذج.
4. اختر نموذجًا في المساعد، أو عيّن نموذجًا افتراضيًا في **Instructions**.

OpenAI

Anthropic

Google Gemini

Perplexity

Z.AI

Groq

OpenRouter

DeepSeek

Mistral

xAI

Ollama

ترتبط كل بطاقة مزود في Settings بإعداد مفتاحها. يتصل Ollama بخادم نماذج محلي.

## اختيار نموذج

تعرض صفوف النماذج معلومات القدرات عند توفرها: حجم السياق، والرؤية، والأدوات، والاستدلال. استخدم نموذجًا يدعم الأدوات لأعمال المشروع، ونموذجًا يدعم الرؤية لفحص الصور.

**Verified** تعني أن فحص استدعاء الأداة نجح. و**Untested** تعني أن المساعد لم يتحقق من ذلك النموذج؛ أما **Blocked** فيتضمن سبب تعذر اختياره. تصف هذه الشارات توافق الأدوات. وهي لا تقيم جودة بحث النموذج أو كتابته.

النموذج الذي لا يستطيع استدعاء الأدوات يظل صالحًا للمحادثة العادية. وأثناء تحديده، يقول مربع الكتابة **Chat only, this model cannot use tools**.

اختر **Refresh** على بطاقة المزود عندما تتغير نماذجه المتاحة. يمكن تحديث كل مزود مرة واحدة كل 30 ثانية؛ مرر فوق الزر لرؤية الوقت المتبقي. يمكنك أيضًا إضافة نموذج بمعرّفه.

يفعّل **Enable all** كل نموذج في قائمة المزود، ويعطّله **Disable all**. عطّل قائمة طويلة بنقرة واحدة، ثم فعّل من جديد النماذج القليلة التي تستخدمها.

## الاتصال بنموذج محلي

ثبّت [Ollama](https://ollama.com/) وشغّله، ثم نزّل نموذجًا في Ollama. في Oleafly، افتح بطاقة Ollama واختر **Check for Ollama**. اختر نموذجًا مثبتًا بمجرد العثور على الخادم.

يُبقي النموذج المحلي طلبات النموذج على جهازك. ولا تزال أدوات البحث عبر الإنترنت تتصل بخدماتها المصدرية عند استخدامها.

## إضافة نقطة نهاية مخصصة

اختر **Add custom provider** لخدمة متوافقة مع OpenAI، أو خادم محلي، أو بوابة. أدخل اسمًا وعنوان URL أساسيًا وأي مفتاح مطلوب. احفظ ثم اختر نموذجًا.

يعمل OpenCode Zen وOpenCode Go مزودين مخصصين. وهما يرفضان الطلبات التي لا تحمل معرّف جلسة، لذا يرسل Oleafly إليهما معرّف كل محادثة، ولا يرسله إلى أي مزود آخر. ويعمل خادم Lemonade المحلي هنا أيضًا. وللاطلاع على نماذجه التي تفكر قبل أن تجيب، انظر [تخطي خطوة التفكير](/docs/ollama/#skip-the-thinking-step).

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

## تعيين تفضيلات الكتابة

يحتفظ **Instructions** بالتفضيلات الدائمة وبنموذج المحادثة الافتراضي. استخدم تعليمات ملموسة:

> استخدم الإملاء البريطاني. حافظ على مفاتيح الاستشهاد. اشرح التغييرات على المعادلات قبل تطبيقها.

يخزن **Personas** مجموعات تعليمات مسماة. ويوفر **Skills** إجراءات لأعمال البحث المتكررة. [استكشف المهارات →](/docs/skills/)

## المفاتيح والتكاليف

تُشفَّر مفاتيح المزودين في مخزن التطبيق المحلي وتبقى خارج ملفات مصدر المشروع. تذهب الطلبات المستضافة إلى المزود المحدد مع السياق المقدم. تُفوتر رسوم واجهات API للنماذج واشتراكات CLI لدى مزوديها.

[راجع الاستخدام والميزانيات →](/docs/ai-usage/)
