סשנים

סשן מייצג שיחה בין סוכן של Dialogflow CX לבין משתמש קצה. יוצרים סשן בתחילת השיחה ומשתמשים בו בכל תור של השיחה. אחרי שהשיחה מסתיימת, אתם מפסיקים להשתמש בסשן.

אסור להשתמש באותה סשן לשיחות בו-זמניות עם משתמשי קצה שונים. סשן נשאר פעיל והנתונים שלו נשמרים למשך 30 דקות אחרי הבקשה האחרונה שנשלחה לסשן.

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

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

סשנים ארוכים

כברירת מחדל, נתוני הסשן נשמרים ב-Dialogflow CX למשך 30 דקות. יש שתי דרכים להאריך את משך החיים של הסשנים:

  • (מומלץ) הגדרת TTL של סשן באמצעות QueryParameters.session_ttl. הערך המקסימלי המותר הוא 24 שעות.

  • אפשר לשחזר את מצב הסשן הקודם על ידי הגדרת QueryParameters.current_page ו-QueryParameters.parameters ב-DetectIntentRequest.

    דוגמה לתהליך עבודה:

    1. משתמש קצה מדבר עם הסוכן בסשן א'.
    2. הקוד שלכם מתעד את המצב שמשויך לסשן א' שהוחזר בתגובת ה-API, כלומר QueryResult.current_page ו-QueryResult.parameters.
    3. משתמש הקצה מפסיק את האינטראקציה עם הנציג אחרי 50 דקות.
    4. משתמש הקצה מדבר שוב עם הסוכן.
    5. הקוד שולח את הקלט של משתמש הקצה, יחד עם QueryParameters.current_page ו-QueryParameters.parameters שתועדו קודם לכן בבקשה, כדי לזהות את הכוונה באמצעות מצב הסשן הקודם. לא צריך להשתמש באותו מזהה סשן שבו נעשה שימוש בסשן א'.

קובצי עזר

מידע על תמחור של סשנים מופיע בדף התמחור.

מידע נוסף על סשנים:

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

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

הקודם
Training
הבא
Git export/restore