סקירה כללית

מאגר הנתונים של Microsoft SharePoint ל-Gemini Enterprise מאפשר לכם לחפש ולבצע פעולות בנתונים שלכם ב-Microsoft SharePoint Online, כולל מסמכים, רשימות ואתרים.

גרסאות נתמכות של Microsoft SharePoint

מאגר הנתונים של Microsoft SharePoint תומך בגרסה העדכנית של Microsoft SharePoint Online בענן.

פעולות נתמכות

כמאגר הנתונים של Microsoft SharePoint מופעל, משתמשי הקצה יכולים להשתמש בפקודות בשפה טבעית ב-Gemini Enterprise כדי לבצע את הפעולות הבאות.

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

ההרשאות הנדרשות

כדי לאפשר ל-Gemini Enterprise לבצע חיפוש ולהטמיע נתונים באמצעות מאגר הנתונים של Microsoft SharePoint, אתם צריכים את ההרשאות הבאות:

הרשאות של Microsoft Graph API

בטבלה הבאה מפורטות ההרשאות הנדרשות לכל מצב חיבור.

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

מצב החיבור היקף מטרה
חיפוש מאוחד לא רלוונטי לא נדרשות הרשאות ל-Graph API.
הטמעת נתונים GroupMember.Read.All (פרטי כניסה מאוחדים ואסימון רענון של OAuth 2.0) מאפשרת למאגר הנתונים לקרוא את החברויות ואת מאפייני הקבוצה הבסיסיים של כל הקבוצות ללא משתמש מחובר.
User.Read (פרטי כניסה מאוחדים וטוקן רענון של OAuth 2.0) מאפשרים למאגר הנתונים לקרוא את הפרופיל של משתמשים שמחוברים לחשבון. היא גם מאפשרת למאגר הנתונים לקרוא מידע בסיסי על החברה של משתמשים שמחוברים לחשבון שלהם.
User.Read.All (טוקן רענון מסוג OAuth 2.0 בלבד) מאפשר למאגר הנתונים לקרוא פרופילים של משתמשים.
‫Sites.FullControl.All (אפשרות 1)
Sites.Selected (אפשרות 2)		 (פרטי כניסה מאוחדים ואסימון רענון של OAuth 2.0) אפשרות 1 מאפשרת למאגר הנתונים שליטה מלאה בכל אוספי האתרים. אפשרות 2 מאפשרת למאגר הנתונים לגשת לקבוצת משנה של אוספי אתרים. אפשר להגדיר ב-SharePoint Online את אוספי האתרים הספציפיים ואת ההרשאות שניתנו.
‫User.Read.All (אפשרות 1)
User.ReadBasic.All (אפשרות 2)		 (רק לפרטי כניסה מאוחדים) אפשרות 1 מאפשרת למאגר הנתונים לקרוא פרופילי משתמשים. אפשרות 2 מאפשרת למאגר הנתונים לקרוא קבוצה בסיסית של מאפייני פרופיל של משתמשים אחרים בארגון.
פעולות Sites.ReadWrite.All (חיפוש מאוחד והעברת נתונים) מאפשר למאגר הנתונים לערוך או למחוק מסמכים ופריטים ברשימה בכל אוספי האתרים בשם המשתמש שמחובר לחשבון.
Sites.Read.All (חיפוש מאוחד והעברת נתונים) מאפשרת למאגר הנתונים לקרוא רשימות, פריטים ברשימה וסכימות של רשימות בכל אוספי האתרים בשם המשתמש שמחובר לחשבון. נדרש לפעולות list lists,‏ get list item ו-get list fields.
Files.ReadWrite מאפשרת למאגר הנתונים לקרוא, ליצור, לעדכן ולמחוק את הקבצים של המשתמש שמחובר לחשבון.
Files.ReadWrite.All מאפשר למאגר הנתונים לקרוא, ליצור, לעדכן, למחוק, להעלות ולהוריד את כל הקבצים שהמשתמש המחובר יכול לגשת אליהם.
Sites.Manage.All מאפשר למאגר הנתונים ליצור או למחוק ספריות מסמכים ורשימות בכל אוספי האתרים בשם המשתמש.

הרשאות ל-Microsoft SharePoint API

בטבלה הבאה מפורטות ההרשאות הנדרשות לכל מצב חיבור.

מצב החיבור היקף מטרה
חיפוש מאוחד Sites.Search.All (הועברה הרשאה) מאפשרת למאגר הנתונים להריץ שאילתות חיפוש ולקרוא מידע בסיסי על האתר בשם המשתמש הנוכחי שמחובר לחשבון. תוצאות החיפוש מבוססות על ההרשאות של המשתמש ולא על ההרשאות של האפליקציה.
AllSites.Read (אפשרות 1, מואצל) מאפשר למאגר הנתונים לקרוא מסמכים ופריטים ברשימה בכל אוספי האתרים בשם המשתמש שמחובר לחשבון.
‫Sites.Selected (אפשרות 2, מואצל) מאפשרת למאגר הנתונים לגשת לקבוצת משנה של אוספי אתרים עם משתמש שמחובר לחשבון. אפשר להגדיר ב-SharePoint Online את אוספי האתרים הספציפיים ואת ההרשאות שניתנו.
העברת נתונים (פרטי כניסה מאוחדים) ‫Sites.FullControl.All (אפשרות 1, אפליקציה) ההרשאה הזו מאפשרת למאגר הנתונים שליטה מלאה בכל אוספי האתרים.
‫Sites.Selected (אפשרות 2, אפליקציה) מאפשרת למאגר הנתונים לגשת לקבוצת משנה של אוספי אתרים עם משתמש שמחובר לחשבון. אפשר להגדיר ב-SharePoint Online את אוספי האתרים הספציפיים ואת ההרשאות שניתנו.
העברת נתונים (טוקן רענון OAuth 2.0) AllSites.FullControl (אפשרות 1, מואצל) מאפשר למאגר הנתונים שליטה מלאה בכל אוספי האתרים בשם המשתמש המחובר.
‫Sites.Selected (אפשרות 2, מואצל) מאפשרת למאגר הנתונים לגשת לקבוצת משנה של אוספי אתרים עם משתמש שמחובר לחשבון. אפשר להגדיר ב-SharePoint Online את אוספי האתרים הספציפיים ואת ההרשאות שניתנו.
פעולות AllSites.Write (הועברה הרשאה) מאפשר למאגר הנתונים ליצור, לקרוא, לעדכן, למחוק, להעלות ולהוריד מסמכים ופריטים ברשימה בכל אוספי האתרים בשם המשתמש המחובר.

במאמר הגדרה של Microsoft SharePoint והרשאות נדרשות מוסבר איך להוסיף את ההרשאות ל-Microsoft SharePoint.

מגבלות

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

  • כשיוצרים אפליקציה חדשה או מוסיפים מאגר נתונים לאפליקציה קיימת, מומלץ לשייך רק מאגר נתונים אחד לפעולות ששייכות לסוג מחבר יחיד.
  • אין תמיכה באכיפת היקף של VPC Service Controls במאגרי נתונים קיימים של Microsoft SharePoint. כדי לאכוף את VPC Service Controls, צריך למחוק את מאגרי הנתונים וליצור אותם מחדש. מידע נוסף על VPC Service Controls ועל אופן השימוש בפעולות אחרי הפעלת VPC Service Controls זמין במאמר אבטחת האפליקציה באמצעות VPC Service Controls.
  • מאגר הנתונים של Microsoft SharePoint נתמך רק במיקומים global, us ו-eu.

  • תנאי מוקדם לאיכות החיפוש: כדי להשיג תוצאות חיפוש אופטימליות ולנצל את כל התכונות של Knowledge Graph, מומלץ להגדיר ולסנכרן את מאגר נתוני החיפוש של אנשים בנוסף למאגר הנתונים של Microsoft SharePoint.

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

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

המלצה

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

פתרון בעיות בתוצאות חיפוש של מחבר SharePoint

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

  • בודקים את מאגר הנתונים של אנשים: אם נתקלים בבעיות ברלוונטיות או בהתאמת ישויות, צריך לוודא שמאגר הנתונים של חיפוש אנשים מוגדר ומסונכרן.
  • שגיאות אימות: שגיאות אימות חוזרות, כמו 'שגיאה באחזור טוקן גישה ל-Graph API', ימנעו את פעולת החיפושים. כדי לפתור את הבעיה, צריך לבדוק את היומנים של Microsoft Entra ID כדי לקבל פרטים, ואז לאמת מחדש את החיבור.
  • אי התאמה של הזהות: אם משתמשים בזהות Google, צריך לוודא שכתובת האימייל של המשתמש ב-Google זהה בדיוק לכתובת האימייל שלו ב-Microsoft SharePoint. חוסר התאמה מונע את החזרת התוצאות.
  • חיפושים בתיקיות ממוקדות (כתובות URL מסוג ‎.aspx): חיפוש באמצעות כתובות URL מלאות של דפדפן שמסתיימות ב-/Forms/AllItems.aspx מבצע חיפוש בכל האתר, ולא רק בתיקייה הספציפית. תמיד משתמשים בנתיבי תיקיות מוחלטים לחיפושים ממוקדים.
  • מגבלות על התוצאות: שימו לב שלחיפושים מאוחדים עשויות להיות מגבלות על מספר המסמכים שמוחזרים לכל שאילתה (בדרך כלל עד 20 תוצאות).
  • בעיות בציטוטים: יכול להיות שציטוטים שגויים יופיעו לסירוגין. אם הבעיה נמשכת, צריך לדווח עליה לתמיכה ולכלול את אסימוני האבחון.
  • תאימות של מחבר למודל: חשוב לוודא שאתם משתמשים בגרסאות העדכניות של מודלי Gemini. יש דגמים ישנים יותר (לדוגמה, 3.x) שיש להם בעיות ידועות בפתרון כלים לפעולות ב-SharePoint, כמו download_document ב-Agent Builder.

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