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

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

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

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

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

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

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

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

יצירת מאגר הנתונים ב-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 policy, מצרפים מדיניות קיימת של Sensitive Data Protection כדי לבדוק את הנתונים ש-Gemini Enterprise מאחזר דרך מאגר הנתונים הזה ולהסיר מהם פרטים מזהים. אם בארגון שלכם לא נדרשת מדיניות Sensitive Data Protection, אתם יכולים לדלג על השלב הזה.

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

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

  1. עוברים למחבר ברשימת מאגרי הנתונים ועוקבים אחרי הסטטוס שלו עד שהוא משתנה ל-Active.
  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 Workspace אמורים להיות בארגונים שונים.
‫403 אין לך הרשאה הגישה של Agentspace ל-Workspace הושבתה על ידי מנהל חשבון ארגוני. אדמין ב-Google Workspace השבית את הגישה של Gemini Enterprise לנתוני Google Workspace. כדי לקבל גישה, צריך לפנות לאדמין ב-Google Workspace.
‫400 ארגומנט לא תקין הבקשה מכילה ארגומנט לא תקין. השגיאה הזו מתרחשת אם השם של מחבר הנתונים בבקשה לא עומד בדרישות למתן שמות. מוודאים שהשם של מחבר הנתונים תקין: הוא צריך להיות באורך של 1 עד 63 תווים, להתחיל באות קטנה, להסתיים באות קטנה או בספרה, ולהכיל רק אותיות קטנות, ספרות, מקפים או קווים תחתונים. לדוגמה, השתמשו בשם כמו cymbal-collection-123456789 במקום 123456789-cymbal-collection.

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

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