ورشة مجانية 21–22.11ورشة مجانية لمدة يومين في Vibecoding يومي 21–22 نوفمبر الساعة 16:00 بتوقيت موسكو · الدفعة 3 تبدأ 23.11سجّل مجاناً ←الدفعة 3 (23.11)
إصدارAPI / منتج · جاهز للعملGoogle AI Blog→ المصدر

Gemini API يتعلّم تحميل مخططات الأدوات عند الطلب بدل إرسالها مع كل موجّه

عندما يملك الوكيل مئات الأدوات، يجب إرسال مخطط المعاملات الخاص بكل أداة مع كل طلب. فترتفع التوكنات وزمن الاستجابة، ويصبح اختيار الأداة المناسبة أكثر اضطرابًا. أضافت Google إلى Gemini Interactions API وضع Tool Retrieval: يرى النموذج اسم الدالة ووصفها فقط، ولا يحمّل المخطط الكامل إلا عند الحاجة إليه. وبالنسبة إلى المكتبات الكبيرة، هذه طريقة لخفض توكنات الإدخال دون رسوم منفصلة، لكن من الأفضل التحقق من الفائدة على حركة المرور الخاصة بك.

معالج بواسطة الذكاء الاصطناعي من Google AI Blog؛ بتحرير Hamidun News
Gemini API يتعلّم تحميل مخططات الأدوات عند الطلب بدل إرسالها مع كل موجّه
المصدر: Google AI Blog. كولاج: Hamidun News.
استمع للمقال
بطاقة الحقائق والأرقام
المعيارالتفاصيل
المصدر الأصليGoogle AI Blog ↗
رئيس التحرير
التفعيلإضافة tool_search في الطلب وdefer_loading: true للأدوات
حقيقة رئيسية #2يعمل مع Gemini 3.6 وما بعده، بما في ذلك جميع نماذج Gemini 4
لا توجد رسوم منفصلةتدفع مقابل التوكنات إضافة إلى كتلة ثابتة صغيرة

يتعامل الوكيل مع الأدوات الخمس الأولى دون مشكلات. عند خمسين أداة تبدأ الصعوبات: لكل دالة مخطط JSON للمعاملات، وكل ذلك يُرسل إلى النموذج مع كل طلب. ترتفع فاتورة توكنات الإدخال، ويصل الرد ببطء أكبر، ويختار النموذج الدالة الخاطئة في كثير من الأحيان لأن عدد المرشحين كبير جدًا. حاولت Google معالجة ذلك، فأطلقت بنسخة معاينة ميزة Tool Retrieval في Gemini Interactions API.

كيف يعمل

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

لتفعيل هذا الوضع، أضف أداة tool_search إلى الطلب، وعيّن defer_loading: true للدوال التي يُفضَّل تأجيل تحميلها. بعد ذلك يجري كل شيء داخل استدعاء API واحد. لنفترض أن المستخدم كتب: «وصل الطلب A-1042 تالفًا، أعيدوا 40 دولارًا». يطلب النموذج الأداة issue_refund بالاسم، فيُدرج API مخططها الكامل، ثم يكوّن النموذج استدعاء الدالة برقم الطلب والمبلغ. الخطوات الثلاث كلها ظاهرة في interaction.steps: البحث ونتيجة البحث وfunction_call نفسه. هذا مفيد عند تصحيح الأخطاء: يتضح فورًا أي الأدوات نظر فيها النموذج، وهل كانت الأسماء والأوصاف كافية لتوجيهه.

بعد ذلك يسير كل شيء كما في function calling المعتاد. ينفّذ كودك عملية الاسترجاع ويعيد function_result.

لا حاجة إلى بناء فهرس أو استضافته، فالبحث يعمل من جهة Gemini. يمكن إبقاء الأدوات كثيرة الاستخدام محمّلة من البداية، وتأجيل «الذيل الطويل» فقط.

الذاكرة المؤقتة وMCP والسجل الخاص

هناك ثلاث تفاصيل عملية. الأولى تخص ذاكرة البادئة المؤقتة (prefix cache). المخططات المؤجلة لا تقع في بداية الموجّه، أما المخططات المختارة فتُضاف لاحقًا خلال المحادثة. لذلك لا يتغير الجزء الأول المخزَّن مؤقتًا من دور إلى آخر، ولا تضيع فائدة الذاكرة المؤقتة.

التفصيل الثاني يخص MCP. إذا وضعت defer_loading: true على أداة من نوع mcp_server، فستُحمَّل جميع دوال هذا الخادم البعيد عند الطلب. يمكن إذن ربط خادم MCP كبير دون سرد أدواته يدويًا.

التفصيل الثالث لمن يملك أصلًا سجلًا خاصًا بالأدوات أو فهرسًا متجهيًا أو مرشِّحًا للصلاحيات حسب المستخدم. لهؤلاء يتوفر وضع العميل: يُعلَن عن tool_search مع "execution": "client"، ويتولى تطبيقك البحث ويعيد المخططات المناسبة ضمن function_result. ثمن هذا الأسلوب جولة شبكية إضافية مع كل عملية بحث. في المقابل لا حاجة إلى الإعلان عن الأدوات مسبقًا. وعندما يربط المستخدم تكاملًا جديدًا أثناء عمله، يمكن عرض دوال هذا التكامل على النموذج في منتصف المحادثة مباشرة.

السعر والقيود وما يجب فعله

لا توجد رسوم منفصلة على Tool Retrieval. تُحتسب توكنات الإدخال والإخراج وفق التعرفة المعتادة للنموذج المختار. لكن لا وجود لغداء مجاني هنا، وتقول Google ذلك صراحة. فأداة tool_search نفسها تضيف كتلة ثابتة صغيرة من توكنات الإدخال. وكل مخطط يُحمَّل يُدفع ثمنه كتوكنات إدخال حتى نهاية المحادثة، تمامًا كأداة أُعلن عنها مسبقًا. يتحقق التوفير عندما يكون عدد المخططات التي لم يحمّلها النموذج أكبر من عدد التي حمّلها. وبحسب Google، هذا هو الوضع المعتاد في المكتبات الكبيرة، لكن الإعلان لا يتضمن أرقامًا محددة للتوفير. وتنصح الشركة بقياس الأثر على حركة المرور الخاصة بك.

وهناك عدة قيود أخرى. الميزة ما زالت في مرحلة المعاينة، أي أن الواجهة قد تتغير. وهي تعمل فقط في Interactions API ومع نماذج Gemini 3.6 وما بعده، بما في ذلك جميع نماذج Gemini 4. إذا كان لديك عدد قليل من الأدوات، فستكون الفائدة ضئيلة، وقد تضيف خطوة البحث الإضافية زمن استجابة. كما أن النموذج يختار الأداة بناءً على الاسم والوصف، ولذلك فإن الأوصاف الضعيفة أو المتشابهة ستجلب دوال خاطئة بالخطأ.

ماذا تفعل عمليًا؟ إذا كنت تبني وكيلًا بعشرات الدوال أو تربط خوادم MCP كبيرة، فمن المفيد إجراء تجربة صغيرة. أبقِ الأدوات الأكثر استخدامًا محمّلة من البداية، وأجّل البقية، ثم قارن التوكنات وزمن الاستجابة ونسبة الدوال المختارة بشكل صحيح في محادثات حقيقية. وراجع الأوصاف في الوقت نفسه: فهي الآن ما يحدد ما إذا كان النموذج سيعثر على الأداة المطلوبة.

القصة

أسئلة وأجوبة حول الخبر

ما أبرز التفاصيل حول كيف يعمل؟

الفكرة أشبه بفهرس الكتاب. يرى النموذج دائمًا اسم كل أداة ووصفها المختصر، فيعرف ما المتاح أصلًا. أما الجزء الثقيل، أي مخطط المعاملات، فلا يدخل السياق إلا عند الحاجة إليه. لتفعيل هذا الوضع، أضف أداة tool_search إلى الطلب، وعيّن defer_loading: true للدوال التي يُفضَّل تأجيل تحميلها. بعد ذلك يجري كل شيء داخل استدعاء API واحد. لنفترض أن المستخدم كتب: «وصل الطلب A-1042 تالفًا، أعيدوا 40 دولارًا». يطلب النموذج الأداة issue_refund بالاسم، فيُدرج API مخططها الكامل، ثم يكوّن النموذج استدعاء الدالة برقم الطلب والمبلغ.

ما أبرز التفاصيل حول الذاكرة المؤقتة وMCP والسجل الخاص؟

هناك ثلاث تفاصيل عملية. الأولى تخص ذاكرة البادئة المؤقتة (prefix cache). المخططات المؤجلة لا تقع في بداية الموجّه، أما المخططات المختارة فتُضاف لاحقًا خلال المحادثة. لذلك لا يتغير الجزء الأول المخزَّن مؤقتًا من دور إلى آخر، ولا تضيع فائدة الذاكرة المؤقتة. التفصيل الثاني يخص MCP. إذا وضعت defer_loading: true على أداة من نوع mcp_server، فستُحمَّل جميع دوال هذا الخادم البعيد عند الطلب. يمكن إذن ربط خادم MCP كبير دون سرد أدواته يدويًا.

ما أبرز التفاصيل حول السعر والقيود وما يجب فعله؟

لا توجد رسوم منفصلة على Tool Retrieval. تُحتسب توكنات الإدخال والإخراج وفق التعرفة المعتادة للنموذج المختار. لكن لا وجود لغداء مجاني هنا، وتقول Google ذلك صراحة. فأداة tool_search نفسها تضيف كتلة ثابتة صغيرة من توكنات الإدخال. وكل مخطط يُحمَّل يُدفع ثمنه كتوكنات إدخال حتى نهاية المحادثة، تمامًا كأداة أُعلن عنها مسبقًا. يتحقق التوفير عندما يكون عدد المخططات التي لم يحمّلها النموذج أكبر من عدد التي حمّلها. وبحسب Google، هذا هو الوضع المعتاد في المكتبات الكبيرة، لكن الإعلان لا يتضمن أرقامًا محددة للتوفير.

ZK
جمال حميدون — مدير المنتجات في Alpina Digital ومدير منتج AlpinaGPT. يبني منتجات الذكاء الاصطناعي منذ 2019. بدأ Hamidun News كمشروع شخصي ثم أصبح مُجمِّعًا إنتاجيًا بأكثر من 6000 قارئ.
✦ Unified AI Workspace · Nomad

Test Frontier LLMs & Autonomous Agents in One Workspace

Run Claude Opus 5.5, GPT-6, Gemini 3.1, and DeepSeek side-by-side in Nomad AI (nomadnet.ai) — unified model routing, deep research, and multimodal workflows under one subscription.

Try Nomad AI →Launch Nomad Agent
ما رأيك؟
جارٍ تحميل التعليقات…