> ## Documentation Index
> Fetch the complete documentation index at: https://clickhouse.com/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# مفسر الشيفرة

> تنفيذ التعليمات البرمجية داخل بيئة معزولة في ClickHouse Agents

[ميزة Beta](https://clickhouse.com/docs/reference/settings/beta-and-experimental-features.md#beta-features)

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

## تمكين مفسر الشيفرة

في Agent Builder، فعِّل **تشغيل الشيفرة** في قسم **الإمكانات**، ثم احفظ. يحدّد الوكيل متى يشغّل الشيفرة استنادًا إلى طلب المستخدم وتعليمات الوكيل.

![قسم تشغيل الشيفرة في لوحة الإمكانات، مع تفعيل مربع اختيار تشغيل الشيفرة وظهور الزر Upload to Code Environment](https://mintcdn.com/private-7c7dfe99/i3Gw7HRb0YxPr7dq/images/cloud/agent-builder/run-code/run-code.webp?fit=max\&auto=format\&n=i3Gw7HRb0YxPr7dq\&q=85\&s=00125f4a580b82198fdd9dc20dc6d25f)

## اللغات المدعومة

البيئة المعزولة هي بيئة Unix تضم بيئتَي تشغيل للأغراض العامة وبعض أدوات الصدفة:

* **Python 3** - الخيار الافتراضي لمهام البيانات.
* **Node.js (JavaScript)** - عندما يفضّل الوكيل استخدام JS لهذه المهمة.
* **Bash** و**sh** - لكتابة نصوص الصدفة لربط الأوامر وتنفيذ عمليات الإدخال/الإخراج السريعة.
* **AWK** و**sed** - لمعالجة النصوص الموجّهة للأسطر.
* **bc** - لإجراء حسابات بدقة غير محدودة.

يلجأ الوكلاء إلى Python أولًا في كل ما يتضمن تحليل البيانات أو تحويلها أو إجراء العمليات الحسابية عليها.

> [!TIP]
>
> احصر استخدام أدوات الصدفة في المهام التي تستفيد فعلًا من أمر مختصر من سطر واحد.

## الملفات

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

## عزل البيئة المعزولة

يعمل كل تنفيذ داخل بيئة معزولة مؤقتة من دون إمكانية الوصول إلى الشبكة ومن دون تخزين دائم. ولا تشارك الجلسات الحالة — فلا تنتقل المتغيرات والملفات من تشغيل إلى آخر إلا إذا أعاد الوكيل تحميلها صراحةً.

وتُطبَّق حدود الموارد الخاصة بالخطة (الذاكرة، وعدد الملفات لكل تشغيل، وحصص الطلبات الشهرية). كما تظهر الأخطاء وstderr في المحادثة إلى جانب stdout.

## متى تستخدمه

استخدم `code interpreter` عندما تتطلب الإجابة حسابًا حتميًا لا يستطيع نموذج اللغة تقديمه بموثوقية بالاعتماد على الاستدلال وحده.
وتشمل الحالات الشائعة ما يلي:

* تحليل ملف CSV أو JSON حمّله المستخدم.
* حساب إحصاءات موجزة أو تشغيل محاكاة سريعة.
* التحويل بين التنسيقات (Parquet وJSON وCSV).
* إنشاء مخطط من نتائج الاستعلام.

> [!TIP]
>
> تجنّب استخدامه للمهام التي يستطيع النموذج الإجابة عنها بالفعل من السياق.
> إذ إن تنفيذ الشيفرة يزيد زمن الانتظار ويستهلك الحصة.
