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

Python Node.js 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 2.0 Flash، يتيح تنفيذ الرمز إدخال الملفات وإخراج الرسوم البيانية. باستخدام إمكانات الإدخال والإخراج الجديدة هذه، يمكنك تحميل ملفات CSV وملفات نصية وطرح أسئلة حول الملفات وإنشاء الرسوم البيانية Matplotlib كجزءٍ من الردّ.

أسعار وحدات الإدخال والإخراج

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

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

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

رموز الإخراج:

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

تفاصيل الإدخال/الإخراج

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

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

الفوترة

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

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

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

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

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

القيود

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