הגדרת מאגר נתונים של Microsoft SharePoint

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

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

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

  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)

    • ‫URI של המכונה

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

יצירת מאגר נתונים של Microsoft SharePoint

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

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

    Gemini Enterprise

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

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

  4. ‫Create data store.

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

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

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

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

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

      1. מזינים את פרטי האימות הבאים לפי הצורך:
        • מזהה לקוח: המזהה הייחודי של האפליקציה שרשומה ב-Microsoft Entra ID של הארגון.
        • סוד לקוח: המפתח הסודי שנוצר במהלך תהליך הרישום של אפליקציית OAuth 2.0 ב-Microsoft Entra ID.
        • מזהה הדייר: המזהה הייחודי של הארגון שלכם במרכז הניהול של Microsoft Entra.
        • Instance URI: כתובת ה-URL הבסיסית של המכונה של Microsoft SharePoint (לדוגמה, https://{your-domain}.sharepoint.com).
        • סוג הסביבה של Microsoft SharePoint: בוחרים את הסביבה שמארחת את הדייר (tenant) שלכם ב-Microsoft 365:
          • אם אתם מתחברים ל-Microsoft 365 מסחרי רגיל או ל-Government Community Cloud ‏(GCC), בחרו באפשרות רגיל (ברירת המחדל).
          • אם אתם מתחברים לענן ריבוני של ממשלת ארה"ב ב-Microsoft 365 (‏GCC High או DoD), בוחרים באפשרות ממשלת ארה"ב.

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

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

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

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

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

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

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

    7. בקטע Advanced options, בוחרים את Microsoft 365 Cloud Environment:

      • אם אתם מתחברים למכונה של Microsoft 365 US Government, בחרו באפשרות שמתאימה לה: GCC,‏ GCC High או DoD.
      • אחרת, משאירים את ברירת המחדל Global.

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

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

      המסוף

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

      1. בקטע "מסנן אתרים":
        • בוחרים את סוג המסנן: הכללה בחיפוש או החרגה מהחיפוש.
        • בשדה מסנן כתובות URL של אתרים, מזינים את כתובות ה-URL המדויקות של אתרי Microsoft SharePoint שרוצים לסנן, בפורמט https://{your-tenant}.sharepoint.com/sites/{your-site-name}.

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

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

          הערה: השדה הזה תומך בנתיבי משנה, בתיקיות ובספריות מסמכים, בפורמט 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: מזהה הלקוח לאימות ב-SharePoint.
      • ‫CLIENT_SECRET: סוד הלקוח לאימות ב-SharePoint.
      • ‫INSTANCE_URI: ה-URI של המכונה ב-SharePoint.
      • ‫TENANT_ID: מזהה הדייר ב-SharePoint.
      • ‫FILTER_TYPE: סוג המסנן שנוסף למאגרי הנתונים של Microsoft SharePoint. מידע נוסף זמין במאמר סוגי מסננים.
      • ‫FILTER_KEY: המפתח של המסנן, שתואם לשדה בנתונים. מידע נוסף זמין במאמר בנושא מקשי סינון.
      • ‫FILTER_VALUES: הערך או הערכים שלפיהם רוצים לסנן את FILTER_KEY.

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

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

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

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

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

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

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

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

        1. מזינים את פרטי האימות הבאים לפי הצורך:

          • מזהה לקוח: המזהה הייחודי של האפליקציה שרשומה ב-Microsoft Entra ID של הארגון.
          • סוד לקוח: המפתח הסודי שנוצר במהלך תהליך הרישום של אפליקציית OAuth 2.0 ב-Microsoft Entra ID.
          • מזהה הדייר: המזהה הייחודי של הארגון שלכם במרכז הניהול של Microsoft Entra.
          • Instance URI: כתובת ה-URL הבסיסית של המכונה של Microsoft SharePoint (לדוגמה, https://{your-domain}.sharepoint.com).

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

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

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

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

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

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

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

  11. אם בתהליך היצירה של מאגר הנתונים מופיע הקטע Advanced options, אתם יכולים לסמן בו את התיבה Enable Static IP Addresses. כך מאגר הנתונים משתמש בקבוצה קבועה של כתובות IP לתנועה יוצאת, שמתאימות להוספה לרשימת ההיתרים במערכת המקור. מידע נוסף זמין במאמר הגדרת תעבורת נתונים יוצאת עם כתובת IP סטטית.

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

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

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

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

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

בדף Data Stores, לוחצים על שם מאגר הנתונים כדי לראות את הסטטוס. אחרי שהסטטוס של מאגר הנתונים משתנה מ-Creating (בשלבי יצירה) ל-Active (פעיל), אפשר להשתמש במחבר של Microsoft SharePoint.

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

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

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

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

ישויות ב-Microsoft SharePoint יצירה עדכון מחיקה שינויים בהרשאות
קבצים מצורפים
תגובות
אירועים
קבצים
Pages

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

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

    Gemini Enterprise

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

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

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

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

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

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

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

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

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

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

הרצת שאילתות

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

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

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

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

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

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