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