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