بقلم: ليلى | محررة أدوات المطورين · صوت تحريري بإشراف بشري
Gemini المُدارة الجديدة”>أعلنت Google عن توسيع قدرات الوكلاء المُدارين في Gemini API، بإضافة أربع قدرات طال انتظارها من المطورين: التنفيذ غير المتزامن في الخلفية، والتكامل مع خوادم MCP البعيدة، واستدعاء الدوال المخصصة، وتحديث بيانات الاعتماد عبر التفاعلات. هذه التحديثات تحوّل الوكلاء من أدوات استجابة فورية إلى عمّال مستقلين يعملون داخل بيئات تطوير حقيقية دون أن يعيق عملهم بقية التطبيق.
الفكرة الأساسية خلف Managed Agents في Gemini API بسيطة وطموحة في آنٍ معاً: تستدعي endpoint واحداً، ويتولى Gemini ما تبقى — من التفكير وتنفيذ الكود وتثبيت الحزم وإدارة الملفات والبحث على الويب، كل ذلك داخل sandbox سحابي معزول. الجديد اليوم أن هذا الـ sandbox بات أقوى وأكثر مرونة من أي وقت مضى.
-
التنفيذ في الخلفية (Background Execution): الإبقاء على اتصال HTTP مفتوحاً لمدة طويلة هش وغير موثوق. الحل الجديد بسيط: مرّر
background: trueلتشغيل التفاعل بشكل غير متزامن على الخادم. تعيد الـ API فوراً معرّفاً (ID) يمكن للتطبيق استخدامه للاستعلام عن الحالة أو استقبال التقدم أو إعادة الاتصال لاحقاً بينما يكمل الوكيل مهمته عن بُعد. التوثيق الكامل لهذه الميزة متاح على موقع Google للمطورين. -
التكامل مع خوادم MCP البعيدة (Remote MCP): بدلاً من كتابة middleware وسيط للوصول إلى قواعد البيانات الخاصة أو الـ APIs الداخلية، يمكنك الآن توصيل الوكلاء المُدارين مباشرةً بخوادم Model Context Protocol البعيدة. الأمر لا يقتصر على MCP وحده — يمكنك مزج الأدوات البعيدة مع الأدوات المدمجة في الـ sandbox، فتمرّر أداة
mcp_serverإلى جانب Google Search أو تنفيذ الكود في آنٍ واحد، والوكيل يتواصل مع endpoints الخاصة بك من داخل بيئته الآمنة. -
استدعاء الدوال المخصصة (Custom Function Calling): يمكنك الآن إضافة أدوات مخصصة بجانب الأدوات المدمجة للتنفيذ المحلي. الآلية تعتمد على “step matching”: الأدوات المدمجة تعمل تلقائياً على الخادم، بينما تُحوّل الدوال المخصصة التفاعل إلى حالة
requires_actionليُنفّذ العميل منطق الأعمال الخاص به محلياً. منطق واضح وفصل نظيف بين ما يعمل على السحابة وما يبقى عندك. -
تحديث بيانات الاعتماد الشبكية (Network Credential Refresh): رموز الوصول ومفاتيح الـ API قصيرة العمر تنتهي صلاحيتها. الحل: مرّر
environment_idالحالي مع إعداد شبكة جديد في تفاعلك التالي، وستحلّ القواعد الجديدة محلّ القديمة فوراً. الأهم من ذلك أن الـ sandbox يحتفظ بحالته الكاملة — نظام الملفات والحزم المثبتة والمستودعات المستنسخة — دون أن يُعاد تهيئتها من الصفر.
من الناحية العملية، هذه التحديثات الأربع تعالج نقاط الألم الأكثر شيوعاً في بناء وكلاء الإنتاج. إذا سبق وبنيت وكيلاً استغرق دقائق في التنفيذ فوجدت نفسك أمام اتصال HTTP منقطع، أو اضطررت لكتابة proxy معقّد للوصول إلى بياناتك الداخلية، أو عانيت من انتهاء صلاحية التوكن في منتصف مهمة طويلة — فهذه التحديثات موجّهة تحديداً إليك.
للبدء، يمكن مراجعة نظرة عامة على Gemini Interactions API مع دليل البدء السريع للوكلاء المُدارين. الأمثلة المتاحة في الإعلان مكتوبة بـ JavaScript SDK عبر @google/genai، وتتوفر نظيراتها بـ Python وcURL في توثيق Antigravity agent. لمن يبني باستخدام وكلاء AI للكود، يمكن تثبيت مهارة الـ Interactions API مباشرةً عبر: npx skills add google-gemini/gemini-skills --skill gemini-interactions-api.
الإضافة الأهم هنا ليست أياً من الميزات الأربع منفردةً، بل الصورة الكاملة التي ترسمها مجتمعةً: وكيل يعمل في الخلفية، ويصل إلى بياناتك الخاصة عبر MCP، وينفّذ منطق أعمالك المحلي عند الحاجة، ويجدّد بيانات اعتماده تلقائياً — هذا وكيل جاهز للإنتاج الفعلي، لا نموذج أوليّ.
