סוכנים רב-לשוניים

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

שפות בסיס ושפות ספציפיות ללוקאל

יש שתי קטגוריות של שפות:

• שפות בסיס: אלה שפות כמו אנגלית (en) שלא מציינות לוקאל.
• שפות ספציפיות ללוקאל: אלה שפות כמו אנגלית (ארה"ב) (en-US) שמציינות לוקאל כאזור או כמדינה ספציפיים.

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

• סינית-קנטונזית (zh-HK)
• סינית פשוטה (zh-CN)
• סינית (מסורתית) (zh-TW)
• פורטוגזית (ברזיל) (pt-BR)
• פורטוגזית – פורטוגל (pt)

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

הוספת שפה

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

כדי להוסיף שפה או לוקאל באמצעות מסוף Dialogflow ES:

1. בתפריט הצדדי השמאלי, לוחצים על לחצן הוספת שפה לצד השפות הקיימות.
   הלחיצה תעביר אתכם לכרטיסייה שפות בהגדרות הסוכן.
2. בוחרים שפה מהתפריט הנפתח Select Additional Language (בחירת שפה נוספת).
3. כדי להוסיף לוקאל, מעבירים את העכבר מעל שפת בסיס ולוחצים על + הוספת לוקאל.
4. לוחצים על Save.

נתונים ספציפיים לשפה

הערה: המידע בסעיף הזה רלוונטי גם לשפות ספציפיות ללוקאל וגם לשפות בסיסיות. לדוגמה: לכל אחד מהסוכנים en, en-US ו-en-GB יש נתונים ייחודיים של

ביטויים לאימון כוונות.

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

• משפטי אימון לזיהוי כוונות
• תשובות לכוונות
• entity entries

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

לדוגמה, סוג הישות size שמופיע בהמשך משמש להזמנת חולצות טישרט. הסוכן הוגדר במקור באנגלית, ולכן לישות יש ערכים כמו 'S' עם המילה הנרדפת 'small'. כשמוסיפים את הספרדית כשפה,‏ Dialogflow יוצר את הישות בשפה החדשה, אבל צריך לספק רשומות של ישויות בספרדית.

ישות	מילים נרדפות
XS	XS, extra pequeño
S	S, pequeño
M	M, medio
L	L, grande
XL	XL, extra grande

נתונים ספציפיים לשפה כשמשתמשים ב-API

כדי לגשת לנתונים ספציפיים לשפה באמצעות ה-API, צריך לספק את הפרמטר languageCode כשמקבלים, יוצרים או מעדכנים סוגים של EntityType או Intent.

כדי לגשת לכל הנתונים הספציפיים לשפה, צריך לשלוח קריאות נפרדות ל-API לכל שפה. אם קריאות ה-API שלכם מעדכנות נתונים כלליים לשפה, הנתונים האלה מתעדכנים לכל השפות.

בדיקה בסימולטור

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

ציון שפה באמצעות ה-API

כששולחים בקשות באמצעות ה-API, צריך להגדיר את השדה queryInput.input.languageCode של השיטה detectIntent. מידע נוסף זמין במאמר בנושא סוג Sessions.

בקשות שלא מצוינת בהן השפה של הנציג

כש-Dialogflow מקבל בקשה שלא מצוינת בה שפה שהנציג תומך בה, הכללים הבאים חלים:

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

שילובים

אינטראקציות עם נציגים באמצעות שילובים של שער לטלפון וצ'אט מבוסס-טקסט מתבצעות רק בשפת ברירת המחדל של הנציג.