الخلاصة
- غوغل أطلقت Tool Retrieval معاينةً في Gemini Interactions API، فيحمّل النموذج مخطط الأداة عند الحاجة بدل إرسال مكتبة الأدوات كاملة.
- تعمل الميزة مع Gemini 3.6 وما بعده وكل نماذج Gemini 4، ومع مخدّمات MCP البعيدة، ومن دون رسوم منفصلة.
- مطورو الوكلاء يستطيعون ربط مئات الأدوات بنموذج واحد دون أن تستهلك مخططاتها رموز كل طلب، فتنخفض كلفة تشغيل الوكلاء الكبار.
خبر:
أتاحت غوغل للمطورين ميزة Tool Retrieval معاينةً في Gemini Interactions API، تُبقي مخططات معاملات الأدوات خارج سياق النموذج حتى يطلبها بالاسم، فتُحمَّل وتُنفَّذ داخل الطلب نفسه. يرى النموذج اسم كل أداة مؤجلة ووصفها فقط، ويجري البحث على خوادم غوغل من دون فهرس يبنيه المطور أو يستضيفه. الميزة بلا رسوم منفصلة، وتعمل مع Gemini 3.6 وما بعده بما فيها كل نماذج Gemini 4.
تفصيل:
- آلية العمل: يضيف المطور أداة tool_search إلى الطلب ويضع defer_loading: true على الأدوات التي يريد تأجيلها. يبقى اسم الأداة ووصفها في سياق النموذج ويُحجب مخطط معاملاتها، وحين يحتاجها النموذج يطلبها بالاسم فتحمّل الواجهة المخطط الكامل ويستدعي النموذج الدالة في الطلب نفسه من دون جولة إضافية.
- تسلسل الاستجابة: في المثال المنشور يستخدم الطلب نموذج gemini-4-hydrogen مع أداة tool_search ودالة issue_refund مؤجلة التحميل، وتأتي الاستجابة بخطوات tool_search_call ثم tool_search_result ثم function_call، ويعيد تطبيق المطور نتيجة الدالة function_result. ولا يحتاج المطور إلى بناء فهرس أو استضافته، لأن Gemini يجري البحث من جهة الخادم.
- التخزين المؤقت: تعمل الميزة مع التخزين المؤقت للبادئة prefix caching: تبقى المخططات المؤجلة خارج بادئة الطلب، وتُلحق المخططات المحمّلة لاحقاً. وتصف غوغل المشكلة التي تعالجها بأن إرسال كل مخطط معاملات كامل في كل طلب يتراكم سريعاً مع نمو مكتبة الأدوات التي يملكها الوكيل.
- مخدّمات MCP: تعمل الميزة مع مخدّمات MCP البعيدة في Gemini API؛ بوضع defer_loading: true على أداة mcp_server تُحمَّل كل الأدوات التي يعرضها ذلك المخدّم عند الطلب، فيستطيع الوكيل الاتصال بمخدّمات تعرض عشرات الأدوات من دون إرسال مخططاتها كلها في كل دورة من المحادثة.
- النسخة من جهة العميل: يمكن للمطور إعلان tool_search بخاصية execution: client مع اسم ووصف ومعاملات خاصة به، فيشغّل تطبيقه عملية البحث بنفسه، وهو ما يضيف جولة اتصال واحدة لكل بحث. ولا يلزم إعلان الأدوات مسبقاً، فيمكن كشف أدوات جديدة للنموذج في منتصف المحادثة.
- النماذج والإتاحة: الميزة في مرحلة المعاينة ضمن Gemini Interactions API وحدها، وتعمل مع Gemini 3.6 والنماذج اللاحقة بما فيها كل نماذج Gemini 4. غوغل لم تحدد موعداً للإتاحة العامة ولم تذكر واجهات أخرى، ونشرت التوثيق في Google AI Studio للمطورين الراغبين في تجربتها.
- التسعير: لا رسوم منفصلة على Tool Retrieval؛ تُحاسب رموز الإدخال والإخراج بأسعار النموذج المستخدم. تفعيل tool_search يضيف كتلة ثابتة صغيرة من رموز الإدخال، وكل مخطط يحمّله النموذج يُحاسب إدخالاً لبقية المحادثة كأداة أُعلنت مسبقاً. وتقول غوغل إن الوفر يتوقف على نسبة المخططات غير المحمّلة إلى المحمّلة، وتدعو المطورين إلى قياسه على حركتهم.
- الكاتبتان: نشرت الإعلان لوسيا لوهر، مديرة منتج Gemini API، ونورا كاسنر، الباحثة في غوغل ديب مايند، في 19 نوفمبر 2026. ولم تنشر غوغل أرقاماً عن وفر الرموز أو زمن الاستجابة أو دقة اختيار الأدوات، واكتفت بوصف الوفر بأنه يتفاوت بحسب حركة كل مطور وعدد الأدوات التي يحمّلها النموذج فعلاً.
ماذا بعد؟
موعد انتقال Tool Retrieval من المعاينة إلى الإتاحة العامة في Gemini API، وما إذا كانت غوغل ستنشر أرقاماً عن وفر الرموز أو دقة اختيار الأدوات بعد قياس المطورين لها.