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

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

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

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

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

בנוסף, אתם יכולים ליצור ווּבקוקים ספציפיים לסביבה, כדי לבודד את סביבת הייצור מסביבות הפיתוח והבדיקה.

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

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

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

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

תמיד להשתמש ב-webhook ספציפי לסביבה

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

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

שימוש בווּבּהוּקים ספציפיים לסביבה מאפשר להשיג את שתי המטרות האלה.

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

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

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

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

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

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

ניהול גרסאות

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

המסוף

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

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. הגרסאות מפורטות עבור הכלי שנבחר.

לכל מקור מוצגים הפרטים הבאים:

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

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

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

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	לא זמין	לא זמין

סגירה

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

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

השוואה בין גרסאות של זרימת עבודה

הערה: השוואת גרסאות מוגבלת לגודל תגובה של 2MB. כדי לעקוף את המגבלה הזו, צריך להשתמש בmethod של 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. מוצגת רשימה של סביבות הסוכן.

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

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

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

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

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

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

כדי לציין סביבה עבור detectIntent, ‏ streamingDetectIntent,‏ matchIntent וקריאות REST של ישויות של סשנים, צריך לשנות את כתובת ה-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

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