הגדרה של מאגר נתונים ב-Microsoft OneDrive

בדף הזה מוסבר איך ליצור מאגר נתונים ולחבר את Microsoft OneDrive ל-Gemini Enterprise.

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

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

  1. מקצים את התפקיד Discovery Engine Editor‏ (roles/discoveryengine.editor). התפקיד הזה נדרש כדי שהמשתמש יוכל ליצור את מאגר הנתונים. כדי להקצות את התפקיד הזה:

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

      כניסה לדף IAM

    2. מוצאים את חשבון המשתמש ולוחצים על עריכה .
    3. מקצים למשתמש את התפקיד Discovery Engine Editor. מידע נוסף זמין במאמר תפקידים והרשאות ב-IAM.

  2. רושמים את Gemini Enterprise בתור אפליקציית OAuth 2.0 ב-Microsoft Entra ID ומקבלים את פרטי הכניסה הבאים:

    • מזהה לקוח

    • סוד לקוח

    • מזהה דייר (tenant)

  3. מגדירים את הרשאות האפליקציה של Microsoft API בהסכמת האדמין של Microsoft OneDrive.

יצירת מאגר נתונים ב-Microsoft OneDrive

כדי ליצור מאגר נתונים של Microsoft OneDrive:

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

    Gemini Enterprise

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

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

  4. ‫Create data store.

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

  6. בקטע נתונים:

    1. בקטע מצב מחבר, בוחרים באפשרות הטמעת נתונים או חיפוש מאוחד כמצב החיבור.

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

    3. בקטע Authentication settings, מגדירים את האימות בהתאם למצב החיבור שנבחר.

      1. מזינים את פרטי האימות הבאים:
        • מזהה לקוח: המזהה הייחודי של האפליקציה שרשומה ב-Microsoft Entra ID של הארגון.
        • סוד לקוח: המפתח הסודי שנוצר במהלך תהליך הרישום של אפליקציית OAuth 2.0 ב-Microsoft Entra ID.

        • מזהה הדייר: המזהה הייחודי של הארגון שלכם במרכז הניהול של Microsoft Entra. מידע נוסף זמין במאמר קבלת פרטי כניסה של לקוח.

        • סוג הסביבה של Microsoft OneDrive: בוחרים את הסביבה שמארחת את הדייר (tenant) שלכם ב-Microsoft 365:

          • אם אתם מתחברים ל-Microsoft 365 מסחרי רגיל או ל-Government Community Cloud ‏(GCC), בחרו באפשרות רגיל (ברירת המחדל).
          • אם אתם מתחברים לענן ריבוני של ממשלת ארה"ב ב-Microsoft 365 (‏GCC High או DoD), בוחרים באפשרות ממשלת ארה"ב.

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

        • מזהה הנושא: המזהה הייחודי של חשבון השירות שבו אתם מתכננים להשתמש.

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

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

    5. אם בחרתם באפשרות חיפוש מאוחד:

      1. בקטע יעדים, מזינים את כתובת ה-URL הבסיסית של האתר ב-Microsoft OneDrive.

      2. בקטע Advanced options,

        1. בוחרים את סביבת הענן של Microsoft 365:
          • אם אתם מתחברים למכונה של Microsoft 365 US Government, בחרו באפשרות שמתאימה לה: GCC,‏ GCC High או DoD.
          • אחרת, משאירים את ברירת המחדל Global.
        2. מזינים את Azure Tenant, מזהה הדייר שקיבלתם כשיצרתם את אפליקציית Entra.

        3. אתם יכולים לצמצם את היקף החיפושים והפעולות שלכם על ידי ציון הנתיבים של Microsoft OneDrive שאתם רוצים לכלול או להחריג. אפשר לשנות או לאחזר נתונים רק בנתיבים הכלולים. בקשות לנתונים שלא נכללים בהיקף נכשלות או לא מחזירות תוצאות.

          אפשר להוסיף מסננים למאגר הנתונים באמצעות מסוף Google Cloud או ה-API:

          המסוף

          הערה: כשמזינים כמה אתרים, צריך להפריד בין כתובות ה-URL באמצעות פסיק. אפשר גם להעתיק ולהדביק רשימה של כתובות URL ישירות מקובץ CSV.

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

              הערה: השדה הזה תומך בנתיבי משנה, בתיקיות ובספריות מסמכים, בפורמט https://{your-tenant}.sharepoint.com/sites/{your-site-name}/{your-folder-name}/. כל תוכן בנתיב שצוין יסונן.

          REST

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

          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": "sharepoint_federated_search",
            "params": {
            "client_id": "CLIENT_ID",
            "client_secret": "CLIENT_SECRET",
            "instance_uri": "INSTANCE_URI",
            "tenant_id": "TENANT_ID",
            "FILTER_TYPE": {
                "FILTER_KEY": [
                "FILTER_VALUE1",
                "FILTER_VALUE2"
                ]
            }
            },
            "entities": [
            {
                "entityName": "file"
            }
            ],
            "refreshInterval": "7200s",
            "connectorType": "THIRD_PARTY_FEDERATED",
            "connectorModes": [
            "FEDERATED"
            ]
        }
        }'

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

          • ‫PROJECT_ID: מזהה הפרויקט.
          • ‫ENDPOINT_LOCATION: האזור המרובה לבקשת ה-API. מציינים אחד מהערכים הבאים:
            • ‫us לאזור הגיאוגרפי שכולל מספר אזורים בארה"ב
            • ‫eu למספר אזורים באיחוד האירופי
            • ‫global למיקום הגלובלי
            מידע נוסף זמין במאמר הגדרת מספר אזורים למאגר הנתונים.
          • ‫LOCATION: האזור של מאגר הנתונים: global,‏ us או eu
          • ‫COLLECTION_ID: המזהה הייחודי של מאגר הנתונים.
          • ‫COLLECTION_DISPLAY_NAME: השם המוצג של מאגר הנתונים.
          • ‫CLIENT_ID: מזהה הלקוח לאימות ב-Microsoft OneDrive.
          • ‫CLIENT_SECRET: סוד הלקוח לאימות ב-Microsoft OneDrive.
          • ‫INSTANCE_URI: ה-URI של המכונה ב-Microsoft OneDrive.
          • TENANT_ID: מזהה הדייר ב-Microsoft OneDrive.
          • ‫FILTER_TYPE: סוג המסנן שנוסף למאגרי הנתונים של Microsoft OneDrive. מידע נוסף זמין במאמר סוגי מסננים.
          • ‫FILTER_KEY: המפתח של המסנן, שתואם לשדה בנתונים. מידע נוסף זמין במאמר בנושא מקשי סינון.
          • ‫FILTER_VALUES: הערך או הערכים שלפיהם רוצים לסנן את FILTER_KEY.

        פרטים נוספים על סוגי המסננים ועל הוספת מסננים זמינים במאמר הוספת מסננים למאגר נתונים של Microsoft OneDrive.

    6. אם בחרתם באפשרות הטמעת נתונים, בקטע אפשרויות מתקדמות מבצעים את הפעולות הבאות:

      1. אופציונלי: כדי לאפשר קבוצה של כתובות IP סטטיות במערכת, מסמנים את התיבה הפעלת כתובות IP סטטיות. מידע נוסף זמין במאמר הגדרת תעבורת נתונים יוצאת עם כתובת IP סטטית.
      2. אופציונלי: בשדה מספר מקסימלי של שאילתות לשנייה (QPS), מזינים את המספר המקסימלי של שאילתות לשנייה כדי להגביל את קצב השאילתות שהמחבר שולח למכונה של Microsoft OneDrive.
      3. אופציונלי: כדי לנסות לפענח את כל הקבצים שמוצפנים באמצעות הגנת המידע של Microsoft Purview, מסמנים את התיבה פענוח קבצים שמוצפנים באמצעות הגנת המידע של Microsoft Purview.

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

    8. בקטע ישויות לחיפוש (אם בחרתם באפשרות חיפוש מאוחד) או ישויות לסנכרון (אם בחרתם באפשרות הטמעת נתונים):

      1. בוחרים את כל הישויות הנדרשות.
      2. אם בחרתם באפשרות חיפוש מאוחד, המשיכו לשלב הבא.
      3. אם בחרתם באפשרות הטמעת נתונים, המשיכו לשלבים הבאים:
        1. אופציונלי: כדי לסנכרן פרויקטים ספציפיים, מבצעים את הפעולות הבאות:
          1. לוחצים על סינון.
          2. כדי לסנן ישויות מהאינדקס, מסמנים את התיבה החרגה מהאינדקס. כדי לוודא שהן נכללות באינדקס, מסמנים את התיבה הכללה באינדקס.
          3. מזינים את המפתחות. צריך ללחוץ על Enter אחרי כל מפתח.
          4. לוחצים על Save.
        2. כדי להגדיר את תזמון הסנכרון:
          1. ברשימה תדירות הסנכרון, בוחרים את תדירות הסנכרון.
            • כדי לתזמן סנכרונים מלאים נפרדים של נתוני ישויות וזהויות, מרחיבים את התפריט בקטע סנכרון מלא ובוחרים באפשרות אפשרויות בהתאמה אישית.
          2. ברשימה תדירות הסנכרון המצטבר, בוחרים את תדירות הסנכרון המצטבר. מידע נוסף זמין במאמר לוחות זמנים לסנכרון.

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

  8. בקטע פעולות:

    1. אם בחרתם באפשרות חיפוש מאוחד:
      1. בקטע בחירת פעולות של Microsoft OneDrive להפעלה, בוחרים את הפעולות מהקטגוריה כדי להפעיל אותן במחבר.

    2. אם בחרתם באפשרות הטמעת נתונים:

      1. בקטע Authentication settings, מגדירים את האימות בהתאם למצב החיבור שנבחר. מזינים את פרטי האימות הבאים:

        • מזהה לקוח: המזהה הייחודי של האפליקציה שרשומה ב-Microsoft Entra ID של הארגון.
        • סוד לקוח: המפתח הסודי שנוצר במהלך תהליך הרישום של אפליקציית OAuth 2.0 ב-Microsoft Entra ID.
        • מזהה הדייר: המזהה הייחודי של הארגון שלכם במרכז הניהול של Microsoft Entra.

        מידע נוסף זמין במאמר קבלת פרטי כניסה של לקוח.

      2. לוחצים על התחברות ונכנסים ל-Microsoft OneDrive כדי לאמת את החשבון.

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

      4. בקטע Advanced settings, מזינים את Azure Tenant, מזהה הדייר שקיבלתם כשיצרתם את האפליקציה ב-Entra.

      5. בקטע יעדים, מזינים את כתובת ה-URL הבסיסית של האתר ב-Microsoft OneDrive.

      6. בקטע בחירת פעולות של Microsoft OneDrive להפעלה, בוחרים את הפעולות מהקטגוריה כדי להפעיל אותן במחבר.

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

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

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

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

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

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

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

בדף Data Stores, לוחצים על שם מאגר הנתונים כדי לראות את הסטטוס. אחרי שהסטטוס של מאגר הנתונים משתנה מבשלבי יצירה לפעיל, אפשר להשתמש במחבר של Microsoft OneDrive.

במחבר הטמעה שנוצר באמצעות Microsoft OneDrive, מצב מאגר הנתונים משתנה מבשלבי יצירה לפועל כשהסנכרון מתחיל. אחרי שההטמעה מסתיימת, הסטטוס משתנה ל-Active (פעיל), מה שמציין שמאגר הנתונים מוגדר באופן מלא. בהתאם לנפח הנתונים, יכול להיות שתהליך ההטמעה יימשך כמה שעות.

אחרי שיוצרים את מאגר הנתונים, יוצרים אפליקציה, מקשרים אותה למאגר הנתונים של Microsoft OneDrive ונותנים ל-Gemini Enterprise הרשאה לגשת ל-Microsoft OneDrive לפני שמריצים שאילתות.

הפעלת סנכרון בזמן אמת להטמעת נתונים

כדי להפעיל סנכרון בזמן אמת במאגר הנתונים:

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

    Gemini Enterprise

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

  3. לוחצים על השם של מאגר הנתונים ב-Microsoft OneDrive שרוצים להפעיל בו סנכרון בזמן אמת.

  4. בדף Data של מאגר הנתונים, ממתינים עד שהערך של Connector state ישתנה ל-Active.

  5. בשדה סנכרון בזמן אמת, לוחצים על צפייה/עריכה.

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

  7. בשדה סוד לקוח, מזינים ערך. הערך הזה משמש לאימות אירועי webhook של Microsoft OneDrive. מומלץ להשתמש במחרוזת של 20 תווים.

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

    מחכים שהשדה סנכרון בזמן אמת ישתנה לפועל.

טיפול בנתונים והרצת שאילתות

בקטע הזה מוסבר איך Gemini Enterprise מנהל את השאילתה שלכם ומהן ההשלכות על הפרטיות כשמשתמשים במאגר הנתונים המשותף.

הרצת שאילתות

אחרי שנותנים הרשאה ל-Microsoft OneDrive ושולחים שאילתת חיפוש ל-Gemini Enterprise:

  • ‫Gemini Enterprise שולח את שאילתת החיפוש ישירות ל-API של מיקרוסופט.
  • ‫Gemini Enterprise משלב את התוצאות עם תוצאות ממקורות נתונים מקושרים אחרים ומציג תוצאת חיפוש מקיפה.

טיפול בנתונים

כשמשתמשים בחיפוש מאוחד של צד שלישי, חלים הכללים הבאים לטיפול בנתונים:

  • מחרוזת השאילתה נשלחת למערכת הבק-אנד של צד שלישי (Microsoft API).
  • הצדדים השלישיים האלה עשויים לשייך את השאילתות לזהות שלכם.
  • אם מופעלים כמה מקורות נתונים של חיפוש מאוחד, יכול להיות שהשאילתה תישלח לכולם.
  • אחרי שהנתונים מגיעים למערכת של הצד השלישי, הם כפופים לתנאים ולהגבלות ולמדיניות הפרטיות של המערכת הזו.

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