# وثائق إضافة ⁦Pize⁩

> ⁦Pize⁩ هو مساعد برمجة بالذكاء الاصطناعي للحوسبة العلمية والتحليل الإحصائي. يعمل ضمن ⁦Pize Code⁩ و⁦Positron⁩، ويتوفر أيضًا بصفته ⁦SDK.⁩

⁦Pize⁩ مساعد برمجي بالذكاء الاصطناعي للحوسبة العلمية والتحليل الإحصائي. يعمل في ⁦Pize Code⁩ و⁦Positron⁩، ويتوافر أيضًا في صورة ⁦SDK.⁩ ويركّز جهده على المرحلة الأكثر عرضة للخطأ والأكثر إهمالًا: التعرّف على البيانات الإحصائية وقراءتها. لا يمكن أن تصح الحسابات والاختبارات والاستدلالات اللاحقة إلا بعد فهم البيانات فهمًا صحيحًا.

## ما الذي يفعله ⁦Pize⁩، وما الذي لا يفعله

يركّز معظم وكلاء البرمجة على كتابة مزيد من الشيفرات. لكن الأخطاء في الإحصاء والبحث تحدث عادةً في مرحلة أبكر: إذا قُرئت البيانات بصورة خاطئة، فإن كل اختبار ونموذج واستدلال لاحق يرث هذا الخطأ من دون أن يلفت الانتباه. يركّز ⁦Pize⁩ جهده هنا؛ إذ يجعل النموذج أولًا يفهم شكل البيانات وأنواعها وقيمها المفقودة بدقة، ثم يكتب الشيفرة ويشغّلها ويقرأ الرسوم البيانية ويصحح النتائج داخل جلسة ⁦R / Python⁩ التي تستخدمها بالفعل.

وهو أيضًا وكيل برمجي متكامل يوفّر التعديل عبر ملفات متعددة، والطرفية، والتخطيط والتنفيذ، وقواعد المشروع، واختيار النماذج، والاتصال عبر ⁦MCP⁩ بالأدوات الموجودة أصلًا في المختبر أو النظام الداخلي. استخدمه في ⁦Pize Code⁩ و⁦Positron⁩ ومن خلال ⁦CLI⁩ أو ⁦SDK.⁩

- **ما هو.** وكيل برمجي محسّن للحوسبة الرياضية والتحليل الإحصائي. تتم قراءة البيانات والحساب والاختبار داخل جلسة فعلية، ويمكن إعادة حساب النتائج.
- **ما لا يمثله.** ليس واجهة جديدة لأداة عامة لإكمال الشيفرة، ولا بديلًا عن ⁦Cursor⁩ يكتب قليلًا من كل شيء. لا ينصبّ التركيز على إكمال الشيفرة، بل على قراءة البيانات بصورة صحيحة وضبط الحسابات.
- **أين يعمل.** ضمن ⁦Pize Code⁩ و⁦Positron⁩ ومن خلال ⁦CLI⁩ و⁦SDK.⁩
- **ما الذي يحصل عليه النموذج.** البنية والأنواع والقيم المفقودة والملخصات، لا الجدول بأكمله محشوًا في السياق. تبقى المشاهدات الأولية داخل الجلسة.

### ثلاثة مداخل، ووكيل واحد

يظهر في المحرر كإضافة في الشريط الجانبي، وفي أدواتك كـ ⁦SDK.⁩ ويستخدم ⁦MCP⁩ للوصول إلى قاعدة بيانات أو برنامج جهاز أو قاعدة معرفة داخلية. وتستدعي المداخل الثلاثة منطق القراءة نفسه، والحساب نفسه، وحدود الموافقة نفسها.

## أين يعمل ⁦Pize⁩، وكيف تُدفع تكلفة استخدام النماذج، ومن يوافق على الإجراءات

يقرأ وكيل البرمجة نفسه الملفات ويكتب الشفرة وينفّذ الأوامر ويمكنه التحكم في المتصفح. وتتطلب كل عملية كتابة وكل أمر موافقتك. يمكنك استخدامه في ⁦Pize Code⁩ و⁦Positron⁩ و⁦CLI⁩ أو عبر ⁦SDK.⁩

### واجهات الاستخدام المتاحة الآن

- **⁦Pize Code.⁩** إضافة في الشريط الجانبي للمحرر، تتيح التحرير عبر ملفات متعددة والطرفية ووضعَي التخطيط والتنفيذ وعمليات ⁦diff⁩ قابلة للمراجعة.
- **⁦Positron.⁩** الوكيل نفسه، مع جسر إلى جلسة ⁦R⁩ أو ⁦Python⁩ التي تركز عليها حاليًا.
- **⁦SDK.⁩** الوكيل نفسه مضمَّن في برنامج تستخدمه بالفعل ومتاح عبر واجهة ⁦CLI.⁩

### كيفية دفع تكلفة استخدام النماذج

يُدفع مقابل استخدام الخدمة الذاتية بأرصدة مدفوعة مسبقًا. يساوي الرصيد الواحد سنتًا أمريكيًا واحدًا. اشترِ باقة من صفحة الأسعار؛ ⁦Stripe⁩ يتولى تحصيل المبلغ. وتُرتَّب شروط المؤسسات بعد التواصل.

### المؤسسات

لا يوجد سعر منشور للمختبرات أو الشروط المخصصة، بل تُرتَّب بعد التواصل.

### وهو في الوقت نفسه وكيل برمجة مكتمل

قراءة البيانات وجسر الجلسة هما الطبقة الإضافية التي يقدمها ⁦Pize.⁩ وما يلي هو إمكانات الوكيل البرمجي المتكامل التي يوفرها أيضًا؛ ومن دونها لا تكتمل دورة العمل الإحصائية.

- **تحرير عبر الملفات ومراجعة الفروقات** تعديلات منسّقة عبر الملفات. كل تحرير فرق قابل للمراجعة والإلغاء، ويمكن إرجاع المهمة كلها.
- **تنفيذ الطرفية والخرج الحي** تشغيل أوامر في الطرفية المدمجة وقراءة الخرج فورًا. تُلتقط الأخطاء وإخفاقات الاختبار في الحال.
- **وضعا التخطيط / التنفيذ** افحص البيانات والشفرة أولًا واتفق على خطة التحليل قبل التنفيذ، حتى لا يُشغَّل نموذج إحصائي غير مناسب من المحاولة الأولى.
- **إحالات السياق وتصحيح المتصفح** غذِّ السياق بدقة بـ ⁦@file⁩ و⁦@folder⁩ و⁦@problems⁩ و⁦@url.⁩ يمكنه أيضًا قيادة المتصفح والتقاط الشاشة وقراءة السجلات.
- **قواعد المشروع والمهارات** اكتب التعاريف الإحصائية واتفاقيات الرسوم وقواعد المجلدات في ملف قواعد ليلتزم بها كل فرد في الفريق.
- **اختيار النموذج و⁦MCP⁩** يمكن توصيل ⁦Anthropic⁩ و⁦OpenAI⁩ و⁦Gemini⁩ و⁦DeepSeek⁩ و⁦Bedrock⁩ و⁦OpenRouter⁩ والنماذج المحلية، والوصول إلى قواعد البيانات عبر ⁦MCP.⁩

## ⁦SDK⁩ حزمة يستطيع برنامج آخر استدعاءها، وليست موقعًا آخر

تجمع ⁦SDK⁩ (⁦Software Development Kit⁩، حزمة تطوير البرمجيات) واجهات ⁦API⁩ والأنواع والأمثلة، كي يستطيع برنامج آخر استدعاء إمكاناتك من دون إعادة تنفيذها.

من دون ⁦SDK⁩، تكتب كل عملية تكامل استدعاءات ⁦HTTP⁩ الخاصة بها وتخمّن الحقول. أما معها، فيحصل البرنامج المستدعي على أسماء دوال مستقرة وأنواع ومثال يعمل فعليًا. وهذه هي الطبقة التي تتيح تضمين نموذج في برنامج جمع البيانات في المختبر أو في منصة تحليل داخلية.

- **ما الذي توفره.** واجهات قابلة للاستدعاء، وأنواعًا، وأصغر مثال يعمل. ولا يحتاج البرنامج المستدعي إلى إعادة ابتكار قراءة البيانات أو الجلسة.
- **ما الذي لا توفره.** لا تستبدل واجهة منتجك، ولا تختار المنهج الإحصائي. يظل اختيار المنهج صادرًا عن النموذج وخاضعًا لموافقتك.
- **كيف تختلف عن الإضافة.** تُفتح الإضافة داخل المحرر، بينما تدمج ⁦SDK⁩ الوكيل نفسه في برنامج تستخدمه بالفعل، من دون شريط جانبي آخر.

### ما الذي توفره ⁦Pize SDK⁩

يجمع ⁦Pize⁩ قراءة البيانات وجسر الجلسة والوكيل البرمجي في حزمة قابلة للتضمين. ولا تحتاج أداة مختبرية أو برنامج داخلي إلى نافذة محرر أخرى كي يحسب النموذج باستخدام بيانات حقيقية ويجري تغييرات بعد موافقتك.

## ⁦MCP⁩ موصل، وليس نموذجًا آخر

⁦MCP⁩ (⁦Model Context Protocol⁩، بروتوكول سياق النموذج) بروتوكول مفتوح يتيح للنموذج الوصول أثناء التشغيل إلى أدوات وبيانات وموجّهات خارجية، من دون إنشاء وصلة خاصة لكل مصدر.

يقتصر دور النموذج على الاستدلال. فهو لا يستطيع رؤية قاعدة بياناتك أو التعامل مع المعلمات داخل برنامج الجهاز. يعرّف ⁦MCP⁩ ثلاثة عناصر: الأدوات (إجراءات يمكن استدعاؤها)، والموارد (بيانات يمكن قراءتها)، والموجّهات (تعليمات يمكن إعادة استخدامها). ويمكن للنموذج استخدام أي نظام يطبّق هذا العقد بالطريقة نفسها.

- **المشكلة التي يحلها.** لم يعد على النموذج والنظام الخارجي ابتكار وصلة خاصة لكل منهما. ويمكن الوصول إلى قواعد البيانات وقواعد المعرفة والبوابات الداخلية عبر بروتوكول واحد.
- **ما لا يمثله.** ليس نموذجًا ولا ⁦SDK.⁩ وهو لا يحدد طريقة تضمين الوكيل في برنامجك، بل يحدد فقط كيفية اتصال الوكيل قيد التشغيل بالأنظمة الخارجية.
- **داخل ⁦Pize.⁩** يعمل ⁦Pize⁩ كعميل يتصل بخوادم ⁦MCP⁩ أخرى. وتبقى موافقتك هي حدود الأمان: القراءة فقط هي الوضع الافتراضي، وتنتظر الإجراءات موافقتك.

### لا تخلط بين ⁦MCP⁩ و⁦SDK⁩

تجيب ⁦SDK⁩ عن سؤال «كيف أضمّن ⁦Pize⁩ في برنامجي؟»، بينما يجيب ⁦MCP⁩ عن سؤال «كيف يصل الوكيل قيد التشغيل إلى الأدوات والبيانات الموجودة لدي؟». الأولى للتضمين، والثاني للاتصال بالأنظمة الخارجية.

## النموذج يستدل، و⁦SDK⁩ تضمّن، و⁦MCP⁩ يتيح الوصول

لكي يصل نظام ذكاء اصطناعي إلى أرقام صحيحة في البحث، نادرًا ما يكون العنصر المفقود هو «نموذج أكبر». المهم هو قدرة النموذج على رؤية بيانات حقيقية، وتشغيل أدوات حقيقية، والعمل داخل البرنامج الذي تستخدمه بالفعل.

يفصل ⁦Pize⁩ بين هذه الطبقات الثلاث ويربطها في الوقت نفسه. يختار النموذج منهجًا ويكتب الشيفرة، وتضع ⁦SDK⁩ الوكيل داخل أدواتك، ويتيح ⁦MCP⁩ له الوصول أثناء التشغيل إلى المكتبات وبرامج الأجهزة والأنظمة الداخلية. وتظل قراءة البيانات أولًا: إذا كانت البيانات خاطئة، فلن تفعل الطبقتان الأخريان سوى نقل الخطأ إلى مدى أبعد.

| الطبقة | دورها | في ⁦Pize⁩ |
| --- | --- | --- |
| النموذج | الاستدلال واختيار المنهج وكتابة الشيفرة | أي نموذج من مزوّد توصله، أو نموذج محلي |
| ⁦SDK⁩ | تضمين الوكيل في برنامج موجود | القراءة والحساب والموافقة نفسها المتاحة في إضافة المحرر |
| ⁦MCP⁩ | الوصول إلى أدوات وبيانات خارجية أثناء التشغيل | يعمل كعميل؛ للقراءة فقط افتراضيًا؛ وتنتظر الإجراءات موافقتك |

لا يتغير الترتيب: اقرأ البيانات بصورة صحيحة، ثم ضمّن الوكيل، ثم صِله بالأنظمة الخارجية. وإذا عُكس ترتيب أي طبقة، فلا يمكن الوثوق بالأرقام التي تليها.

## لماذا «القراءة الصحيحة» شرط القدرة الإحصائية

قلّما تظهر الأخطاء الإحصائية على هيئة تعطّل. ففاصل حقول خاطئ يزيح الأعمدة كلها، واعتبار الصف الأول رأسًا يحذف أول مشاهدة، ومعاملة ⁦NA⁩ و⁦NULL⁩ على أنهما ⁦0⁩ تغيّر المتوسط والتباين، وقراءة عمود رقمي على أنه نص تجعل نموذج الانحدار يعامله على أنه عامل فئوي. لا يوقف أي من ذلك البرنامج؛ بل يعيد رقمًا خاطئًا يبدو معقولًا. ولأن الخطأ وقع عند القراءة، ترثه كل الاختبارات والنماذج والاستدلالات اللاحقة.

لذلك لا يهدف ⁦Pize⁩ إلى جعل النموذج يكتب مزيدًا من الشفرة. بل يجعله يعرف أولًا شكل البيانات، ونوع كل عمود، وعدد القيم المفقودة، والعدد التقريبي للصفوف؛ ثم يكتب شفرة الحساب والنمذجة ويشغّلها في جلستك الفعلية كي ترى النتائج.

## التعرّف على البيانات الإحصائية وقراءتها

يُحدَّد التنسيق من محتوى الملف لا من امتداده؛ ففي بيانات البحث كثيرًا ما يحتوي ملف ⁦.txt⁩ على جدول، بينما قد لا يحتوي ملف ⁦.csv⁩ إلا على ثلاثة أسطر إعداد. وكل قرار أدناه يؤثر مباشرة في النتائج اللاحقة.

- **تعيين فاصل الحقول.** يُختار الفاصل من علامة الجدولة أو الفاصلة أو الفاصلة المنقوطة أو علامة الأنبوب (|). ويجب أن يظل عدد الأعمدة ثابتًا بين الصفوف وأن تبدو الحقول كخلايا، حتى لا يُفسَّر نص نثري يحتوي كل جملة فيه على فاصلة على أنه جدول من عمودين.
- **رأس أم بيانات.** إن بقي الصف الأول أرقامًا في مواضع الأعمدة الرقمية فهو مشاهدة لا اسم عمود — ابتلاع أول مشاهدة رأسًا هو السبب الكلاسيكي لنقص العينة بواحد.
- **تُستبعد القيم المفقودة من استنتاج النوع.** تُعرَف السلاسل الفارغة و⁦NA⁩ و⁦NaN⁩ و⁦NULL⁩ كلٌّ على حدة؛ وإلا فقد يُصنَّف عمود فارغ بالكامل على أنه رقمي، فيلخّص النموذج أرقامًا غير موجودة.
- **استنتاج النوع عمودًا بعمود.** رقمي / نص / فارغ لكل عمود. هذه الخطوة تقرّر إن كان العمود يدخل متوسطًا أو تباينًا أو انحدارًا.
- **نزع التعليقات والبيانات الوصفية.** تُنزع أولًا الكتل البادئة بـ # أو ! أو ⁦@XX.⁩ يخفي ⁦VCF⁩ أسماء الأعمدة في آخر سطر تعليق؛ تُستعاد تلك الأسماء فتصير للأعمدة أسماء.
- **قراءة الجداول المضغوطة بشفافية.** يُفك ⁦.gz⁩ تلقائيًا، ويُحكم الحجم بعد الفك — قد يحمل أرشيف ⁦1⁩ ميغابايت جدولًا من ⁦20⁩ ميغابايت.
- **تقدير عدد الصفوف.** يُقدَّر المجموع من نسبة بايتات البادئة المقروءة، ويُعلَّم أنه تقدير فلا يُبلَّغ حقيقة.
- **يحصل الملف المتجاوز للميزانية على بطاقة بيانات لا رسالة خطأ.** عند تجاوز ميزانية السياق، يعيد ⁦Pize⁩ الحجم وفاصل الحقول وعدد الصفوف المقدّر وأسماء الأعمدة وأنواعها المستنتجة وأول صفين. ويكتب النموذج من هذه البطاقة شفرة القراءة الصحيحة من دون أن يستهلك جدول من مليون صف السياق كله.

### حاويات ثنائية شائعة في الإحصاء والبحث

غالبًا ما تكون البيانات الإحصائية في حاويات ثنائية لا في نص عادي. عند إرفاق ⁦Parquet⁩ أو ⁦Feather⁩ أو ⁦Arrow⁩ أو ⁦RDS⁩ أو ⁦RData⁩ أو ⁦h5ad⁩ أو ⁦Loom⁩ أو ⁦HDF5⁩ أو ⁦NumPy⁩ أو ⁦SPSS (.sav)⁩ أو ⁦Stata (.dta)⁩ أو ⁦SQLite⁩ أو ⁦DuckDB⁩، لا يكتفي ⁦Pize⁩ بالرد بأنه لا يستطيع قراءة ملف ثنائي؛ بل يذكر اسم التنسيق وطريقة فتحه، مثل ⁦readRDS⁩ أو ⁦anndata.read_h5ad⁩، ليكتب النموذج شفرة القراءة الصحيحة. أما ⁦PDF⁩ و⁦DOCX⁩ و⁦XLSX⁩ ودفاتر ⁦Notebook⁩ فتمر باستخراج النص ويمكن قراءتها بالطريقة نفسها.

## احسب على بيانات حقيقية لا على تخمين

تأتي القراءة أولًا ثم الحساب. لا يخترع ⁦Pize⁩ طرائق إحصائية بدلًا منك؛ بل يضمن أن يعمل النموذج على بياناتك الحقيقية وأن تتمكن من رؤية كل خطوة.

- **اختر الطريقة بناءً على التوزيع الحقيقي.** يحصل النموذج على أعداد الصفوف والأعمدة والأنواع وأعداد القيم المفقودة والإحصاءات الملخصة، ويستخدمها للاختيار بين طريقة معلمية وغير معلمية، وتحديد الحاجة إلى تحويل البيانات، وكيفية معالجة القيم المفقودة.
- **اكتب ثم شغّل.** يعمل ⁦R⁩ أو ⁦Python⁩ المولَّد في الجلسة الحالية بعد تأكيدك. ما يعود خرج حقيقي لا تخيّل النموذج للنتيجة.
- **شخّص من الرسوم.** يمكن جلب آخر رسم — رسوم ⁦QQ⁩ والبواقي والتوزيع مما لا يُحكم إلا بالنظر. يشارك النموذج في ذلك الحكم.
- **حلقة مغلقة.** تنفيذ وقراءة وتصحيح في الجلسة نفسها. لا تضيع المتغيرات الوسيطة لأن عملية جديدة بدأت.
- **تجميعات فقط، لا صفوف خام.** ملخص الجدول يعيد البنية والإحصاءات. المشاهدات الخام تبقى في الجلسة.

## جسر وقت تشغيل ⁦Positron⁩

حقيقة التحليل ليست في الملف بل في الذاكرة. يقرأ الجسر عبر واجهة إضافة ⁦Positron⁩ العلنية جلسة ⁦R⁩ أو ⁦Python⁩ التي في المقدّمة. لا ينشئ وقت تشغيل ولا يبدّله. يستخدم فقط ما تستخدمه أصلًا.

### قراءة وتلخيص وتنفيذ وجلب الرسوم

| الأداة | الدور | مستوى الموافقة |
| --- | --- | --- |
| ⁦`get_session_context`⁩ | قراءة لغة الجلسة وحالتها وقائمة المتغيرات (بيانات وصفية فقط) | فئة قراءة |
| ⁦`inspect_variables`⁩ | عرض بنية المتغير ومعاينة مقصوصة بالاسم | فئة قراءة |
| ⁦`summarize_table`⁩ | أعداد الصفوف والأعمدة والأنواع وأعداد القيم المفقودة وملخصات إطار البيانات | فئة قراءة |
| ⁦`execute_code`⁩ | بعد تأكيدك، تنفيذ شفرة إحصائية في الجلسة الحالية | فئة أوامر، مغلقة افتراضيًا |
| ⁦`get_current_plot`⁩ | جلب آخر رسم لينظر إليه النموذج | فئة أوامر، مغلقة افتراضيًا |

حدّ الأمان جزء من التصميم: يعيد كل استدعاء التحقق من أن الجلسة ما زالت في المقدمة، ويُرفض إن انتقلت إلى غيرها. توجد حدود صارمة لحجم الخرج وعدد المتغيرات وطول المعاينة وحجم الصورة؛ ولا تُعاد صفوف البيانات الخام ولا سجل وحدة التحكم ولا الأسرار. في ⁦Pize Code⁩ العادي تختفي هذه الأدوات الخمس تلقائيًا.

### المرفقات مأخوذة من المخزن المؤقت للمحرّر

تقرأ شرائح المرفقات أسفل حقل الإدخال المخزن المؤقت للمحرّر، لا النسخة القديمة من الملف على القرص. لذلك يرى النموذج النص البرمجي أو البيانات التي عدّلتها للتو ولم تحفظها بعد. وتُزال المرفقات ذات المحتوى المكرر باستخدام البصمة ⁦hash.⁩

## منطق القراءة مُتحقَّق منه، لا مصدَّق فحسب

- **اختبارات بمدخلات مولَّدة لمنع عودة الأخطاء.** تُولَّد عينات معلَّمة لواحد وثلاثين شكلًا من أشكال الملفات، بواقع عشرة آلاف عينة في كل دفعة، ثم تمر عبر الكاشف. فشلت الجولة الأولى في ⁦458⁩ حالة وكشفت أربع فئات من العيوب أُصلحت واحدة تلو الأخرى. وتبقى البذرة العشوائية ثابتة، بحيث يمكن استخدام المدخلات نفسها للتحقق من أن الأخطاء المصححة لا تعود.
- **اختبارات إنذار مبكر عند كل نقطة ربط.** لكل نقطة ربط مع شفرة ⁦upstream⁩ اختبار. فإذا أسقط الدمج سطر توصيل واحدًا، يفشل الاختبار فورًا؛ ولا يمكن أن تتعطل الميزة في صمت بينما تظل مجموعة الاختبارات ناجحة.
- **قائمة التحقق كاملة عند كل دمج.** تُشغَّل آلاف اختبارات الوحدة ومدققان للأنواع و⁦lint⁩ على المستودع كله؛ وبعد إنشاء الحزمة تُفك للتحقق من أن السلوك المطلوب موجود فعلًا في الناتج.
- **فحص ذاتي بنقرة.** فحص الجسر في لوحة الأوامر يقرأ جلسة حقًا. النجاح يعني أن الأدوات بلغت بيانات حقيقية.
- **يتعايش مع الإصدار الرسمي.** يُنشر بمعرّف إضافة مستقل، فيُثبَّت إلى جانب إضافة المصدر دون أن يغطيها.

تسري في البنية قاعدة واحدة: يُكتب السلوك الجديد دائمًا في ملفات جديدة، ولا تُعدَّل ملفات ⁦upstream⁩ إلا عند نقاط الاستدعاء الضرورية. لذلك قد يقتصر التعارض عند دمج عشرة ⁦commits⁩ من ⁦upstream⁩ على سطر واحد، ما يتيح للمشروع مواصلة متابعة ⁦upstream⁩ بدلًا من إصدار نسخة واحدة ثم التوقف.

## أجب أولًا عن هذه الأسئلة السبعة

### ما هو ⁦Pize⁩؟

⁦Pize⁩ هو مساعد برمجة بالذكاء الاصطناعي للحوسبة العلمية والتحليل الإحصائي. يعمل ضمن ⁦Pize Code⁩ و⁦Positron⁩، ويتوفر أيضًا بصفته ⁦SDK.⁩

### ما هي ⁦SDK⁩، وهل يوفر ⁦Pize⁩ واحدة؟

⁦SDK⁩ هي مجموعة من الواجهات القابلة للاستدعاء والأنواع والأمثلة، تُستخدم لتضمين إمكانات في برنامج آخر. ويوفر ⁦Pize⁩ حزمة ⁦SDK⁩ تتيح القراءة نفسها والوكيل نفسه، لا داخل المحرر فقط.

### ما هو ⁦MCP⁩، وهل يدعمه ⁦Pize⁩؟

⁦MCP⁩ بروتوكول مفتوح يتيح للنموذج الوصول إلى أدوات وبيانات خارجية. يعمل ⁦Pize⁩ كعميل لخوادم ⁦MCP⁩، ويمكنه من خلالها الوصول إلى قواعد البيانات والبوابات الداخلية. الوضع الافتراضي هو القراءة فقط.

### كيف تعمل ⁦Pize SDK⁩ و⁦MCP⁩ مع نموذج ذكاء اصطناعي؟

يستدل النموذج، وتضمّن ⁦SDK⁩ الوكيل في منتجك، ويتيح ⁦MCP⁩ للوكيل الوصول أثناء التشغيل إلى أدوات وبيانات حقيقية. يجمع ⁦Pize⁩ الطبقات الثلاث ويضع قراءة البيانات قبلها.

### أين يعمل ⁦Pize⁩؟

ضمن ⁦Pize Code⁩ و⁦Positron⁩ ومن خلال ⁦CLI⁩ و⁦SDK.⁩

### هل ⁦Pize⁩ بديل عن ⁦Cursor⁩؟

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

### ما البيانات التي يستطيع ⁦Pize⁩ قراءتها؟

يكتشف ⁦Pize⁩ الفواصل والعناوين والقيم المفقودة وأنواع الأعمدة من المحتوى. وإلى جانب الجداول النصية، يوضح كيفية فتح حاويات مثل ⁦Parquet⁩ و⁦RDS⁩ و⁦h5ad⁩ و⁦SPSS⁩ و⁦Stata.⁩ وتحصل الملفات التي تتجاوز ميزانية السياق على بطاقة بيانات بدلًا من حشو الجدول بأكمله في السياق.

## أربع خطوات: من مجموعة بيانات إلى نتيجة

ثبّت الإضافة، ووصل نموذجًا، وقدّم له البيانات. ثم كرر دورة كتابة الشفرة وتنفيذها وقراءة النتائج والرسوم وتصحيحها.

1. **ثبّت الإضافة** ثبّت الحزمة في ⁦Pize Code⁩ أو ⁦Positron.⁩ تظهر أيقونة ⁦Pize⁩ في الشريط الجانبي.
2. **وصل نموذجًا** أدخل مفتاح ⁦API⁩ لأي مزوّد، أو حدّد نموذجًا محليًا ونقطة نهاية ذاتية الاستضافة.
3. **أعطه البيانات** أرفق ملف البيانات الحالي، أو في ⁦Positron⁩ ركّز جلسة محملًا فيها البيانات.
4. **خطّط ثم نفّذ** اتفق على خطة التحليل في وضع التخطيط. وبعد التأكيد، دع ⁦Pize⁩ يكتب الشفرة وينفذها ثم يصححها استنادًا إلى الرسوم.

أدوات ⁦Positron⁩ تظهر داخل مضيف ⁦Positron⁩ فقط، وهي للقراءة فقط افتراضيًا. تنفيذ الشفرة وجلب الرسم موافقات فئة أوامر ويجب تشغيلها صراحة. أعداد الصفوف تقديرات والملخصات من وقت التشغيل؛ ويُذكر مصدر كليهما في النتيجة.