استخدم أداة code_interpreter
نصيحة
راجع علامة التبويب النص والصور لمزيد من التفاصيل!
توفر أداة code_interpreter لنموذجك وقت تشغيل بايثون يمكنه من خلاله توليد وتشغيل كود بايثون.
ما هي الأداة code_interpreter؟
تتيح أداة code_interpreter لنماذج الذكاء الاصطناعي التوليدي كتابة وتشغيل كود بايثون بشكل ديناميكي أثناء المحادثة. بدلا من مجرد مناقشة الكود أو الخوارزميات، يمكن للنموذج اختبار منطقه، ومعالجة البيانات، وإعادة النتائج الفعلية من الكود. هذا يحول النموذج من مفكر إلى فاعل.
تتضمن الميزات الرئيسية:
- التنفيذ الديناميكي باستخدام بايثون: يكتب النموذج ويشغل كود بايثون في بيئة مفتوحة
- التعامل مع الملفات: رفع، معالجة، وتنزيل الملفات (CSV، JSON، الصور، وهكذا)
- تحليل البيانات: إجراء الحسابات، والتحليل الإحصائي، وتحويلات البيانات أثناء اللعب
- التغذية الراجعة في الوقت الحقيقي: يرى النموذج نتائج تنفيذ الكود ويمكنه التكرار أو تصحيح الأخطاء
- حل المشكلات المعقدة: حل مسائل رياضية، محاكاة، وألغاز منطقية من خلال الشيفرة التنفيذية
حالات الاستخدام الشائعة
| حالة الاستخدام | مثال |
|---|---|
| تحليل البيانات | تحليل ملف CSV وتوليد إحصائيات ملخصة |
| الرياضيات والفيزياء | حل المعادلات التفاضلية أو محاكاة سيناريوهات الفيزياء |
| تحويل الملفات | التحويل بين صيغ البيانات (JSON ↔، CSV، وهكذا) |
| النمذجة الأولية | اختبار الخوارزميات والأفكار قبل التنفيذ الرسمي |
مثال بسيط
إليك كيفية استخدام code_interpreter مع واجهة برمجة تطبيقات OpenAI Responses:
from openai import OpenAI
client = OpenAI(
base_url={openai_endpoint},
api_key={auth_key_or_token}
)
# Get response using the code_interpreter tool
response = client.responses.create(
model={model_deployment},
instructions="You are an AI assistant that provides information. Use the python tool to run code for math problems.",
input="What is the square root of 16?",
tools=[{"type": "code_interpreter",
"container": {"type": "auto"}}]
)
print(response.output_text)
الناتج من هذا الكود مشابه لهذا:
The square root of 16 is 4.
والأهم من ذلك، أن فحص تفاصيل كائن الاستجابة الذي يعيده النموذج يكشف أن النتيجة تم حسابها وإعادتها إلى النموذج باستخدام كود بايثون المولد ديناميكيا مثل هذا:
import math
# Calculate the square root of 16
square_root = math.sqrt(16)
square_root
كيف تعمل أداة code_interpreter
العملية العامة لاستخدام أداة code_interpreter هي:
- ترسل طلبا: أدرج code_interpreter في مصفوفة أدواتك الخاصة بك.
- يحلل النموذج المهمة: يحدد النموذج ما إذا كان تنفيذ الكود مطلوبا.
- النموذج يولد الكود: يكتب النموذج كود بايثون لإنجاز المهمة.
- تشغيل الكود: يعمل الكود في بيئة مفتوحة مع إمكانية الوصول إلى مكتبات مشتركة (مثل pandas، numpy، وmath).
- النتائج العائدة: يستقبل النموذج الناتج ويدمجه في استجابته.
أفضل الممارسات
- كن محددا: صف تنسيق البيانات والمخرج المتوقع بوضوح. العديد من النماذج داخليا تستخدم اسم أداة بايثون لتحديد أداة code_interpreter - لذا استخدم هذه اللغة في تعليماتك.
- وفر السياق: أدرج المعرفة ذات الصلة في الموضوعات
- التحقق من صحة النتائج: دائما راجع الشيفرة التي تم إنشاؤها بواسطة الذكاء الاصطناعي للتأكد من صحتها قبل استخدامها في الإنتاج
- مراقبة التكاليف: تنفيذ الشيفرة يضيف رموزا؛ قد تتطلب العمليات المعقدة موارد أكثر
- الاستفادة من المكتبات: الحزم الشائعة مثل pandas وnumpy وmatplotlib مثبتة مسبقا
- التعامل مع الأخطاء: يمكن للنموذج رؤية الأخطاء ويحاول إصلاحها تلقائيا
القيود التي يجب معرفتها
- التنفيذات تعمل في بيئة مفتوحة بدون وصول خارجي للشبكة
- قد لا تتوفر بعض المكتبات؛ أخبر النموذج إذا فشلت مكتبة قياسية
- تنطبق حدود انتهاء الوقت على العمليات طويلة الأمد
- يعمل الكود مع قيود الذاكرة—قد تحتاج مجموعات البيانات الضخمة إلى البث أو التقسيم