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