הבנת סוגי נתונים עבור משתנים
לפני שנצלול להיבטים המעשיים של השימוש במשתנים, בואו נכיר את סוגי הנתונים השונים הזמינים ב- Botpress.
- חוּט: מחרוזות משמשות לאחסון הטקסט שיכול להיות מורכב מאותיות, מספרים או תווים מיוחדים. הם משמשים בדרך כלל לאחסון שמות המשתמש או הודעות שנוצרו בינה מלאכותית.
- בוליאנית: בוליאנים יכולים להחזיק רק שני ערכים - נכון או לא נכון. הם אידיאליים לאחסון המידע הבינארי כגון האם המשתמש הוא לקוח חוזר או אם המשתמש רוצה לשאול משהו אחר.
- מספר: כפי שהשם מרמז, משתני המספרים משמשים לאחסון הערכים המספריים שיכולים להיות מספרים שלמים או מספרים עם מקומות עשרוניים. הם שימושיים לאחסון מספרי הטלפון, אזורי החיוג ונתונים מספריים אחרים.
- תַאֲרִיך: משתני התאריך משתמשים בפורמט תאריך/שעה ISO 8601. הוא מייצג תאריך בודד או תאריך ושעה.
- לְהִתְנַגֵד: משתנה אובייקט הוא אוסף של צמדי מפתח-ערך הדומים למילונים או למפות. הם בעלי ערך לאחסון מבני הנתונים המורכבים כגון פרופילי המשתמש או התוצאות של קריאת API.
- מַעֲרָך: המערכים משמשים לאחסון אוספי משתנים דומים. הם יכולים להחזיק את המחרוזות או החפצים, מה שהופך אותם לרב-תכליתי עבור מקרי שימוש שונים כגון אחסון הודעות קודמות של משתמש או מתן אפשרויות למשתמש לבחור מהן.
- Enum: זהו משתנה עם סט מוגבל של אפשרויות מוגדרות מראש. הם מתאימים לתרחישים כמו אחסון ימי השבוע או הפריטים הזמינים בתפריט מזון.
- תבנית: משתני הדפוס משתמשים בביטויים הרגולריים (Regex) כדי לאחסן את התבניות המיוחדות בהן ניתן להשתמש כדי להתאים מילים או מספרים ספציפיים. הם שימושיים לאחסון מספרי החשבונות או מספרי הטיסה.
הבנת היקפים המשתנים
סוגים שונים של משתנים כלולים ב-Botpress, והם משתנים בהתאם למקום שבו ניתן לגשת אליהם בזרימת הצ'אטבוט שלך. הבה נחקור את היקפי המשתנים השונים, החל מהמצומצם ביותר ועד הרחב ביותר:
משתני זרימת עבודה
המשתנים האלה מוגדרים ונעשה בהם שימוש בתוך זרימת עבודה אחת או זהה. הם מצוינים עבור זרימות חד פעמיות כמו אחסון פלטי משימות הבינה המלאכותית, תשובות משתמשים לשאלות או ארגון הנתונים מקריאות ה-API.
ניתן לבצע שלבים אלה ליצירת משתנה זרימת עבודה:
שלב 1. בחר את זרימת העבודה המתאימה בתפריט 'סייר'.
שלב 2. לחיצה כפולה על אזור ריק בעורך זרימת העבודה פותחת את החלונית Inspector.
שלב 3. ציין את שם המשתנה, בחר את סוג הנתונים של המשתנה ולחץ על כפתור 'הוסף' כדי ליצור את המשתנה.
אתה יכול להוסיף ערך ברירת מחדל (ראשוני) למשתנה שלך מהקטע 'הגדרות נוספות'.
משתני זרימת עבודה של קלט ופלט
כדי להחליף מידע, לזרימות עבודה עשויות להיות משתני קלט ופלט. תשומות משמשות לקבלת מידע מהמקורות החיצוניים או זרימות עבודה אחרות, בעוד פלטים מספקים מידע למקורות החיצוניים או זרימות עבודה אחרות. זה מאפשר תקשורת וחילופי נתונים גמישים יותר בתוך הבוט.
ניתן לבצע את השלבים הבאים לסימון משתנה קלט:
שלב 1. צור את המשתנה בתוך זרימת העבודה.
שלב 2. בחר את המשתנה על ידי לחיצה על צומת הכניסה של זרימת העבודה בחלונית המפקח.
ניתן לבצע שלבים אלה לסימון משתנה פלט:
שלב 1. צור את המשתנה בתוך זרימת העבודה.
שלב 2. בחר את המשתנה על ידי לחיצה על צומת היציאה של זרימת העבודה בחלונית Inspector.
משתני הפעלה
כל הזרימות יכולות לגשת למשתנים האלה, אבל רק לשיחה אחת. הם אידיאליים לאחסון הנתונים המשמשים במהלך השיחה, כגון היסטוריית צ'אט, פריטים שנאספו בעגלת קניות וירטואלית או נתונים זמניים משיחות API.
כדי ליצור משתנה הפעלה, אתה יכול לכתוב את הקוד הבא:
session.variablename = 'היי ח'ברה!' ;כדי להשתמש במשתנה שלך בכרטיס טקסט, עלינו לסגור אותו בסוגריים המתולתלים, למשל, {{session.variablename}} .
משתני משתמש
משתני המשתמש עוקבים אחר משתמש בין שיחות מה שמאפשר לנתונים להימשך לאורך אינטראקציות מרובות עם הצ'אטבוט. הם מושלמים לאחסון מידע שנשאר רלוונטי למשתמש לאורך זמן, כגון פרטים אישיים, תגיות משיחות קודמות או העדפות שפה.
כדי ליצור משתנה משתמש:
שלב 1. פתח את 'הגדרות צ'אטבוט' מסמל Botpress שנמצא בפינה השמאלית העליונה.
שלב 2. בחר 'משתנים' מהכרטיסיות.
שלב 3. הגדר את משתנה המשתמש על ידי מתן שם וציון סוג הנתונים.
ניתן להשתמש ב-@user.variablename או ב-{{user.variablename}} כדי להתייחס למשתנה 'User' בכרטיס טקסט.
משתני בוט
לכל המשתמשים בצ'אטבוט יש גישה למשתנים האלה בכל השיחות. הם משמשים לעתים קרובות לאחסון המידע והתצורה של המפתח, כמו אחסון נקודות קצה עבור קריאות ה-API, מספר הגרסה של הבוט או שמו.
בצע את השלבים הבאים ליצירת משתנה Bot:
שלב 1. בחר את 'הגדרות צ'אטבוט' על ידי לחיצה על סמל Botpress בפינה השמאלית העליונה.
שלב 2. בחר 'משתנים' מהכרטיסיות.
שלב 3. ציין את השם וסוג הנתונים של משתנה הבוט.
כמו משתני משתמש, ניתן להשתמש ב-@bot.variablename או bot.variablename כדי להתייחס למשתני בוט בכרטיסים.
משתני תצורה
הם סוג מיוחד של משתנה בוט מאובטח. אתה יכול לנהל אותם מ-Cloud Dashboard, ואין צורך לפתוח את הבוט. משתני התצורה אידיאליים לאחסון מידע רגיש כמו אסימוני API, כתובות IP פרטיות או אישורי מסד נתונים.
כדי ליצור משתנה תצורה:
שלב 1. פתח את 'הגדרות צ'אטבוט' מסמל Botpress שנמצא בפינה השמאלית העליונה.
שלב 2. לחץ על הכרטיסייה 'משתנים'.
שלב 3. הוסף משתנה תצורה וציין את שמו וערכו.
כדי לגשת למשתני התצורה בקוד, אתה יכול להשתמש ב-'env.key' כאשר 'key' מייצג את שם משתנה התצורה שיש לאחזר.
שימוש במשתנים בקוד
אין צורך בסוגריים המתולתלים '{{ }}' או סמל @ בעת שימוש במשתנים בקוד. התחביר לגישה למשתנים בקוד עוקב אחר דפוס 'variabletype.variablename'. לדוגמה:
קוד:
- workflow.phoneNumber
- session.userActId
- user.firstName
- bot.endpoint
- env.apiKey
ניתן להקצות למשתנים ערכים או לעדכן אותם בקוד. אבל חשוב לוודא שהערך שהוקצה תואם לסוג הנתונים של המשתנה כדי למנוע שגיאות.
סיכום
המשתנים הם אבני הבניין של אינטראקציות דינמיות ומותאמות אישית ב-Botpress. על ידי שימוש בסוגי הנתונים השונים והבנת ההיקפים המשתנים, המפתחים יכולים ליצור צ'אטבוטים עם יכולות חזקות. בין אם אתה צריך לאחסן את פרטי המשתמש, להתחבר לממשקי API או להעביר את הנתונים בין זרימות עבודה ומשתנים ב-Botpress מספקים את הגמישות והשליטה הדרושים.