M365Con 2027 – כנס אונליין חינמי · 11–22 Jan 2027 · 120 sessions→ m365con.net

בלוג · Mirko Peters

איך כותבים מקרה בדיקה בשפה פשוטה שסוכן AI יכול להריץ

By · · Updated

כתבו מקרי בדיקה בשפה פשוטה שסוכן AI יכול להריץ: התנהגות אחת לכל בדיקה, פעולה אחת לכל שלב, שמות ברורים לרכיבים ותוצאה צפויה שניתנת לבדיקה.

Automatically translated with AI from the original post. Read the English original

כדי לכתוב מקרי בדיקה בשפה פשוטה שסוכן AI יכול להריץ, שמרו על התנהגות אחת לכל בדיקה, פעולה אחת לכל שלב, ובדיקה אחת לכל תוצאה שניתנת לראות על המסך. המדריך מיועד לאנשי QA ולבודקים שרוצים לעבור מתסריטים להוראות כתובות ועדיין להשיג תוצאות אמינות. תלמדו את חמשת חלקי מקרה הבדיקה, את הכללים שהופכים שלב לניתן להרצה, שיטה להפיכת קריטריונים לקבלה לבדיקות, ודוגמה מעובדת שאפשר להעתיק.

עיקרי הדברים

  • למקרה בדיקה בשפה פשוטה יש חמישה חלקים: כותרת, תנאים מוקדמים, שלבים, תוצאה צפויה ונתוני בדיקה, וסוכן AI צריך שכל החמישה יהיו מפורשים.
  • כתבו התנהגות אחת לכל בדיקה ופעולה אחת לכל שלב, כי יצרני כלים מדווחים שהוראות של שלב יחיד הן המדויקות ביותר.
  • ציינו כל רכיב כפי שהמשתמש רואה אותו, למשל כפתור Log In, במקום לכתוב "הכפתור" או "השדה".
  • תנו לכל בדיקה תוצאה צפויה שניתנת לבדיקה על המסך, למשל כותרת או סכום, ולעולם לא "לוודא שזה עובד".
  • קראו את מה שהסוכן יצר לפני שאתם סומכים על הצלחה, ושכתבו כל שלב שהסוכן פירש בצורה שלא התכוונתם אליה.

חמשת החלקים של מקרה בדיקה בשפה פשוטה

מקרה בדיקה טוב נקרא כמו סיפור קצר שכל אחד בצוות יכול לעקוב אחריו. בבדיקות תוכנה, כתיבת מקרי בדיקה יעילים היא מיומנות QA מרכזית, ובודקים ידניים כתבו אותם בשפה פשוטה מאז ומעולם. החידוש הוא שסוכן AI יכול כעת להריץ את שלבי הבדיקה. הדבר חשוב במיוחד לend-to-end testing, שבו בדיקה עוקבת אחר משתמש לאורך תהליך עבודה שלם בדפדפן. עבור AI agent, כל חלק חייב להיות מפורש, משום שהסוכן לא יכול לשאול אתכם למה התכוונתם.

  1. כותרת. שורה אחת שמתארת את ההתנהגות, למשל "לקוח יכול לאפס סיסמה ששכח". הכותרת היא הדבר הראשון שהקורא רואה בדוח.
  2. תנאים מוקדמים. המצב שבו חייב להימצא המוצר לפני תחילת הבדיקה, למשל "קיים חשבון לקוח והלקוח מנותק".
  3. שלבים. מה המשתמש עושה, פעולה אחת בכל שורה.
  4. תוצאה צפויה. מה המשתמש אמור לראות לאחר מכן, בלשון שניתנת לבדיקה על המסך.
  5. נתוני בדיקה. הערכים המדויקים בשימוש, למשל כתובת דוא"ל או מספר הזמנה.

תבנית משותפת שומרת על מקרי הבדיקה של כל בודק באותה צורה, וקבוצת בדיקות עם תבנית אחת קלה הרבה יותר לבדיקה. למקרה בדיקה יש גם צורך בדרך לאמת את התוצאה, וזו הסיבה שהתוצאה הצפויה חשובה.

זו אותה צורה שבה משתמשת פיתוח מונחה התנהגות (BDD). בשפת Gherkin, כפי שמוסבר בAutomation Panda, Given מגדיר את מצב ההתחלה, When מבצע את הפעולה הנבדקת, ו-Then קובע את התוצאה הצפויה. אינכם חייבים להשתמש במילות המפתח האלה. שלושת התפקידים עדיין שימושיים.

כללים שהופכים שלב לניתן להרצה על ידי סוכן AI

כותבי כלים מפרסמים המלצות לכתיבת הוראות שסוכן בינה מלאכותית יוכל לפעול לפיהן. התיעוד של BrowserStack עבור סוכן הבדיקות בשפה טבעית שלהם מציג כללים שמתאימים לרוב הכלים:

  • התחילו בפועל פעולה. "Click the Submit button" הוא הוראה ברורה. "The submit button" אינו הוראה.
  • השתמשו בכוונה אחת לכל פקודה. פצלו משימות רב-שלביות לשלבים נפרדים.
  • ציינו את האלמנט הספציפי. כתבו "the Log In button", ולא "the button".
  • גללו תחילה כשהיעד מחוץ למסך. הוסיפו שלב לפני הפעולה.

באותו עמוד נאמר שהאמינות יורדת ככל שהפקודות מורכבות יותר, ושהוראות של שלב יחיד הן המדויקות ביותר. להלן שלושה כללים שנלמדו מניסיון:

  • השתמשו במילים שמופיעות על המסך. אם הכפתור כתוב "Sign in", אל תכתבו "Log in".
  • כללו את הערכים בתוך השלב. כתבו "Type ana@example.com into the Email field", ולא "enter a valid email".
  • הימנעו מכינויי גוף ומונחים מעורפלים. "It", "there", "properly" ו-"correctly" מסתירים החלטה שהסוכן יצטרך לנחש.

כיצד לכתוב מקרי בדיקה באנגלית פשוטה, שלב אחר שלב

פעלו לפי השיטה הזו כדי להפוך דרישה למקרה בדיקה.

  1. התחילו מקריטריון קבלה אחד. קחו משפט אחד מסיפור המשתמש, למשל "A customer who forgets a password can set a new one by email".
  2. בחרו התנהגות אחת. כל מקרה בדיקה בודק התנהגות אחת. המדריך של Automation Panda על כתיבת Gherkin טובה מנסח זאת כ-"One Scenario, One Behavior" וקובע שיש לפצל תרחיש שמכיל כמה זוגות When-Then.
  3. כתבו את מצב ההתחלה. תארו אותו כמצב, ולא כפעולות הקמה. "A customer account exists" עדיף על עשרה שלבים שיוצרים חשבון אחד.
  4. כתבו את פעולות המשתמש. כל פעולה היא שורה קצרה אחת עם פועל ואלמנט מוגדר בשם.
  5. כתבו את התוצאה הצפויה. ציינו מה אמור להופיע: כותרת, הודעה או ערך. השתמשו בטקסט המדויק.
  6. הוסיפו את הנתונים. שימו את הערכים בתוך השלבים או בטבלה קטנה מתחת לבדיקה.
  7. קראו בקול רם. אם עמית חדש לא יכול להריץ את הבדיקה ביד, גם הסוכן יתקשה.

המדריך מציע גם לשמור על תרחישים קצרים, עם פחות מעשרה שלבים. מקרה בדיקה ארוך הוא לרוב כמה מקרי בדיקה שחוברו יחד. וריאציות של התנהגות אחת, כמו שלוש סיסמאות לא תקינות, שייכות לטבלת נתונים ולא לשלושה עותקים של אותם שלבים.

דוגמה: בדיקת איפוס סיסמה, לפני ואחרי

הפרטים הם פיקטיביים.

לפני (מעורפל מדי). "Check that password reset works." לסוכן אין מצב התחלה, אין פעולות ואין תוצאה לבדוק. הוא עלול לעבור את הבדיקה מסיבה שגויה.

אחרי (ניתן להרצה).

  • כותרת: לקוח יכול לבקש קישור לאיפוס סיסמה.
  • תנאי מוקדם: קיים חשבון לקוח עבור ana@example.com, והלקוח מנותק.
  • שלב 1: פתחו את העמוד Sign in.
  • שלב 2: לחצו על הקישור "Forgot password".
  • שלב 3: הקלידו את ana@example.com בשדה Email.
  • שלב 4: לחצו על הכפתור "Send reset link".
  • תוצאה צפויה: העמוד מציג את ההודעה "Check your email".

לגרסת ה"אחרי" יש התנהגות אחת, חמש פעולות קצרות ותוצאה גלויה אחת. אם המוצר שלכם דורש גם שהקישור בהודעה הדוא"ל יעבוד, כתבו מקרה בדיקה שני עבור ההתנהגות הזו. אל תרחיבו את הראשון.

עכשיו הריצו את הבדיקה וקראו את היומן. נניח שהסוכן לחץ על "Forgot password" כמו שצריך, אבל הקליד את הכתובת בתיבת חיפוש. היומן מראה את הטעות, ואתם כותבים מחדש את שלב 3 כ-"Type ana@example.com into the Email field on the reset form". הצוות של Cypress ממליץ על אותה הרגל לכלי האנגלית הפשוטה שלו: בדקו כל שלב שנוצר, ועברו לקוד קבוע כשצריך בדיקה יציבה.

וריאציות: השתמשו בטבלת נתונים, לא בעותקים

מקרי בדיקה רבים בודקים את אותה התנהגות עם ערכים שונים. טופס הרשמה צריך לדחות כתובת דוא"ל ללא סימן @, כתובת ללא דומיין, וכתובת עם רווחים. אל תכתבו שלושה מקרי בדיקה עם שלבים זהים.

המדריך של Automation Panda מציין ש-Gherkin אין שלב מסוג "Or". לווריאציות של התנהגות אחת הוא ממליץ על Scenario Outline עם טבלת Examples, ומומלץ לכלול רק את הווריאציות שאתם צריכים, כי שורות מיותרות מאריכות את זמן הריצה. אפשר להשתמש באותה גישה גם באנגלית פשוטה. כתבו את השלבים פעם אחת עם placeholder, למשל "Type {email} into the Email field", והוסיפו מתחתיהם טבלה קטנה.

טבלת דוגמה (בדויה): {email} הוא "ana.example.com" וההודעה הצפויה היא "Enter a valid email address"; {email} הוא "ana@" וההודעה זהה; {email} ריק וההודעה היא "Email is required". שלוש שורות, קבוצה אחת של שלבים, שלוש תוצאות ברורות. אם שורה אחת נכשלת, הדוח מראה איזה ערך שבר את הכלל.

רשימת בדיקה לפני ההרצה

השתמשו ברשימה הזו עבור כל מקרה בדיקה חדש:

  • הכותרת מציינת התנהגות אחת.
  • מצב ההתחלה הוא מצב, ולא רשימה של לחיצות הכנה.
  • כל שלב מתחיל בפועל ומציין רכיב כפי שהוא מוצג על המסך.
  • כל הערכים כתובים במלואם.
  • אפשר לראות את התוצאה הצפויה, והיא כוללת טקסט או מספר מדויקים.
  • יש פחות מעשרה שלבים.
  • אדם נוסף קרא את הבדיקה.

טעויות נפוצות

  • שילוב של כמה התנהגויות במקרה בדיקה אחד. כשהבדיקה נכשלת, לא ברור איזה חלק השתבש.
  • תיאור של איך במקום מה. עשרה שלבים של הקשות מסתירים את הכוונה. תארו את הפעולה ברמה שמשתמש היה מבצע.
  • דילוג על התוצאה הצפויה. מקרה בדיקה ללא בדיקה עלול לעבור בלי להוכיח דבר.
  • שימוש בשמות פנימיים. מזהי בדיקה ומחלקות CSS משתנים. השתמשו בתוויות שהמשתמשים רואים.
  • הפקת טסטים מ-generative AI וקבלתם בלי לקרוא. מודל עלול להמציא שלבים שאין למוצר שלכם.
  • השארת הנתונים למקרה. אם ערך לא צוין, הסוכן יבחר אחד, וייתכן שהבדיקה לא תחזור על עצמה.

איך תוכנה יכולה לעזור

גיליון משותף או דף ויקי מספיקים כדי להתחיל. כתבו כל בדיקה בצורה של חמשת החלקים ובדקו אותה כמו קוד. אם אתם משתמשים בכלי לניהול בדיקות, שמרו בדיקה אחת לכל רשומה וקשרו אותה לדרישה. כלי בדיקה בשפה טבעית יקרא אז את אותו הטקסט. צוותים רבים שומרים גם מדריך סגנון קצר עם הכללים שלמעלה, כדי שכל בודק חדש יכתוב שלבים באותו אופן.

הצעד הבא

קחו שלושה קריטריונים לקבלה מהספרינט הנוכחי וכתבו מקרה בדיקה אחד לכל אחד מהם, לפי חמשת החלקים. הריצו אותם בכלי שתבחרו כדי לכתוב מקרי בדיקה בשפה פשוטה שסוכן יכול להריץ, ותקנו כל שלב שהיומן מציג כמובן בצורה שגויה.

Entities in this article

End-to-end testing AI agent Generative AI

Related articles

RSS