نماذج ومنصات الذكاء الاصطناعي
Google تستعرض استرجاع الأدوات عند الطلب لوكلاء Gemini API

النقاط الرئيسيةيؤجل استرجاع الأدوات المخططات الكاملة بحيث لم تعد مكتبات الأدوات الكبيرة تضخم رموز…
عرض المزيد
- يؤجل استرجاع الأدوات المخططات الكاملة بحيث لم تعد مكتبات الأدوات الكبيرة تضخم رموز الإدخال في كل طلب.
- تضيف البحث من جانب الخادم استدعاءً للنموذج بسياق كامل قد يفوق التوفير بالنسبة لمكتبات الأدوات الصغيرة.
- لا يمكن إلغاء تحميل المخططات المسترجعة ويجب إعادة إرسال مصفوفة الأدوات الكاملة في كل طلب.
أعلنت Google عن ميزة استرجاع الأدوات في 19 نوفمبر 2026، وأتاحتها في إصدار معاينة ضمن Gemini Interactions API. تتيح هذه الميزة للوكلاء إبقاء مكتبات كبيرة من الأدوات جاهزة، وتحميل مخططات المعلمات كاملةً عند الحاجة إليها للمهمة الحالية فقط.
تقول Google إن النهج التقليدي يصبح مرهقًا عندما تتصل الوكلاء بعشرات الأدوات أو مئاتها؛ إذ يؤدي إرسال كل مخطط كامل إلى تضخيم عدد رموز الإدخال، وزيادة زمن الاستجابة، وتقليل دقة اختيار الأدوات مع اتساع قائمة الخيارات. في البداية، لا تحتفظ ميزة استرجاع الأدوات في السياق إلا باسم كل أداة مؤجلة ووصفها، وتحجب المخطط الذي يحدد معاملات الدالة إلى أن يطلبه النموذج.
أصبحت واجهة Interactions API متاحة عمومًا في يونيو 2026، وهي الواجهة التي توصي بها Google للمشاريع الجديدة. تعمل ميزة استرجاع الأدوات حصريًا من خلال هذه الواجهة؛ أما الطريقة الأقدم generateContent فلا تدعمها.
الاسترجاع من جهة الخادم ومن جهة العميل
في الوضع الافتراضي من جهة الخادم، يضيف المطورون tool_search أداةً ويضبطون defer_loading: true على أدوات دوال محددة. ويمكن إبقاء الدوال المستخدمة بكثرة محمّلة بالكامل، بينما لا تُدرج في البداية من الدوال المتخصصة إلا أسماؤها وأوصافها. وعندما يحتاج النموذج إلى أداة مؤجلة، يمكن أن يتضمن استدعاء واحد لواجهة برمجة التطبيقات tool_search_call، و tool_search_result يحمل المخطط الكامل و function_call، ما يُبقي خطوات التنفيذ هذه ظاهرة لأغراض تصحيح الأخطاء. وفي حالة الدالة المخصصة، يظل الرمز البرمجي للمطور هو الذي ينفذها ويعيد function_result.
لا حاجة إلى إنشاء فهرس للاسترجاع أو استضافته؛ إذ تتولى Gemini البحث من جهة الخادم. ويؤدي ضبط defer_loading على خادم MCP بعيد إلى تأجيل كل أداة يتيحها ذلك الخادم، ولذلك لا يتطلب الخادم الكبير إدراج كل أداة على حدة. وتُدرج المخططات المسترجعة في موضع تحميلها، لا في بداية الموجّه، ما يحافظ على البادئة السابقة كما هي لإتاحة التخزين المؤقت الضمني.
ينقل الاسترجاع من جهة العميل البحث والترتيب والتصفية إلى تطبيق المطور. ويضيف دورة اتصال ذهابًا وإيابًا لكل عملية بحث، لكنه يتيح إدخال أدوات في أثناء المحادثة من دون التصريح بها مسبقًا، مثلما يحدث عندما يربط المستخدم تكاملًا جديدًا. ولا يمكن الجمع بين الاسترجاع من جهة الخادم والاسترجاع من جهة العميل ضمن الطلب نفسه، ولا يُسمح إلا بتعريف واحد tool_search من هذا النوع.
تكاليف الرموز ودعم النماذج
لا تترتب على ميزة استرجاع الأدوات رسوم منفصلة، لكنها تغيّر طريقة احتساب الرموز، ولا تلغي التكلفة الإضافية لاستخدام الأدوات. وتضيف تعليمات البحث من جهة الخادم كتلة إدخال صغيرة وثابتة إلى كل طلب؛ ويذكر دليل الإعداد أن الاختبارات الأولية أسفرت عن نحو 26 رمزًا لكل أداة مؤجلة، مقابل إدخال موجز يتضمن الاسم والوصف. ويظل كل مخطط يحمّله النموذج خاضعًا لرسوم الإدخال في الاستدعاءات والأدوار اللاحقة. كما يطلق كل بحث من جهة الخادم استدعاءً آخر للنموذج، يتضمن السياق الكامل والمخططات المحمّلة حديثًا؛ وتُحتسب الرموز المستخدمة في هذا الموجّه ضمن رموز استخدام الأدوات، وتُفرض رسومها بسعر الإدخال.
يستخدم المثال التوضيحي الصريح في الدليل، الذي يتناول طلبين، أرقامًا تقريبية مستديرة، ولا يشمل رموز الإخراج أو التخزين المؤقت. ففي حالة تضم 200 أداة، يحتوي كل منها على 400 رمز، مع تحميل أداتين، تبلغ كلفة التحميل الثابت 164,000 رمز إدخال، مقارنةً بنحو 23,650 رمزًا للإدخال واستخدام الأدوات عند الاسترجاع. أما السيناريو الثاني، الذي يضم 10 أدوات بالحجم نفسه وسياقًا من 30,000 رمز، فيبلغ مجموعه 68,000 رمز مع التحميل الثابت، ونحو 92,830 رمزًا مع الاسترجاع. ويوضح هذا السيناريو الثاني كيف يمكن لتكرار سياق كبير لأغراض البحث أن يفوق ما تحققه مكتبة أدوات صغيرة من توفير.
يسرد الدليل صراحةً Gemini 4 Argon وGemini 3.8 Flash وGemini 3.6 Flash ضمن النماذج المدعومة. أما الطلبات التي تضبط defer_loading على نموذج غير مدعوم، فتُرجع خطأ 400. ويحذر الدليل أيضًا من احتمال تغير واجهة برمجة التطبيقات في إصدار المعاينة قبل إتاحتها عمومًا.
وتظل القيود التشغيلية مهمة في جميع النماذج المدعومة. فلا يمكن إلغاء تحميل الأدوات المسترجعة في أثناء المحادثة. كما يجب إعادة إرسال مصفوفة الأدوات كاملةً مع كل طلب، بما في ذلك الأدوار المتسلسلة باستخدام previous_interaction_id، لأن تعريفات الأدوات لا تُخزّن بين الطلبات.
يوصي دليل استدعاء الدوال الأوسع نطاقًا من Google بالتفكير في استخدام الاسترجاع عندما يتجاوز عدد الأدوات في المكتبة نحو 20 إلى 30 أداة. وبذلك يتيح الإطلاق للوكلاء إبقاء قوائم أكبر بكثير من الأدوات جاهزة، فيما يصبح تكرار البحث والمخططات المحتفظ بها عاملين حاسمين في تحديد ما إذا كانت هذه الإمكانية الإضافية ستقلل استخدام الرموز أم تزيده.












