تنفيذ الرمز البرمجي

Python JavaScript Go REST

تتيح ميزة تنفيذ الرمز في Gemini API للنموذج إنشاء رمز Python وتشغيله، والتعلّم بشكل متكرر من النتائج إلى أن يصل إلى نتيجة نهائية. يمكنك استخدام إمكانية تنفيذ الرمز البرمجي هذه لإنشاء تطبيقات تستفيد من الاستنتاج المستند إلى التعليمات البرمجية وتنتج عنه مخرجات نصية. على سبيل المثال، يمكنك استخدام تنفيذ التعليمات البرمجية في تطبيق يحل المعادلات أو يعالج النصوص.

يمكن تنفيذ الرمز البرمجي في كلٍّ من AI Studio وGemini API. في AI Studio، يمكنك تفعيل "تنفيذ الرموز" في اللوحة اليسرى ضمن الأدوات. من خلال Gemini API، يمكنك تنفيذ الرموز البرمجية كأداة مشابهة لطلب الوظائف. بعد إضافة عملية تنفيذ الرمز البرمجي كأداة، يحدّد النموذج وقت استخدامها

تتضمن بيئة تنفيذ التعليمات البرمجية المكتبات التالية: altair، chess، cv2، matplotlib، mpmath، numpy، pandas، pdfminer، reportlab، seaborn، sklearn، statsmodels، striprtf، sympy، وtabulate. لا يمكنك تثبيت مكتباتك الخاصة.

قبل البدء

قبل استدعاء واجهة برمجة التطبيقات Gemini API، تأكَّد من تثبيت حزمة تطوير البرامج (SDK) المفضّلة لديك ومفتاح Gemini API تم ضبطه وأصبح جاهزًا للاستخدام.

بدء تنفيذ الرمز

الإدخال/الإخراج (I/O)

بدءًا من Gemini 2.0 Flash، سيدعم تنفيذ الرموز عمليات إدخال الملفات وإخراج الرسم البياني. وباستخدام إمكانات الإدخال والإخراج الجديدة هذه، يمكنك تحميل ملفات CSV وملفات نصية وطرح أسئلة حول الملفات وإنشاء رسومات بيانية من Matplotlib كجزء من الاستجابة.

أسعار مؤتمر I/O

عند استخدام إدخال/إخراج للرمز البرمجي، يتم تحصيل رسوم منك مقابل الرموز المميزة للإدخال والرموز المميزة للمخرجات:

الرموز المميّزة للإدخال:

• طلب من المستخدم

الرموز المميّزة للمخرجات:

• الرمز الذي ينشئه النموذج
• ناتج تنفيذ الرمز في بيئة الرمز البرمجي
• الملخّص الذي أنشأه النموذج

تفاصيل وحدات الإدخال والإخراج

عند العمل على تنفيذ الرمز البرمجي للإدخال والإخراج، يُرجى الانتباه إلى التفاصيل الفنية التالية:

• يبلغ الحدّ الأقصى لوقت تشغيل بيئة الرموز البرمجية 30 ثانية.
• إذا أدّت بيئة الرموز البرمجية إلى حدوث خطأ، قد يقرّر النموذج إعادة إنشاء ناتج الرمز. وقد يحدث هذا الإجراء بمعدّل يصل إلى 5 مرات.
• يتم تحديد الحد الأقصى لحجم إدخال الملف من خلال نافذة الرمز المميّز للنموذج. وفي AI Studio وباستخدام Gemini Flash 2.0، يبلغ الحد الأقصى لحجم ملف الإدخال مليون رمز مميّز (حوالي 2 ميغابايت للملفات النصية من أنواع الإدخال المتوافقة). إذا حمّلت ملفًا كبيرًا جدًا، لن تسمح لك أداة AI Studio بإرساله.

الفوترة

ما مِن رسوم إضافية لتفعيل تنفيذ الرموز من خلال Gemini API. سيتم تحصيل الرسوم منك المعدّل الحالي للرموز المميّزة للإدخال والإخراج استنادًا إلى نموذج Gemini الذي تستخدمه.

في ما يلي بعض المعلومات الأخرى التي يجب معرفتها عن الفوترة لتنفيذ الرمز:

• يتم تحصيل الرسوم منك مرة واحدة فقط مقابل الرموز المميزة للإدخال التي تمررها إلى النموذج، وسيتم إرسال فاتورة إليك مقابل الرموز المميزة للمخرجات النهائية التي يعيدها إليك النموذج.
• ويتم احتساب الرموز المميزة التي تمثّل الرمز الذي تم إنشاؤه كرموز مميّزة للمخرجات. يمكن أن تتضمن التعليمات البرمجية التي يتم إنشاؤها نصًا ومخرجات متعددة الوسائط مثل الصور.
• يتم أيضًا احتساب نتائج تنفيذ الرمز كرموز مميّزة للمُخرجات.

يظهر نموذج الفوترة في الرسم البياني التالي:

• يتم تحصيل الرسوم منك المعدّل الحالي للرموز المميّزة للإدخال والإخراج استنادًا إلى نموذج Gemini الذي تستخدمه.
• إذا كان Gemini يستخدم عملية تنفيذ الرمز البرمجي عند إنشاء ردّك، يتم تصنيف الطلب الأصلي والرمز الذي تم إنشاؤه ونتيجة الرمز الذي تم تنفيذه برموز مميّزة وسيطة، ويتم تحصيل رسوم منهما على أنّها رموز مميّزة للإدخال.
• ينشئ Gemini بعد ذلك ملخّصًا ويعرض الرمز الذي تم إنشاؤه، ونتيجة الرمز الذي تم تنفيذه، والملخّص النهائي. وتتم فوترتها على أنّها رموز مميّزة للإرسال.
• تشمل واجهة برمجة التطبيقات Gemini API عددًا من الرموز المميّزة المتوسطة في الردّ من واجهة برمجة التطبيقات، ما يتيح لك معرفة سبب حصولك على رموز إدخال مميّزة إضافية غير طلبك الأول.

القيود

• يمكن للنموذج إنشاء التعليمات البرمجية وتنفيذها فقط. لا يمكنها عرض عناصر أخرى مثل ملفات الوسائط.
• في بعض الحالات، قد يؤدي تفعيل تنفيذ الرموز إلى حدوث تراجع في مجالات أخرى من نتائج النموذج (مثل كتابة قصة).
• هناك بعض الاختلاف في قدرة النماذج المختلفة على استخدام تنفيذ الرموز البرمجية بنجاح.