אתם יכולים ליצור ישויות בהתאמה אישית כדי להתאים נתונים ספציפיים לסוכן שלכם.
לדוגמה, אפשר להגדיר סוג ישות vegetable שיכול להתאים לסוגי הירקות שזמינים לרכישה אצל סוכן של חנות מכולת.
יצירת ישויות בהתאמה אישית
כדי ליצור ישות בהתאמה אישית:
המסוף
- פותחים את מסוף Dialogflow CX.
- בוחרים את הפרויקט Google Cloud .
- בוחרים את הסוכן.
- לוחצים על הכרטיסייה ניהול.
- לוחצים על סוגי ישויות.
- לוחצים על יצירה.
- מזינים את נתוני הישות.
- לוחצים על Save.
API
משתמשים בשיטה create של EntityType.
בוחרים פרוטוקול וגרסה להפניה EntityType:
| פרוטוקול | V3 | V3beta1 |
|---|---|---|
| REST | EntityType resource | EntityType resource |
| RPC | ממשק EntityType | ממשק EntityType |
| C++ | EntityTypesClient | לא זמין |
| C# | EntityTypesClient | לא זמין |
| המשך | EntityTypesClient | לא זמין |
| Java | EntityTypesClient | EntityTypesClient |
| Node.js | EntityTypesClient | EntityTypesClient |
| PHP | לא זמין | לא זמין |
| Python | EntityTypesClient | EntityTypesClient |
| Ruby | לא זמין | לא זמין |
מגבלות
ההגבלות הבאות חלות:
- השמות המוצגים של סוגי ישויות בהתאמה אישית הם ייחודיים לכל סוכן.
שמות התצוגה של סוגי הישויות צריכים להתחיל באות ויכולים להכיל את התווים הבאים:
A-Z,a-z,0-9,_(קו תחתון),-(מקף). אין הגבלה כזו לגבי הפניה לישות ולערכי מילים נרדפות.
ייצוא וייבוא של ישויות מותאמות אישית
אתם יכולים לייצא ולייבא ישויות כדי לשתף אותן בין סוכנים.
אחת מאפשרויות הפורמט לייצוא היא חבילת JSON, שהיא קובץ ZIP שמכיל היררכיה של ספריות וקובצי JSON. בקטע הבא מתואר מבנה הספריות:
-
entityTypes: בספרייה הזו מופיעים סוגי הישויות שלכם.-
<entity type name>: קיימת ספרייה אחת או יותר, ושמות הספריות תואמים לשמות המוצגים של סוגי הישויות.-
entities: בספרייה הזו יש קובצי רשומות של ישויות.-
<language tag>.json: קובץ אחד או יותר מהקבצים האלה קיימים, ושמות הקבצים תואמים לתגי שפה. כל קובץ מכיל רשומות של ישויות בשפה ספציפית.
-
-
<excludedPhrases>: בספרייה הזו יש קבצים של ביטויים מוחרגים.-
<language tag>.json: קובץ אחד או יותר מהקבצים האלה קיימים, ושמות הקבצים תואמים לתגי שפה. כל קובץ מכיל החרגות של ביטויים ספציפיים לשפה.
-
-
<entity type name>.json: שם הקובץ הזה תואם לשם המוצג של סוג הישות. הקובץ מכיל נתונים ספציפיים לסוג הישות שלא נמצאים בקבצים אחרים.
-
-
לדוגמה:
entityTypes ⤷ Entity Type A ⤷ entities ⤷ en.json ⤷ en-gb.json ⤷ en-ca.json ⤷ excludedPhrases ⤷ en.json ⤷ en-gb.json ⤷ en-ca.json ⤷ Entity Type A.json ⤷ Entity Type B ⤷ entities ⤷ en.json ⤷ en-gb.json ⤷ en-ca.json ⤷ excludedPhrases ⤷ en.json ⤷ en-gb.json ⤷ en-ca.json ⤷ Entity Type B.json
כשמייבאים סוגי ישויות, יכול להיות שיהיו התנגשויות מיזוג אם השם המוצג של סוג ישות בסוכן הקיים תואם לשם המוצג של סוג ישות מיובא. כדי לשלוט בהתנהגות המיזוג כששמות התצוגה של סוגי הישויות זהים, בוחרים באחת מהאפשרויות הבאות:
- החלפת סוגי ישויות קיימים: סוג ישות מיובא מחליף סוג ישות בעל שם זהה בסוכן הקיים.
- מיזוג עם סוגי ישויות קיימים: ערכי הישות של סוג ישות מיובא מתווספים לסוג הישות הקיים. אם יש רשומות זהות של ישויות, הן לא ישוכפלו, והמילים הנרדפות שמתחתיהן ימוזגו.
- שינוי שם וייבוא כסוגי ישויות חדשים: השם של סוג הישות המיובא משתנה על ידי הוספת '_1' לשם המוצג.
- דילוג על סוגי הישויות: סוג הישות הקיים נשאר ללא שינוי, וסוג הישות המיובא מתעלם.
כדי לייצא סוגי ישויות:
המסוף
- פותחים את מסוף Dialogflow CX.
- בוחרים את הפרויקט Google Cloud .
- בוחרים את הסוכן.
- לוחצים על הכרטיסייה ניהול.
- לוחצים על סוגי ישויות.
- בוחרים את כל סוגי הישויות שרוצים לייצא.
- לוחצים על ייצוא הישות שנבחרה.
- בוחרים את הפורמט ואת היעד.
- לוחצים על שליחה.
כדי לייבא סוגי ישויות:
המסוף
- פותחים את מסוף Dialogflow CX.
- בוחרים את הפרויקט Google Cloud .
- בוחרים את הסוכן.
- לוחצים על הכרטיסייה ניהול.
- לוחצים על סוגי ישויות.
- לוחצים על Import.
- בוחרים את המקור ואת אופן המיזוג.
- לוחצים על שליחה.
ייבוא של רשומות של ישויות
אפשר לייבא רשומות של ישויות לסוג ישות קיים.
פורמט הקובץ שמשמש לייבוא של רשומות של ישויות זהה לפורמט שמשמש לייבוא של סוגי ישויות. עם זאת, קובץ הייבוא יכול להכיל רק סוג ישות אחד, וכל הרשומות שמתחתיו ייובאו לסוג הישות שנבחר. אם יש רשומות זהות של ישויות, הן לא ישוכפלו, והמילים הנרדפות שמתחתיהן ימוזגו.
כדי לייבא רשומות של ישויות לסוג ישות:
המסוף
- פותחים את מסוף Dialogflow CX.
- בוחרים את הפרויקט Google Cloud .
- בוחרים את הסוכן.
- לוחצים על הכרטיסייה ניהול.
- לוחצים על סוגי ישויות.
- בוחרים יישות.
- לוחצים על ייבוא לישות.
- בוחרים קובץ.
- לוחצים על שליחה.