בדיקת פעולות השיחה

סביבת הפיתוח של Actions Builder ו-Actions SDK מספקת שיטות רבות לבדיקת פרויקט הפעולות בכל שלב של מחזור הפיתוח, מבדיקות פיתוח אינטראקטיביות ועד בדיקות בטא של משתמשי קצה.

כדי לשפר את האיכות והאמינות של הפעולה מהפיתוח הראשוני ועד לפרסום הגרסה החדשה:

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

בדיקה ידנית באמצעות הסימולטור

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

איור 1. ממשק הסימולטור של מסוף הפעולות שבו מוצגות אפשרויות הקלט.

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

למידע נוסף על הסימולטור של מסוף Actions.

בדיקות אוטומטיות באמצעות Actions API

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

Node.js Testing Library משתמש ב-Actions API כדי לקיים אינטראקציה עם קוד הפרויקט. ספריית הבדיקות מאפשרת להגדיר חבילת בדיקות ששולחת שאילתות לפעולה וקובעת טענות לגבי הפלט הזה כדי לאמת מידע ספציפי למצב השיחה של הפעולה.

ה-Actions API מספק נקודות קצה ל-REST, שמאפשרות ליצור טיוטה של הפעולה ולבצע בה פעולות פרוגרמטיות באמצעות שאילתות, ולמצוא נתוני Intent תואמים לשאילתה נתונה. כדי להשתמש ישירות בנקודות הקצה האלה, אפשר להוריד את ספריית הלקוח של Node.js Actions API.

בספריית הבדיקות אפשר לבדוק סבב שיחה אחד על ידי שליחת שאילתה באמצעות הפונקציה sendQuery. השיטה הזו מקבלת שאילתת טקסט כקלט ומפיקה פלט מובנה שמכיל את תוכן ההנחיה שמוצגת למשתמש, וגם פרטי אבחון אחרים שמסבירים איך הבקשה טופלה. אפשר להשתמש בשיטות מובנות של טענת נכוֹנוּת (assertion) באובייקט של בדיקת הפלט כדי לאמת את התנהגות הפעולה. למשל, הכוונה התואמת והסצנה הנוכחית.

בדוגמה הבאה מוצגת בדיקה שמציינת שפעולה מופעלת עם תגובת הפתיחה המתאימה:

it('starts Action and enters the Welcome scene', async function() {
    testManager.setTestSurface('SMART_DISPLAY');
    await testManager.sendQuery('Talk to my test app');
    testManager.assertSpeech('Hello World!');
    testManager.assertText('Hello World!');
    testManager.assertIntent('actions.intent.MAIN');
    testManager.assertScene('Welcome');
    await testManager.sendStop();
    testManager.assertConversationEnded();
});

בדוגמת הקוד של רכיבי השיחה, אפשר לעיין בדוגמה המלאה של חבילת הבדיקות שנכתבה ב-Node.js.

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

בדיקת משתמשים בגרסאות אלפא ובטא

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

איור 2. ממשק הגרסאות של מסוף הפעולות מאפשר להגדיר ערוצי גרסאות אלפא ובטא עבור הפעולה.

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

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

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