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

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

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

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

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

בנוסף, אתם יכולים ליצור תגובות לפעולה מאתר אחר (webhooks) ספציפיות לסביבה, כדי לבודד את סביבת הייצור מסביבות הפיתוח והבדיקה.

שיטות מומלצות לתנועה בסביבת הייצור

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

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

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

תמיד להשתמש בקטעי Webhook ספציפיים לסביבה

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

• כדי לבדוק את העדכונים של הנציג מול העדכונים של קוד ה-webhook.
• כדי להימנע מפריסת קוד ה-webhook בסביבת הייצור לפני שסיימתם את הבדיקה.

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

שגיאות אפשריות של הנציג בזמן שינוי גרסאות

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

טעינת גרסה לטיוטה

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

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

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

ניהול גרסאות

כדי לנהל את הגרסאות:

המסוף

כדי להציג את הגרסאות הנוכחיות של תהליך:

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

כדי להציג את הגרסאות הנוכחיות של פלייבוק:

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

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

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

המידע הבא מוצג לכל משאב:

• השם המוצג: השם המוצג של הגרסה.
• מזהה גרסה: המזהה של הגרסה.
• ‫NLU Type: סוג ה-NLU של גרסת התהליך.
• חותמת הזמן של היצירה: התאריך והשעה שבהם הגרסה נוצרה.
• סטטוס: סטטוס האימון. גרסת תהליך לא מוכנה לשימוש עד שהסטטוס שלה מסומן כ-Ready (מוכן).

כדי ליצור גרסה חדשה, לוחצים על הכפתור Create ומזינים את השם המוצג (Display name) ואת התיאור (Description) של הגרסה.

כדי לטעון גרסה ספציפית של תהליך כטיוטה:

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

כדי למחוק גרסה ספציפית של תהליך:

1. מציבים את הסמן מעל שורה של גרסה.
2. לוחצים על כפתור האפשרויות .
3. לוחצים על האפשרות מחיקת הגרסה.

API

השיטות לסוג Version. לעיון בהפניית ה-API של הגרסה

בוחרים פרוטוקול וגרסה להפניה לגרסה:

פרוטוקול	V3	V3beta1
REST	משאב גרסה	משאב גרסה
RPC	ממשק הגרסאות	ממשק הגרסאות
C++‎	VersionsClient	לא זמין
C#‎	VersionsClient	לא זמין
המשך	VersionsClient	לא זמין
Java	VersionsClient	VersionsClient
Node.js	VersionsClient	VersionsClient
PHP	לא זמין	לא זמין
Python	VersionsClient	VersionsClient
Ruby	לא זמין	לא זמין

סגירה

הערה: ל-method‏ load יש שדה allowOverrideAgentResources, שבאמצעותו אפשר לקבוע אם משאבים ברמת הנציג יוחלפו כשמשחזרים תהליך כטיוטת תהליך.

הערה: כשקוראים ל-method‏ delete כדי למחוק גרסה, צריך קודם להסיר את כל ההפניות לגרסה בנתוני הסביבות.

השוואה בין גרסאות של תהליכים

הערה: השוואת גרסאות מוגבלת לגודל תגובה של 2MB. כדי לעקוף את המגבלה הזו, אפשר להשתמש בשיטת API בארכיטקטורת REST.

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

המסוף

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

API

אפשר לעיין בשיטה compareVersions של הסוג Version. לעיון בהפניית ה-API של הגרסה

בוחרים פרוטוקול וגרסה להפניה לגרסה:

פרוטוקול	V3	V3beta1
REST	משאב גרסה	משאב גרסה
RPC	ממשק הגרסאות	ממשק הגרסאות
C++‎	VersionsClient	לא זמין
C#‎	VersionsClient	לא זמין
המשך	VersionsClient	לא זמין
Java	VersionsClient	VersionsClient
Node.js	VersionsClient	VersionsClient
PHP	לא זמין	לא זמין
Python	VersionsClient	VersionsClient
Ruby	לא זמין	לא זמין

סגירה

ניהול סביבות

כדי לנהל את סביבות הנציג:

המסוף

כדי להציג את הסביבות הנוכחיות של נציג:

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

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

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

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

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

כדי למחוק סביבה, לוחצים על לחצן המחיקה ליד הצד השמאלי של הסביבה ברשימה.

API

השיטות לסוג Environment. למאמרי העזרה של Environment API

בוחרים פרוטוקול וגרסה להפניה לסביבה:

פרוטוקול	V3	V3beta1
REST	משאב סביבה	משאב סביבה
RPC	ממשק הסביבה	ממשק הסביבה
C++‎	EnvironmentsClient	לא זמין
C#‎	EnvironmentsClient	לא זמין
המשך	EnvironmentsClient	לא זמין
Java	EnvironmentsClient	EnvironmentsClient
Node.js	EnvironmentsClient	EnvironmentsClient
PHP	לא זמין	לא זמין
Python	EnvironmentsClient	EnvironmentsClient
Ruby	לא זמין	לא זמין

סגירה

הערה: כדי להפנות לטיוטת תהליך, משתמשים ב-0 כמזהה גרסת התהליך.

ציון הסביבה לשיחות בסשן

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

המסוף

כשמשתמשים בסימולטור של המסוף, בוחרים באפשרות Test agent in environment ואז בוחרים סביבה.

API

כדי לציין סביבה לקריאות REST של detectIntent, ‏ streamingDetectIntent,‏ matchIntent וישויות של סשנים, משנים את כתובת ה-URL על ידי הוספת environments/environment-id בין הפרמטרים של הנתיב agent ו-sessions.

לדוגמה, כתובת ה-URL הבאה משתמשת במזהה הסביבה 6db409d7-57ac-41d7-83bd-89b8768e2745:

https://dialogflow.googleapis.com/v3/projects/my-project-id/locations/us/agents/my-agent-id/environments/6db409d7-57ac-41d7-83bd-89b8768e2745/sessions/my-session-id:detectIntent

ציון גרסאות של תהליכים לשיחות בסשן

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

המסוף

כשמשתמשים בסימולטור של המסוף, בוחרים באפשרות Test agent with specific flow versions ואז בוחרים את גרסאות התהליך.

API

כדי לציין גרסאות של תהליכים לקריאות REST של detectIntent, ‏ streamingDetectIntent,‏ matchIntent וישויות של סשנים, צריך לציין את גרסאות התהליכים שנבחרו בשדה query_parameters.flow_versions של הבקשה.