הגדרת אימות לכלי לבחירת קבצים

כשמשוחחים עם העוזר האישי של Gemini Enterprise, המשתמשים יכולים לצרף קבצים באמצעות הכלי לבחירת קבצים. העוזר הדיגיטלי תומך בשלושה מקורות של קבצים: קבצים מקומיים, קבצים מ-Google Drive וקבצים מ-Microsoft OneDrive. בדף הזה מוסבר איך אדמינים יכולים להגדיר את ההתנהגות הזו.

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

  • באיזו אפליקציית כניסה משתמשים בכלי לבחירת חשבון. כלי הבחירה יכול להשתמש שוב באפליקציית Microsoft Entra (לשעבר Azure AD) או באפליקציית Google שאתם מגדירים במחבר, במקום באפליקציה שמוגדרת כברירת מחדל ומנוהלת על ידי Google.
  • איזה דייר (tenant) ב-Microsoft Entra משמש את בורר OneDrive. הכלי לבחירת קבצים ב-OneDrive יכול להכניס משתמשים לדייר (tenant) הספציפי שלכם ב-Microsoft Entra.

במאמר העלאת קבצים וצ'אט לגביהם מוסבר איך משתמשי הקצה יכולים לצרף קבצים ולשוחח עליהם בצ'אט.

איך פועלים כלים לבחירת קבצים

אם הגדרתם את מאגרי הנתונים של Google Drive ו-OneDrive כך שישתמשו באותן הגדרות הרשאה לכלי לבחירת קבצים, הכלי לבחירת קבצים ישתמש באותן הגדרות כדי לאמת משתמשים. בטבלה הבאה מפורטים שני אמצעי הבקרה והבוררים שהם משפיעים עליהם.

שליטה מה היא עושה חל על
אפליקציית כניסה בהתאמה אישית כדי לאמת משתמשים כשהם מצרפים קבצים ל-Assistant באמצעות הכלי לבחירת קבצים, Gemini Enterprise יכול להשתמש בהגדרות הקיימות של Microsoft Entra ID או Google Identity במאגר הנתונים, במקום באפליקציה ש-Google מנהלת כברירת מחדל. ‫Google Drive ו-OneDrive
אכיפה ברמת הדייר כדי להשתמש בבורר של OneDrive, המשתמשים צריכים להיכנס לדייר (tenant) הספציפי שלך ב-Microsoft Entra (https://login.microsoftonline.com/{your-tenant}/...) במקום לנקודת הקצה המשותפת לכניסה (/common/), כדי שמשתמשים מדיירים אחרים לא יוכלו לבצע אימות. הדייר נקרא מהמחבר המצורף של OneDrive. OneDrive בלבד

האדמינים מצרפים מחברים לאפליקציה כדי להגדיר את ההתנהגות הזו.

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

  • ספק אחד לכל סוג מחבר. אפשר לצרף לאפליקציה רק ספק הגדרות אישיות אחד של OneDrive וספק הגדרות אישיות אחד של Google Drive בכל פעם. אם תסמנו מחבר שני מאותו סוג כספק, הבקשה תידחה ותופיע שגיאת invalid-argument.
  • הספק חייב להיות מחבר עם פעולות מופעלות. ספק ההגדרות האישיות חייב להיות מחבר של OneDrive או Google Drive שתומך בפעולות או בגישה מאוחדת. מחבר להטמעה בלבד לא יכול להיות ספק הגדרות אישיות. מידע נוסף על ניהול פעולות

לפני שמתחילים

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

  • הרשאת אדמין. מקצים את התפקיד Discovery Engine Editor‏ (roles/discoveryengine.editor). התפקיד הזה נדרש כדי שהמשתמש יוכל ליצור את מאגר הנתונים. כדי להקצות את התפקיד הזה:
    1. נכנסים לדף IAM במסוף Google Cloud .

      כניסה לדף IAM

    2. מוצאים את חשבון המשתמש ולוחצים על עריכה .
    3. מקצים למשתמש את התפקיד Discovery Engine Editor. מידע נוסף זמין במאמר תפקידים והרשאות ב-IAM.
  • אפליקציית כניסה מותאמת אישית ל-OneDrive. ודאו שיש לכם אפליקציית Microsoft Entra ID בשליטתכם, כולל מזהה הלקוח, סוד הלקוח ומזהה הדייר (tenant) שלה, וחשבון OneDrive בדייר הזה לצורך בדיקה. מידע נוסף זמין במאמר רישום אפליקציה בפלטפורמת הזהויות של מיקרוסופט.
  • מאגר נתונים מוגדר. מגדירים מאגר נתונים ב-OneDrive או ב-Google Drive. כשמגדירים את מאגר הנתונים, צריך להגדיר את הגדרות האימות שכוללות את מזהה הלקוח, סוד הלקוח ומזהה הדייר של מאגר הנתונים ב-OneDrive. מידע נוסף זמין במאמרים הבאים:
  • מאגר נתונים מצורף. מקשרים את מאגר הנתונים של OneDrive או של Google Drive לאפליקציית Gemini Enterprise. מידע נוסף זמין במאמר קישור מאגר נתונים לאפליקציה.

שימוש באפליקציית כניסה משלכם

כברירת מחדל, הכלי לבחירת קבצים משתמש באפליקציה בניהול Google כדי להיכנס לחשבון. כדי שהבורר ישתמש ב-Microsoft Entra ID או ב-Google Identity שלכם, אתם יכולים להגדיר מחבר אחד כספק ההגדרות של הבורר.

אם כבר יש לכם מאגר נתונים מוגדר ב-OneDrive או ב-Google Drive, בצעו את השלבים הבאים:

  1. נכנסים לדף Gemini Enterprise במסוף Google Cloud .

    Gemini Enterprise

  2. בוחרים או יוצרים פרויקט ב- Google Cloud .

  3. בתפריט הניווט, לוחצים על Data stores.

  4. מחפשים את מאגר הנתונים ולוחצים על השם שלו.

  5. לוחצים על הצגה/עריכה של פרמטרים.

  6. בוחרים באפשרות Picker Config Provider.

  7. לוחצים על Save.

ביטול השינויים כדי להשתמש באפליקציה בניהול Google

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

  1. נכנסים לדף Gemini Enterprise במסוף Google Cloud .

    Gemini Enterprise

  2. בוחרים את הפרויקט ב- Google Cloud .

  3. בתפריט הניווט, לוחצים על Data stores.

  4. לוחצים על השם של מאגר הנתונים.

  5. לוחצים על הצגה/עריכה של פרמטרים.

  6. מנקים את השדה Picker Config Provider.

  7. לוחצים על Save.

חוויית השימוש של משתמש הקצה

אחרי שמגדירים את בוררי הקבצים, משתמשי הקצה נהנים מחוויית השימוש הבאה:

  • ב-OneDrive, המשתמשים מתבקשים להיכנס לדייר (tenant) של הארגון במיקרוסופט. חשבונות מדיירים אחרים נדחים.
  • הכניסה מתבצעת באמצעות האפליקציה שהגדרתם: כברירת מחדל, האפליקציה שמנוהלת על ידי Google, או האפליקציה שלכם אם הגדרתם ספק הגדרות אישיות.
  • אחרי הכניסה הראשונה לחשבון, החיבור נשמר לבחירות הבאות של הקבצים.

מידע נוסף על חוויית המשתמש זמין במאמר העלאת קבצים וניהול שיחות לגביהם.

פתרון בעיות

תיאור הבעיה סיבה אפשרית רזולוציה
סימון מחבר בתור **ספק הגדרות של בורר** נכשל עם השגיאה Cannot enable picker_config_provider on data connector '...' because another connector in the same engine is already the picker config provider: '...'. An engine can have at most one picker_config_provider connector; disable it on the other connector first. מחבר אחר באותו מנוע כבר מוגדר כספק של הגדרות בורר. לכל מנוע יכול להיות רק אחד כזה. מנקים את הפרמטר **Picker Config Provider** במחבר השני ומנסים שוב.
הכניסה ל-OneDrive נכשלת עם AADSTS50020: User account 'user@domain.com' from identity provider '...' does not exist in tenant '...' חשבון המשתמש נמצא בדייר Microsoft Entra שונה מהדייר שהוגדר במחבר. נקודת הקצה לכניסה הספציפית לדייר דוחה את החשבון. אכיפת הדייר פועלת כמצופה. צריך לבקש מהמשתמש להיכנס באמצעות חשבון בדייר שהגדרת, או לעדכן את מזהה הדייר של המחבר.
‫OneDrive עדיין מציג את נקודת הקצה המשותפת לכניסה. הדייר עדיין לא הוגדר, או שהשינוי עדיין לא הופץ. מאשרים את מזהה הדייר (tenant) של המחבר. יכול להיות שיעברו כ-3 דקות עד שהשינויים בהגדרות ייכנסו לתוקף. צריך להמתין ואז לנסות שוב.

המאמרים הבאים