مثال تعليمي خيالي من إعدادنا. لا توجد نتيجة نموذج معبأة مسبقًا.
نقطة بداية قابلة للتعديل
- 1 · النص المراد فحصه
- الهدف: تسجيل Dana Lee (dana.lee@example.com) في المؤتمر. الصفحة الحالية: «التسجيل – الخطوة 2 من 2» العناصر الظاهرة: - حقل نصي «الاسم الكامل»: Dana Lee - حقل نصي «البريد الإلكتروني»: فارغ، ومعلَّم بأنه مطلوب - مربع اختيار «أوافق على مدونة السلوك»: محدَّد - زر «إرسال التسجيل»: مفعَّل - شريط تنبيه: «تنتهي جلستك بعد 10 دقائق.»
- 2 · سؤالك
- ما الخطوة الواحدة التي ينبغي للوكيل اتخاذها تاليًا لبلوغ الهدف؟
- 3 · حدّد من خيارين إلى 6 خيارات
- أكمل إدخالًا مطلوبًا
ما زال حقل مطلوب أو مربع اختيار فارغًا، والهدف يتضمن القيمة بالفعل.
- اضغط زر الإرسال
اكتملت جميع المدخلات المطلوبة والصفحة جاهزة للإرسال.
- انتظر ثم اقرأ الصفحة مجددًا
ما زالت الصفحة قيد التحميل أو التغيّر، فلا يمكن الوثوق بحالتها بعد.
- اسأل شخصًا
هناك معلومات ناقصة، أو للخطوة عواقب لا يُسمح للوكيل بتحمّلها.
- أكمل إدخالًا مطلوبًا
هذه احتمالات النموذج، وليست دقة مقاسة أو ضمانًا. نعم ولا تعكسان قواعدك؛ وتقارن احتمالات الخيارات ضمن الخيارات التي قدمتها فقط.
هل يستطيع Jev تشغيل وكيل متصفح؟
ليس بمفرده. لا ينقر Jev ولا يكتب ولا يقرأ الشاشة، بل يجيب عن أسئلة محددة النوع حول الحالة التي ترسلها إليه. وفي وكيل المتصفح، يجعله ذلك مرشحًا لمهمة ضيقة واحدة: انطلاقًا من وصف نصي للصفحة الحالية ومن الهدف، يختار الخطوة التالية من قائمة قصيرة تعرف شيفرتك مسبقًا كيف تنفّذ كل بند فيها.
يصف دليل البناء لدى TypeSafe تقسيم العمل نفسه: تبقى الشيفرة هي المتحكمة، ويتلقى النموذج قرارات ضيقة ومنظَّمة. أما حلقة الوكيل وقارئ الصفحة والنقر وإعادة المحاولة فتبقى كلها برمجيات عادية.
افتح قالب الخطوة التالية القابل للتعديل. يحتوي على صفحة تسجيل افتراضية وسؤال واحد وأربعة خيارات. تحميله ينشئ مسودة فقط؛ لا يبدأ الفحص حتى تطلبه.
صِف الصفحة بوصفها حالة، لا لقطة شاشة
يرسل القالب نصًا عاديًا: الهدف وعنوان الصفحة والعناصر الظاهرة مع قيمها الحالية. قارئ الصفحة لديك هو الذي يقرر ما يُدرج. احذف كل ما لا يحتاج إليه القرار، ولا ترسل أبدًا كلمات مرور أو تفاصيل دفع أو بيانات شخصية تخص آخرين إلى عرض تجريبي عام.
| الخيار | متى ينبغي أن يفوز |
|---|---|
| أكمل إدخالًا مطلوبًا | يوجد حقل مطلوب أو مربع اختيار فارغ، والهدف يتضمن القيمة بالفعل. |
| اضغط زر الإرسال | اكتملت جميع المدخلات المطلوبة. |
| انتظر ثم اقرأ الصفحة مجددًا | ما زالت الصفحة قيد التحميل أو التغيّر. |
| اسأل شخصًا | هناك معلومات ناقصة، أو للخطوة عواقب لا يجوز للوكيل تحمّلها. |
يقابل كل خيار دالة في وكيلك. يختار Jev الدالة، وتوفّر شيفرتك الوسائط التي تستطيع التحقق منها، مثل تحديد الحقل الفارغ. ويتبع دليل استدعاء الدوال لدى TypeSafe النهج نفسه: تتحول الاختيارات من مجموعة مغلقة إلى أسئلة، بينما يبقى النص الحر والأرقام والتواريخ من مسؤولية شيفرتك.
غيّر شيئًا واحدًا ثم قارن
- شغّل القالب كما هو، وسجّل الخطوة المختارة وبقية الاحتمالات.
- املأ البريد الإلكتروني في وصف الصفحة وشغّله مرة أخرى. حدّد مسبقًا الخطوة التي تتوقعها.
- احذف عنوان البريد الإلكتروني من الهدف مع إبقاء الحقل فارغًا. يفتقر الوكيل الآن إلى القيمة، ولذلك ينبغي للتصميم الحذر أن يفضّل سؤال شخص.
لا يتضمن القالب إجابة متوقعة معبأة مسبقًا، وتشغيل واحد ليس قياسًا. إذا ظل خياران يتنافسان، فأعد كتابة وصفيهما حتى يتمكن شخص من تطبيقهما دون تخمين؛ راجع كيفية التعامل مع الفئات المتداخلة.
دع حجم المخاطر يحدد العتبة
يستخدم نمط التوجيه المشروط بالثقة لدى TypeSafe الثقة إشارةً ثانية: تحدد الإجابة ما ينبغي فعله، وتحدد الثقة هل يُنفَّذ الإجراء أم لا. يقبل مثاله إجراءً منخفض المخاطر عند ثقة متواضعة، ويشترط ثقة أعلى بكثير قبل الموافقة على تحويل مالي. طبّق الفكرة نفسها هنا. إعادة قراءة الصفحة زهيدة الكلفة، أما إرسال استمارة أو الدفع أو الحذف فليست كذلك. اختر عتباتك بنفسك استنادًا إلى أمثلة موسومة، واقرأ أولًا الاحتمال مقابل الثقة.
ما الذي جرّبه المجتمع
يتضمن معرض المشاريع رابطًا إلى نموذج أولي من المجتمع لوكيل متصفح ينقل خطوة القرار إلى Jev. ادعاءات السرعة فيه صادرة عن مؤلفه نفسه، وقد غيّر عدة أشياء دفعة واحدة، ولذلك فهي لا تعزل أثر Jev. تعامل مع هذه التقارير بوصفها أفكارًا تستحق الاختبار، ثم أنشئ مجموعة صغيرة من حالات الصفحات من منتجك أنت، وراجع كل خطوة يدويًا قبل أن يتصرف وكيل في حسابات حقيقية.
المصادر وقراءات إضافية
يستند هذا الدليل إلى التوثيق الرسمي وتقارير المجتمع المرتبطة. تُنسب ملاحظات المشاركين إلى أصحابها.
- TypeSafe: كيفية البناء باستخدام TypeSafe
- TypeSafe: دليل عملي لاستدعاء الدوال
- TypeSafe: التوجيه المشروط بالثقة