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