اختبار Momentic

# نموذج Momentic

يحول Momentic اللغة الطبيعية المهيكلة إلى أتمتة للمتصفح باستخدام Playwright المتفرع، وCDP، والوكلاء المخصصين. تحل الخطوات التفاعلية الأهداف باللغة الطبيعية، ويمكن للتأكيدات استخدام نماذج متعددة الوسائط، ويمكن لإجراءات الذكاء الاصطناعي إكمال أهداف أوسع.

# ملفات المشروع وتنسيقاته

تستخدم الاختبارات `*.test.yaml`؛ وتستخدم الوحدات النمطية القابلة لإعادة الاستخدام `*.module.yaml`. تعيش معرفات الاختبار في حقل `id` بملف الاختبار. تحقق من `momentic.config.yaml` والبيانات الوصفية على مستوى الاختبار قبل افتراض تطبيق إعدادات المشروع الافتراضية.

`fileType: momentic/test/v2` و `fileType: momentic/module/v2` تحدد ملفات الإصدار الثاني (v2). تعامل مع `fileType` المفقود أو المختلف على أنه إصدار أول (v1) مهمل. لا تقم أبدا بتحرير YAML من الإصدار الأول مباشرة؛ احتفظ بالتغييرات من خلال `momentic_test_splice_steps`.

يختار اختبار الإصدار الثاني بيئته باستخدام `defaultEnv`، ويتجاوز `--env <name>` ذلك. لا يوجد احتياطي للبيئة الوحيدة في التكوين. يأتي عنوان URL الأساسي من `--url-override`، ثم `url` الخاص بالاختبار، ثم `env.BASE_URL`، لذا فإن الاختبار الذي يحدد `url` يحتفظ به في كل بيئة. بدون عنوان URL أساسي، يفشل التشغيل: "Cannot run test with no base URL and no BASE_URL variable defined in its environment".

يمكن للإصدار الثاني الإشارة إلى الوحدات النمطية، وJavaScript، وحالة المصادقة بمسارات نسبية. يتم حل المسارات من ملف YAML الذي يحتوي على المرجع. استخدم `./...` أو `../...`، ولا تستخدم أبدا المسارات المطلقة أو `~`. قبل نقل أو إعادة تسمية أو حذف ملف مشار إليه، ابحث عن مساره وقم بتحديث أو إزالة كل مرجع. لا تضف حقولا داخلية أو منشأة إلى YAML من الإصدار الثاني.

# اختر سير العمل

فضل سير العمل المدمج هذا ما لم يطلب المستخدم شيئا آخر:

- **تغيير معروف في الإصدار الثاني:** افحص الأنماط القريبة -> حرر YAML -> قم بالتحقق من الصحة (lint) عندما تكون الصيغة أو المراجع غير مؤكدة -> أعد التحميل أو أعد التشغيل إذا كنت تقوم بالتحقق -> قم بتشغيل النطاق ذي الصلة. هذا هو الأسرع وينتج فرقا واضحا وقابلا للمراجعة. - **الإصدار الأول، واجهة مستخدم غير معروفة، أو التحقق التفاعلي:** ابدأ جلسة MCP -> قم بتشغيل أي متطلبات مسبقة -> قم بمعاينة نقطة تحقق منطقية -> قم بدمجها -> قم بالتحقق من النطاق المحفوظ -> قم بالإنهاء. هذا يرسخ كل تعديل في التطبيق المباشر دون تشغيل الاختبار بأكمله بشكل متكرر. - **اختبار جديد:** أنشئ باستخدام `momentic_test_create` -> قم بتأليف تسلسل معروف من الإصدار الثاني في تعديل YAML واحد، أو استخدم MCP خطوة بخطوة عند الحاجة إلى الاكتشاف. `momentic_session_start` يفتح اختبارا موجودا فقط.

استخدم MCP كواجهة تفاعلية افتراضية: فهي ترجع نتائج مهيكلة، ولقطات شاشة، ومخرجات، ومراجع خطوات، وتنفيذ قابل للاستقصاء. تنتظر أدوات المعاينة والتشغيل 30 ثانية افتراضيا، ثم ترجع `stepRunnerId` بينما يستمر العمل. اترك `timeoutSeconds` غير محدد لمعظم المكالمات، خاصة الخطوات المسبقة الفردية. اضبطه أقل من 30 ثانية فقط عندما يكون مهلة استدعاء الأداة لوكيل الترميز أقصر. ارفعه فقط للانتظار لفترة أطول ضمن مهلة استدعاء أداة أكبر؛ استقص المقابض المرتجعة باستخدام `momentic_poll_runner`.

يحتوي الاستقصاء على `timeoutSeconds` منفصل (الافتراضي 0، الحد الأقصى 30). مرر `stepRunnerId` المرتجع واستخدم انتظارا غير صفري ضمن مهلة استدعاء الأداة لوكيل الترميز بدلا من الاستقصاء المتكرر بدون انتظار.

# قبل التحرير

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

# قواعد التأليف

- فضل الأهداف باللغة الطبيعية. استخدم المحددات أو الإحداثيات فقط عندما لا يتمكن الذكاء الاصطناعي من رؤية الهدف أو عندما يطلب المستخدم دقة على مستوى المحدد. - استخدم خطوات Momentic الأصلية لإجراءات المتصفح وعمليات التحقق. راجع **JavaScript** ضمن **سلوك تنفيذ الاختبار** للاستثناءات. - لا تضف التنقل الأولي؛ تبدأ الجلسة عند عنوان URL الأساسي للاختبار. - حافظ على التأكيدات بسيطة ومدفوعة من قبل المستخدم. بعد التنقل أو تغيير حالة مادية، تحقق من العقد قبل الإجراءات التابعة. - فضل `waitForUrl` لعقود URL، وعمليات التحقق من الصفحة/العنصر للنص أو الهيكل الثابت، وتأكيدات الذكاء الاصطناعي للحالة البصرية الدلالية. - فضل AI Action V3 للاختبارات الجديدة. استخدم خطوات دقيقة عندما تحتاج نقاط التحقق إلى تحكم فردي؛ للتسلسلات السريعة، راجع **التفاعلات الحساسة للوقت**. - لا تضف حقولا اختيارية أو ذات قيم افتراضية إلا إذا كانت الدقة تتطلب ذلك. - حافظ على التغييرات ضيقة. حافظ على القيم غير ذات الصلة، والتعليقات، والترتيب، ونمط الخطوات. لا تضعف اختبارا لإخفاء تطبيق أو خدمة معطلة. - حافظ على بنية `before` / `steps` / `after` الحالية ما لم يتطلب هدف الاختبار تغييرا.

## AI Action V3

يتلقى AI Action V3 هدفا باللغة الطبيعية ويحدد خطوات المتصفح.

- **مخزن مؤقتا افتراضيا:** حفظ وإعادة تشغيل تدفق ناجح، مع إصلاح ذاتي لخطوات إعادة التشغيل الفاشلة. استخدمه للتدفقات القابلة للتكرار. - **غير مخزن مؤقتا:** قم بتشغيل الوكيل من جديد في كل مرة. اضبط `cache: false` في الإصدار الثاني أو استخدم `--disable-cache` مع `AI_ACTION_DYNAMIC`. فضل هذا للدردشات، وسير العمل الوكيل، والاختبارات الاستكشافية، وغيرها من الديناميكيات أو غير المحددة.