تتيح ميزة تنفيذ الرمز في Gemini API للنموذج إنشاء رمز Python وتشغيله والتعلّم بشكل متكرر من النتائج إلى أن يصل إلى نتيجة نهائية. يمكنك استخدام إمكانية تنفيذ التعليمات البرمجية هذه لإنشاء تطبيقات تستفيد من الاستنتاج المستند إلى الرموز البرمجية وتنتج عنه مخرجات نصية. على سبيل المثال، يمكنك استخدام تنفيذ التعليمات البرمجية في تطبيق يحل المعادلات أو يعالج النصوص.
يمكن تنفيذ الرمز البرمجي في كلٍّ من AI Studio وGemini API. في AI Studio، يمكنك تفعيل خيار "تنفيذ الرمز" ضمن الإعدادات المتقدّمة. من خلال Gemini API، يمكنك تنفيذ الرموز البرمجية كأداة مشابهة لطلب الوظائف. بعد إضافة عملية تنفيذ الرمز البرمجي كأداة، يحدّد النموذج وقت استخدامها
بدء تنفيذ الرمز
 العرض على ai.google.dev
|
 التنفيذ في Google Colab
|
 عرض المصدر على GitHub
|
يفترض هذا القسم أنّك ثبَّت حزمة تطوير برامج Gemini وضبطت مفتاح واجهة برمجة التطبيقات، كما هو موضّح في مقالة quickstart.
تنفيذ الرمز البرمجي مقابل استدعاء الدوال
إنّ تنفيذ الرمز البرمجي واستدعاء الدوال هما ميزتان متشابهتان:
- يتيح تنفيذ الرمز للنموذج تشغيل الرمز في الواجهة الخلفية لواجهة برمجة التطبيقات في بيئة ثابتة ومعزولة.
- يتيح لك استدعاء الدوال تشغيل الدوال التي يطلبها النموذج في أي بيئة تريدها.
بشكل عام، من الأفضل استخدام ميزة "تنفيذ الرمز" إذا كان بإمكانها معالجة حالة استخدامك. إنّ عملية تنفيذ الرمز البرمجي أسهل في الاستخدام (ما عليك سوى تفعيلها) وتتم معالجتها من خلال طلب GenerateContent واحد (وبالتالي يتم تحصيل رسوم واحدة). يتطلّب استدعاء الدوال طلب GenerateContent إضافيًا لإعادة إرسال الناتج من كل استدعاء الدالة (وبالتالي يتم تحصيل رسوم متعددة).
في معظم الحالات، عليك استخدام استدعاء الدوال إذا كانت لديك دوال خاصة بك تريد تشغيلها محليًا، ويجب تنفيذ التعليمات البرمجية إذا كنت تريد من واجهة برمجة التطبيقات كتابة رمز Python وتشغيله لك وعرض النتيجة.
الفوترة
ما مِن رسوم إضافية مقابل تفعيل تنفيذ الرموز من Gemini API. سيتم تحصيل الرسوم منك بالسعر الحالي للرموز المميّزة للإدخالات والمخرجات.
في ما يلي بعض المعلومات الأخرى التي يجب معرفتها عن الفوترة لتنفيذ الرمز:
- وتتم الفوترة مرة واحدة فقط مقابل الرموز المميزة للإدخال التي تمررها إلى النموذج، ويتم تحصيل الرسوم منك مقابل الرموز المميزة للمخرجات النهائية التي يعيدها إليك النموذج.
- ويتم احتساب الرموز المميزة التي تمثّل الرمز الذي تم إنشاؤه كرموز مميّزة للمخرجات.
- يتم احتساب نتائج تنفيذ الرمز البرمجي أيضًا كرموز مميّزة للمخرجات.
القيود
- لا يمكن للنموذج سوى إنشاء التعليمات البرمجية وتنفيذها. لا يمكنها عرض عناصر أخرى مثل ملفات الوسائط.
- لا تتيح الميزة إدخال/إخراج الملف أو حالات الاستخدام التي تتضمن إخراجًا غير نصي (مثل مخططات البيانات).
- يمكن تنفيذ الرمز البرمجي لمدة 30 ثانية كحد أقصى قبل انتهاء المهلة.
- في بعض الحالات، قد يؤدي تفعيل تنفيذ الرموز إلى حدوث تراجع في مجالات أخرى من نتائج النموذج (مثل كتابة قصة).
- هناك بعض الاختلاف في قدرة النماذج المختلفة على استخدام تنفيذ الرموز البرمجية بنجاح. واستنادًا إلى اختباراتنا، فإنّ نموذج Gemini 1.5 Pro هو النموذج الأفضل أداءً من حيث الأداء.