Gemini API يتعلّم تحميل مخططات الأدوات عند الطلب بدل إرسالها مع كل موجّه
عندما يملك الوكيل مئات الأدوات، يجب إرسال مخطط المعاملات الخاص بكل أداة مع كل طلب. فترتفع التوكنات وزمن الاستجابة، ويصبح اختيار الأداة المناسبة أكثر اضطرابًا. أضافت Google إلى Gemini Interactions API وضع Tool Retrieval: يرى النموذج اسم الدالة ووصفها فقط، ولا يحمّل المخطط الكامل إلا عند الحاجة إليه. وبالنسبة إلى المكتبات الكبيرة، هذه طريقة لخفض توكنات الإدخال دون رسوم منفصلة، لكن من الأفضل التحقق من الفائدة على حركة المرور الخاصة بك.
معالج بواسطة الذكاء الاصطناعي من Google AI Blog؛ بتحرير Hamidun News
يتعامل الوكيل مع الأدوات الخمس الأولى دون مشكلات. عند خمسين أداة تبدأ الصعوبات: لكل دالة مخطط 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 كبيرة، فمن المفيد إجراء تجربة صغيرة. أبقِ الأدوات الأكثر استخدامًا محمّلة من البداية، وأجّل البقية، ثم قارن التوكنات وزمن الاستجابة ونسبة الدوال المختارة بشكل صحيح في محادثات حقيقية. وراجع الأوصاف في الوقت نفسه: فهي الآن ما يحدد ما إذا كان النموذج سيعثر على الأداة المطلوبة.
- 19 نوفمبر 2026OpenCode يطلق تطبيقًا للجوال: جهاز تحكم عن بُعد بالوكيل الذي يعمل على حاسوبك
- 19 نوفمبر 2026Skyflow في AgentCore Gateway يحجب البيانات الشخصية عن أدوات وكلاء الذكاء الاصطناعي
- 19 نوفمبر 2026روبوتات الدردشة تتراجع بعد ثلاثة اعتراضات: دقة إجاباتها عن المناخ تنخفض بنسبة 30–35%
- 19 نوفمبر 2026Anthropic تطرح أسهمها في البورصة وتجمع 81.3 مليار دولار، متجاوزة رقم SpaceX القياسي البالغ 75 مليار دولار
أسئلة وأجوبة حول الخبر
ما أبرز التفاصيل حول كيف يعمل؟
الفكرة أشبه بفهرس الكتاب. يرى النموذج دائمًا اسم كل أداة ووصفها المختصر، فيعرف ما المتاح أصلًا. أما الجزء الثقيل، أي مخطط المعاملات، فلا يدخل السياق إلا عند الحاجة إليه. لتفعيل هذا الوضع، أضف أداة 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، هذا هو الوضع المعتاد في المكتبات الكبيرة، لكن الإعلان لا يتضمن أرقامًا محددة للتوفير.
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.
أهم ما في عالم الذكاء الاصطناعي — مرة كل أسبوع
سبع قصص مهمة فعلاً هذا الأسبوع، مختارة بعناية. بلا ضجيج ولا بيانات صحفية.
تم! تحقق من بريدك للتأكيد.