فريق ينقل 203 كيلوبايت من البرومبتات من كود PHP إلى YAML — أي ثلث الكود بأكمله
يحتفظ فريق مشروع PHP بـ203 كيلوبايت من البرومبتات، أي نحو ثلث حجم كود PHP بأكمله، في ملفات YAML داخل Git بدلًا من الكود. كانت البرومبتات تُعدَّل سابقًا من لوحة الإدارة، فكانت بيئة الإنتاج تختلف عن بيئة الاختبار (staging) دون أي سجل للتعديلات. أما الآن فيضم ملف واحد نص البرومبت والنموذج ودرجة الحرارة وصيغة الإجابة، ويستدعي الكود هذه «القدرة» بالاسم. الخلاصة: ينبغي إدارة إصدارات البرومبت كما يُدار الكود، مع معاملات التوليد.
معالج بواسطة الذكاء الاصطناعي من Habr AI؛ بتحرير Hamidun News
السؤال عن مكان تخزين البرومبتات يواجه عاجلًا أم آجلًا كل فريق يبني منتجًا على LLM. أجاب مشروع PHP واحد عنه بجذرية: يحتوي المستودع على 203 كيلوبايت من البرومبتات، أي نحو ثلث حجم كود PHP بأكمله. ومع ذلك لا يوجد في الكود نفسه أي برومبت. فجميعها ملفات YAML (صيغة نصية بسيطة لملفات الإعدادات) تخضع للمراجعة وتُدار إصداراتها في Git وتُنشر مع الإصدار. المشروع خاضع لاتفاقية عدم إفصاح (NDA)، لذلك ابتكر المؤلف أمثلة البرومبتات على سيناريو بوت دعم، لكن بنية الملفات وكود المعالجة والمشكلات العملية حقيقية. واتضح خلال العمل أن «نقل البرومبت إلى ملف إعدادات» ليس قرارًا واحدًا بل عشرات القرارات الصغيرة، ويسهل الخطأ في كلٍّ منها.
لماذا ليس في الكود ولا في لوحة الإدارة
البرومبت داخل الكود يعني نشرًا كاملًا من أجل فاصلة واحدة. لكن للبرومبتات خصوصية: من يعدّلها ليس المطوّر، بل المسؤول عن جودة إجابات النموذج. يغيّر الصياغة، ويراجع المخرجات، ويتراجع، ثم يجرّب بطريقة أخرى. وتُقاس هذه الدورة بالساعات لا بالسبرينتات.
الحل البديهي هو حقل قابل للتحرير في لوحة الإدارة. فعل الفريق ذلك في النسخة الأولى وحصل على نتيجة معتادة: برومبت الإنتاج يختلف عن برومبت بيئة الاختبار (staging)، ولا أحد يتذكر من غيّر فقرة صيغة الإجابة ولماذا، ولا يمكن التراجع إلا بالاعتماد على الذاكرة. لا مراجعة ولا سجل ولا مكان لعرض الفروقات. ويحل Git هذه المشكلات الأربع بثمن واحد: لتعديل البرومبت لا بد أن تعرف كيف تُجري commit. وبالنسبة لهذا الفريق كان هذا المقابل مقبولًا.
وحدة التخزين لم تكن سلسلة نصية بل «قدرة» (capability)، مثل summarize-ticket. يضم ملف واحد المزوّد والنموذج ومعاملات التوليد وقالبي النظام والمستخدم لكل لغة وصيغة الإجابة المتوقعة. والسبب بسيط: النص نفسه بدرجة حرارة 0,2 وبدرجة 0,9 يمنح سلوكين مختلفين. فإذا كانت درجة الحرارة في الكود والنص في ملف، يستحيل إعادة إنتاج نتيجة الأمس. يستدعي الكود القدرة بالاسم ولا يعرف شيئًا عن النموذج أو المزوّد.
القوالب والأمان والمشكلات الصغيرة
البرومبت نادرًا ما يكون ثابتًا: إذ يُدرَج فيه سجل الرسائل والسياق. لم يكتب الفريق محرّك قوالب خاصًا به، بل ربط Blade بسطر واحد. والثمن واضح: يحوّل Blade القالب إلى PHP وينفّذه، أي أن محتوى ملف YAML كود قابل للتنفيذ. وما دامت الملفات تمر بالمراجعة فهذا مقبول. لكن إن أراد مدير المنتج تحرير البرومبتات مباشرة من لوحة الإدارة، فلا يجوز إدخال محرّك قوالب كامل هناك: المطلوب محرّك مقيّد دون تنفيذ كود ودون وصول إلى نظام الملفات.
والحماية الثانية هي ترتيب الإدراج. يُعالَج أولًا القالب الموثوق من المستودع، وبعد ذلك فقط تُدرَج نصوص المستخدم، كالاسم مثلًا، في النص الجاهز عبر str_replace العادي. أما إذا مُرِّر الاسم إلى داخل محرّك القوالب، فمن سمّى نفسه {{ config('app.key') }} سيحصل في الإجابة على مفتاح التطبيق.
وهذه بضع تفاصيل عملية أخرى:
- خمس لغات لا تعني ترجمة فقط. فالنموذج يلتزم بالصيغة بشكل مختلف بالروسية ويخلط اللغات أكثر، لذلك تظهر في القوالب غير الإنجليزية إضافات مثل اشتراط الرد باللغة المطلوبة. واختبار «تطابق المعنى» عديم الفائدة، أما فحص «وجود قالب في جميع اللغات المحلية (locales) ومجموعة المتغيرات المُدرَجة نفسها» فضروري: فقد يترجم المترجم
{user}إلى كلمة «مستخدم» بسهولة. - في القدرة يُذكر النموذج باسم مستعار قصير، ويوجد تفصيله في ملف المزوّد. وعندما يعيد المزوّد تسمية النموذج يُعدَّل ملف واحد لا تسعة.
- يُخزَّن في YAML اسم متغير البيئة مثل
${FAST_CLOUD_KEY}لا المفتاح نفسه. فالمفتاح الحقيقي الذي يُدرَج «لدقيقة واحدة» يبقى في سجل Git إلى الأبد، ولذلك يُفحص هذا بشكل مستقل أثناء المراجعة. - الأقواس حول الأرقام في YAML تحوّلها إلى سلاسل نصية، فيردّ المزوّد بخطأ في التحقق. ويحوّل الفريق المعاملات إلى أرقام داخل الكود.
الإجابات المهيكلة وإعادة المحاولة والسجلات
يختلف المزوّدون في قدرتهم على إرجاع إجابة مهيكلة، لذلك ثمة ثلاثة مستويات في الإعدادات: مخطط JSON كامل، أو وضع «JSON صالح» فقط، أو «لا شيء». ويتدرّج النظام هبوطًا على هذا السلّم. فإذا كان المزوّد يفهم المخطط، يُرسَل المخطط في response_format. وإذا كان يدعم وضع JSON فقط، يُلحَق المخطط نصًّا بنهاية برومبت النظام بلغة المستخدم. لكن هذا طلب لا ضمان، ولذلك توجد طبقة ثالثة: يُقتطع من الإجابة كل ما بين أول { وآخر }، لأن النموذج يحب أن يضيف «بالتأكيد! إليك إجابتك:». ثم تُحلَّل النتيجة وتُفحص وفق المخطط. ويعترف المؤلف بأنه قاوم هذه الميزة طويلًا حتى رأى كم إجابة تنقذها.
تنقسم إعادة المحاولة إلى نوعين. الإخفاق الشبكي (انتهاء المهلة، 502، انقطاع الاتصال) يُعالَج بتكرار عادي مع فاصل زمني متزايد أُسّيًّا، حتى ثلاث محاولات. أما الإخفاق الدلالي — رمز 200 لكن سلسلة فارغة أو JSON غير صالح أو بنية لا تجتاز المخطط — فيتطلب إعادة الطلب بالكامل، وعدد هذه المحاولات اثنتان بالضبط. فكل محاولة تكلّف مالًا وثواني من انتظار المستخدم، وإذا أخفق النموذج مرتين مع البرومبت نفسه فالمشكلة في البرومبت أو في النموذج لا في الحظ. والأصدق أن تُعرَض الخطأ ويُسجَّل الحادث.
وفي بيئة الإنتاج تُسجَّل الأخطاء فقط. أولًا، جسم الطلب — برومبت النظام مع سجل الرسائل — عشرات الكيلوبايتات في السطر الواحد، ويكبر هذا الجدول أسرع من غيره. وثانيًا، يحتوي على مراسلات المستخدم، أي بيانات شخصية لها مدد حفظ وحذف عند الطلب. ومع ذلك فتسجيل الأخطاء إلزامي: الحالة والمزوّد والنموذج ووقت التنفيذ والتفاصيل. وإلا فسيُضطر الفريق إلى فحص شكوى «ردّ البوت بكلام فارغ» اعتمادًا على وصف المستخدم.
ويشير المؤلف في موضوع الاختبار إلى أن إجابة النموذج غير حتمية ولا يمكن التحقق منها بتأكيد (assert) عادي، لكن هذا لا يعني أنه لا شيء يمكن فحصه. والخلاصة العملية لمن يبنون منتجاتهم على LLM: تعاملوا مع البرومبتات كما تتعاملون مع الكود، واحفظوا معاملات التوليد بجوار النص، وأدرجوا بيانات المستخدم بعد معالجة القالب، وحدّدوا مسبقًا مدى قوة محرّك القوالب الذي أنتم مستعدون لإتاحته لمن يعدّلون البرومبتات.
- 12 أكتوبر 2026T-Bank يعلّم وكيل الذكاء الاصطناعي كتابة اختبارات الوحدة لنظام iOS عبر AGENTS.md وSKILL.md
- 16 يونيو 2026الذكاء الاصطناعي في التطوير: كيف يكتشف نموذج لغوي كبير (LLM) تعارضات الخدمات المصغّرة
- 18 نوفمبر 2026«Куб три» منحت وكيل الذكاء الاصطناعي ذاكرة للمشروع: مراجعة أسهل، لكن النموذج أغلى بنحو الثلث
- 2 مايو 2026إطار zymi يقترح بناء وكلاء الذكاء الاصطناعي كمشروع dbt باستخدام yaml وevent sourcing
أسئلة وأجوبة حول الخبر
ما أبرز التفاصيل حول لماذا ليس في الكود ولا في لوحة الإدارة؟
البرومبت داخل الكود يعني نشرًا كاملًا من أجل فاصلة واحدة. لكن للبرومبتات خصوصية: من يعدّلها ليس المطوّر، بل المسؤول عن جودة إجابات النموذج. يغيّر الصياغة، ويراجع المخرجات، ويتراجع، ثم يجرّب بطريقة أخرى. وتُقاس هذه الدورة بالساعات لا بالسبرينتات. الحل البديهي هو حقل قابل للتحرير في لوحة الإدارة. فعل الفريق ذلك في النسخة الأولى وحصل على نتيجة معتادة: برومبت الإنتاج يختلف عن برومبت بيئة الاختبار (staging)، ولا أحد يتذكر من غيّر فقرة صيغة الإجابة ولماذا، ولا يمكن التراجع إلا بالاعتماد على الذاكرة.
ما أبرز التفاصيل حول القوالب والأمان والمشكلات الصغيرة؟
البرومبت نادرًا ما يكون ثابتًا: إذ يُدرَج فيه سجل الرسائل والسياق. لم يكتب الفريق محرّك قوالب خاصًا به، بل ربط Blade بسطر واحد. والثمن واضح: يحوّل Blade القالب إلى PHP وينفّذه، أي أن محتوى ملف YAML كود قابل للتنفيذ. وما دامت الملفات تمر بالمراجعة فهذا مقبول. لكن إن أراد مدير المنتج تحرير البرومبتات مباشرة من لوحة الإدارة، فلا يجوز إدخال محرّك قوالب كامل هناك: المطلوب محرّك مقيّد دون تنفيذ كود ودون وصول إلى نظام الملفات. والحماية الثانية هي ترتيب الإدراج.
ما أبرز التفاصيل حول الإجابات المهيكلة وإعادة المحاولة والسجلات؟
يختلف المزوّدون في قدرتهم على إرجاع إجابة مهيكلة، لذلك ثمة ثلاثة مستويات في الإعدادات: مخطط JSON كامل، أو وضع «JSON صالح» فقط، أو «لا شيء». ويتدرّج النظام هبوطًا على هذا السلّم. فإذا كان المزوّد يفهم المخطط، يُرسَل المخطط في response_format. وإذا كان يدعم وضع JSON فقط، يُلحَق المخطط نصًّا بنهاية برومبت النظام بلغة المستخدم. لكن هذا طلب لا ضمان، ولذلك توجد طبقة ثالثة: يُقتطع من الإجابة كل ما بين أول { وآخر }، لأن النموذج يحب أن يضيف «بالتأكيد! إليك إجابتك:». ثم تُحلَّل النتيجة وتُفحص وفق المخطط.
Test Frontier LLMs & Autonomous Agents in One Workspace
Run Claude Opus 5.5, GPT-6, Gemini 3.1, and DeepSeek side-by-side in Nomad AI (nomadnet.ai) — unified model routing, deep research, and multimodal workflows under one subscription.
أهم ما في عالم الذكاء الاصطناعي — مرة كل أسبوع
سبع قصص مهمة فعلاً هذا الأسبوع، مختارة بعناية. بلا ضجيج ولا بيانات صحفية.
تم! تحقق من بريدك للتأكيد.