הבנת פעולות בבוטפרס
פעולות ב-Botpress הן פונקציות בצד השרת שמבוצעות על ידי הבוט במהלך זרימות שיחה. יש להם את הכוח לשנות את מצב השיחה, לשלוח הודעות מותאמות אישית, להפעיל קוד שרירותי (כגון קריאה ל-APIs או אחסון הנתונים), ועוד. בעיקרו של דבר, פעולות הן פונקציות JavaScript רגילות מה שאומר שהן יכולות לבצע כמעט כל דבר במגבלות הפלטפורמה.
כאשר פעולה מופעלת על ידי מנהל הדיאלוגים (DM), היא מקבלת מספר ארגומנטים המספקים הקשר לפונקציה. הארגומנטים הללו כוללים את תכונות המשתמש, משתני ההפעלה, משתנים זמניים, משתנים ברמת הבוט, אירוע המשתמש האחרון בשיחה, ארגומנטים שהועברו מבונה הזרימה החזותית, ו-vm עם ארגז חול המכיל כמה משתני סביבה.
רישום פעולות חדשות
כדי להוסיף את פעולות הבוט המותאמות אישית, עליך ליצור קובץ JavaScript (.js) ולהציב אותו ב- נתונים/גלובליים/פעולות תיקייה בתוך פרויקט ה-Botpress שלך. למרבה הצער, אין דרך להוסיף פעולות חדשות באופן תוכנתי במהלך זמן הריצה. באמצעות הערות JavaDoc בקוד שלך, אתה יכול לספק מידע משמעותי על הפעולות כגון השם, התיאור, הארגומנטים וערכי ברירת המחדל שלהן. אתה יכול גם להסתיר פעולה בעורך הזרימה על ידי הוספת הדגל @hidden true בהערת JavaDoc.
כיצד ליצור פעולות מותאמות אישית ב-Botpress
הנה כמה שלבים שתוכל לבצע כדי ליצור פעולה מותאמת אישית ב-Botpress:
שלב 1: צור את הבוט שלך והוסף צומת
כדי להתחיל, צור בוט חדש ב-Botpress. לאחר יצירת הבוט שלך, הוסף צומת חדש לזרימת השיחה.
שלב 2: הוסף הודעות מתאימות לצומת שלך
בצומת החדש שנוצר, הוסף את ההודעות הנחוצות כדי להקל על חילופי התוכן עם המשתמשים. לדוגמה, אתה יכול להוסיף הודעת טקסט כדי לברך את המשתמש ולבקש את שמו.
שלב 3: פתח את קוד הביצוע מהסרגל הצידי
נווט לסרגל הצד ב- Botpress Flow Builder ופתח את 'עורך הקודים'. זה המקום שבו אתה יכול לבנות ולנהל את הפעולות המותאמות אישית שלך.
שלב 4: לחץ על כפתור 'הוסף פעולה'.
בקטע 'ביצוע קוד', לחץ על כפתור 'הוסף פעולה'. פעולה זו פותחת את החלון 'Create a new action_legacy'.
שלב 5: ציין שם לקובץ ולחץ על לחצן שלח
בחלון 'Create a new action_legacy', תן שם משמעותי לקובץ הפעולה המותאם אישית שלך; לדוגמה, customAction.js. לאחר שציינת את השם, לחץ על כפתור 'שלח'. זה יוצר את הקובץ 'customAction.js'.
שלב 6: כתוב את הקוד המותאם אישית שלך
פתח את הקובץ החדש שנוצר 'customAction.js'. בתוך הקובץ, תראה את קוד ה-boilerplate שנוצר עבור פעולה חדשה. ספק תיאור משמעותי לפעולה המותאמת אישית שלך באמצעות ההערות המתאימות.
כעת, כתוב את הקוד המותאם אישית שלך בתוך הפונקציה. קוד זה מגדיר את התנהגות הפעולה המותאמת אישית שלך. אתה יכול להשתמש ב-JavaScript כדי לבצע משימות שונות כמו ביצוע קריאות API, גישה לבסיסי הנתונים או טיפול בלוגיקה מורכבת.
שלב 7: שנה את הצומת שלך לשימוש בפעולה המותאמת אישית
חזור אל Botpress Flow Builder ושנה את הצומת שבו תרצה להפעיל את הפעולה המותאמת אישית שלך. הוסף כרטיס 'ביצוע קוד' לצומת.
שלב 8: בחר את שם הפעולה המותאם אישית שלך וציין את פרמטרי הפעולה
בכרטיס 'הפעל קוד', תראה רשימה נפתחת המכילה את השמות של כל הפעולות המותאמות אישית שלך. בחר את השם של הפעולה המותאמת אישית שלך מהרשימה. אם הפעולה המותאמת אישית שלך דורשת פרמטרים כלשהם, תוכל לציין אותם בקטע 'פרמטרים' בכרטיס 'הפעל קוד'.
שלב 9: גרמו לבוט שלכם לבצע את הפעולה
לבסוף, הוסף עוד כרטיס לצומת כדי לגרום לבוט שלך לבצע את הפעולה המותאמת אישית. אתה יכול להשתמש במשתנים שנשמרים באירוע (המצוינים בכרטיס 'הפעל קוד') כדי לגשת לתוצאות הפעולה המותאמת אישית שלך ולכלול אותם בתגובת הבוט.
דוגמה לפעולה מותאמת אישית
נניח שאתה רוצה שהצ'אטבוט שלך יספק את מידע מזג האוויר הנוכחי עבור מיקום מוגדר. אתה יכול ליצור פעולה מותאמת אישית שקוראת ל-API של מזג אוויר ומחזירה את נתוני מזג האוויר.
const axios = לִדרוֹשׁ ( 'אקסיות' );const getWeather = אסינכרון ( מִשׁתַמֵשׁ , session, args) => {
const location = args.location || 'ניו יורק' ;
const apiKey = 'מפתח_מפתח_מזג האוויר' ;
const apiUrl = `https://api.weatherapi.com/v1/current.json?key=${apiKey}&q=${location}`;
נסה {
const response = await axios.get(apiUrl);
const weatherData = response.data;
return `מזג האוויר הנוכחי ב-${location} הוא ${weatherData.current.condition.text} עם טמפרטורה של ${weatherData.current.temp_c}°C.`;
} תפוס (שגיאה) {
לַחֲזוֹר ״סליחה, יכולתי \' לא להביא את מידע מזג האוויר כרגע. בבקשה נסה שוב מאוחר יותר.' ;
}
};
החזר getWeather( מִשׁתַמֵשׁ , סשן, args);
פעולה זו לוקחת ארגומנטים מסוימים, כולל המשתמש, ההפעלה והארגים המספקים את ההקשר והנתונים לעבודה איתם. בדוגמה זו, הפעולה המותאמת אישית 'getWeather' לוקחת את המיקום כארגומנט או ברירת המחדל היא 'ניו יורק' אם לא מסופקת. הפעולה קוראת ל-Weather API באמצעות Axios, מאחזרת את נתוני מזג האוויר ומחזירה הודעה המכילה את מצב מזג האוויר והטמפרטורה.
היתרונות של פעולות מותאמות אישית
פעולות מותאמות אישית ב-Botpress מציעות מספר יתרונות המשפרים את היכולות והפונקציונליות של הצ'אטבוט שלך:
- הם מרחיבים את פונקציונליות הצ'אט בוט מעבר ליכולות המובנות.
- הם יוצרים אינטראקציות מותאמות לחוויית משתמש טובה יותר.
- הם מביאים נתונים בזמן אמת ממשקי API לתגובות דינמיות.
- הם משתלבים עם מערכות backend ומסדי נתונים.
- הם מטפלים בתרחישים מורכבים עם קוד מותאם אישית.
- הם עושים שימוש חוזר בפעולות בצ'אטבוטים ובזרימות.
- הם מיישמים את הטיפול בשגיאות ורישום הרישום המותאמים אישית.
- הם מייעלים את המשימות עתירות המשאבים.
- הם ממנפים את השירותים החיצוניים להרחבה.
- הם ניגשים ומשתפים את הפעולות המותאמות אישית שנבנו מראש.
סיכום
פעולות מותאמות אישית ב-Botpress מרחיבות את יכולות הצ'אטבוט, מתאימות אינטראקציות אישית ומשלבות ממשקי API חיצוניים. מפתחים יוצרים את פונקציות ה-JavaScript בצד השרת ומפעילים אותן מ- Botpress Flow Builder. פעולות אלו מציעות שימוש חוזר בקוד, ביצועים משופרים ומדרגיות שהופכים את הצ'אטבוטים לכלים צדדיים וחזקים יותר. מינוף הפעולות המותאמות אישית ב-Botpress יוצר חוויות צ'אטבוט חדשניות ומרתקות.