הגדרה של מאגר נתונים ב-Google Drive

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

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

כדי להכין את סביבת Google Drive לפני שיוצרים את מאגר הנתונים:

  • אתם צריכים להיכנס למסוף Google Cloud באמצעות אותו חשבון שבו אתם משתמשים במופע של Google Drive שאתם מתכננים לחבר. כדי להתחבר ל-Google Drive, ‏Gemini Enterprise משתמש במספר הלקוח שלכם ב-Google Workspace. לחשבונות Google אישיים (חשבונות של משתמשים פרטיים עם הסיומת @gmail.com) אין מספר לקוח ואין להם תמיכה.

  • כדי לאכוף את בקרת הגישה למקורות הנתונים ולאבטח את הנתונים ב-Gemini Enterprise, ודאו שהגדרתם את ספק הזהויות.

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

  • הפעלת הגישה ל-Gemini Enterprise ב-Google Workspace: בGoogle מסוף Admin, אדמין ב-Google Workspace בארגון שבו נמצאים המשתמשים ומיקום אחסון הנתונים של Google Drive צריך להפעיל את ההגדרה אפשר לתת ל-Gemini Enterprise גישה לנתוני Google Workspace. אם ההגדרה הזו מושבתת, החיפושים ב-Google Drive לא מחזירים תוצאות באפליקציית האינטרנט של Gemini Enterprise (ויכולים להחזיר שגיאת 403 Permission Denied: Workspace access for Agentspace disabled by organization admin. ב-API). איך שולטים בגישה של Gemini Enterprise לנתוני Google Workspace

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

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

  • הגדרת גישה בין ארגונים (אם רלוונטי): כברירת מחדל, Gemini Enterprise מאפשר למשתמשים לחפש במאגר נתונים ב-Google Drive רק אם מזהה הלקוח של המשתמש ב-Google Workspace תואם לארגון של מאגר הנתונים ב-Google Drive ולפרויקט ב- Google Cloud . אם המשתמשים או הנתונים ב-Google Drive שייכים לארגון אחר ב-Google Workspace (לדוגמה, אם פרויקט Google Cloud נמצא בדומיין אחד והמשתמשים נכנסים מדומיין נפרד אחד או יותר ב-Google Workspace או מדיירים לבדיקה), צריך לבצע את השלבים הבאים:

    1. פונים לCloud Customer Care כדי להוסיף את מזהה הלקוח של כל ארגון ב-Google Workspace (לדוגמה, C01234567) לרשימת ההיתרים של הפרויקט ב- Google Cloud .
    2. מבקשים מהאדמין ב-Google Workspace בכל ארגון ב-Google Workspace להפעיל את ההגדרה אפשר לתת ל-Gemini Enterprise גישה לנתוני Google Workspace במסוף Admin של הארגון Google . לא מספיק להפעיל את ההגדרה הזו רק בארגון של הפרויקט Google Cloud . איך שולטים בגישה של Gemini Enterprise לנתונים ב-Google Workspace

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

יצירת מאגר הנתונים ב-Google Drive

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

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

    Gemini Enterprise

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

  3. בתפריט הניווט, לוחצים על מאגרי נתונים.

  4. ‫ לוחצים על Create data store.

  5. בקטע מקור, מחפשים את Google Drive ולוחצים על בחירה.

  6. אופציונלי: בקטע Data, מגדירים מסננים שקובעים את היקף התוכן ב-Google Drive שמאגר הנתונים מחפש. כדי להגדיר מסננים באמצעות מסוף Google Cloud או API בארכיטקטורת REST, בוחרים באחת מהאפשרויות הבאות:

    המסוף

    1. בשדה מזהי תיקיות אחסון שיתופי, בשדה מזהי תיקיות או בשניהם, מזינים את המזהים שרוצים לסנן לפיהם.
    2. בכל שדה, בוחרים באפשרות Include כדי לחפש רק את המזהים שצוינו, או באפשרות Exclude כדי להשמיט אותם מהחיפוש. מגדירים לכל שדה מצב Include או מצב Exclude, אבל לא את שניהם.
    3. כדי לאתר מזהה של תיקייה או של אחסון שיתופי, פותחים את התיקייה או את האחסון השיתופי ב-Google Drive ומעתיקים את המזהה מכתובת ה-URL. כתובת ה-URL היא בפורמט הזה: https://drive.google.com/drive/folders/ID. לדוגמה, https://drive.google.com/drive/folders/123456789012345678901.

    ‫API בארכיטקטורת REST

    כדי ליצור מאגר נתונים עם מסננים, מפעילים את השיטה setUpDataConnector.

    רשימות ההכללה מוגדרות בקטע admin_filter ורשימות ההחרגה מוגדרות בקטע admin_exclusion_filter. לכל סוג מסנן, מאכלסים את הרשימה בקטע admin_filter או בקטע admin_exclusion_filter, אבל לא בשניהם.

       curl -X POST \
       -H "Authorization: Bearer $(gcloud auth print-access-token)" \
       -H "Content-Type: application/json" \
       -H "X-Goog-User-Project: PROJECT_ID" \
       "https://ENDPOINT_LOCATION-discoveryengine.googleapis.com/v1alpha/projects/PROJECT_ID/locations/LOCATION:setUpDataConnector" \
       -d '{
           "collectionId": "COLLECTION_ID",
           "collectionDisplayName": "COLLECTION_DISPLAY_NAME",
           "dataConnector": {
             "dataSource": "google_drive",
             "params": {
               "FILTER_TYPE": {
                 "FILTER_KEY": [
                   "FILTER_VALUE_1",
                   "FILTER_VALUE_2"
                 ]
               }
             },
             "entities": [
               {
                 "entityName": "google_drive"
               }
             ],
             "connectorModes": [
               "FEDERATED"
             ]
           }
       }'
       

    מחליפים את מה שכתוב בשדות הבאים:

    • ‫PROJECT_ID: מזהה הפרויקט.
    • ‫ENDPOINT_LOCATION: האזור הגיאוגרפי של בקשת ה-API. מציינים אחד מהערכים הבאים:
      • ‫us לאזור הגיאוגרפי שכולל מספר אזורים בארה"ב
      • ‫eu למספר אזורים באיחוד האירופי
      • ‫global למיקום הגלובלי
      מידע נוסף זמין במאמר הגדרת מספר אזורים למאגר הנתונים.
    • ‫LOCATION: האזור של מאגר הנתונים: global או us.
    • ‫COLLECTION_ID: המזהה הייחודי של מאגר הנתונים.
    • ‫COLLECTION_DISPLAY_NAME: השם המוצג של מאגר הנתונים.
    • ‫FILTER_TYPE: סוג המסנן, admin_filter להכללה או admin_exclusion_filter להחרגה. צריך לאכלס את הרשימה ב-admin_filter או ב- admin_exclusion_filter, אבל לא בשניהם.
    • ‫FILTER_KEY: הישות ב-Drive שרוצים לסנן לפיה, SharedDriveIds או FolderIds.
    • ‫FILTER_VALUE_1, FILTER_VALUE_2: מזהי התיקיות או האחסון השיתופי שרוצים לסנן לפיהם.
  7. בקטע פעולות, בוחרים את הפעולות מהרשימה כדי להפעיל אותן במחבר של Google Drive.

    כדי לנהל את רשימת הפעולות, עיינו בקטע ניהול פעולות.

  8. לוחצים על Continue.

  9. בקטע Configuration (הגדרה):

    1. ברשימה Multi-region, בוחרים את המיקום של מחבר הנתונים.
    2. בשדה שם מחבר הנתונים, נותנים שם למחבר.
    3. אם בחרתם ב-us או ב-eu בתור המיקום, הגדירו את הגדרות ההצפנה:
      • בוחרים באפשרות מפתח הצפנה בניהולGoogle או מפתח Cloud KMS.
      • אם בחרתם באפשרות Cloud KMS key:
        • ברשימה Key management type, בוחרים את הסוג המתאים.
        • ברשימה Cloud KMS key, בוחרים את המפתח.
      מידע נוסף זמין במאמר מפתחות הצפנה בניהול הלקוח.

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

  11. אופציונלי: בקטע מדיניות Sensitive Data Protection, מצרפים מדיניות תוכן קיימת של Sensitive Data Protection כדי לבדוק ולחסום מידע רגיש ש-Gemini Enterprise מאחזר דרך מאגר הנתונים הזה. מידע נוסף זמין במאמר הגנה על מידע אישי רגיש במקורות. אם בארגון שלכם לא נדרשת מדיניות תוכן של Sensitive Data Protection, אתם יכולים לדלג על השלב הזה.

  12. לוחצים על יצירה. ‫Gemini Enterprise יוצר את מאגר הנתונים ומציג את מאגרי הנתונים בדף Data Stores.

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

  1. עוברים למחבר ברשימת מאגרי הנתונים ועוקבים אחרי הסטטוס שלו עד שהוא משתנה לפעיל.
  2. כשהסטטוס של מאגר הנתונים משתנה מבשלבי יצירה לפעיל, אפשר להשתמש במחבר של Google Drive.

אחרי שיוצרים את מאגר הנתונים, יוצרים אפליקציה ומקשרים אותה למאגר הנתונים ב-Google Drive לפני שמריצים את השאילתה.

הרצת שאילתות

אחרי שנותנים הרשאה ל-Google Drive, כשמזינים שאילתת חיפוש:

  1. ‫Gemini Enterprise שולח את שאילתת החיפוש שלכם אל Google Drive API.

  2. ‫Gemini Enterprise משלב את התוצאות עם תוצאות ממקורות אחרים ומציג אותן.

הודעות שגיאה ופתרון בעיות

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

קוד שגיאה הודעת השגיאה תיאור פתרון בעיות
‫403 אין לך הרשאה אי אפשר לחפש באמצעות פרטי כניסה של חשבון שירות במאגרי נתונים של Google Workspace. במנוע החיפוש יש מאגרי נתונים של Google Workspace, ופרטי הכניסה שהועברו הם של חשבון שירות. אי אפשר לחפש במאגרי נתונים של Google Workspace באמצעות פרטי כניסה לחשבון שירות. מפעילים חיפוש באמצעות פרטי הכניסה של המשתמש, או מסירים את מאגרי הנתונים של Google Workspace מהמנוע.
‫403 אין לך הרשאה אי אפשר להשתמש בחשבונות פרטיים במאגרי נתונים של Google Workspace. החיפוש מתבצע באמצעות פרטי כניסה של חשבון פרטי (‎@gmail.com), שלא נתמך במאגרי נתונים של Google Workspace. צריך להסיר את מאגרי הנתונים של Google Workspace מהמנוע או להשתמש בחשבון מנוהל Google .
‫403 אין לך הרשאה מספר הלקוח לא תואם למאגר הנתונים החיפוש מותר רק למשתמשים שמזהה הלקוח שלהם ב-Google Workspace תואם לארגון של מאגר הנתונים של Google Workspace ושל פרויקט Google Cloud , אלא אם מזהה הלקוח של המשתמש ב-Google Workspace נמצא ברשימת ההיתרים של הפרויקט. אם חוסר ההתאמה לא מכוון, צריך ליצור מחדש את מאגר הנתונים בפרויקט Google Cloud ששייך לאותו ארגון כמו המשתמשים ב-Google Workspace, או להסיר מהאפליקציה את מאגר הנתונים של Google Workspace. אם המשתמשים ומאגר הנתונים של Google Workspace אמורים להיות בארגונים שונים, צריך לפנות לCloud Customer Care כדי להוסיף את מזהה הלקוח של כל משתמש ב-Google Workspace לרשימת ההיתרים של הפרויקט ב- Google Cloud , ולוודא שאדמין ב-Google Workspace בכל ארגון של משתמש מפעיל את הגישה של Gemini Enterprise לנתוני Google Workspace. בנוסף, אם המשתמשים צריכים למצוא מסמכים שבבעלות גורמים מחוץ לארגון, צריך להפעיל את האפשרות הכללת מסמכים מדומיינים אחרים בקטע ניהול התכונות של אפליקציית האינטרנט.
‫403 אין לך הרשאה הגישה של Agentspace ל-Workspace הושבתה על ידי מנהל חשבון ארגוני. אדמין ב-Google Workspace בארגון של המשתמש ב-Google Workspace השבית את הגישה לנתוני Google Workspace ב-Gemini Enterprise. יכול להיות שהשגיאה הזו לא תוצג ישירות באתר Gemini Enterprise, ובמקום זאת, השאילתות לא יחזירו קבצים תואמים ב-Google Drive. פנו לאדמין ב-Google Workspace של הארגון של המשתמש כדי להפעיל את הגישה. בהגדרות שכוללות כמה ארגונים, צריך להפעיל את ההגדרה הזו במסוף Admin של כל ארגון ב-Google Workspace שהמשתמשים שלו שולחים שאילתות ל-Google Drive. Google
‫400 ארגומנט לא תקין הבקשה מכילה ארגומנט לא תקין. השגיאה הזו מתרחשת אם השם של מחבר הנתונים בבקשה לא עומד בדרישות למתן שמות. מוודאים שהשם של מחבר הנתונים תקין: הוא צריך להיות באורך של 1 עד 63 תווים, להתחיל באות קטנה, להסתיים באות קטנה או בספרה, ולהכיל רק אותיות קטנות, ספרות, מקפים או קווים תחתונים. לדוגמה, השתמשו בשם כמו cymbal-collection-123456789 במקום 123456789-cymbal-collection.

אם אתם נתקלים בבעיות נפוצות בחיפוש כשאתם שולחים שאילתות לנתונים ב-Google Drive, עיינו במאמר בעיות נפוצות בחיפוש.

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