אם אתם לא משתמשים באחת מאפשרויות השילוב, אתם צריכים לכתוב קוד שמתקשר ישירות עם משתמש הקצה. בנוסף, אתם צריכים ליצור אינטראקציה ישירה עם ה-API של Dialogflow בכל תור בשיחה כדי לשלוח ביטויים של משתמשי קצה ולקבל התאמות של כוונות. בתרשים הבא מוצג תהליך העיבוד כשמתקשרים עם ה-API.
- משתמש הקצה מקליד או אומר ביטוי.
- השירות שלכם שולח את הביטוי של משתמש הקצה ל-Dialogflow בהודעת בקשה לזיהוי כוונות.
- Dialogflow שולח הודעת תגובה של זיהוי כוונות לשירות שלכם. ההודעה הזו מכילה מידע על הכוונה התואמת, הפעולה, הפרמטרים והתגובה שהוגדרו לכוונה.
- השירות מבצע פעולות לפי הצורך, כמו שאילתות במסד נתונים או קריאות ל-API חיצוני.
- השירות שלכם שולח תגובה למשתמש הקצה.
- משתמש הקצה רואה או שומע את התשובה.
הגדרת הפרויקט ואימות
לפני שמבצעים קריאה ל-API, צריך להגדיר פרויקט ב-GCP ואימות. אפשר לפעול לפי השלבים במדריך ההגדרה המהירה.
יצירת סוכנים
ברוב המקרים, מומלץ להשתמש במסוף Dialogflow ES (למשאבי העזרה, לפתיחת המסוף) כדי ליצור סוכנים. כדי ליצור סוכן, אפשר לפעול לפי השלבים שבדף התחלה מהירה במסוף. אפשר גם להשתמש ב-Dialogflow API כדי ליצור סוכנים לתרחישים מתקדמים. הרבה דפים עם הסברים על קונספטים מתמקדים בשימוש במסוף כדי ליצור סוכנים, אבל הם גם כוללים קישורים לסוגים רלוונטיים של API.
REST, gRPC וספריות לקוח
אפשר לגשת אל Dialogflow API באמצעות REST, gRPC או אחת מספריות הלקוח שזמינות. פרטים על האפשרויות האלה מופיעים בסקירה הכללית על השימוש ב-API.
סשנים
סשן מייצג שיחה בין סוכן Dialogflow לבין משתמש קצה. יוצרים סשן בתחילת השיחה ומשתמשים בו בכל תור של השיחה. אחרי שהשיחה מסתיימת, מפסיקים להשתמש בסשן.
אסור להשתמש באותו סשן לשיחות בו-זמניות עם משתמשי קצה שונים. מערכת Dialogflow שומרת את ההקשרים הפעילים כרגע לכל סשן פעיל. נתוני הסשן מאוחסנים על ידי Dialogflow למשך 20 דקות.
כל סשן נחשב לייחודי לפי מזהה הסשן שנוצר על ידי המערכת. כדי ליצור סשן חדש, צריך לספק מזהה סשן חדש בבקשה לזיהוי כוונת המשתמש. מזהה הסשן הוא מחרוזת בגודל של עד 36 בייטים. המערכת שלכם אחראית ליצירת מזהי סשן ייחודיים. יכולים להיות אלה מספרים אקראיים, מזהים של משתמשי קצה שעברו גיבוב, או כל ערך אחר שנוח לכם ליצור.
זיהוי כוונות
כשמשתמשים בממשק ה-API לאינטראקציות, השירות יוצר אינטראקציה ישירה עם משתמש הקצה.
בכל תור בשיחה, השירות שלכם שולח ביטויים של משתמשי הקצה ל-Dialogflow על ידי קריאה לשיטה detectIntent או streamingDetectIntent של הסוג Sessions.
Dialogflow מגיב עם מידע על ה-Intent התואם, הפעולה, הפרמטרים והתגובה שהוגדרו עבור ה-Intent.
השירות שלכם מבצע פעולות לפי הצורך (לדוגמה, שאילתות במסד נתונים או קריאות ל-API חיצוני) ושולח הודעה למשתמש הקצה.
התהליך הזה נמשך עד שהשיחה מסתיימת.
דוגמאות לקריאה ל-detect intent מופיעות בדף ההפעלה המהירה של ה-API ובדפי ההוראות.