واجهة برمجة تطبيقات Gemini Interactions: دليل الوكلاء لعام 2026

لقد غيرت Google للتو طريقة بناء وكلاء الذكاء الاصطناعي.

وصلت Interactions API إلى مرحلة التوفر العام في 23 يونيو 2026. هذا ليس مجرد تحديث بسيط، بل هو تحول كامل في طريقة عمل Gemini.

إذا كنت تستخدم نقطة نهاية GenerateContent القديمة، فمن المرجح أن بنيتك البرمجية أصبحت قديمة.

الطريقة القديمة:

  • تستخدم واجهة برمجة تطبيقات عديمة الحالة (stateless API).
  • تعيد إرسال سجل الدردشة بالكامل في كل دورة.
  • يتحمل تطبيقك العبء الكامل للذاكرة.
  • تزداد تكاليف الرموز (tokens) كلما طالت المحادثة.

الطريقة الجديدة:

  • الحالة (state) تُحفظ على الخادم.
  • تشير فقط إلى معرف الجلسة (session ID).
  • يتذكر Gemini السجل والأدوات والنتائج.
  • ترسل فقط الجزء الجديد من المحادثة.

التأثير على ميزانيتك هائل. في اختباراتنا باستخدام مسار RAG، أدى الانتقال إلى الحالة المدارة من جانب الخادم (server-side state) إلى خفض الإنفاق على رموز الإدخال (input tokens) بنسبة 34% عبر 10,000 جلسة يومية. وفي اختبار مكون من 10 أدوار، لاحظنا انخفاضاً في رموز الإدخال بنسبة تصل إلى 82%.

ما الجديد في هذا الإصدار؟

• الوكلاء المدارون (Managed Agents): توفر Google بيئة Linux sandbox عن بُعد. يمكن لوكيلك تشغيل الكود، والبحث في الويب، وإدارة الملفات دون الحاجة لإدارة أي خوادم بنفسك. • التنفيذ في الخلفية (Background Execution): استخدم background=True للمهام الطويلة. لم تعد بحاجة للإبقاء على اتصال مفتوح ومواجهة مشكلات انتهاء المهلة (timeouts). • دعم MCP: واجهة برمجة التطبيقات متوافقة مع بروتوكول سياق النموذج (Model Context Protocol). يمكنك دمج أدوات Google مع أدواتك المخصصة بسهولة.

متى يجب عليك الانتقال؟

لا تنقل كل شيء.

استخدم GenerateContent إذا:

  • كنت بحاجة إلى مهام بسيطة من خطوة واحدة (one-shot).
  • كنت تقوم بعمليات تصنيف أو تلخيص أساسية.
  • لم تكن بحاجة إلى ذاكرة.

استخدم Interactions API إذا:

  • كان لديك 3 استدعاءات للأدوات أو أكثر.
  • كنت بحاجة إلى حالة محادثة مستمرة.
  • كنت تقوم بتشغيل وظائف خلفية طويلة.

تحذير واحد: الحالة المدارة من جانب الخادم تؤدي إلى الارتباط بالمورد (vendor lock-in). إذا كان سجلك محفوظاً في سحابة Google، فسيكون من الصعب المغادرة. قم ببناء مسار تصدير إلى قاعدة بياناتك الخاصة منذ اليوم الأول.

إن عصر الذكاء الاصطناعي عديم الحالة (stateless AI) يقترب من نهايته. لقد حان الوقت لبناء وكلاء يقومون بالفعل بالعمل.

المصدر: https://blog.google/innovation-and-ai/technology/developers-tools/interactions-api-general-availability/

مجتمع تعليمي اختياري: https://t.me/GyaanSetuAi