במסוף Dialogflow יש עורך קוד מובנה שנקרא עורך מוטבע. אפשר להשתמש בו כדי ליצור קוד לביצוע בקשות משתמשים ולפרוס את הקוד ל-Cloud Functions. יש חיובים שמשויכים ל-Cloud Functions, אבל השירות זמין ללא תשלום עד מספר משמעותי של הפעלות בחודש. חשוב לזכור שעדיין צריך להירשם ולספק חשבון חיוב תקין. תמיד אפשר לבטל.
כשמפעילים את העורך המוטבע בפעם הראשונה, קוד המילוי של Node.js מאוכלס מראש ב-handlers שמוגדרים כברירת מחדל עבור default intents שכלולים בכל הסוכנים. הקוד כולל גם הוראות עם הערות להוספת handlers ל-intents שהוגדרו על ידי המפתחים.
העורך המוטמע מיועד לבדיקות פשוטות של ביצוע בקשות ולבניית אב טיפוס. כשמוכנים ליצור אפליקציה לייצור, צריך ליצור שירות webhook.
ספריית מילוי הבקשות של Dialogflow
כברירת מחדל, העורך המוטבע משתמש בספריית ה-fulfillment של Dialogflow. הספרייה הזו לא מתעדכנת יותר, אבל היא עדיין שימושית כפתרון פשוט לספריית מימוש. הספרייה הזו צריכה לשמש רק קוד של עורך מוטבע.
ספריית מילוי הבקשות של Dialogflow לא תומכת בניהול גרסאות. אם אתם צריכים להשתמש בניהול גרסאות, אתם יכולים לבחור באחת מהאפשרויות הבאות:
- מחליפים את קוד העורך המוטבע שמוגדר כברירת מחדל בקוד ה-webhook המותאם אישית.
- פריסת קוד של webhook בהתאמה אישית ישירות ב-Cloud Functions.
- מבצעים Fork לספריית ה-fulfillment של Dialogflow ומשנים אותה כדי לתמוך בניהול גרסאות.
שימוש בעורך המוטבע
במדריך למתחילים בנושא ביצוע הזמנות יש הוראות מפורטות לשימוש בכלי לעריכה מוטבעת.
הורדת הקוד
כשהקוד מוכן להעברה למערכת אחרת, אפשר להשתמש בלחצן ההורדה get_app בכלי לעריכה בשורה.
שיחות ברשת
על שיחות ברשת שמקורן בקוד של Cloud Functions ליעדים מחוץ לרשת של Google מחויב שירות Cloud Functions.
מגבלות
ההגבלות הבאות חלות:
- העורך המוטמע תומך רק ב-Node.js.
- אם משנים את הקוד באמצעות מסוף Cloud Functions, אי אפשר יותר להשתמש בעורך המוטבע כדי לשנות את הקוד. הפונקציה תמשיך לספק מילוי בקשות לסוכן, אבל בעתיד יהיה צורך לבצע שינויים במסוף Cloud Functions.
- הפונקציה של העורך המוטמע חייבת להיקרא
dialogflowFirebaseFulfillment. - אי אפשר לשמור או להוריד קוד שעבר שינוי בעורך המובנה בלי לפרוס אותו קודם.
- העורך המוטמע תומך רק בשני קבצים:
-
index.js: מכיל את כל קוד ההשלמה. -
package.json: שינוי הקובץ הזה יגרום להתקנת כל התלויות שציינתם במהלך הפריסה.
-
- בקטע ספריית ה-fulfillment של Dialogflow מפורטות המגבלות של הספרייה הזו, שמשמשת כברירת מחדל את העורך המוטמע.