סשנים

סשן מייצג שיחה בין סוכן 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 משאב הסשן משאב הסשן
RPC ממשק הסשן ממשק הסשן
C++‎ SessionsClient לא זמין
C#‎ SessionsClient לא זמין
המשך SessionsClient לא זמין
Java SessionsClient SessionsClient
Node.js SessionsClient SessionsClient
PHP לא זמין לא זמין
Python SessionsClient SessionsClient
Ruby לא זמין לא זמין

הקודם
הדרכה
הבא
ייצוא/שחזור של Git