> ## Documentation Index
> Fetch the complete documentation index at: https://phaseo.app/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# Google Gemini 3.1

> ما ينبغي معرفته لاعتماد Gemini 3.1، بما في ذلك ضوابط الاستدلال ومعالجة الوسائط المتعددة وتواقيع التفكير.

# Google Gemini 3.1

استخدم هذا الدليل لاعتماد عائلة Gemini 3.1 بأمان في الإنتاج:

* `google/gemini-3-pro-preview`
* `google/gemini-3-flash-preview`
* `google/gemini-3.1-pro-preview`
* `google/gemini-3.1-flash-lite-preview`

أدخل Gemini 3 تغييرات فعلية على مستوى API لضبط الاستدلال ومعالجة الوسائط المتعددة. ثم رفع Gemini 3.1 المستوى الأساسي مجددًا، خصوصًا للمهام المعقدة والمكثفة في الاستدلال.

## الجديد

* قدّم Gemini 3 `thinking_level` بوصفه عنصر التحكم الأساسي في عمق الاستدلال.
* أضاف `media_resolution` لمعالجة الصور متعددة الوسائط.
* يستخدم Gemini 3 تواقيع التفكير للحفاظ على سياق الاستدلال بين الاستدعاءات.
* في سير العمل الأكثر صرامة، قد يؤدي غياب التواقيع إلى انخفاض الجودة أو أخطاء `400`.
* يُعد Gemini 3.1 Pro ترقية أقوى للاستدلال في المهام المعقدة وسير عمل الوكلاء.

## البدء السريع للترحيل

### 1. أعد مواءمة ضوابط الاستدلال

إذا كان التطبيق يوفّر عنصر تحكم عامًا للاستدلال، فعيّنه بعناية لمسارات Gemini 3. في التدفقات المتوافقة مع OpenAI، يقابل `reasoning_effort` مفهومًا `thinking_level` في Gemini، لكن السلوك ليس متطابقًا ويجب إعادة اختباره.

### 2. عالج تواقيع التفكير بشكل صحيح

مع SDKs الرسمية لـ Gemini وسجل المحادثة المعتاد، تُعالج التواقيع تلقائيًا غالبًا. أما عند إنشاء طلبات منخفضة المستوى، خصوصًا لاستدعاء الدوال أو توليد الصور وتحريرها، فاحتفظ بالتواقيع المعادة وأرسلها مجددًا تمامًا كما هو مطلوب.

### 3. راجع أسلوب المطالبات

تفضّل إرشادات Gemini 3 المطالبات المباشرة والتحكم عبر المعلمات بدلًا من القوالب الطويلة. إذا كانت مطالباتك الحالية تعوّض كثيرًا عن سلوك النماذج القديمة، فبسّطها وأعد تقييمها.

### 4. اضبط إعدادات الوسائط المتعددة

إذا تضمنت المسارات صورًا أو مستندات أو وسائط مختلطة، فأعد اختبار `media_resolution` بدل افتراض ملاءمة القيم الافتراضية القديمة.

## ما ينبغي اختباره

### سلوك المطالبات والاستدلال

* المطالبات الموجزة مقارنةً بالمطالبات ذات القوالب المكثفة
* مهام الاستدلال خطوة بخطوة
* تركيب المعلومات من سياق طويل
* سير عمل الوكلاء الذي يعتمد على استمرار الاستدلال

### معالجة الاستجابات

* الحفاظ على التواقيع بين الأدوار
* معدل نجاح استدعاء الدوال
* معدل اجتياز المخططات
* المخرجات الفارغة أو الجزئية أو المشوّهة بعد تغيير ضوابط التفكير

### مقاييس الإنتاج

* زمن الاستجابة عند كل مستوى `thinking_level`
* استهلاك الرموز والتكلفة
* أداء مسارات الوسائط المتعددة مع إعدادات `media_resolution` المختلفة
* نجاح المهام عند مقارنة Gemini 3 بـ Gemini 3.1 Pro

## نصائح الطرح

تعامل مع Gemini 3 وGemini 3.1 على أنهما عمليتا ترحيل منفصلتان.

1. رحّل تنسيق الطلب ومعالجة التواقيع أولًا.
2. أعد تقييم المطالبات والمخططات على Gemini 3.
3. أطلق Gemini 3.1 Pro بصورة منفصلة للمسارات التي تحتاج إلى استدلال أعمق.
4. أبقِ مسارًا بديلًا أبسط أو أقل تكلفة للأحمال كبيرة الحجم.

## المصادر

* [دليل مطوري Gemini 3](https://ai.google.dev/gemini-api/docs/gemini-3)
* [تحديثات Gemini API الجديدة لـ Gemini 3](https://developers.googleblog.com/en/new-gemini-api-updates-for-gemini-3/)
* [إعلان Gemini 3.1 Pro](https://blog.google/innovation-and-ai/models-and-research/gemini-models/gemini-3-1-pro/)


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.