גרסאות וסביבות

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

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

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

• בדיקה
• פיתוח
• מסמכים שהופקו על-ידי Google
• וכו'.

תנועת גולשים בסביבת הייצור

תמיד משתמשים בגרסאות של סוכנים לתנועת נתונים בסביבת ייצור

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

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

שימו לב לשגיאות אפשריות של סוכן המכירות הווירטואלי במהלך שינוי הגרסאות

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

פרסום גרסה בסביבה חדשה

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

המסוף

1. עוברים אל מסוף Dialogflow ES.
2. בוחרים את הסוכן בחלק העליון של תפריט הסרגל הצדדי הימני.
3. לוחצים על לחצן ההגדרות לצד שם הסוכן.
4. לוחצים על הכרטיסייה סביבות.
5. לוחצים על פרסום גרסה.
6. מוסיפים תיאור אופציונלי ולוחצים על הבא.

7. לוחצים על + סביבה חדשה.

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

8. מזינים שם לסביבה.

9. בוחרים את שיטת ההפצה של הסביבה.

10. בוחרים את ההגדרות של המרת טקסט לדיבור לסביבה.

11. לוחצים על פרסום.

12. פרטי הסביבה מופיעים עכשיו בקטע סביבות בהתאמה אישית.

API

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

חזרה לגרסה קודמת של סביבה

אפשר להחזיר סביבה לגרסה קודמת של סוכן:

המסוף

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

API

מבצעים קריאה לשיטה patch/update של סוג הסביבה כדי לעדכן סביבה. מזינים את גרסת הסוכן שיצרתם קודם בשדה agentVersion.

טעינה של גרסה קודמת לטיוטה

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

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

כדי לטעון גרסה קודמת לטיוטה:

המסוף

1. עוברים אל מסוף Dialogflow ES.
2. בוחרים את הסוכן בחלק העליון של תפריט הסרגל הצדדי הימני.
3. לוחצים על לחצן ההגדרות לצד שם הסוכן.
4. לוחצים על הכרטיסייה סביבות.
5. בקטע טיוטה, לוחצים על הצגת כל הגרסאות.
6. לוחצים על האפשרות button לגרסה שרוצים לטעון לטיוטה.
7. לוחצים על טעינה לטיוטה.
8. לוחצים על כן.
9. צריך לטעון מחדש את הכרטיסיות הפתוחות בדפדפן של המסוף, כדי שהן יתעדכנו עם הנתונים העדכניים של הסוכן.

API

מבצעים קריאה ל-method‏ patch/update עבור סוג הסביבה עם הקלטים הבאים:

• משתמשים ב-- כמזהה הסביבה כדי לציין את סביבת ברירת המחדל.
• מגדירים את allowLoadToDraftAndDiscardChanges לערך true.
• בשדה agentVersion, מציינים את גרסת הסוכן שתחליף את טיוטת הסוכן.

ייצוא גרסה

כדי לייצא גרסה, קודם צריך לטעון אותה לטיוטה ואז לייצא את הסוכן.

בדיקת הסוכן בסביבה

אתם יכולים להשתמש ב-API כדי לבדוק את הנציג בכל אחת מהסביבות המותאמות אישית שלכם. קוראים לשיטה detect intent, אבל משנים את כתובת ה-URL של נקודת הקצה על ידי הוספת environments/environment-name/users/-/ בין agent לבין sessions.

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

"https://dialogflow.googleapis.com/v2/projects/my-project-id/agent/environments/development/users/-/sessions/123456789:detectIntent"

הגדרות ספציפיות לסביבה

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

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

Google Assistant

אם אתם משתמשים בסביבות הפצה של Actions on Google, כדאי לעיין במגבלות של ניהול הגרסאות בספריית ה-fulfillment של Dialogflow.

מגה סוכן

איך גרסאות וסביבות עבודה פועלות בסוכנים ראשיים

מגבלות

ההגבלות הבאות חלות:

• מספר הסביבות המקסימלי לכל סוכן: 10
• מספר הגרסאות המקסימלי לכל סוכן: 1,000